Agency-Banking: полноценный банк для FiveM, с фреймворком или без него

Полноценный банк для вашего города

Agency-Banking превращает каждое отделение банка и банкомат в полноценное банковское приложение. Игроки видят баланс банковского счёта и наличные рядом, переводят деньги, управляют картами, срочными вкладами и инвестициями в одном месте. Скрипт работает с QBCore, Qbox или ESX, а на сервере без фреймворка ведёт собственные счета. Единственный необходимый ресурс, oxmysql.

Всё в меню

• Кошелёк: баланс банковского счёта и наличные, пополнение и снятие средств.
• Переводы: по ID сервера или игроку поблизости.
• Карты: банковские карты в четырёх темах.
• PIN-код банкомата: блокировка на 60 секунд после пяти неверных попыток.
• Срочные вклады: по умолчанию на 7, 14 или 30 дней, по ставкам из конфигурации сервера, которые не зависят от игрока.
• Рынки: торговля акциями и криптовалютой.
• Журнал операций: полная история счёта.

Автоопределение фреймворка или standalone

Оставьте настройку фреймворка на auto, и банк сам обнаружит QBCore, Qbox или ESX, даже если фреймворк запускается с задержкой. При каждом запуске консоль сервера сообщает, какой фреймворк обнаружен, или что банк работает в режиме standalone. Режим standalone выбирается, только если ни один из них не установлен.

В режиме standalone игроки идентифицируются по лицензии Rockstar, а администраторы определяются через ACE или список лицензий в конфигурации. Баланс и наличные хранит сам банк. Если установлен Agency-Phone, телефон и банк используют общий баланс. Серверы со своей денежной системой подключают её через несколько хуков в конфигурации.

Денежная система для ваших других скриптов

Серверные экспорты работают одинаково на всех фреймворках. На сервере в режиме standalone они служат денежной системой: магазин, работа или гараж начисляют деньги игрокам и списывают их через банк, а в открытом банке сразу отображается новый баланс.

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

Такая же пара экспортов доступна для наличных через AddCashMoney и RemoveCashMoney, рядом с GetBankBalance, GetCashBalance, AddTransaction , для журнала операций, и GetFramework. В QBCore и ESX открытый банк сам отслеживает изменения средств во фреймворке. После любого другого изменения вызовите agency_banking:client:MoneyChanged для этого игрока.

Проверка на сервере

Выплаты, процентные ставки, срочные вклады, карты и транзакции проверяются на сервере, поэтому модифицированный клиент не может создавать деньги или получать доступ к картам других игроков. Связь через Companion сама по себе не даёт никаких прав на банковские операции: каждое денежное действие из приложения повторно проверяется на сервере.

Два дизайна и настройка размера

Меню выполнено в стиле Agency: цельная тёмная панель, золотые акценты, кнопки-пилюли и золотой индикатор, который плавно перемещается по боковой панели. Серверы, которым больше нравится классический синий стиль, могут переключить настройку дизайна на v1 и сохранить все функции.

Каждый игрок может настроить масштаб банка от 60 до 150 процентов с шагом 1 процент в разделе настроек, размер сохраняется отдельно для каждого игрока. Банк поддерживает 13 языков и открывается у маркеров, через qb-target или ox_target.

Установка и обновления

Импорт SQL не требуется: все таблицы, столбцы и индексы создаются при первом запуске на MariaDB и MySQL 8. В комплект входит agency_banking.sql только для серверов, где пользователю базы данных запрещено создавать таблицы. По умолчанию /openbank доступен только администраторам, а один переключатель в конфиге открывает его для всех игроков.

Обновления бесплатны для всех владельцев Agency-Banking. Счета, карты, транзакции, срочные вклады и сопряжения с Companion сохраняются при обновлении. Используйте новый config.lua, не копируйте поверх него старый, и выполните refresh перед перезапуском ресурса, если изменился manifest.

Банкинг на настоящем телефоне

Agency-Banking работает с бесплатным приложением Agency Companion для iOS и Android, независимо от Agency-Phone: баланс, переводы, карты, срочные вклады и PIN-код банкомата всегда под рукой. Игроки выполняют сопряжение с /abconnect, короткий /abcили с помощью QR-кода в меню банка.

Приобрести Agency-Banking

Agency-Banking доступен в магазине Agency Scripts, а документация включает описание конфигурации, экспортов и событий.