HomePlugin

HomePlugin - это легковесный и быстрый плагин для серверов Minecraft на Paper/Spigot, который решает главную проблему любого сервера: удобное управление домами игроков и телепортацией. Если вы администрируете сервер и хотите дать игрокам возможность ставить несколько именных домов, быстро возвращаться на спавн или телепортироваться друг к другу - этот плагин станет отличным выбором.

Возможности

Основной функционал

• Именные дома - можно создать сколько угодно домов с уникальными названиями и дополнительной информацией.
• Глобальный спавн - управление точкой возрождения на сервере.
• Запросы на телепортацию (TPA) - игроки могут отправлять друг другу запросы с настраиваемым таймаутом.
• Случайная телепортация (RTP) - телепорт в случайную точку с контролем радиуса и кулдауна.
• Команда /back - возврат на предыдущую локацию.

Гибкое хранение данных

• YAML (по умолчанию) - простое файловое хранилище.
• MySQL - полноценная база данных для крупных серверов.
• Redis кеширование - опциональная синхронизация между несколькими экземплярами сервера.

Игровой опыт

• Интерактивный GUI - визуальный интерфейс управления домами.
• Мультиязычность - французский, английский, испанский, русский, украинский, немецкий, турецкий.
• Задержка телепортации - настраиваемая задержка с тайтлами, сообщениями и частицами.
• Лимиты через права - динамические ограничения на количество домов через пермишены.

Интеграции

• PlaceholderAPI - плейсхолдеры для отображения списка домов, их количества и стоимости.
• Vault Economy - опциональная экономика: можно установить цену за создание дома, телепортацию, TPA и RTP.

Администрирование

• Инструменты админа - управление домами других игроков, спавном и кешем.
• Ограничения по мирам - запрет на установку домов в определённых мирах.
• Проверка локаций - предотвращение небезопасных точек.
• Модульная архитектура - возможность подключать собственные модули.

Установка

1. Скачайте последнюю версию JAR-файла.
2. Поместите его в папку plugins/ вашего сервера.
3. Запустите сервер - сгенерируются файлы конфигурации.
4. Настройте plugins/HomePlugin/config.yml под себя.
5. Перезапустите сервер или сделайте reload.

Быстрые советы по настройке

• Из коробки работает с YAML-хранилищем.
• Для MySQL пропишите данные в config.yml до перезапуска.
• Для Redis включите Use-Redis: true и убедитесь, что Redis-сервер доступен.

Команды

Игроки

Команда	Описание	Право
/sethome [название] [инфо]	Создать или обновить дом	homeplugin.command.sethome
/home [название]	Телепортироваться домой (без названия - открыть GUI)	homeplugin.command.home
/delhome <название>	Удалить дом	homeplugin.command.delhome
/listhome	Список всех домов	homeplugin.command.listhome
/renamehome <старое> <новое>	Переименовать дом	homeplugin.command.home
/relocatehome <название>	Переместить дом в текущую позицию	homeplugin.command.home
/back	Вернуться на предыдущую локацию	homeplugin.back.use
/spawn	Телепорт на спавн	homeplugin.command.spawn
/tpa <игрок>	Запросить телепортацию к игроку	homeplugin.command.tpa
/tpaccept [игрок]	Принять запрос	homeplugin.command.tpa
/tpdeny [игрок]	Отклонить запрос	homeplugin.command.tpa
/rtp	Случайная телепортация	homeplugin.command.rtp

Администраторы

Команда	Описание	Право
/setspawn	Установить глобальный спавн	homeplugin.admin
/delspawn	Удалить глобальный спавн	homeplugin.admin
/homeadmin <игрок>	Управление домами другого игрока	homeplugin.admin
/cache view	Просмотр статистики кеша	homeplugin.admin
/cache clearall	Очистить весь кеш плагина	homeplugin.admin
/cache player <имя>	Очистить кеш конкретного игрока	homeplugin.admin
/lang set <код>	Установить язык	homeplugin.lang.update
/lang update	Обновить языковые файлы (добавить новые ключи)	homeplugin.lang.update
/plugins	Список загруженных модулей HomePlugin	homeplugin.admin

Права доступа

Базовые права

Право	Описание	По умолчанию
homeplugin.command.home	Использовать команды дома	true
homeplugin.command.sethome	Создавать дома	true
homeplugin.command.delhome	Удалять дома	true
homeplugin.command.listhome	Просматривать список домов	true
homeplugin.command.spawn	Использовать спавн	true
homeplugin.command.tpa	Использовать TPA систему	true
homeplugin.command.rtp	Использовать случайную телепортацию	true
homeplugin.back.use	Использовать /back	op
homeplugin.admin	Админские функции	op
homeplugin.lang.update	Управление языками	op

Динамические лимиты домов

Установите лимит через право вида homeplugin.limit.<число>:

• homeplugin.limit.5 - 5 домов
• homeplugin.limit.10 - 10 домов
• homeplugin.limit.unlimited - безлимит

Плагин сканирует права от 1 до 100 и применяет наибольшее значение.

Права на обход ограничений

Право	Описание
homeplugin.bypass.limit	Игнорировать лимит домов
homeplugin.bypass.validation	Обходить проверки локации
homeplugin.bypass.cooldown	Игнорировать кулдауны телепортации

Конфигурация

Файл конфигурации находится в plugins/HomePlugin/config.yml. Основные разделы:

Язык и локализация

Выберите язык из списка: FRENCH, ENGLISH, SPANISH, RUSSIAN, UKRAINIAN, GERMAN, TURKISH.

Хранилище данных

• YAML (по умолчанию) - не требует дополнительной настройки.
• MySQL - укажите HOST, PORT, USERNAME, PASSWORD, DATABASE.

Redis кеш (опционально)

Включите Use-Redis: true, укажите хост, порт, SSL и пароль при необходимости.

Настройки домов

• Default-Home-Limit - базовый лимит домов (переопределяется правами).
• Prevent-Unfair-Location - блокировка небезопасных точек.
• Disabled-Worlds - список миров, где нельзя ставить дома.

Задержка телепортации и эффекты

• Task-Duration - задержка перед телепортом (секунды).
• Use-Title, Use-Message - показывать уведомления.
• Particles-After-Teleport - частицы при прибытии.
• Skip-If-Op - мгновенная телепортация для операторов.

TPA система

• Tpa-Duration - время жизни запроса (секунды).

Случайная телепортация (RTP)

• Enabled, Cooldown-Seconds, Max-Radius - радиус от спавна.

Экономика (Vault)

• UseEconomy, цены за создание дома, телепорт, TPA и RTP.

Включение/отключение функций

Можно отключить TPA (Enable-TPA: false), спавн или систему домов целиком.

Интеграции

PlaceholderAPI

Плагин предоставляет множество плейсхолдеров:

• %homeplugin_homes% - список домов через запятую.
• %homeplugin_homes_numbers% - количество домов.
• %homeplugin_has_homes% - true/false есть ли дома.
• И другие для координат, стоимости и т.д.

Vault Economy

Настройте цены за действия через Vault. Поддерживается любой плагин экономики, совместимый с Vault.

Поддерживаемые языки

Встроенная поддержка языков с полностью настраиваемыми YAML-файлами:

• Французский (FRENCH)
• Английский (ENGLISH)
• Испанский (SPANISH)
• Русский (RUSSIAN)
• Украинский (UKRAINIAN)
• Немецкий (GERMAN)
• Турецкий (TURKISH)

Установить язык можно в config.yml или командой /lang set <LANGUAGE> в игре.

Developer API (для разработчиков)

HomePlugin предоставляет API для интеграции и расширения функционала. Есть JavaDocs и Wiki с примерами использования событий и менеджеров домов/спавна.

Для подключения через Maven или Gradle используйте репозиторий JitPack (подробности в оригинальной документации). Замените Tag на нужную версию.

Архитектура

Плагин построен на модульной архитектуре с упором на производительность:

• Абстракция хранилища - единый интерфейс для YAML и MySQL.
• Опциональный Redis слой для синхронизации между инстансами.
• Система событий для всех действий плагина.
• Асинхронные операции с базой данных.
• Гибкая система прав для ограничений.

Совместимость

• Minecraft: 1.14+ (api-version: 1.14)
• Сервер: Paper, Spigot и их производные
• Java: 8+
• Мягкие зависимости: PlaceholderAPI, Vault (необязательны)

Планы развития (Roadmap)

• ✅ Завершено: экономика за дом, редактирование домов офлайн, /back, кликабельные сообщения в чате.
• 📝 В планах: публичные дома, варпы, обновление интерфейса/стиля, интеграция с BlueMap и Dynmap.

Лицензия

HomePlugin распространяется под лицензией Apache License 2.0.