VillagerUnknown's Platform

VillagerUnknown's Platform - это не контентный мод в привычном смысле, а библиотека-ядро для всей линейки модов автора VillagerUnknown. Работает она примерно по тому же принципу, что Cloth Config или Fabric API: сама по себе почти ничего зрелищного в игру не приносит, но без неё остальные проекты серии вроде Villager Coin, Head Hunters и Inns & Innkeepers просто не запустятся. Так что если вы собрались скачать моды этого автора, платформу придётся поставить первой. Приятный бонус - разработчик всё же добавил сюда несколько полезных мелочей, которые пригодятся и на сервере, и в одиночной игре.

Мод сделан только под Fabric (Фабрик) для Minecraft Java с 1.21.1 по 1.21.11, актуальная сборка на сегодня - 1.3.3+1.21.11. Forge, NeoForge и Quilt не поддерживаются, тут уж как есть.

Зачем вообще нужна эта платформа

Когда автор выпускает сразу десяток модов, выносить общий код в отдельную библиотеку - нормальная и здоровая практика. Меньше дублирования, меньше конфликтов, проще обновления. Игроку от этого тоже плюс: конфиги модов серии перезагружаются одной командой, а системные вещи вроде кэша и уведомлений живут в одном месте, а не раскиданы по десяти jar-файлам.

По факту VillagerUnknown's Platform решает две задачи:

1. Обеспечивает корректную работу всех модов семейства VillagerUnknown - для них это обязательная зависимость.
2. Добавляет набор серверных QoL-функций: приветствия игроков, координаты смерти, напоминание про сон и служебные команды для администрирования.

Опциональные функции

Важный момент: всё, кроме первого пункта, по умолчанию выключено. После установки мод никак себя не проявляет, пока вы сами не откроете конфиг и не включите нужное. Мне такой подход нравится - платформа не лезет в игру без спроса.

• Постоянное кэширование профилей игроков (включено по умолчанию). Платформа хранит профили игроков локально, поэтому модам вроде Head Hunters не нужно каждый раз запрашивать данные заново. Меньше обращений - быстрее отклик и меньше шансов словить микрофризы, когда мод активно работает с головами и профилями игроков.
• Приветственные сообщения для новых и вернувшихся игроков. Тексты задаются отдельно для каждой категории в конфиге. Удобная штука для сервера: зашёл новый человек - его встречает сообщение с правилами или подсказкой. По сути бесплатная замена тяжёлым плагинам уровня Essentials с их MOTD.
• Уведомление о возможности сна. Когда условия выполнены и ночь можно проспать, в чат приходит подсказка. На сервере с активным онлайном это снимает вечный вопрос "кто не лёг?" и лишний флуд в чате.
• Координаты смерти в чате. После гибели игрок получает точные координаты места смерти. Если не пользуетесь мини-картами вроде Xaero's, которая сама ставит точку, эта функция реально спасает вещи - особенно в Незере, где путь обратно по памяти восстановить то ещё удовольствие.

Команды

В VillagerUnknown's Platform встроено четыре служебные команды. Пару раз выручали лично меня при настройке сервера:

Команда	Что делает
/villagerunknown-platform-help	Справка по платформе
/villagerunknown-platform-reload	Перезагружает моды семейства VillagerUnknown и их конфиги без рестарта сервера
/villagerunknown-platform-worldspawn	Показывает координаты мирового спавна и его радиус
/villagerunknown-platform-flushcaches	Полностью очищает кэши платформы

Совет из практики: поменяли что-то в конфиге - сразу вбивайте reload, не перезапуская сервер. А если после обновления моды серии начали вести себя странно (такое бывало на стыках версий), первым делом очистите кэши через flushcaches, часто этого уже достаточно.

Настройки

Все параметры крутятся прямо в игре через Mod Menu, для которого нужен Cloth Config API - он и так идёт в зависимостях. Вот что там есть:

• Enable Villager Comments - включает реплики жителей, фирменную фишку всей экосистемы автора
• Enable Commands - глобальный выключатель команд платформы
• Enable Command Feedback Sounds - звуковое подтверждение при выполнении команд
• Enable Welcome Message плюс отдельные поля текста для новых и вернувшихся игроков
• Enable Sleep Notice и настраиваемый текст уведомления
• Enable Death Coordinate Notice - сообщение с координатами смерти

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

Зависимости и установка

Зависимость	Зачем нужна
Fabric Loader	Единственный поддерживаемый загрузчик
Fabric API	Базовый API для модов на Фабрике
Mod Menu	Экран настроек модов прямо в игре
Cloth Config API	Работа конфигурации

Установка стандартная: закинуть jar в папку mods вместе с зависимостями. Мод работает и на клиенте, и на сервере. Хотите серверные функции (приветствия, уведомление о сне, координаты смерти) - ставьте на сервер, в одиночной игре всё то же самое заработает локально.

С какими модами используется

Главная причина качать VillagerUnknown's Platform - связка с остальными проектами автора. Все они требуют платформу как обязательную зависимость:

• Villager Coin
• Head Hunters
• Inns & Innkeepers
• Graveyards & Ghosts
• Immortal Villagers
• Custom Villager Names
• Healthy Habits
• Flatuence Update

Если собираете сборку модов из линейки VillagerUnknown, порядок такой: сначала Fabric Loader и Fabric API, потом Platform, потом всё остальное. Иначе лаунчер вежливо, но твёрдо откажется запускать игру и будет прав.

Важные нюансы

• Почти все функции из коробки выключены. Это осознанное решение: платформа играет роль тихого фундамента, а активные механики вы включаете сами под свои задачи.
• В обновлении 1.3.3 утилита HeadUtil научилась работать с головами медного голема. Актуально для тех, кто играет со связкой Head Hunters на свежих версиях Майнкрафт 1.21.x.
• Автор регулярно чинит конфликты со сторонними модами, о чём прямо говорят свежие патчи. Ловите краш в связке с чем-то ещё - первым делом обновите Platform до последней сборки, это 1.3.3+1.21.11.
• Отдельных модов под Forge или NeoForge у платформы нет и, судя по всему, не планируется. Если ваша сборка на Forge, линейка VillagerUnknown вам, увы, не подойдёт никак.

Скачать VillagerUnknown's Platform стоит даже тем, кого интересует всего один мод из серии: зависимость лёгкая, лишнего в игру не добавляет, зато открывает набор серверных удобств, за которые обычно приходится ставить несколько отдельных решений. Поставьте платформу на Minecraft 1.21.1 или новее, включите нужные функции в конфиге - и забудьте про неё, как и положено хорошей библиотеке.