LandClaimPlugin

Плагин LandClaimPlugin для Minecraft 1.21.11

LandClaimPlugin — это мощный чанковый плагин для защиты территорий на серверах Minecraft, поддерживающий платформы Paper, Purpur, Spigot и Folia. Он позволяет создавать профили территорий, управлять членами и союзниками, настраивать сложные системы прав доступа, блокировать взлом и устанавливать точки телепортации. Плагин интегрируется с популярными инструментами, такими как WebMap и Geyser, обеспечивая бесшовный опыт для игроков.

Основная функциональность

Плагин предоставляет продвинутую защиту территорий на основе чанков размером 16×16 блоков. Пользователи могут создавать профили территорий, защищать свои постройки и управлять доступом для других игроков с помощью детализированных ролей. Система поддерживает создание альянсов между территориями, установку точек телепортации (warps) и полную кастомизацию всех аспектов управления землей. Также доступна функция автоматического захвата чанков при ходьбе и интерактивные селекторы для управления доверенными игроками через их головы.

Система прав доступа

LandClaimPlugin использует четырехуровневую цепочку приоритетов: Владелец > Роль > Доверенный > Посетитель, где первое совпадение определяет разрешение. Администраторы могут создавать и настраивать кастомные роли (например, Member, CoOwner) с детализированными флагами разрешений. Для отдельных игроков доступна система доверенных лиц (Trusted Players), предоставляющая индивидуальные оверрайды прав. Настройки для посетителей (Visitor Settings) позволяют контролировать действия нечленов внутри территорий. Плагин поддерживает более 25 флагов разрешений для дверей, ловушек, контейнеров, рабочих станций, животных, транспортных средств, редстоуна и других элементов.

Социальные системы

Плагин включает систему членства для приглашения игроков в территорию, назначения им ролей и управления доступом. Система альянсов позволяет создавать взаимные союзы между территориями с настраиваемыми межтерриториными разрешениями. Система доверия предоставляет индивидуальные оверрайды прав для отдельных игроков. Система блокировок (Ban System) жестко запрещает игрокам вход или взаимодействие с территорией; заблокированные игроки физически отталкиваются на границах чанков и телепортируются за пределы территории, если они онлайн в момент блокировки. Блокировки сохраняются после перезагрузки сервера. Система точек телепортации (Warp System) позволяет создавать названные warps с кастомными иконками и лимитами на игрока. Публичные warps можно опубликовать в серверном списке, и другие игроки могут просматривать и телепортироваться через команду /claim publicwarps.

Защита и безопасность

Плагин обеспечивает защиту блоков от несанкционированного разрушения и установки, защиту сущностей (животных, подставок, рам с предметами), защиту от взрывов (TNT, криперов и других), защиту взаимодействия с дверями, контейнерами и рабочими станциями, защиту предметов от несанкционированного подбора и броска, защиту от движения поршней через границы территории, отключение PvP внутри территорий, защиту транспортных средств от несанкционированного использования и уничтожения, блокировку конкретных команд внутри чужих территорий и опциональную защиту дикой местности через флаг wildernessProtection.enabled, который меняет поведение по умолчанию: игроки могут строить/разрушать только внутри территорий, а не в незащищенных чанках. Эта функция разработана для серверов в стиле кланов или городов.

Кастомизация и визуализация

Владелец может установить кастомное отображаемое имя (alias), заменяющее имя игрока Minecraft в элементах интерфейса, на миникарте и в заголовках. Доступна настройка кастомного цвета территории в формате HEX для отображения на картах и границах. Визуализация границ может переключаться между режимом отображения сущностей или частиц. При входе и выходе из территории игроки получают кастомные заголовки в формате MiniMessage. Имя территории можно переименовывать в любой момент. Все сообщения плагина настраиваются через Okaeri Configs. Также доступна функция claim unstuck для безопасного телепортирования застрявших игроков в ближайший безопасный блок дикой природы.

Интеграции и совместимость

Плагин обеспечивает бесшовную интеграцию с популярными плагинами серверов. Для плагинов веб-карт (BlueMap, Dynmap, Squaremap, Pl3xMap) территории отображаются как цветные полигоны с информацией о владельце и размере. Для плагинов комбат-таггеров (DeluxeCombat, PvPManager, EternalCombat) предотвращается злоупотребление командами защиты в активном бою. Плагин уважает регионы WorldGuard при попытке захвата земли, используя объемную проверку пересечения границ на 100% точность. Поддерживается Geyser для Bedrock Edition: игроки Bedrock получают адаптированный интерфейс через CustomForm и ModalForm, а визуализация автоматически переключается в режим частиц. Плагин использует асинхронную обработку команд с выделенными пулами потоков и модульную архитектуру для устранения задержек при загрузке GUI.

API и аддоны

Плагин предоставляет публичный API (LandClaimAPI) и шину событий (ClaimCreateEvent, ClaimDeleteEvent, PlayerEnterClaimEvent, PlayerLeaveClaimEvent), что позволяет создавать автономные аддоны. Официальный аддон LandClaimPlugin-Economy позволяет взимать плату за захват, warps и приглашения членов, с ежедневным налогом за чанк и автоматическим снятием территории. API предоставляет методы для получения информации о территориях, управления владением, добавления бонусных блоков и проверки состояния боя. Для аддонов, желающих реагировать на жизненный цикл территорий, доступны события из пакета org.ayosynk.landClaimPlugin.api.event.*.

Команды управления

Все команды используют базу /claim (аллиас /c). Основные команды включают захват чанка (/claim), захват радиуса чанков (/claim radius ), управление профилями (/claim profiles, /claim create, /claim rename, /claim color), автоматический захват (/claim auto), получение миникарты (/claim map), просмотр информации (/claim info), переключение визуализации (/claim visible, /claim toggle), отмену захвата (/unclaim, /unclaim radius, /unclaim all), управление PvP (/claim pvp [time]), управление членами (/claim member invite, /claim member kick, /claim member list), управление доверенными (/claim trust invite, /claim trust remove), управление альянсами (/claim ally invite, /claim ally accept), установку точек телепортации (/claim setwarp, /claim delwarp, /claim warp), и административные команды (/claim admin check, /claim admin unclaim, /claim admin edit). Также доступны меню для быстрого доступа к настройкам, членам, ролям, доверенным, посетителям, альянсам и warps.

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

Плагин использует следующую иерархию прав: landclaim.* (все права), landclaim.claim (основной захват, по умолчанию разрешено), landclaim.minimap (доступ к миникарте, по умолчанию разрешено), landclaim.auto (автозахват, по умолчанию разрешено), landclaim.admin (административные команды и обход защиты, по умолчанию для OP), landclaim.update.notify (уведомления об обновлениях, по умолчанию для OP), landclaim.limit. (оверрайд лимита чанков, например landclaim.limit.50), landclaim.list (просмотр территорий, по умолчанию разрешено), landclaim.warps.limit. (оверрайд лимита warps, например landclaim.warps.limit.10), landclaim.createrole. (оверрайд максимума кастомных ролей).

Внешние соединения и телеметрия

Плагин отправляет запросы на API Modrinth для проверки новых версий и на bStats для сбора анонимных метрик (версия Java, софт сервера, количество онлайн игроков). Оба сервиса можно отключить в конфигурации (updateChecker.enabled: false и enabled: false в bStats). Также возможна опциональная связь с Redis и удаленным MySQL для синхронизации между серверами или централизованного хранения данных. Все внешние соединения требуют явной настройки в конфиге и не передают идентифицирующие данные игроков или сервера.

Автор: AyoSynk · Лицензия: MIT