Плагин Защита SMP Protections [v1.0.6]

Что такое SMP Protections?
SMP Protections — это современный плагин для Minecraft, предназначенный для приватизации территорий, представляющий собой альтернативу ProtectionStones, построенную на базе SMP Regions.


Игроки получают специальные блоки защиты, размещают их в мире, после чего автоматически создаются защищённые регионы вокруг установленного блока. Владельцы могут управлять своей территорией через удобные команды и инвентарные меню: добавлять доверенных игроков, удалять доступ, настраивать флаги, запрещать пользователям вход на территорию, просматривать границы региона, телепортироваться к своим точкам дома и при необходимости снимать защиту.


В отличие от плагинов на базе WorldGuard, использующих систему защитных блоков, SMP Protections работает на ядре SMP Regions, которое отвечает за реальное применение и контроль регионов. Сам защитный блок выступает как пользовательский предмет для создания привата, а SMP Regions обеспечивает фактическую защиту и обработку правил региона.


Если вы запускаете выживательный SMP-сервер, сервер с PvP и системой территорий, облегчённый Factions-режим, Donut-style SMP или кастомную соревновательную выживалку, этот плагин предоставляет более чистую систему защиты с привычной логикой ProtectionStones.

Система привата в стиле ProtectionStones

• Приваты через размещение блоков — игроки размещают настроенные блоки защиты (protection stones), которые создают защищённые регионы.
• Приват через разрушение блока — владелец может разрушить блок защиты, чтобы удалить регион и вернуть предмет защиты (если это включено в настройках).
• Меню /sps get — игроки могут покупать или получать блоки защиты через удобное GUI-меню.
• Многоуровневые приваты — возможность настраивать разные типы блоков, цены, радиусы, названия, описание (lore) и права доступа.
• Стандартные размеры 32 / 64 / 96 / 128 — стартовые, стандартные, продвинутые и премиум-размеры приватов.
• Целостность предметов защиты — блоки, выданные плагином, имеют метки, чтобы обычные рудные блоки не могли использоваться как приваты при включённом ограниченном режиме.
• Безопасное владение через UUID — источником истины являются UUID игроков; имена используются только для отображения.

Работа на базе SMP Regions

SMP Protections — это не просто блок-листенер с набором отменённых событий. Он использует SMP Regions как систему управления регионами.

• Приваты на базе SMP Regions — размещённые блоки защиты создают реальные регионы SMP Regions.
• Слой принудительного контроля региона — правила для строительства, разрушения, доступа к сундукам, PvP, TNT, спавна мобов, входа и других действий управляются через региональные флаги.
• Метаданные защиты — SMP Protections хранит информацию о типе камня, якорном блоке, владельцах, участниках, скрытом статусе, доме, отображаемом имени и специфичных параметрах защиты.
• Кеши мгновенного доступа — якоря и регионы индексируются для быстрых проверок взаимодействий.
• Локальные данные + движок регионов — функции защиты для игрока остаются простыми и чистыми, в то время как SMP Regions отвечает за реальное применение правил.

Итог: система приватов в стиле ProtectionStones, но спроектированная для экосистемы ArkFlame / SMP Regions, а не для зависимых цепочек WorldGuard.

Типы блоков защиты (Protection Stone Types)

Создавайте разные блоки защиты для различных рангов, миров, экономик и этапов развития сервера.

• Настраиваемый материал — используйте разные блоки для каждого типа защиты.
• Настраиваемый алиас — короткие ID, например 32, 64, 96 или 128.
• Настраиваемый радиус — управление размером защиты по осям X, Y и Z для каждого камня.
• Приваты на всю высоту мира — вертикальные настройки радиуса для защиты от низа до верха мира при необходимости.
• Цена через Vault — взимание внутриигровой валюты при покупке блоков защиты.
• Стоимость установки — возможность взимать плату при размещении блока.
• Привилегированные блоки — ограничение премиальных приватов по рангам, донатам, ивентам или персоналу.
• Автоскрытие — автоматическое скрытие блока защиты после установки (при включении).
• Запрет возврата предмета — блокировка возврата блока при удалении привата (если включено).
• Оформление (glow, name, lore) — кастомизация предметов защиты через MiniMessage-совместимый формат текста.

Управление регионами (Region Management GUI)

Игрокам не нужно запоминать все команды. SMP Protections предоставляет управление основными действиями с регионами через удобное меню.

• Главное меню /sps menu — доступ ко всем инструментам защиты через единый интерфейс.
• Меню получения приватов — покупка настроенных уровней блоков защиты с поддержкой Vault.
• Меню региона — управление защитой, в которой вы находитесь в данный момент.
• Меню участников — просмотр, добавление и удаление доверенных игроков.
• Меню владельцев — управление со-владельцами с расширенными правами.
• Меню заблокированных игроков — блокировка нежелательных игроков в пределах региона.
• Меню флагов — включение и настройка поведения региона через GUI-действия.
• Список регионов — просмотр всех приватов, принадлежащих игроку.
• Безопасные клики — клики в инвентаре отменяются и обрабатываются только через явные действия меню.

Владельцы, участники и блокировки

SMP Protections разделяет уровни доступа, чтобы владельцы серверов могли гибко управлять территориями.

• Владельцы — полный контроль над защитой, меню управления, флагами, участниками и снятием привата.
• Участники — доверенные игроки, которые могут взаимодействовать с регионом согласно настроенным правилам.
• Заблокированные игроки — пользователи, которым может быть запрещён вход в регион или доступ к нему в зависимости от поведения флагов.
• Идентификация по UUID — проверки владельцев и участников выполняются по UUID, а не по никнейму игрока.
• Имена только для интерфейса — имена игроков используются в меню и для удобства чтения, но не являются основанием для выдачи прав.
• Структура, устойчивая к офлайну и смене ника — метаданные хранят стабильные идентификаторы, поэтому смена имени не ломает приваты.

Флаги и правила защиты

У каждого сервера свои правила защиты. SMP Protections предоставляет доступ к флагам регионов через команды и меню, чтобы владельцы и персонал сервера могли управлять поведением приватов.

• Контроль строительства — управление установкой и разрушением блоков внутри приватов.
• Доступ к сундукам — защита контейнеров и зон хранения.
• Контроль PvP — разрешение или запрет сражений в защищённых регионах.
• Контроль TNT и взрывов — защита баз от разрушений взрывами и гриферства.
• Правила спавна мобов — управление появлением сущностей в регионе.
• Поведение входа — настройка возможности входа игроков на защищённую территорию.
• Приветственные и прощальные сообщения — отображение сообщений при входе в регион и выходе из него, если это включено в настройках.
• Редактируемые списки флагов — возможность определить, какие флаги обычные игроки могут изменять самостоятельно.
• Административный контроль флагов — персонал сервера может применять общесерверные правила, сохраняя при этом возможность кастомизации для владельцев регионов.

Поддержка экономики Vault

Превратите защиту территорий в удобный экономический механизм для survival-сервера.

• Покупка блоков защиты — списание средств с игроков при выборе блоков защиты в меню получения.
• Отдельные цены для каждого блока — небольшие приваты могут быть дешёвыми, а премиум-приваты — более дорогими.
• Опциональная стоимость установки — возможность взимать плату в момент фактического создания привата.
• Безопасный процесс покупки с возвратом средств — при ошибке выдачи предмета деньги возвращаются игроку, а не списываются без результата.
• Админ-команда выдачи — персонал может выдавать блоки защиты без списания средств с игроков.
• Экономика по желанию — функции Vault используются только тогда, когда они включены и доступны.

Лимиты и масштабирование по рангам

Контролируйте использование территорий на сервере без жёсткой привязки к вашей системе рангов.

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

Пример использования: обычные игроки получают небольшие стартовые приваты, игроки с рангами открывают больше защит, а премиум-ранги получают увеличенную общую защищённую площадь.


Команды

• /sps — открыть главное меню SMP Protections.
• /sps get [stone] — получить или купить блок защиты.
• /sps give <stone> <player> [amount] — выдать блоки защиты от имени персонала.
• /sps info — посмотреть информацию о привате, в котором вы находитесь.
• /sps list [player] — вывести список принадлежащих приватов.
• /sps count [player] — подсчитать количество приватов.
• /sps add <player> — добавить участника в текущий приват.
• /sps remove <player> — удалить участника.
• /sps addowner <player> — добавить совладельца.
• /sps removeowner <player> — удалить совладельца.
• /sps ban <player> — заблокировать игрока в регионе.
• /sps unban <player> — снять блокировку с игрока.
• /sps flag <flag> <value> — изменить флаг региона.
• /sps name <name|none> — переименовать приват.
• /sps sethome — установить точку дома региона.
• /sps home [name/id] — телепортироваться к точке дома принадлежащего вам привата.
• /sps tp <id/player> [number] — телепортироваться к привату, если это разрешено.
• /sps view — показать границы привата.
• /sps unclaim [id] — удалить приват и вернуть блок защиты, если это включено в настройках.
• /sps reload — перезагрузить конфигурацию и сообщения.

Доступность команд зависит от прав и включённых модулей. Все сообщения об отсутствии прав, показываемые игрокам, могут отображать недостающий permission-узел для более удобной поддержки.


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

• Инструменты перезагрузки — перезагрузка конфигурации и сообщений без перезапуска сервера.
• Админ-выдача — выдача блоков защиты для кейсов, наборов, рангов или ивентов.
• Список/подсчёт приватов других игроков — просмотр использования приватов конкретным игроком.
• Удалённое снятие привата — удаление защит по ID при наличии соответствующих прав.
• Отладочное логирование — отслеживание установки, владения, удаления, действий в меню и создания регионов SMP Regions.
• Подробные сообщения о правах — отображение точного недостающего permission-узла для игроков или персонала.
• Метаданные, удобные для восстановления регионов — UUID-владение и данные защиты структурированы для восстановления и будущей миграции.

Folia, Paper, Spigot, Bukkit, Purpur

SMP Protections создан для совместимости с семейством Bukkit, а не как экспериментальный плагин только для современных серверов.

• Поддержка всех версий — архитектура построена вокруг мостов совместимости для устаревшего и современного поведения серверов.
• Готовность к Folia-планировщику — работа с игроками/сущностями, регионами, глобальными задачами и асинхронными операциями направляется через scheduler bridge.
• Целевая поддержка Java 8 — подходит для устаревших серверных экосистем.
• Определение современной совместимости — при необходимости используется reflection/capability-based подход для совместимости с новыми API.
• Поддержка текста MiniMessage — современные настраиваемые сообщения с безопасным выводом для старых версий.
• Обработка fallback-материалов — поддержка старых и новых схем названий материалов через утилиты совместимости.

Интеграции

• SMP Regions — обязательный движок защиты и слой принудительного применения правил.
• Vault — опциональная поддержка экономики для покупки блоков защиты и оплаты их установки.
• Готовность к PlaceholderAPI — плейсхолдеры региона, владельца, количества, лимитов и флагов могут использоваться в скорбордах и меню.
• Экосистема ArkFlame — разработано для выживания, SMP и инфраструктурных плагинов в рамках стека ArkFlame.

Философия конфигурации

Всё важное должно быть настраиваемым.

• Уровни блоков защиты.
• Материал, алиас, отображаемое имя, описание (lore), свечение и поведение идентификации предмета.
• Радиус по осям X/Y/Z и защита на всю высоту мира.
• Цена покупки через Vault и стоимость установки.
• Поведение выдачи предмета при снятии привата.
• Стандартные флаги и редактируемые флаги.
• Поведение владельцев, участников и заблокированных игроков.
• Лимиты количества приватов.
• Лимиты общей защищённой площади.
• Префиксы прав для масштабирования по рангам.
• Меню и расположение предметов в интерфейсе.
• Сообщения с форматированием MiniMessage.
• Отладочные логи для установки, удаления, проверок владельца и создания регионов.
• Ограничения по мирам и поведение для будущей миграции.

Почему стоит выбрать SMP Protections?

• UX в стиле ProtectionStones — привычная система привата через блоки без принудительной привязки владельцев серверов к архитектуре WorldGuard-first.
• Построен на SMP Regions — использует отдельный движок регионов вместо разрозненных кастомных проверок защиты.
• Создан для реальных SMP-серверов — владельцы, участники, блокировки, флаги, лимиты, экономика, меню и административные инструменты.
• Безопасное владение через UUID — смена никнейма игрока не нарушает права управления регионом.
• Архитектура, готовая к Folia — владение задачами планировщика корректно обрабатывается для современных многопоточных серверов.
• Конфигурация прежде всего — ранги, цены, лимиты, флаги, сообщения и уровни блоков защиты управляются через конфиг.
• Удобная отладка для поддержки — структурированные debug-логи помогают диагностировать проблемы с установкой, владением и снятием приватов.

FAQ

Для каких серверов подходит этот плагин?
Для survival SMP, PvP survival, factions-lite, экономических SMP, Donut-like серверов и соревновательных survival-сетей, которым нужна защита территорий через размещаемые блоки.

Это ProtectionStones?
Нет. SMP Protections — это альтернатива на базе SMP Regions, вдохновлённая рабочим процессом ProtectionStones.

Нужен ли WorldGuard?
Нет. SMP Protections спроектирован вокруг SMP Regions, который используется как основной движок регионов.

Поддерживается ли Folia?
Да. Плагин разработан с учётом Folia-safe планирования задач, поэтому работа с сущностями, регионами, глобальными и асинхронными операциями маршрутизируется корректно.

Можно ли брать деньги за блоки защиты?
Да. Vault может использоваться для цен в меню получения блоков и для опциональной стоимости установки.

Можно ли создавать разные размеры приватов?
Да. Можно настроить несколько типов защитных блоков с разными алиасами, материалами, радиусами, ценами, правами, отображаемыми именами и описанием.

Могут ли ранги получать больше приватов?
Да. Лимиты можно увеличивать через настраиваемые permission-узлы для количества приватов и общей защищённой площади.

Владельцы хранятся по имени?
Нет. Источником истины являются UUID. Имена используются только для отображения.

Могут ли игроки управлять регионами через меню?
Да. Плагин включает GUI-сценарии для получения блоков защиты, просмотра списка приватов, управления регионами, участниками, владельцами, заблокированными игроками и флагами.

Требуется ли PlaceholderAPI?
Нет. Поддержка в стиле PlaceholderAPI является опциональной и может использоваться, если она включена на сервере.