Custom LAN

Fabric мод, который предоставляет расширенные возможности управления локальным сервером Minecraft.

Основные возможности

• Глубокая настройка встроенного сервера: режим онлайн, PvP, максимальное количество игроков, сообщение дня (MOTD)
• Поддержка форматирования текста в MOTD с использованием амперсандов (&) вместо символов параграфа (§) и переменных (например, ${username}, ${world})
• Изменение параметров сервера во время игры, включая порт, с возможностью остановки сервера без выхода из мира
• Сохранение настроек глобально или для каждого мира отдельно (приоритет имеют настройки мира, затем глобальные, затем системные по умолчанию)
• Индивидуальное управление правами администратора через команды /op и /deop, возможность использовать читы в одиночной игре без открытия доступа по LAN
• Система банов: /ban, /ban-ip, /banlist, /pardon, /pardon-ip, а также белый список игроков через /whitelist (включение/выключение через /whitelist on/off)
• Доступ к серверу извне локальной сети без проброса портов через туннели (в настоящее время поддерживается только ngrok)

Дополнительные функции

Запуск мира по LAN нажатием Enter, сохранение режима игры для игроков (например, игрок в творческом режиме останется в нём при повторном подключении, даже если мир настроен на выживание). Команда /publish расширена и позволяет изменять настройки во время игры (используйте порт -1 для его случайного выбора):

/publish [<port>] [<onlineMode>] [<pvpEnabled>] [<maxPlayers>] [<defaultGameMode>] [<tunnel>] [<motd>]
/publish [perworld|global|system] [<port>] [<onlineMode>] [<pvpEnabled>] [<maxPlayers>] [<defaultGameMode>] [<tunnel>] [<motd>]
/publish stop

Форматирование MOTD и переменные

В сообщении дня амперсанды (&) заменяются на символы параграфа (§) для применения кодов форматирования (например, &9Hello, &a&lworld! сделает Hello, синим, а world! — зелёным и жирным). Для вывода самого амперсанда используйте два подряд (&&).

Доступные переменные:

• ${username} — имя пользователя хоста (например, "DimiDimit")
• ${world} — название мира (например, "Новый мир")

Система сохранения настроек

Настройки сохраняются отдельно для каждого мира или глобально. При открытии экрана "Открыть для LAN" настройки загружаются автоматически в указанном порядке, также их можно загрузить вручную через соответствующие кнопки.

Команда /publish без указания типа сохранённых настроек использует тот же порядок приоритетов, если мир ещё не был открыт для LAN, или текущие значения, если был. При указании конкретного типа (perworld, global, system) используются только эти настройки или системные по умолчанию, если они не сохранены.

Глобальные настройки хранятся в .minecraft/config/customlan.toml, а настройки для каждого мира — в data/customlan.dat в соответствующей папке мира.

Управление операторами

Команды /op и /deop работают так же, как на выделенных серверах. Их можно применять к себе, хосту. Это добавит/удалит метку "Читы" у мира. Команды доступны без открытия доступа по LAN, заменяя стандартный метод с перезаходом в мир.

Операторы сохраняются для каждого мира в файле ops.json. Чтобы разрешить операторам назначать и снимать других операторов, а также банить игроков и управлять белым списком, измените их level в файле ops.json на 3 или выше (по умолчанию 2, уровень 4 позволяет использовать /publish). Хост всегда может назначать и снимать операторов, даже не будучи оператором.

Баны и белый список

Команды работают аналогично выделенным серверам, но хост не может быть забанен или добавлен в белый список. Включение белого списка не выкидывает игроков, не входящих в него.

Файлы банов и белого списка сохраняются для каждого мира: banned-players.json, banned-ips.json, whitelist.json. Состояние белого списка хранится в data/customlan.dat.

Требования

Требуется Fabric Loader и Cloth Config API, но Fabric API не обязателен.

Мод портирован на все версии Minecraft, поддерживаемые Fabric (кроме снапшотов). Портирование на Forge не планируется, но pull request приветствуются.