Agency Docs
QBESXStandalone

Agency-Blackmarket V2 Установка

Живой чёрный рынок для FiveM на QBCore, Qbox, ESX или полностью в режиме standalone.

v2.0.0Платно6 Страницы

01Установка

  1. 1Поместите Agency-Blackmarket в папку resources
  2. 2Добавьте ensure Agency-Blackmarket в server.cfg после вашего фреймворка, инвентаря и ресурса target
  3. 3С oxmysql таблица agency_blackmarket создаётся при первом запуске. install/agency_blackmarket.sql нужен, только если пользователю вашей базы данных нельзя создавать таблицы
  4. 4Сверьте предметы из Config.Items и Config.Sell.items с вашим инвентарём. Предметы, которых ваш инвентарь не знает, пропускаются, с одной строкой в консоли сервера
  5. 5Необязательно: add_ace group.admin agency.blackmarket allow для страницы администратора в /ablackmarket
  6. 6Обновление с V1: замените старую папку и используйте новый config.lua. Репутация из blackmarket_reputation переносится при первом запуске, а qb-menu больше не нужен

02Зависимости

  • Зависимости не требуются
  • QBCore, QBox или ESX (необязательно, без фреймворка работает в режиме standalone)
  • Инвентарь (необязательно: ox_inventory, qb-inventory, qs-inventory, ps, lj или jpr)
  • oxmysql (необязательно, без него всё сохраняется в хранилище ключ-значение сервера)
  • ox_target или qb-target (необязательно, иначе подсказка с клавишей)
  • Скрипт dispatch (необязательно: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch, lb-tablet или origen_police)
  • Agency-Banking (необязательно, деньги в режиме standalone)
  • Agency-Notify (необязательно)
  • Agency Phone (необязательно, игроки платят через Agency Pay)

03SQL файл

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

-- Agency Blackmarket V2 -- The resource creates this table by itself when oxmysql runs. Run this file -- only if your database user may not create tables. CREATE TABLE IF NOT EXISTS `agency_blackmarket` ( `scope` VARCHAR(16) NOT NULL, `id` VARCHAR(96) NOT NULL, `data` LONGTEXT NOT NULL, `updated` INT UNSIGNED NOT NULL DEFAULT 0, PRIMARY KEY (`scope`, `id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- V1 kept reputation in `blackmarket_reputation`. V2 takes it over once on its -- first start; the old table can be dropped afterwards: -- DROP TABLE IF EXISTS `blackmarket_reputation`;

+Полезно знать

Agency-Blackmarket V2 работает сразу после строки ensure. Перед первым запуском стоит взглянуть на четыре пункта: предметы, грязные деньги, базу данных и, при обновлении, переход с V1.

Предметы
Рынок продаёт то, что указано в Config.Items, а скупщик покупает то, что указано в Config.Sell.items. Предметы, которых ваш инвентарь не знает, пропускаются при запуске, и одна строка в консоли сервера их называет. Для ox_inventory можно задать другое имя предмета через ox, например ammo-9 для pistol_ammo.
Грязные деньги
QBCore использует меченые купюры (markedbills) или предмет black_money, если его знает ox_inventory. Qbox использует предмет black_money, а ESX счёт black_money. Config.Money.dirty задаёт способ принудительно, а Config.Money.buyWith определяет, чем берут дилеры: грязными деньгами, наличными или банком.
База данных
С oxmysql репутация, запас, заказы и подключённые телефоны сохраняются в таблице agency_blackmarket, которую скрипт создаёт сам. Без oxmysql всё попадает в хранилище ключ-значение сервера. install/agency_blackmarket.sql нужен, только если пользователю вашей базы данных нельзя создавать таблицы.
Обновление с V1
Замените старую папку новой и используйте новый config.lua, конфиг из V1 не подходит. Репутация переносится из blackmarket_reputation при первом запуске. qb-menu и esx_menu_default больше не нужны.

?Частые вопросы

Откуда берутся изображения предметов?

С Config.Images = 'auto' меню берёт их из работающего инвентаря: ox_inventory, qs-inventory, qb-inventory, ps, lj или jpr. Подойдёт и собственный веб-адрес, а false показывает вместо них значки категорий.

Кто может открыть страницу администратора?

Игроки с ACE agency.blackmarket, group.admin или group.superadmin, а в QBCore и ESX также с группой из Config.AdminGroups. Для большинства серверов достаточно add_ace group.admin agency.blackmarket allow в server.cfg.

После этой страницы всё ещё не получается? Дальше подключается наша поддержка.