Farmstead Mods
EN

Установка и токен

Требования, установка jar на сервер и клиентам, токен из кабинета и проверка по логу.

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

Требования#

  • Сервер NeoForge 1.21.1, Java 21.
  • Тот же jar у игроков в mods/ клиента: клиентская половина рисует голограмму-прицел (R — поворот, ЛКМ/Enter — поставить, ПКМ/Backspace — отменить) и всю анимацию стройки.
  • Аккаунт на farmsteadminecraft.online с AI-токенами на балансе.
  • Исходящий HTTPS с сервера на ai.farmsteadminecraft.online.
  • LuckPerms — необязателен. Нужен, только если хотите раздавать команды по группам, а не уровнями прав из конфига.

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

Установка#

  1. Скачайте последний релиз и положите jar в mods/ сервера. Тот же файл раздайте игрокам.
  2. Запустите сервер один раз — появится config/farmstead_aibuilder.toml.
  3. В кабинете farmsteadminecraft.online/cabinet/ai-builder нажмите «Создать токен». Значение показывается один раз — скопируйте сразу.

  4. Впишите его в конфиг:

    toml [api] api_base_url = "https://ai.farmsteadminecraft.online" bearer_token = "fsm_..."

  5. Перезапустите сервер.

Проверка по логу#

После перезапуска в логе появятся две строки:

[hello] AI service OK: server='Основной сервер' mode=external apiVersion=1 …
[regionguard] API available (ClaimsApi) — claims are enforced for non-operators

Первая — токен принят. Если вместо неё [hello] the AI service rejected this server's token, токен вписан неверно или отозван. Если [hello] /aibuild is not configured, в конфиге пусты api_base_url или bearer_token.

Вторая — про приваты: найден ли Farmstead Claims или исходный RegionGuard. Подробнее — в разделе «Защита территорий».

Обновление#

Постоянная ссылка на свежую сборку: releases/latest/download/farmstead-aibuilder-neoforge-1.21.1.jar. Имя файла одно и то же во всех версиях, поэтому новый jar заменяет старый — два файла с одним mod id FML молча загрузил бы в случайном порядке. Версия указана в названии релиза и в манифесте jar. Лимиты хранятся на стороне сервиса, обновление мода их не сбрасывает.

Безопасность токена#

Токен — это ключ к вашему кошельку AI-токенов. Не публикуйте конфиг. Утёк — отзовите токен в кабинете и создайте новый.