Быстрый старт · Farmstead NeoEssentials

Установка#

Farmstead NeoEssentials работает только на сервере — игрокам ничего ставить не нужно, ванильный клиент подключается как обычно.

Положите neoessentials-<версия>.jar в папку mods/ сервера.
Запустите сервер один раз и остановите. Мод создаст config/neoessentials/ со всеми конфигурационными файлами и файлами данных.
Откройте config/neoessentials/config.json и пройдитесь по секции modules — там включаются и выключаются подсистемы целиком.

Переключатели в modules и commands читаются один раз при старте: команда либо регистрируется, либо нет. /neoessentials reload обновляет только значения настроек, он не может добавить или убрать уже зарегистрированную команду. После правки этих двух секций нужен перезапуск сервера.

Автодополнение ников#

В командах, которые принимают ник игрока, нажмите Tab, чтобы выбрать игрока из списка онлайн. Это работает, в частности, для личных сообщений (/me <игрок> <сообщение>, /msg, /pm), телепортации, модерации, почты, домов, магазинов и служебных команд.

Подсказки содержат только игроков онлайн. Если команда поддерживает офлайн-цели, например /seen, /tpoffline или историю наказаний, известный ник офлайн-игрока всё так же можно ввести вручную.

Язык сервера#

Из коробки сервер отвечает по-английски ("language": "" означает en_us). Язык задаётся одним ключом в config.json:

"localization": {
  "language": "ru_ru"
}

После /neoessentials reload сервер начнёт отвечать по-русски. Непереведённые строки автоматически откатываются на английский, так что сломать вывод неверным кодом языка нельзя. Полнота перевода по языкам — на странице Локализация.

Первая выдача прав#

По умолчанию почти всё закрыто: permissions.requireExplicitGrant: true — узел работает только после явной выдачи (LuckPerms или внутренний менеджер). defaultValue=true в реестре сам по себе доступ не даёт. OP всё ещё проходит при opsBypassPermissions: true.

Базовый набор для обычного игрока и для модератора выглядит так (пример для LuckPerms):

/lp group default permission set neoessentials.use true
/lp group default permission set neoessentials.teleport.home true
/lp group default permission set neoessentials.teleport.home.set true
/lp group default permission set neoessentials.teleport.spawn true
/lp group default permission set neoessentials.economy.balance true
/lp group default permission set neoessentials.ah true
/lp group default permission set neoessentials.ah.sell true
/lp group default permission set neoessentials.chestshop true
/lp group default permission set neoessentials.chat.msg true
/lp group default permission set neoessentials.votifier.vote true

/lp group moderator permission set neoessentials.chat.mute true
/lp group moderator permission set neoessentials.moderation.kick true
/lp group moderator permission set neoessentials.moderation.jail true
/lp group helper permission set neoessentials.moderation.stafflog true
/lp group moderator permission set neoessentials.moderation.stafflog true
/lp group headmoderator permission set neoessentials.moderation.stafflog true
/lp group admin permission set neoessentials.moderation.stafflog true

/lp group admin permission set neoessentials.* true

Полный список узлов с описаниями — на странице Права. Какое право проверяет конкретная команда, видно в колонке «Право» на странице Все команды, а в игре — по /help <команда>.

neoessentials.admin и wildcard neoessentials.* — не одно и то же. Wildcard намеренно не выдаёт градуированные экономические узлы-модификаторы, если не включить permissions.wildcardsGrantEconomyModifierPermissions. Это защита от случайной выдачи права менять чужие балансы вместе с общим доступом.

Проверка, что всё живо#

Команда	Что подтверждает
`/neoessentials`	мод загрузился, показывает версию и номер сборки
`/help`	реестр команд собрался, показывает только доступное вам
`/neoessentials reload`	конфиги читаются без ошибок
`/balance`	включена и проинициализирована экономика

Если команда есть в этом справочнике, но не работает в игре — сначала проверьте, включена ли её подсистема в modules, а затем не выключена ли сама команда в секции commands конфига.

Куда дальше#

Разделы по системам в меню слева устроены одинаково: сверху команды и рабочие примеры, ниже тонкие места, затем известные проблемы, и в самом конце — подробное руководство оригинального проекта на английском.