SimplePrefixes

SimplePrefixes - плагин для Майнкрафт, который кардинально меняет подход к выдаче префиксов на сервере. Обычно админам приходится возиться с пермишенами, вручную прописывать группы в LuckPerms и выдавать префиксы по запросу. Этот проект решает проблему: игрок сам открывает меню, выбирает красивый префикс, а плагин просто хранит его в переменной. Никакого вмешательства в метаданные пермишенов, всё работает автономно.

Если вы планируете запускать сервер, плагин без проблем встанет на BungeeHost (https://bungee.host) буквально в один клик, так что поиграть с друзьями онлайн с красивыми никами не составит труда.

Требования для запуска

• Ядро на базе Paper (например PurpurMC). Плагин использует встроенный парсер Mini-Message.
• Обязательно нужен PlaceholderAPI, иначе ничего не заработает.

Основные фишки

• Удобное GUI - игрокам не нужно учить команды, все делается через клики в меню.
• Изоляция от других плагинов - SimplePrefixes не лезет в права или группы. Он держит префикс в плейсхолдере, что спасает от конфликтов.
• Mini-Message - можно делать градиенты, ховеры, кликабельные ссылки. Выглядит сочно.
• Система требований (Requirements) - можно выдать префикс только тем, кто выполнил условие: убил босса, получил достижение или имеет нужную статистику.

Команды и плейсхолдеры

Для интеграции в чат используйте плейсхолдеры:

%simpleprefixes_prefix%

Основной плейсхолдер. Пихаете его в настройки вашего чат-плагина. Пример: %sp_prefix% %player_displayname% " {message}

%simpleprefixes_prefix_legacy%

Конвертирует формат Mini-Message в старыйlegacy-формат (&a / §a). Незаменим, если у вас стоят старые плагины вроде TAB, которые не понимают новые теги. Теги <hover> и <click> автоматически вырезаются, чтобы не ломать вывод.

Команды админа и игрока:

• /sp gui - открыть сгенерированное меню.
• /sp reset - сбросить текущий префикс.
• /sp set <prefix-id> - выставить префикс вручную.
• /sp reload - перезагрузить конфигурацию.

Настройка хранения данных

В конфиге можно выбрать, как именно сохранять прогресс игроков:

Настройка	Описание	Значения
saving-type	Тип системы сохранения	PDC, FILE, MYSQL
mysql	Настройки подключения к базе данных	Данные SQL
default-prefix	Префикс по умолчанию (для новичков)	Строка
prefix-menu-name	Название меню в инвентаре	Строка

Варианты сохранений:

• PersistentDataContainer (PDC) - данные пишутся прямо в профиль игрока. Но если он оффлайн, плагин не сможет узнать его префикс. Это скорее рудимент, оставшийся с ранних версий.
• YML File (FILE) - дефолтный способ. Все ID префиксов пишутся в файл. Префикс доступен даже когда игрок не в сети, но при каждом изменении идет запись на диск.
• MySQL - для крупных проектов и BungeeCord-сетей. Самый надежный вариант.

Создание своих префиксов

Префиксы создаются в файле prefixes.yml. Формат очень гибкий. Вы можете задать предмет, который будет отображаться в меню, его количество и даже Custom Model Data (если используете ресурспаки).

yml permitted: display-name: "The Permitted" description: - "You do have permission to run this command!" prefix: "[Permitted]" requirements: - "permission simpleprefix.permitted"

Параметры префикса

• Prefix ID - уникальный идентификатор. Дубликаты нельзя.
• display-name - формальное имя в меню. Поддерживает PlaceholderAPI.
• prefix - то, что будет выводиться в чат вместо %sp_prefix%.
• description - список строк, описание под префиксом в меню.
• item - настройка предмета (материал, количество, custom-model-data). Если не указать, будет обычная бирка.
• show-when-locked - если false, префикс вообще не появится в меню, если условия не выполнены.
• verify-always - если true, плагин будет проверять условия КАЖДЫЙ раз, когда префикс запрашивается. Если условие слетело (например, забрали VIP), префикс автоматически очистится. Очень полезная штука.

Система требований (Requirements)

Это самая мощная часть SimplePrefixes. Требования - это условия, которые должны выполняться, чтобы игрок мог надеть префикс.

Важный нюанс Если формулировка кривая или выдает ошибку - плагин просто игнорирует это условие. Проверки прав работают только когда игрок онлайн. Офлайн-чеки игнорируются.

Permission (Права) Формат: permission <permission.node> [false] Проверяет наличие права. Если добавить [false], то префикс выдается только если права НЕТ. Пример: permission example.permission

Statistic (Статистика) Формат: statistic <statistic> <operator> <value> Проверяет ванильную статистику Minecraft. Операторы: >, <, >=, <=, ==, != Пример: statistic ANIMALS_BRED >= 100 (вырастил 100 животных).

Advancement (Достижения) Формат: advancement <namespace:advancement> [false] Проверка ванильных или кастомных достижений. Пример: advancement minecraft:nether/summon_wither (призвал Визера).

Compare Int (Сравнение чисел) Формат: compare_int <placeholder> <operator> <value> Берет число из любого плейсхолдера PAPI и сравнивает. Пример: compare_int %player_absorption% > 0 (игрок имеет поглощение).

Итог

SimplePrefixes - must-have для серверов, где хотят дать игрокам свободу кастомизации, но не хотят плодить сотни групп в пермишенах. Плагин легкий, гибкий и отлично интегрируется с современными чат-системами. Скачайте SimplePrefixes для Minecraft и дайте своим игрокам то, что они хотят - красивые ники без лишней возни с админами.