Minecraft plugin SetHome

🔌 Про плагін SetHome

SetHome — це плагін для Minecraft серверів, який дозволяє гравцям створювати (set), телепортуватись (home), видаляти (delete) і переглядати (list) свої домашні точки (homes). SetHome розроблений як легкий, конфігурований і продуктивний plugin для Paper/Spigot серверів.

🎯 Призначення

SetHome вирішує просту, але поширену задачу: надання гравцям можливості зберігати позиції як "home" та повертатись до них швидко. SetHome підходить для Survival і RPG серверів, де потрібен мінімалістичний набір команд для управління домашніми точками.

⚙ Основні можливості

• SetHome дозволяє встановлювати, телепортуватись до, видаляти та переглядати імена home.
• Підтримка зберігання: YAML (файли за гравцем), SQLite та MySQL.
• Конфігурований максимальний ліміт homes на гравця.
• Підтримка cooldown та warmup (завчасне очікування), скасування при русі.
• Опціональне відродження на home після смерті.
• Налаштовувані повідомлення через config.yml та локалізація мовних файлів.
• Інтеграція з bStats для анонімної статистики.
• API для інших плагінів та імпортери з інших плагінів (наприклад, Essentials-style YAML).

🧩 Кому підійде

• Адміністраторам Survival серверів, які хочуть прості home команди.
• Власникам серверів Paper/Spigot, що шукають легкий плагін без зайвих залежностей.
• Серверним модераторам і технічним модерам, які потребують конфігурованого зберігання (файли/SQLite/MySQL).

🏗 Приклади використання

• Гравець встановлює /sethome base і повертається /home base під час подорожі.
• Сервер зберігає homes у SQLite, щоб уникнути файлової фрагментації на великих інсталяціях.
• Адміністратор імпортує дані із резервної Essentials YAML експорту через імпортер плагіна.

⌨️ Команди

Примітка: Перелік команд підтверджено у README репозиторію та сторінці ресурсу. Базові команди не потребують permission-вузлів за замовчуванням.

🔐 Права доступу (permissions)

⚙ Інсталяція

📥 Встановлення

• Переконайтесь, що сервер використовує Java 17 або новіше.
• Завантажте JAR плагіна з офіційного джерела.
• Помістіть JAR у папку plugins/ вашого сервера (Paper/Spigot/Purpur підтримуються).
• Повністю перезапустіть сервер (не рекомендується використовувати /reload).
• Після першого запуску плагін створить plugins/SetHome/ з config.yml та папкою homes/ або базою даних залежно від конфігурації.

📦 Залежності

• Ніяких зовнішніх залежностей (Vault, PlaceholderAPI тощо) для базової роботи не вимагається.
• Для збору статистики використовується bStats (плагін включено; можна відключити у plugins/bStats/config.yml).

🧾 Конфігурація

• Плагін генерує config.yml при першому запуску.
• Наявні опції: storage-type (yaml/sqlite/mysql), max-homes-per-player, extra.language, cooldown/warmup тощо.
• Підтримка MySQL доступна через блок mysql в config.yml (якщо вибрано storage-type: mysql).

🧠 Додаткова інформація

Відомі конфлікти

• Команди /sethome та /home часто реалізуються декількома плагінами (наприклад Essentials/EssentialsX). Якщо у вас є інший плагін, що надає ті самі команди, перевірте пріоритет команд або переназначте/відключіть дублювання.

Обмеження

• Плагін вимагає Java 17.
• При використанні зовнішньої бази (MySQL) адміністрування збереження та бекапів лишається за адміністратором.

FAQ

Q: Чи можна дозволити гравцям кілька homes?
A: Так — SetHome підтримує конфігурований max-homes-per-player у config.yml.

Q: Чи є підтримка Folia/Velocity/BungeeCord?
A: Офіційна підтримка multi-proxy не згадується у README; для proxy-середовищ тестуйте на staging перед production.

Q: Чи плагін збирає статистику?
A: Так — анонімні метрики відправляються через bStats; можна відключити на сервері.

Q: Чи є інтеграція з Discord?
A: Прямої інтеграції Discord у README не вказано; підтримка через зовнішні мости/боти можлива окремими рішеннями.

Підтримка та issue tracker

• Офіційний репозиторій і tracker (Issues) розміщені на GitHub; для багрепортів і запитів використовуйте сторінку Issues у репозиторії.

Коли потрібен простий, перевірений і конфігурований набір команд для роботи з homes на Paper/Spigot, SetHome — практичне рішення: легке, без зайвих залежностей і з підтримкою різних backend для збереження.