SimpleNicks

SimpleNicks - это standalone-плагин для серверов Minecraft, который решает одну конкретную проблему: как дать игрокам возможность менять свои ники, не тащив за собой тонны лишнего функционала. Знакомая ситуация, когда нужен только никнейм, а приходится ставить огромный плагин с кучей всего? Вот тут и выручает SimpleNicks.

Плагин построен на MiniMessage - современной системе форматирования текста. Это значит, что игроки могут использовать цвета, градиенты, радугу, жирный, курсив и другие эффекты прямо в нике. Выглядит это намного круче, чем старые &-коды.

Что умеет SimpleNicks

• Установка ников с MiniMessage - полный контроль над внешним видом ника.
• Отображение в табе (Tab List) - никаких костылей, ники подставляются прямо в список игроков.
• Сохранение ников - можно сохранить несколько вариантов и переключаться между ними. Удобно для ролевых игр или просто чтобы не вводить каждый раз одно и то же.
• Защита от подмены - плагин не даст прикинуться другим игроком, используя его ник или имя.
• Команда /nick who - если видите странный ник, можно узнать, кто за ним скрывается.

Команды

Для игроков

Команда	Описание
/nick help	Показывает справку.
/nick set <ник>	Устанавливает ник с поддержкой MiniMessage.
/nick save [ник]	Сохраняет текущий ник или указанный для будущего использования.
/nick delete <ник>	Удаляет сохраненный ник из списка.
/nick reset	Сбрасывает ник на оригинальное имя.
/nick who <ник>	Показывает, кто скрывается под этим ником.

Для администрации

Команда	Описание
/nick admin set <игрок> <ник>	Устанавливает ник другому игроку (используются права админа на форматирование).
/nick admin reset <игрок>	Сбрасывает ник другого игрока.
/nick admin delete <игрок> <ник>	Удаляет сохраненный ник из списка игрока.
/nick admin lookup <игрок>	Показывает текущий ник и все сохраненные ники игрока.
/nick reload	Перезагружает конфиг и локаль.

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

Для игроков

Право	Описание	По умолчанию
simplenick.nick.set	Установка своего ника.	op
simplenick.nick.reset	Сброс своего ника.	op
simplenick.nick.delete	Удаление сохраненного ника.	op
simplenick.nick.who	Использование /nick who.	true

Цветовые права

Право	Описание	По умолчанию
simplenick.color.basic	Использование цветов (<red>, <color:#aabbcc>).	op
simplenick.color.gradient	Использование градиентов (<gradient:red:blue>).	op
simplenick.color.✨	Использование <✨>.	op
simplenick.color.reset	Использование <reset>.	op

Форматные права

Право	Описание	По умолчанию
simplenick.format.bold	<b>/</b>.	op
simplenick.format.italic	<i>/</i>.	op
simplenick.format.underline	<u>/</u>.	op
simplenick.format.strikethrough	<st>/</st>.	op
simplenick.format.obfuscated	<obf>/</obf>.	op

Для администрации

Право	Описание	По умолчанию
simplenick.admin.set	Установка ника другому игроку.	op
simplenick.admin.reset	Сброс ника другого игрока.	op
simplenick.admin.delete	Удаление сохраненного ника у другого игрока.	op
simplenick.admin.lookup	Просмотр ников игрока.	op
simplenick.reload	Перезагрузка конфига.	op

Права на обход

Право	Описание	По умолчанию
simplenick.bypass.username	Использовать чужое имя как ник.	false
simplenick.bypass.length	Ставить ники длиннее лимита.	false
simplenick.bypass.regex	Ставить ники, не проходящие проверку символов.	false
simplenick.bypass.nick-protection	Игнорировать защиту ников (онлайн/офлайн/срок).	false

PlaceholderAPI

Плагин предоставляет плейсхолдеры для интеграции с другими плагинами:

Плейсхолдер	Описание	Пример вывода
%simplenick_nickname%	Обработанный (с цветами) ник игрока.
%simplenick_mininick%	Сырой MiniMessage-ник (с тегами).
%simplenick_prefixed-nickname%	Ник с префиксом из конфига.
%simplenick_prefixed-mininick%	Сырой ник с префиксом.

Настройка конфига

MySQL

По умолчанию плагин использует локальный SQLite-файл - никакой возни с базами данных не нужно. Если хотите общую базу для сети серверов, включите MySQL:

mysql:
  enabled: false
  ip: "localhost:3306"
  name: simplenicks
  username: username1
  password: badpassword!

Длина ника

Максимальная длина ника считается без учета форматирования. То есть <blue>Привет</blue> будет считаться как 6 символов.

max-nickname-length: 30

Регулярка для символов

По умолчанию разрешены только латиница, цифры и подчеркивание: [A-Za-z0-9_]+. Если хотите кириллицу или другие символы - меняйте регулярку.

nickname-regex: "[A-Za-z0-9_]+"

Требовать права на функции

Можно настроить, какие функции требуют прав, а какие доступны всем:

require-permission:
  nick: true
  color: true
  format: true
  who: false

Защита ников (Nickname Protection)

Настраивается отдельно для онлайн-игроков, офлайн-игроков и защиты имен пользователей:

nickname-protection:
  username:
    enabled: true
    expires: 30 # дней до снятия защиты с имени пользователя; -1 = никогда не снимать
  online:
    enabled: false # защита только для онлайн-игроков?
  offline:
    enabled: false # защита для офлайн-игроков?
    expires: 30 # дней до снятия защиты; -1 = никогда не снимать

Максимум сохранений и префикс для ников

max-saves: 5 # сколько ников можно сохранить одному игроку?
nickname-prefix: "" # префикс перед ником (например, "~")
tablist-nick: false # менять ли ники в табе? (лучше false, если используете другой плагин для таба)
debug-mode: false # не включайте без необходимости - зафлудит логи.

Миграция со старых версий SimpleNicks (до SQL)

Если обновляетесь со старой версии (где данные хранились в YML или PDC), плагин сам перенесет все данные в SQLite или MySQL при первом запуске. Основные изменения:

• Админские команды теперь под /nick admin, а не отдельно.
• Права на цвета и форматы разделены на отдельные ноды (simplenick.color.*, simplenick.format.*).
• Плейсхолдеры переименованы для единообразия.
• Установка ника админом теперь всегда использует права самого админа на форматирование.

В целом, SimpleNicks - это именно то, что нужно, если хочется дать игрокам возможность менять ники без лишней головной боли. Легкий, настраиваемый и с нормальной защитой от путаницы.