AI Core

Совместимость

Как AI Core запускает скрипты ESX, QBCore, Qbox и vRP и подключает сторонние ресурсы.

Почти каждый скрипт FiveM написан под ESX, QBCore, Qbox или vRP, поэтому их запуск является одной из главных целей. AI Core не поставляет сторонних скриптов и не отдаёт предпочтения ни одному разработчику: вы устанавливаете свои.

Три слоя

Мост фреймворков

AI Core предоставляет es_extended, qb-core и qbx_core и отвечает на их экспорты, объекты ядра, объекты игроков, колбэки, события и подключаемые файлы (@qb-core/shared/locale.lua, @es_extended/imports.lua, @qbx_core/modules/playerdata.lua), поэтому скрипты, написанные для ESX, QBCore или Qbox, видят AI Core как свой фреймворк и работают без изменений. Для скриптов vRP AI Core также предоставляет vrp (см. Скрипты vRP ниже). Их меню, текстовые подсказки, полосы прогресса и диалоги ввода отрисовываются собственным интерфейсом AI Core.

Слои интеграции

AI Core и скриптам ai-* нужно то, что дают другие скрипты. У каждой категории один интерфейс, и каждый поддерживаемый скрипт подключается одним адаптером. AI Core находит установленный скрипт при старте, а также когда скрипты запускаются или останавливаются; админ-панель может переопределить выбор.

КатегорияПримеры
Инвентарьai-inventory, ox_inventory, qb-inventory, tgiann-inventory и другие
Ключи от транспортаai-vehiclekeys, qbx_vehiclekeys и другие
Диспетчер (вызовы полиции)ai-policealert и скрипты оповещений
Телефонtgiann-phone, lb-phone
Одеждаai-appearance, tgiann-clothing
Смертьai-death, qbx_medical, qb-ambulancejob, esx_ambulancejob, ars_ambulancejob
Погода и времяai-weathersync, qb-weathersync, Renewed-Weathersync, cd_easytime
Тюрьмаai-prison, qb-prison
Радиальное менюai-radialmenu, qb-radialmenu, ox_lib

Заменители

Несколько скриптов ai-* отвечают на API того скрипта, который они заменяют, поэтому сторонние скрипты работают с ними без адаптера: ai-mysql заменяет oxmysql (а также mysql-async и ghmattimysql), ai-inventory заменяет ox_inventory и qb-inventory, ai-target заменяет ox_target, ai-voice заменяет pma-voice, ai-chat заменяет chat, ai-vehicles и ai-vehiclekeys заменяют скрипты транспорта Qbox.

Список совместимых скриптов показывает, с чем AI Core интегрируется сегодня.

Скрипты vRP

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

Версия vRPЧто работает
vRP 1.0Скрипты, которые используют Proxy / Tunnel с vRP.* и vRPclient.*: пользователи, деньги, группы и права, инвентарь и сундуки, личность, голод и жажда, меню, текстовые подсказки, уведомления, блипы и маркеры.
vRPex, Zirix, DunkoТо же самое плюс дополнительные функции этих форков vRP 1 (format, hasPermissions, tryBankPayment и другие).
Старый стиль вызовов vRP 0.5Вызовы, которые передают аргументы в таблице с колбэком, например vRP.getUserId({source}).
vRP 2 и vRP 3Расширения (extensions), которые скрипт загружает через vRP.loadScript. Каждое работает в своей песочнице внутри AI Core: его глобальные переменные никогда не трогают другой скрипт, а всё, что оно зарегистрировало, удаляется, когда его ресурс останавливается.

Меню, текстовые подсказки и вопросы «да / нет» скриптов vRP отрисовываются собственным меню и диалогами AI Core. Когда скрипт добавляет пункты в главное меню vRP, игроки открывают его клавишей F7; клавишу можно изменить в разделе Keybinds админ-панели.

AI Core протестирован на работающем сервере с семью публичными скриптами vRP: vrp_basic_mission, vrp_chests, vrp_blips, self_storages, vrp_drugfarms, vrp_worlditems и party_system.

Установка скрипта vRP

Удалите оригинальный vRP

Теперь ваш ресурс vrp это AI Core, поэтому оригинал нужно убрать. Если на сервере есть папка vrp или драйвер базы данных vRP (vrp_mysql, vrp_oxmysql, vrp_ghmattimysql, vRP-db-drivers), удалите папку и её строку ensure в server.cfg. Пока хоть один из них на месте, AI Core отклоняет подключения и называет папку, которую нужно удалить.

Добавьте скрипт

Положите папку скрипта в resources/[standalone]/ и добавьте ensure <имя папки> в server.cfg ниже строк ensure ai-*, как для любого другого скрипта. Не редактируйте скрипт: его зависимость vrp и подключаемый файл @vrp/lib/utils.lua сами находят AI Core.

Запустите его и раздайте его права

Перезапустите сервер и попробуйте функции скрипта в игре. Затем откройте админ-панель (F10) и вкладку vRP scripts в AI Core: Asked permissions показывает каждое имя права, которое запросил скрипт. Решите, кто получает каждое из них, как объясняет следующий раздел.

Вкладка vRP scripts

Скрипты vRP не спрашивают «этот игрок полицейский?». Они запрашивают имена прав (police.service), имена групп (police, vip) и id предметов (edible|tacos). Вкладка vRP scripts в разделе AI Core админ-панели решает, что эти имена значат на вашем сервере. Каждое изменение сохраняется сразу, без перезапуска. На вкладке пять карточек:

Built-in rules (встроенные правила)

Эти три переключателя отвечают на каждое имя права, которое не упоминает ни одно правило, поэтому многие скрипты работают ещё до того, как вы добавите хоть одно правило:

  • Job permissions go to the job: право, которое начинается с названия работы, например police.service, получают сотрудники этой работы. Если включено Only while on duty, оно есть у них только на смене.
  • admin. permissions go to admins: право, которое начинается с admin., например admin.tickets, получают игроки с правами админа (ACE ai.admin).
  • player. permissions go to everyone: право, которое начинается с player., например player.phone, получает каждый игрок.

Asked permissions (запрошенные права)

Каждое имя права, которое запрашивали ваши скрипты, с полем поиска. Нажмите Add rule рядом с именем, и правило для него появится вверху Permission rules. Новое правило даёт право только админам, пока вы не выберете, у кого оно должно быть.

Permission rules (правила прав)

Одна строка на правило. В Permission name впишите право (police.service) или имя, которое заканчивается на * (police.*), чтобы охватить все права, начинающиеся так же. В Who has it выберите одно:

  • Members of a job: выберите работу и Lowest grade (этот ранг и все выше). Включите Only on duty, если право должно быть только на смене.
  • Members of a gang: выберите банду и самый низкий ранг.
  • Characters in a group: впишите имя группы, которую выдают скрипты (см. Group names).
  • Admins или Everyone.

Несколько правил могут называть одно и то же право: оно есть у каждого, кто подходит под любое из них. Как только правило называет право, встроенные правила для него больше не действуют. Панель отклоняет ранг, которого нет у работы или банды.

Group names (имена групп)

Скрипты vRP выдают и проверяют группы по имени. Собственное название работы или банды (police, ballas) работает без строки. Для любого другого имени, которое использует скрипт (Coronel, sheriff), добавьте строку: впишите его в Group name и выберите в Means, что оно значит:

  • A job grade или A gang grade: когда скрипт выдаёт эту группу, персонаж получает эту работу или банду с этим рангом; когда скрипт её проверяет, ответ «да» для этого ранга и всех выше.
  • Admins: проверка отвечает «да» для игроков с правами админа. Скрипт никогда не сделает кого-то админом: выдача этой группы отклоняется.

Имя без строки остаётся отдельной группой, которая сохраняется вместе с персонажем.

Item names (имена предметов)

Свяжите id предмета, который использует скрипт (Name scripts use, например edible|tacos), с предметом вашего инвентаря (Inventory item, выбирается из списка). Id, который уже совпадает с именем одного из ваших предметов, строки не требует. Без строки wbody|WEAPON_X означает предмет-оружие, а любой другой id вида a|b означает b.

Пример: полицейский скрипт запрашивает police.service, но ваша полицейская работа называется lspd. Добавьте правило права с именем police.service, Members of a job, работа lspd, самый низкий ранг 0 и включённое Only on duty. Теперь это право есть у каждого полицейского на смене.

Что не работает с vRP

  • Creative v5. Его API (имена в PascalCase, @vrp/lib/Utils.lua, @vrp/config/*.lua) другой и не поддерживается.
  • SQL к собственным таблицам vRP. AI Core хранит свои данные, поэтому скрипт, который своими запросами читает или пишет vrp_users, vrp_user_identities, vrp_user_data, vrp_srv_data или похожие таблицы, ничего не находит.
  • Модули vRP, которых нет в AI Core: телефонный справочник, дома, бизнесы, личный транспорт и гаражи, навыки (aptitudes), полицейские записи и тюрьма, магазины, переработчики предметов, банкоматы, аудио и рация, полосы прогресса, баны и вайтлист, а также миссии vRP 1 (миссии vRP 2 / 3 работают). Скрипт, который их использует, теряет эту часть.
  • В меню нет влево / вправо. Пункты, которые меняют значение стрелками, принимают только обычный выбор.
  • vRP:playerSpawn срабатывает один раз за загрузку персонажа, а не после возрождения: возрождения относятся к скрипту смерти.
  • vrp всегда выглядит запущенным. Скрипт, который поддерживает несколько фреймворков и сначала проверяет vRP, берёт свой код для vRP. Если вам нужен его код для ESX или QBCore, выберите этот фреймворк в конфиге самого скрипта.
  • Расширение vRP 2 / 3 работает внутри AI Core, поэтому его время CPU видно под ai-core в resmon. Если оно падает, консоль выводит одну строку с его файлом, а AI Core продолжает работать.

Замена скрипта ai-*

Если вы установите платный скрипт, который заменяет один из ai-* (например, другой инвентарь), AI Core подскажет, какую папку удалить, и не будет пускать игроков, пока работают оба, чтобы два скрипта никогда не боролись за одну задачу.

Добавление скрипта

Поддержка нового скрипта сводится к одной небольшой повторяемой задаче: скопируйте шаблон адаптера категории, заполните его вызовы, добавьте одну строку в реестр. Это можно поручить вашему ИИ.

На этой странице