ai-core

ai-core и есть AI Core: фреймворк, на котором строится каждый другой скрипт. Он знает, кто играет, какого персонажа выбрал, сколько у него денег, к каким работам и бандам он относится и кто является администратором. Он содержит админ-панель для каждого скрипта и позволяет скриптам ESX, QBCore, Qbox и vRP работать без изменений.

Эта страница является обзором. Сама админ-панель описана на странице Админ-панель.

Игроки и персонажиCopy Anchor Link

• Аккаунты. Игрок определяется по его аккаунту FiveM (идентификатор fivem:). Подключение без него отклоняется. Id лицензии и Discord хранятся рядом с ним для скриптов, которые их читают.
• Несколько персонажей на аккаунт (по умолчанию 3 слота). Игроки могут удалять персонажей, если вы это не отключите.
• Экран персонажей. Персонажи игрока стоят в настоящей сцене города, каждый в своей одежде; камера плавно переезжает к выбранному. На нём показываются название вашего сервера, подзаголовок и слоган.
• Создание персонажа спрашивает имя и фамилию, дату рождения (по умолчанию минимальный возраст 18), пол и национальность. Затем новый персонаж проходит через редактор одежды (ai-appearance или другой скрипт одежды).
• Где появиться. Новый персонаж появляется в точке First spawn. По желанию после выбора персонажа показывается список с последним местом и местами, которые вы задали.
• Сохранение. Деньги и членство сохраняются сразу. Позиция, броня и другие мелкие изменения сохраняются каждые 5 минут (панель), при выходе, при остановке ресурса и при выключении через txAdmin.
• PvP. Один переключатель решает, могут ли игроки наносить урон друг другу (по умолчанию включено); администраторы переключают его в игре командой /togglepvp.

ДеньгиCopy Anchor Link

• По умолчанию счета Cash (500 на старте), Bank (5000), Dirty money и Crypto. Вы добавляете, переименовываете или удаляете счета в панели (Money accounts), у каждого есть начальная сумма и признак, может ли он уходить ниже нуля.
• У работ и банд тоже есть свои счета (деньги организации).
• Каждое изменение записывается строкой в журнал операций: кто, сколько, причина.

Работы и бандыCopy Anchor Link

• Несколько работ на персонажа (по умолчанию 3, или одна, когда Several jobs per character выключено) и несколько банд (по умолчанию 2) с одной активной бандой.
• Дежурство. Персонаж может быть на дежурстве не больше чем в одной работе. Зарплата идёт только с работы, на дежурстве в которой он находится. После входа игроки начинают не на дежурстве, если вы не включите Keep duty after rejoining.
• Зарплата. Каждые 15 минут (панель) игроки на дежурстве получают зарплату своего ранга на банковский счёт; её платит сервер или, если вы выберете, собственный счёт работы.
• Прайм-тайм. Вне часов пик (по умолчанию с 18:00 до 01:00) зарплаты падают вдвое. Часы, снижение и переключатель находятся в панели; у работы могут быть свои часы.
• Сами работы и банды (ранги, зарплаты, ранги босса) являются записями во вкладках панели Jobs и Gangs.

ПраваCopy Anchor Link

• Администраторы являются игроками с ACE ai.admin. permission.cfg из рецепта выдаёт его group.admin; добавьте игрока командой add_principal identifier.fivem:<id> group.admin. На новом сервере приветственная карточка показывает точную строку.
• Команды, созданные через lib AI Core, проверяют права на сервере: все, администраторы или определённые ACE и группы. Вкладка панели Commands перечисляет каждую команду и тех, кто может её использовать.
• Права работ и банд. ai-core отражает членство в принципалах ACE: ai.job.<name> и ai.job.<name>.<grade> (каждый ранг до ранга игрока включительно), то же для банд. Поэтому add_ace ai.job.police command.mdt allow даёт команду каждому полицейскому.

Админ-панельCopy Anchor Link

ai-core содержит панель в игре (F10 или /aiadmin) для себя и для каждого скрипта ai-*. Его собственные разделы:

Он также проверяет обновления каждого скрипта с репозиторием на GitHub (раз в 6 часов на скрипт) и рекомендует на дашборде бесплатные скрипты, которые стоит установить.

Мост (ESX, QBCore, Qbox, vRP)Copy Anchor Link

ai-core делает provide для es_extended, qb-core, qbx_core и vrp и отвечает на их экспорты, объекты ядра и события. Скрипты, написанные для этих фреймворков, видят AI Core как свой фреймворк: вызовы ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, vRP 1, 2 и 3 работают с игроками, деньгами и работами AI Core.

Он также отрисовывает ресурсы интерфейса фреймворков собственными меню и карточками AI Core: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input и progressbar. Удалите эти ресурсы: ai-core отвечает на их имена. См. Совместимость.

Слои: одно место для каждого вида скриптовCopy Anchor Link

Предметы, ключи от транспорта, вызовы полиции, одежда, смерти и реанимации, тюрьма, топливо, замки дверей, гаражи, время и погода, счета, банк, телефоны, радиальное меню, HUD и уведомления идут через ai-core. Скрипт просит ai-core («выдай этот предмет»), а ai-core вызывает тот скрипт, который у вас отвечает за эту задачу. Поэтому почти любой скрипт ai-* можно заменить сторонним, и поэтому ai-core сообщает в консоли, когда одновременно запущены два скрипта для одной задачи.

УстановкаCopy Anchor Link

Его устанавливает рецепт AI Core для txAdmin. Вручную: положите папку в resources/[ai]/ и добавьте ensure ai-core в server.cfg после ensure ai-mysql и перед каждым другим скриптом ai-*. Ему нужны OneSync и база данных:

add_convar_permission ai-core read mysql_connection_string

Его таблицы (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) создаются при первом запуске. Не устанавливайте рядом с ним es_extended, qb-core или qbx_core. Оставьте set resources_useSystemChat false.

КомандыCopy Anchor Link

Команды aicore_* являются инструментами для тестов: они отвечают в консоли сервера. Привычные админ-команды QB / ESX (setjob, givemoney...) идут вместе с ai-admin.

Привязки клавишCopy Anchor Link

Известные ограниченияCopy Anchor Link

• Игрокам нужен привязанный аккаунт FiveM (идентификатор fivem:); игроки без него не могут зайти.
• Если одновременно запущен скрипт и его замена (tgiann-inventory рядом с ai-inventory), никто не может зайти, пока работают оба, если включено Refuse players while both run (по умолчанию). Консоль называет папку, которую нужно удалить.