Установка
Установите сервер AI Core через txAdmin за несколько минут или вручную.
Требования
| Зависимость | Версия | Зачем |
|---|---|---|
| FXServer (artifact) с txAdmin | 38039 или новее | Это нужно 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>". |