AI Core

Установка

Установите сервер AI Core через txAdmin за несколько минут или вручную.

Требования

ЗависимостьВерсияЗачем
FXServer (artifact) с txAdmin38039 или новееЭто нужно ai-core: сервер сам видит смерть игроков.
MariaDB (или MySQL)актуальнаяБаза данных. AI Core сам создаёт свои таблицы.
BunактуальнаяТолько для изменения или сборки скриптов. Каждый скрипт поставляется уже собранным, поэтому для работы сервера инструменты сборки не нужны.

Установка через txAdmin (рекомендуется)

Запустите txAdmin

Скачайте свежий artifact FXServer и запустите его: txAdmin откроется в браузере. Следуйте официальному руководству до шага развёртывания.

Используйте рецепт AI Core

Выберите Popular Recipes > Remote URL Template и вставьте:

https://raw.githubusercontent.com/aicore8/aicore-server/main/recipe/ai-core.yaml

Заполните данные

Введите имя сервера, лицензионный ключ с portal.cfx.re и данные базы. Рецепт запишет server.cfg и env.cfg, подключит базу данных и скачает все скрипты ai-*. SQL-файл импортировать не нужно: AI Core и скрипты сами создают и обновляют свои таблицы при первом запуске.

Станьте администратором

Зайдите на сервер. Приветственная карточка покажет строку, которая делает вас администратором: добавьте её в permission.cfg и перезапустите сервер. Затем нажмите F10, чтобы открыть админ-панель; её мастер настройки проведёт вас через первые настройки.

Название сервера в списке, описание, теги, язык, баннеры и ссылка на Discord задаются на portal.cfx.re/servers, а не в server.cfg.

Установка вручную

Получите папку сервера

Скачайте папку сервера (cfg-файлы, recipe/, tools/, template/). Для каждого скрипта ai-* скачайте <name>.zip из его последнего релиза на GitHub и распакуйте в resources/[ai]/. Если нужны только файлы, которые запускает сервер, без исходников, используйте вместо него <name>-runtime.zip.

Настройте секреты

Скопируйте env.example.cfg в env.cfg, впишите лицензионный ключ и подключение к базе данных, затем создайте базу данных.

Запустите сервер

Запустите FXServer (txAdmin), указав эту папку как папку данных сервера.

Структура

ПутьЧто
server.cfgСписок ресурсов и подключение конфигов.
env.cfgЛицензия, слоты, адреса, база данных, RCON. Свой для каждой машины, никогда не попадает в git.
security.cfgСтрогие настройки безопасности FiveM. Никогда их не ослабляйте: каждый скрипт написан под них.
permission.cfgАдминистраторы и права ACE.
misc.cfgЯзык и другие общие convar.
resources/[ai]/Скрипты AI Core, по одной папке на каждый скрипт ai-*.
resources/[standalone]/Сторонние ресурсы, которые вы добавляете.
packages/Пакеты @aicore8/* (для разработчиков).
template/Шаблон для новых скриптов: bun run new <name> "<description>".

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