Home Point

🏠 Home Point

Лёгкая интерактивная система телепортации для вашего Minecraft-сервера.

🛡️ О моде

Home Point — это серверный мод, который полностью переделывает стандартную команду /home. Вместо громоздких GUI в инвентаре или необходимости вручную вводить длинные команды всё управляется через аккуратный кликабельный интерфейс прямо в чате. А поскольку мод серверный, игрокам ничего не нужно скачивать!

✨ Возможности

• 📡 Поделиться базой (/home share): Гордитесь своей постройкой? Поделитесь домом в общем чате. Другие игроки увидят зелёную кнопку [Add Home], нажав на которую смогут мгновенно сохранить ваши координаты в свой список. Новое в 1.5.6: теперь поддерживаются селекторы @a, @p, @r для отправки сразу нескольким игрокам!
• ⌨️ Умное автодополнение: Начните вводить /home tp , нажмите TAB — и мод сам подставит и безопасно закавычит названия ваших домов, даже если в них есть пробелы или кириллица!
• ⚔️ Боевой тег (анти-PvP): Больше никаких побегов из боёв. Если игрок наносит или получает урон, он входит в режим боя, и телепортация блокируется.
• 🌍 Контроль измерений: Хотите, чтобы дома работали только в Overworld? Легко ограничьте телепортацию через белые или чёрные списки в конфиге.
• 🎛️ 100% настраиваемый: Настройте практически любую мелочь. Хотите задержку в 5 секунд? Свои частицы? Строгий лимит домов? Всё это есть.

🚀 Производительность

Home Point создан с расчётом на огромные многопользовательские серверы:

• Нулевое влияние на TPS: Таймеры ожидания телепортации не используют стандартные серверные циклы событий onTick. Всё построено на высокоэффективных планировщиках задач.
• Асинхронное сохранение: Когда мод сохраняет координаты игрока, процесс уходит в фоновый поток (system_async_saving). Это никогда не заморозит и не залагивает основной поток сервера!

💬 Команды и аргументы

Всё работает через команду /home, которая полностью поддерживает TAB-автодополнение. Если в названии дома есть пробелы — не беда, мод сам добавит кавычки вокруг имени!

🔹 Основная навигация

🔹 Обмен

При отправке домов можно указать, кому их отправить — по имени игрока или через селекторы (@a, @p, @r), а также выбрать, добавлять ли кликабельную кнопку [Add Home].

Пример: /home share "My Base" @a false — отправляет координаты "My Base" всем игрокам онлайн, без каких-либо кликабельных кнопок.

🔹 Ранги прав и лимиты

Конфиг позволяет задавать конкретные квоты вроде homes_limit_vip и homes_limit_admin. Мод автоматически определяет эти квоты на основе стандартных уровней прав или статуса оператора. Можно мгновенно обойти все лимиты, выдав статус OP, если homes_unlimited_for_operators установлен в true.

⚙️ Конфигурация сервера (v1.5.6+)

Где её искать: config/home_mod.json

Файл конфига очень подробный, но при этом простой для чтения. Если ты когда-нибудь обновишь мод, новые настройки добавятся безопасно, не сломав твой существующий конфиг! Вот полная разборка каждой настройки, которую можно подкрутить:

📐 1. Лимиты игроков (homes_limit_*)

• homes_limit_default [Int, по умолчанию: 3]: Максимальное число домов, которое может задать обычный игрок.
• homes_limit_vip [Int, по умолчанию: 10]: Расширенный лимит, обычно выдаваемый VIP-игрокам (например, через LuckPerms).
• homes_limit_admin [Int, по умолчанию: 50]: Огромный лимит для администраторов или модераторов.
• homes_unlimited_for_operators [Boolean, по умолчанию: true]: Если true, игроки со статусом OP полностью обходят все лимиты. Установи false, если хочешь, чтобы админы придерживались homes_limit_admin.

🚷 2. Защита от PvP (pvp_block_*)

• pvp_block_teleport_in_combat [Boolean, по умолчанию: true]: Если true, вступление в бой (получение или нанесение урона) мгновенно блокирует команду /home, предотвращая combat-logging.
• pvp_combat_duration_seconds [Int, по умолчанию: 15]: Сколько игрок остаётся "в бою" после последнего удара, прежде чем снова сможет телепортироваться.

⏱ 3. Механика телепортации и кулдауны (teleport_*)

• teleport_wait_seconds [Int, по умолчанию: 3]: Задержка-разогрев с требованием стоять на месте перед телепортацией. Установи 0 для мгновенной телепортации.
• teleport_cooldown_seconds [Int, по умолчанию: 10]: Ограничивает, как часто игроки могут спамить командой /home.
• teleport_cancel_if_player_moves [Boolean, по умолчанию: true]: Если true, разогрев отменяется, если игрок идёт.
• teleport_cancel_if_hurt [Boolean, по умолчанию: true]: Если true, разогрев отменяется, если игрок получает любой урон во время ожидания.
• teleport_cancel_if_attacking [Boolean, по умолчанию: false]: Если true, разогрев отменяется, если игрок атакует сущность во время ожидания.
• teleport_auto_dismount_vehicles [Boolean, по умолчанию: true]: Автоматически снимает игрока с лошадей/вагонеток перед телепортацией, чтобы предотвратить серьёзные баги рассинхронизации.
• teleport_allow_between_dimensions [Boolean, по умолчанию: true]: Если false, игроки могут телепортироваться только к домам в том измерении, где находятся сейчас.
• teleport_check_destination_safety [Boolean, по умолчанию: true]: Проверяет наличие твёрдых блоков в точке назначения, чтобы игроки не задохнулись внутри блоков по прибытии.
• teleport_keep_velocity [Boolean, по умолчанию: false]: Если true, игроки, падающие на предельной скорости, продолжат быстро падать и после телепортации (крайне опасно).
• teleport_center_camera [Boolean, по умолчанию: false]: Если true, принудительно направляет взгляд игрока прямо вперёд (pitch 0) по прибытии.
• teleport_max_y_limit [Int, по умолчанию: 320]: Запрещает ставить дома выше карты (например, исключения для крыши Nether).
• teleport_min_y_limit [Int, по умолчанию: -64]: Запрещает ставить дома под бедроком.

🌌 4. Миры и измерения (world_*)

• world_use_whitelist [Boolean, по умолчанию: false]: Если true, игроки могут использовать /home ТОЛЬКО в измерениях из белого списка.
• world_whitelist [Список строк, по умолчанию: ["minecraft:overworld", "minecraft:the_nether", "minecraft:the_end"]]: Допустимые ID измерений.
• world_use_blacklist [Boolean, по умолчанию: false]: Если true, игрокам запрещено использовать дома в любом измерении из чёрного списка.
• world_blacklist [Список строк, по умолчанию: []]: ID измерений, где дома запрещены.

🎨 5. Функции интерфейса чата (chat_* и button_*)

• chat_enable_gui [Boolean, по умолчанию: true]: Включает интерактивные кликабельные кнопки в чате. Если false, мод работает только через текстовые команды.
• chat_homes_per_page [Int, по умолчанию: 5]: Сколько домов показывается на одной странице, прежде чем перейти к /home list 2.
• chat_prefix [String, по умолчанию: "§6[Home] §r"]: Префикс, который игроки видят перед любым сообщением мода.
• chat_color_primary / secondary / error / accent [String]: Стандартные цветовые коды Minecraft (§a, §e, §c, §b), используемые по всему интерфейсу.
• chat_share_button_enabled [Boolean, по умолчанию: true]: Включает кнопку [Share] рядом с каждым домом.
• chat_share_button_default [Boolean, по умолчанию: true]: При отправке дома через GUI определяет, добавляется ли к сообщению интерактивная кнопка [Add Home], чтобы другие игроки могли по ней кликнуть.
• button_text_tp / _rename / _delete / _add_home [String]: Полная настройка интерактивных текстов в скобках (например, можно перевести [TP] в [Телепорт]).

🏷 6. Всплывающие подсказки и сообщения (hover_* и msg_*)

Переведите или настройте каждую подсказку и сообщение об ошибке!

• hover_tp / _rename / _share / _copy_coords [String]: Всплывающие подсказки при наведении на кнопки в чате.
• msg_home_not_found / msg_limit_reached / msg_tp_in_combat [String]: Стандартные сообщения об ошибках.
• msg_cooldown_active [String]: Содержит плейсхолдер %time% для динамического показа оставшихся секунд.
• msg_tp_cancelled_moved / _damage [String]: Отправляется, если подготовка к телепортации прервана.

🎇 7. Визуал и звук (effect_* и sound_*)

• effect_spawn_particles [Boolean, по умолчанию: true]: Создаёт визуальные частицы на игроке во время телепортации.
• effect_teleport_end_particle [String, по умолчанию: "minecraft:dragon_breath"]: Конкретная частица, создаваемая при прибытии.
• effect_teleport_particle_count [Int, по умолчанию: 30]: Плотность облака частиц.
• effect_teleport_particle_radius [Double, по умолчанию: 1.5]: Радиус разброса частиц.
• sound_enabled [Boolean, по умолчанию: true]: Включает все звуковые сигналы, связанные с телепортацией.
• sound_teleport_start [String, по умолчанию: "entity.enderman.teleport"]: Звук, играющий во время подготовки.
• sound_teleport_success [String, по умолчанию: "block.portal.travel"]: Звук, играющий при прибытии на место назначения.
• sound_teleport_cancel [String, по умолчанию: "block.note_block.bass"]: Звук, играющий при прерывании подготовки.
• sound_teleport_start_volume / _success_volume / _cancel_volume [Float, по умолчанию: 1.0f / 0.8f / 1.0f]: Индивидуальная настройка громкости.

🔧 8. Резервные копии файлов и движок (system_*)

• system_save_interval_minutes [Int, по умолчанию: 15]: Как часто сервер автоматически сохраняет базу данных домов игроков на диск, чтобы предотвратить откаты.
• system_async_saving [Boolean, по умолчанию: true]: КРИТИЧНО: Принудительно сохраняет записи базы данных в фоновом потоке, не нагружая серверный поток. Гарантирует абсолютно нулевое падение TPS на огромных сетях. Оставьте true, если только не диагностируете конфликты ввода-вывода.
• system_debug_mode [Boolean, по умолчанию: false]: Включите, чтобы выводить в консоль сервера подробные технические диагностические логи (только для разработчиков/отладки).

❓ Часто задаваемые вопросы (FAQ)

В: Нужно ли моим игрокам скачивать этот мод? О: Нет! Этот мод глубоко встроен в ядро сервера. Игроки могут заходить с полностью ванильным клиентом и пользоваться всеми кликабельными функциями сразу!

В: Потеряю ли я старые дома игроков при обновлении с 1.4.0 до 1.5.6? О: Нет. Наши собственные менеджеры конфигурации Gson идеально обрабатывают миграции. Ваш файл homes.json полностью в безопасности!

В: Конфликтует ли это с EssentialsX или другими модами на телепортацию? О: Нет. Модифицированные загрузчики корректно перехватывают выполнение команд. Если возникнет небольшой конфликт идентичности команды /home с другим модом, стандартные нативные системы приоритета решат это динамически.

🛠️ Установка

ВАЖНО: Этот мод ставится ТОЛЬКО в папку mods вашего сервера. Игрокам не нужно его скачивать, чтобы зайти!

1. Скачайте .jar файл для вашего загрузчика (Fabric, Forge, NeoForge или Quilt).
2. Закиньте его в папку mods вашего сервера.
3. Запустите сервер один раз. Файл config/home_mod.json создастся автоматически, чтобы вы могли его отредактировать.

⚠️ Поговорим о старых версиях (1.12.2, 1.8.9)

Если вы держите сервер на 1.12.2 или 1.8.9, мод ограничен версией 1.0.0. Старые версии чисто командные — в них нет кликабельного Chat UI или JSON-файлов конфигурации.

📌 Примечание о версии

Последняя версия: 1.5.6 Это описание и перечисленные настройки конфига основаны на новейшей версии мода. Если вы скачиваете старый релиз (например, v1.3.0 или v1.4.0 для более ранних сборок Minecraft), некоторых новейших параметров конфигурации или функций чата в вашем файле может не быть. Всегда старайтесь использовать последнюю доступную версию для вашего конкретного загрузчика Minecraft!