BlossomHomes

Мод BlossomHomes для Minecraft — управление домами игроков на сервере

BlossomHomes — это серверный мод для Minecraft (Fabric, Quilt), входящий в серию Blossom-серии. Он предоставляет игрокам и администраторам сервера удобную систему команд для управления персональными точками сохранения («домами»). Мод позволяет создавать, удалять и перемещаться между точками, настраивает лимиты на количество сохранений и поддерживает интеграцию с системами прав, такими как LuckPerms или fabric-permissions-api.

Основная функциональность

BlossomHomes — это утилитарный мод для Minecraft, входящий в серию Blossom, который реализует систему команд для управления персональными точками сохранения («домами»). Мод предоставляет игрокам возможность создавать, удалять и телепортироваться к сохранённым локациям с помощью команды /home. Система автоматически отслеживает количество созданных точек и сравнивает его с лимитом, установленным в конфигурации (startHomes). Если лимит превышен, создание новой точки блокируется, и игроку возвращается сообщение о достижении максимума. При отсутствии явно заданного имени точки система использует значение по умолчанию (defaultHome), что упрощает использование для новых игроков.

Команды и управление правами

Мод предоставляет гибкий набор команд для администраторов и игроков. Основные действия, такие как создание (/sethome) и удаление (/delhome) точек, доступны по умолчанию. Однако для продвинутых функций требуются специальные права доступа. Например, команда /sethome с аргументами позиции (x y z), направления взгляда (yaw, pitch) или измерения (dimension) требует прав blossom.home.set.pos, blossom.home.set.dim или blossom.homes.set.in-blacklist. В рамках команды /homes реализованы алиасы (list, set, add, delete, remove) и административные подкоманды: set-max для изменения лимита точек у всех игроков (требует OP level 2) и load-legacy для импорта сохранений из старых модов серии FabricHomes (требует OP level 4). Последняя команда позволяет обновлять данные игроков, даже если они не находятся онлайн.

Настройка конфигурации

Поведение мода регулируется файлом конфигурации config/BlossomMods/BlossomHomes.json, который генерируется автоматически после первого запуска сервера с модулем. В разделе teleportation настраиваются параметры телепортации: standStill определяет время в секундах, которое игрок должен стоять неподвижно, прежде чем его телепортируют к точке, а cooldown задаёт задержку в секундах между телепортациями. Параметр dimensionBlacklist позволяет запретить создание точек в определённых измерениях (например, minecraft:the_end), а опция useBlacklistAsWhitelist инвертирует логику, превращая список в разрешённые измерения. Если у игрока нет заданной точки, параметр fallbackToPlayerSpawnPoint определяет, использовать ли точку спавна как запасную.

Локализация и сообщения

Интерфейс мода использует систему ключей локализации, что позволяет легко переводить сообщения. Доступны переводы на китайский (упрощённый и традиционный), добавленные сообществом. В текущей версии русский язык не поддерживается. Сообщения описывают состояние системы: blossom.homes.list.empty сообщает о достижении лимита сохранений, blossom.homes.add.failed.name — об ошибке создания точки с таким же именем, а blossom.homes.load-legacy.done — об успешной загрузке старых данных. Полный список ключей и их аргументов можно найти в файле ресурсов src/main/resources/data/blossom/lang/en_us.json.

Связанные материалы

• Mod Menu — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод

Автор: CodedSakura · Лицензия: MIT