- Документация
- https://modrinth.com/plugin/zhomes
zHomes — серверный плагин для создания и управления домашними точками игроков. Он сочетает сохранение мест и телепортацию с административным контролем, настройкой интерфейсов и интеграциями. Проект относится к категориям транспорта и служебных инструментов, распространяется по лицензии MIT и связан с автором yleoft. Клиентская установка не предусмотрена: обязательна серверная сторона.
Игрок может создавать, удалять, переименовывать и просматривать дома, а затем перемещаться к выбранной точке. Администрации доступны управление чужими записями, экспорт, импорт и конвертация. Набор действий регулируется правами и настройками.
В описании заявлены задержка перед телепортацией и проверка безопасности назначения. Это помогает согласовать перемещения с правилами выживания. Точный алгоритм проверок не раскрыт, поэтому считать его защитой от всех нестандартных ситуаций нельзя.
zHomes рассчитан на серверы выживания, социальные проекты и другие многопользовательские миры с личными точками возврата. Выбор уместен, когда требуется:
• разграничивать доступ к домам по группам;
• настраивать сообщения и меню;
• учитывать WorldGuard или GriefPrevention;
• применять стоимость команд через экономику;
• хранить записи во встроенной или внешней SQL-базе;
• переносить дома из поддерживаемого решения.
Для небольшого закрытого мира с одной точкой набор может быть избыточным. Плагин оправдан, если администрация готова сопровождать права, конфигурацию, интеграции и резервные копии.
Подтверждены версии Minecraft от 1.19 до 1.21.11 с промежуточными выпусками, а также 26.1, 26.1.1, 26.1.2 и 26.2. В карточке платформами названы Folia, Paper и Purpur. В исходном описании дополнительно упомянуты Spigot и PufferFish. Это не доказывает одинаковую проверку каждой комбинации, поэтому JAR нужно сопоставлять с конкретным ядром и выпуском игры.
Исходный текст указывает Java 17 или новее, но предлагает проверять точное требование JDK для релиза. Номер Minecraft не является единственным критерием: ядро и Java тоже должны быть совместимы.
Заявлены настраиваемые команды, сообщения, разрешения и меню, административное управление и конвертация. PlaceholderAPI поддерживается для подстановок, MiniPlaceholders — для MiniMessage. WorldGuard и GriefPrevention используются при региональных проверках. Интеграция Vault предназначена для экономики и стоимости команд; для этих функций Vault должен быть установлен.
MiniPlaceholders, WorldGuard, GriefPrevention и PlaceholderAPI отмечены как необязательные зависимости, NBT-API встроена. Без внешнего дополнения основная работа может сохраниться, но связанную функцию нельзя считать доступной. Совместимость разных версий интеграций не описана.
zHomes заявляет H2, SQLite, MariaDB и MySQL. Описание отмечает, что дома не хранятся в обычном локальном каталоге data/. Резервное копирование поэтому должно охватывать фактически выбранную базу, а не только JAR и настройки.
Материалы не подтверждают совместное использование одной базы несколькими серверами, правила блокировок и совместимость схем между всеми релизами. Такие сценарии требуют отдельной проверки.
Порядок установки:
• остановить сервер и сохранить текущие данные;
• выбрать JAR для нужных ядра и Java;
• поместить его в папку plugins;
• запустить сервер для создания настроек;
• изучить журнал и параметры;
• провести тест до допуска игроков.
Указаны zHomes-3.0.5.jar размером 870956 байт и zHomes-3.0.4.jar размером 868331 байт. Для них опубликованы SHA-512 и SHA-1. Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому целостность экземпляра не подтверждает работу в конкретной сборке.
До открытия сервера следует определить число домов для групп, задержку, исключённые миры или регионы и административные полномочия. Сообщения должны ясно объяснять отказ, ожидание и результат.
Практичный порядок:
• проверить базовые операции без интеграций;
• подключить систему подстановок;
• включить региональные проверки;
• отдельно протестировать Vault;
• выдавать минимум административных прав;
• перед импортом сохранить исходные данные.
Последовательное подключение упрощает поиск причины сбоя.
Официальный быстрый тест предлагает /sethome home1, затем /home home1; для администратора приведена /zhomes reload. Проверять лучше тестовым аккаунтом в безопасной области.
Минимальная приёмка должна подтвердить:
• создание точки и её появление в списке;
• перенос к ожидаемым координатам;
• отказ без нужного права;
• действие задержки;
• блокировку опасной или запрещённой позиции;
• соблюдение региональных правил;
• сохранение после полного перезапуска;
• отсутствие повторяющихся ошибок в журнале.
При внешней базе дополнительно проверяют сохранность записи после переподключения.
Материалы не указывают предельное число домов, производительность при определённом онлайне, точный алгоритм безопасной позиции, межмировые правила, поддержку прокси-сетей и детали миграции SQL-схем. Динамические испытания JAR не проводились.
Фраза о полной настраиваемости не означает совместимость с любой системой меню, экономики или прав. Чем больше интеграций используется, тем важнее отдельное тестовое окружение.
Перед обновлением сохраняют старый JAR, конфигурацию, сообщения, меню и базу. Для внешней СУБД нужна согласованная резервная копия.
Рекомендуемая последовательность:
• временно запретить изменение домов;
• штатно остановить сервер;
• создать копию файлов и базы;
• сверить новый JAR;
• заменить только файл плагина;
• проверить запуск, журнал и тестовый дом;
• после проверки обновить рабочий сервер.
Не стоит одновременно менять Java, ядро, базу и интеграции. Для отката восстанавливают прежний JAR, соответствующие настройки и базу до обновления. Возврата одного файла может быть недостаточно, если новая версия изменила данные. Удалять каталог или базу без копии не следует.
Если плагин не запускается, проверяют Java, ядро, JAR и первые сообщения ошибки. Если команды недоступны, изучают права и конфликт имён. Если перенос блокируется только в отдельных местах, на тестовой копии поочерёдно исключают влияние WorldGuard и GriefPrevention.
При проблемах с данными устанавливают:
• какая СУБД выбрана;
• доступна ли база;
• есть ли права чтения и записи;
• переживают ли данные перезапуск;
• не возникла ли ошибка после импорта;
• соответствует ли конфигурация версии JAR.
Менять следует по одному параметру, сохраняя полный журнал первого сбоя.
zHomes распространяется по MIT. При локализации и распространении следует сохранять название, авторство и лицензионные сведения, не приписывая автору редакционные выводы или результаты сторонней проверки.
Нет. Серверная сторона обязательна, а клиентская отмечена как неподдерживаемая. Отдельный клиентский мод не заявлен.
Нет, они перечислены как необязательные. Они нужны только для соответствующих интеграций.
В описании перечислены MariaDB и MySQL наряду с H2 и SQLite. Параметры подключения и миграции в предоставленных данных не раскрыты.
Плагин должен загрузиться без новых ошибок, существующие дома — открываться, а тестовая точка — создаваться, сохраняться после перезапуска и удаляться.
Нет. Хеш подтверждает совпадение с опубликованным экземпляром. Статическая проверка структуры не заменяет запуск, аудит кода и испытание в реальной конфигурации.
Назначение и принцип работы
Игрок может создавать, удалять, переименовывать и просматривать дома, а затем перемещаться к выбранной точке. Администрации доступны управление чужими записями, экспорт, импорт и конвертация. Набор действий регулируется правами и настройками.
В описании заявлены задержка перед телепортацией и проверка безопасности назначения. Это помогает согласовать перемещения с правилами выживания. Точный алгоритм проверок не раскрыт, поэтому считать его защитой от всех нестандартных ситуаций нельзя.
Скриншоты и внешний вид
Кому подходит плагин
zHomes рассчитан на серверы выживания, социальные проекты и другие многопользовательские миры с личными точками возврата. Выбор уместен, когда требуется:
• разграничивать доступ к домам по группам;
• настраивать сообщения и меню;
• учитывать WorldGuard или GriefPrevention;
• применять стоимость команд через экономику;
• хранить записи во встроенной или внешней SQL-базе;
• переносить дома из поддерживаемого решения.
Для небольшого закрытого мира с одной точкой набор может быть избыточным. Плагин оправдан, если администрация готова сопровождать права, конфигурацию, интеграции и резервные копии.
Совместимость и требования
Подтверждены версии Minecraft от 1.19 до 1.21.11 с промежуточными выпусками, а также 26.1, 26.1.1, 26.1.2 и 26.2. В карточке платформами названы Folia, Paper и Purpur. В исходном описании дополнительно упомянуты Spigot и PufferFish. Это не доказывает одинаковую проверку каждой комбинации, поэтому JAR нужно сопоставлять с конкретным ядром и выпуском игры.
Исходный текст указывает Java 17 или новее, но предлагает проверять точное требование JDK для релиза. Номер Minecraft не является единственным критерием: ядро и Java тоже должны быть совместимы.
Возможности и зависимости
Заявлены настраиваемые команды, сообщения, разрешения и меню, административное управление и конвертация. PlaceholderAPI поддерживается для подстановок, MiniPlaceholders — для MiniMessage. WorldGuard и GriefPrevention используются при региональных проверках. Интеграция Vault предназначена для экономики и стоимости команд; для этих функций Vault должен быть установлен.
MiniPlaceholders, WorldGuard, GriefPrevention и PlaceholderAPI отмечены как необязательные зависимости, NBT-API встроена. Без внешнего дополнения основная работа может сохраниться, но связанную функцию нельзя считать доступной. Совместимость разных версий интеграций не описана.
Хранение данных
zHomes заявляет H2, SQLite, MariaDB и MySQL. Описание отмечает, что дома не хранятся в обычном локальном каталоге data/. Резервное копирование поэтому должно охватывать фактически выбранную базу, а не только JAR и настройки.
Материалы не подтверждают совместное использование одной базы несколькими серверами, правила блокировок и совместимость схем между всеми релизами. Такие сценарии требуют отдельной проверки.
Установка
Порядок установки:
• остановить сервер и сохранить текущие данные;
• выбрать JAR для нужных ядра и Java;
• поместить его в папку plugins;
• запустить сервер для создания настроек;
• изучить журнал и параметры;
• провести тест до допуска игроков.
Указаны zHomes-3.0.5.jar размером 870956 байт и zHomes-3.0.4.jar размером 868331 байт. Для них опубликованы SHA-512 и SHA-1. Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому целостность экземпляра не подтверждает работу в конкретной сборке.
Первичная настройка
До открытия сервера следует определить число домов для групп, задержку, исключённые миры или регионы и административные полномочия. Сообщения должны ясно объяснять отказ, ожидание и результат.
Практичный порядок:
• проверить базовые операции без интеграций;
• подключить систему подстановок;
• включить региональные проверки;
• отдельно протестировать Vault;
• выдавать минимум административных прав;
• перед импортом сохранить исходные данные.
Последовательное подключение упрощает поиск причины сбоя.
Проверка результата
Официальный быстрый тест предлагает /sethome home1, затем /home home1; для администратора приведена /zhomes reload. Проверять лучше тестовым аккаунтом в безопасной области.
Минимальная приёмка должна подтвердить:
• создание точки и её появление в списке;
• перенос к ожидаемым координатам;
• отказ без нужного права;
• действие задержки;
• блокировку опасной или запрещённой позиции;
• соблюдение региональных правил;
• сохранение после полного перезапуска;
• отсутствие повторяющихся ошибок в журнале.
При внешней базе дополнительно проверяют сохранность записи после переподключения.
Ограничения
Материалы не указывают предельное число домов, производительность при определённом онлайне, точный алгоритм безопасной позиции, межмировые правила, поддержку прокси-сетей и детали миграции SQL-схем. Динамические испытания JAR не проводились.
Фраза о полной настраиваемости не означает совместимость с любой системой меню, экономики или прав. Чем больше интеграций используется, тем важнее отдельное тестовое окружение.
Безопасное обновление и откат
Перед обновлением сохраняют старый JAR, конфигурацию, сообщения, меню и базу. Для внешней СУБД нужна согласованная резервная копия.
Рекомендуемая последовательность:
• временно запретить изменение домов;
• штатно остановить сервер;
• создать копию файлов и базы;
• сверить новый JAR;
• заменить только файл плагина;
• проверить запуск, журнал и тестовый дом;
• после проверки обновить рабочий сервер.
Не стоит одновременно менять Java, ядро, базу и интеграции. Для отката восстанавливают прежний JAR, соответствующие настройки и базу до обновления. Возврата одного файла может быть недостаточно, если новая версия изменила данные. Удалять каталог или базу без копии не следует.
Диагностика
Если плагин не запускается, проверяют Java, ядро, JAR и первые сообщения ошибки. Если команды недоступны, изучают права и конфликт имён. Если перенос блокируется только в отдельных местах, на тестовой копии поочерёдно исключают влияние WorldGuard и GriefPrevention.
При проблемах с данными устанавливают:
• какая СУБД выбрана;
• доступна ли база;
• есть ли права чтения и записи;
• переживают ли данные перезапуск;
• не возникла ли ошибка после импорта;
• соответствует ли конфигурация версии JAR.
Менять следует по одному параметру, сохраняя полный журнал первого сбоя.
Лицензия
zHomes распространяется по MIT. При локализации и распространении следует сохранять название, авторство и лицензионные сведения, не приписывая автору редакционные выводы или результаты сторонней проверки.
FAQ
Нужна ли установка игрокам?
Нет. Серверная сторона обязательна, а клиентская отмечена как неподдерживаемая. Отдельный клиентский мод не заявлен.
Обязательны ли WorldGuard и PlaceholderAPI?
Нет, они перечислены как необязательные. Они нужны только для соответствующих интеграций.
Можно ли использовать внешнюю базу?
В описании перечислены MariaDB и MySQL наряду с H2 и SQLite. Параметры подключения и миграции в предоставленных данных не раскрыты.
Как проверить успешное обновление?
Плагин должен загрузиться без новых ошибок, существующие дома — открываться, а тестовая точка — создаваться, сохраняться после перезапуска и удаляться.
Гарантирует ли сверка хеша безопасность?
Нет. Хеш подтверждает совпадение с опубликованным экземпляром. Статическая проверка структуры не заменяет запуск, аудит кода и испытание в реальной конфигурации.
