Home Point - мод на точки дома с /home для сервера

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

Если вы держали выживание-сервер, то знаете боль: плагиновые решения типа EssentialsX тянут за собой половину Bukkit-экосистемы, а ванильные датапаки на /trigger выглядят убого. Home Point решает это на стороне Fabric/Forge/NeoForge/Quilt - один jar в папку mods, и у вас полноценная система домов с лимитами, кулдаунами, анти-PvP защитой и шарингом координат в чат. Скачать Home Point стоит в первую очередь владельцам серверов на выживание, приваток и кооперативных миров.

Что умеет мод

• Шаринг базы в чат (/home share) - построил крутую базу? Кинь её в общий чат, и другие игроки увидят зелёную кнопку [Add Home], по клику координаты сохранятся в их личный список. С версии 1.5.6 поддерживаются селекторы @a, @p, @r - можно разослать точку сразу нескольким игрокам.
• Умный автокомплит - начинаете печатать /home tp , жмёте TAB, и мод сам подставит имена домов, аккуратно завернув их в кавычки. Пробелы и кириллица в названиях не ломают ничего.
• Combat Tagging (анти-PvP) - получил или нанёс урон? Команда /home блокируется на время боя. Никаких телепортов из драки в последний момент.
• Контроль измерений - хотите разрешить дома только в обычном мире? Белые и чёрные списки измерений настраиваются в конфиге за минуту.
• Полная кастомизация - задержка перед телепортом, частицы, звуки, лимиты по рангам, тексты кнопок и сообщений - всё выносится в конфиг.

Производительность: важный нюанс

Мод писался с оглядкой на крупные сервера, и это видно по архитектуре:

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

По факту это одна из тех вещей, которыми грешат дешёвые плагины на дома: каждый сейв кладёт сервер на пару тиков. Тут такого нет.

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

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

Базовая навигация

Команда	Описание
/home	Открывает интерактивное меню в чате с кнопками [TP], [Ren], [Del], [Share]
/home list <страница>	Показывает конкретную страницу списка домов
/home <название>	Мгновенный телепорт к указанному дому
/home set <название>	Создаёт дом в текущей позиции
/home del <название>	Удаляет дом
/home rename <старое> <новое>	Переименовывает дом

Шаринг координат

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

Команда	Описание
/home share <название>	Отправляет дом в общий чат с кнопкой [Add Home]
/home share <название> <цель>	Отправляет дом конкретным игрокам. Поддерживает @a (все), @p (ближайший), @r (случайный)
/home share <название> <цель> true	Шаринг цели с кнопкой [Add Home]
/home share <название> <цель> false	Шаринг цели без кнопки, только координаты
/home share_coords <название>	Отправляет дом в общий чат простым текстом с координатами
/home share_coords <название> <цель>	Отправляет координаты текстом конкретным игрокам

Пример: /home share "Моя База" @a false - разошлёт координаты базы всем игрокам онлайн без всяких кнопок.

Лимиты и права

В конфиге задаются квоты вида homes_limit_vip и homes_limit_admin. Мод сам определяет их по стандартным уровням прав или OP-статусу. Если homes_unlimited_for_operators выставлен в true, операторы обходят все лимиты нативно, без сторонних плагинов. С LuckPerms связка тоже работает - VIP-группе выдаёте расширенный лимит, и всё.

Настройка сервера (v1.5.6+)

Где лежит конфиг: config/home_mod.json

Файл детальный, но читается легко. При обновлении мода новые настройки дописываются аккуратно, не ломая существующий конфиг. Ниже разбор каждого параметра.

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

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

2. Анти-PvP защита (pvp_block_*)

• pvp_block_teleport_in_combat [true/false, по умолчанию: true] - вход в бой (получение или нанесение урона) мгновенно блокирует /home, никакого комбат-логгинга.
• pvp_combat_duration_seconds [число, по умолчанию: 15] - сколько секунд игрок считается "в бою" после последнего удара.

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

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

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

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

5. Интерфейс в чате (chat_* и button_*)

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

6. Подсказки и сообщения (hover_* и msg_*)

Переводится или меняется буквально каждая подсказка и ошибка:

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

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

• effect_spawn_particles [true/false, по умолчанию: true] - частицы вокруг игрока во время телепорта.
• effect_teleport_end_particle [строка, по умолчанию: "minecraft:dragon_breath"] - частица в точке прибытия.
• effect_teleport_particle_count [число, по умолчанию: 30] - плотность облака частиц.
• effect_teleport_particle_radius [число, по умолчанию: 1.5] - радиус разлёта частиц.
• sound_enabled [true/false, по умолчанию: true] - включает все звуки телепортации.
• sound_teleport_start [строка, по умолчанию: "entity.enderman.teleport"] - звук во время разогрева.
• sound_teleport_success [строка, по умолчанию: "block.portal.travel"] - звук по прибытии.
• sound_teleport_cancel [строка, по умолчанию: "block.note_block.bass"] - звук при отмене.
• sound_teleport_start_volume / _success_volume / _cancel_volume [число, по умолчанию: 1.0 / 0.8 / 1.0] - отдельная громкость для каждого звука.

8. Бэкапы и движок (system_*)

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

Важно знать

Игрокам нужно качать мод? Нет. Home Point глубоко встраивается в серверное ядро. Игроки заходят с чистого ванильного клиента и получают все кликабельные фишки из коробки.

Потеряю ли я дома игроков при обновлении с 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 сгенерируется автоматически, дальше правите под себя.

Кстати, если держите сервер на хостинге, Home Point без проблем заводится на BungeeHost - установка в один клик, и ваши игроки сразу получают рабочую систему домов. Для кооператива с друзьями это вообще идеальный сценарий: поднял сервер, закинул мод, и у каждого свой набор точек.

Про старые версии (1.12.2, 1.8.9)

Если ваш сервер живёт на 1.12.2 или 1.8.9, мод ограничен версией 1.0.0. Старые релизы работают чисто на командах, без кликабельного чат-интерфейса и JSON-конфигов. Учитывайте это при выборе.

Заметка о версиях

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

Стоит ли ставить

Если у вас выживание-сервер на Fabric или NeoForge и нужна нормальная система домов без Bukkit-наследия - это must-have. Home Point закрывает всё: лимиты по рангам, анти-PvP, шаринг баз в чат, кастомные тексты и звуки, при этом не жрёт TPS и не требует ничего от клиентов. Скачать мод Home Point можно под все актуальные загрузчики, и на фоне плагинных аналогов он выглядит заметно аккуратнее. Для одиночной игры смысла меньше, но в связке с сервером для друзей - одна из тех QoL-вещей, без которой потом уже не хочется играть.