NameRetriever: расширяем горизонты никнеймов и команд на серверах Minecraft
Каждый администратор сервера Minecraft хотя бы раз сталкивался с ситуацией, когда игрок с запоминающимся ником вроде ~Алексей не может воспользоваться приватными командами, потому что плагины упорно не распознают его псевдоним. Стандартная команда /realname из Essentials работает только для тех, кто сейчас в сети, а что делать с офлайн-друзьями? Ответ — NameRetriever, небольшой, но мощный плагин, который превращает работу с именами в настоящее удовольствие.
Что такое NameRetriever и зачем он нужен
NameRetriever — это дополнение для серверов на базе Essentials, которое расширяет функционал команды /realname на офлайн-игроков и добавляет удобную команду /realnick. Если вы когда-нибудь пытались отправить запрос на телепортацию другу с нечитаемым техническим ником hjfdiwj_48728, который носит кличку ~jerry, то знаете, как это раздражает. Стандартный /tpa jerry просто не сработает. NameRetriever решает эту проблему, автоматически подставляя реальное имя вместо никнейма для целого списка команд.
Ключевые возможности
- Работа с офлайн-игроками: плагин анализирует лог-файлы Essentials, чтобы найти соответствия даже для тех, кто давно не заходил.
- Команда /realnick: обратная операция — по реальному имени можно узнать действующий никнейм.
- Интеграция с другими плагинами: NameRetriever умеет подменять первый (или первые два) аргумента любых команд, указанных в конфигурации, на реальные имена.
- Асинхронная обработка: при включённой опции useAsync поиск по диску не вызывает лагов, что критически важно для крупных серверов с тысячами игроков.
- Гибкая настройка через регулярные выражения: вы сами решаете, какие команды будут обрабатываться.
Установка и первый запуск
Процесс предельно прост. Скачайте NameRetriever, скопируйте jar-файл в папку plugins вашего сервера, настройте права и перезапустите сервер. После запуска в директории plugins появится папка NameRetriever с файлом config.yml — именно там живут все тонкие настройки. Если вы решите что-то поменять, не обязательно перезагружать весь сервер: достаточно выполнить /nr reload в консоли или прямо в игре при наличии соответствующего разрешения.
Кстати, если вы активно пользуетесь модификациями на клиентской стороне и хотите быстро устанавливать их без лишних телодвижений, присмотритесь к лаунчеру foxygame.net. Это удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню — он отлично дополнит серверную экосистему с NameRetriever, позволяя игрокам моментально подгружать нужные клиентские дополнения.
Команды и права
Плагин добавляет несколько простых команд с интуитивно понятными алиасами:
- /realname (алиасы /rname, /name) — показывает реальное имя игрока по его отображаемому нику. Если совпадений по никнейму нет, выводит и реальное имя, и ник по реальному имени.
- /realnick (алиас /rnick) — обратная операция: по реальному имени показывает текущий никнейм.
- /nameretriever reload (или /nr reload) — перезагрузка конфигурации.
- /nameretriever version — версия плагина.
- /nameretriever help — справка.
Права распределены по отдельным узлам: nameretriever.realname, nameretriever.realnick, nameretriever.reload, nameretriever.version, nameretriever.help. Выдавайте их точечно, чтобы сохранить контроль над функционалом.
Тонкая настройка конфигурации
Файл config.yml содержит несколько ключевых параметров, которые стоит изучить внимательно:
- showStatus — при значении true к результату добавляется статус «онлайн» или «офлайн». Рекомендуется отключать, если вы не используете Essentials для никнеймов.
- getOfflineAlways — заставляет плагин всегда искать по офлайн-игрокам, даже если найдены онлайн-совпадения.
- nickIndicatorChar — символ-индикатор перед никнеймом. По умолчанию ~, как в Essentials.
- useAsync — асинхронный доступ к дисковым данным. Настоятельно рекомендуется включать на серверах с большой историей игроков.
- cmdRegex1 и cmdRegex2 — регулярные выражения для команд, у которых нужно заменять первый аргумент (или первые два) на реальное имя.
Магия регулярных выражений
Даже если вы никогда не работали с regex, изменить список команд несложно. Стандартное выражение выглядит так: ^\/(?i)(tp|tphere|tpa|tpahere). Не трогайте начало строки, а просто добавляйте или убирайте названия команд внутри последних скобок, разделяя их вертикальной чертой. Например, чтобы добавить /msg и /mail, выражение станет ^\/(?i)(tp|tphere|tpa|tpahere|msg|mail). Главное — сохранить формат, и всё будет работать.
API для разработчиков
NameRetriever предоставляет открытый API, который позволяет другим плагинам использовать его механизмы поиска реальных имён и никнеймов. Подробная документация доступна в репозитории на GitHub, а исходный код полностью открыт — вы можете не только пользоваться, но и дорабатывать плагин под свои нужды.
Почему NameRetriever — мастхэв для серверов с Essentials
Этот плагин закрывает досадный пробел в экосистеме Essentials, делая взаимодействие с никнеймами по-настоящему бесшовным. Больше не нужно запоминать технические идентификаторы друзей или просить их перезайти под реальным именем. NameRetriever автоматически связывает красивые псевдонимы с настоящими учётными записями, а гибкая система регулярных выражений позволяет распространить эту магию практически на любые команды — от телепортации до личных сообщений.
Установите NameRetriever, настройте список команд под свои нужды и забудьте о путанице с никами навсегда. Асинхронная работа и продуманная работа с логами Essentials гарантируют стабильность даже на самых населённых проектах.