🧍 PlayerChecker

PlayerChecker — это простой плагин для Paper, который позволяет быстро проверить, заходил ли игрок на сервер и узнать его текущую группу (ранг) через API LuckPerms.
Идеально подходит для интеграции с веб-сайтами, системами авторизации или панелями управления игроками.

---

⚙️ Возможности

• Проверяет, заходил ли указанный игрок когда-либо на сервер.
• Определяет его ранг (primary group) из LuckPerms.
• Возвращает короткие статусы, удобные для парсинга внешними системами (RCON / HTTP).

---

🧩 Зависимости

Для корректной работы требуется установленный плагин:

- LuckPerms

---

💡 Команды

Команда	Описание	Разрешение
/checkplayer <ник>	Проверяет наличие игрока и его ранг	playerchecker.use (по умолчанию op)

---

📤 Форматы возвращаемых данных

Команда /checkplayer <ник> возвращает один из следующих форматов:

Ответ	Описание
NOT_FOUND	Игрок никогда не заходил на сервер и не найден в базе данных.
FOUND:NO_RANK	Игрок найден, но у него нет назначенной группы (ранга) в LuckPerms.
FOUND:<rank>	Игрок найден, и у него установлен ранг <rank>. Например: FOUND:default, FOUND:vip.
ERROR:<сообщение>	Произошла внутренняя ошибка при выполнении команды.

---

🧠 Примеры использования

Пример 1 — игрок не найден:

/checkplayer Steve
# → NOT_FOUND

Пример 2 — найден без ранга:

/checkplayer Alex
# → FOUND:NO_RANK

Пример 3 — найден с рангом:

/checkplayer Denis
# → FOUND:vip

---

🧱 Пример интеграции (RCON)

Пример вызова через mcrcon:

mcrcon -H 127.0.0.1 -P 25575 -p mypass "checkplayer Steve"
# Ответ: FOUND:vip  (или NOT_FOUND / FOUND:NO_RANK)

Пример обработки в Python:

result = rcon_command(f"checkplayer {username}").strip()
if result.startswith("FOUND:"):
    rank = result.split("FOUND:")[1].strip()
    # rank может быть "NO_RANK" или реальный ранг
elif result == "NOT_FOUND":
    # игрок не найден
else:
    # обработка ошибок

---

🛠 Установка

1. Скачайте последний релиз из раздела Releases
2. Помести .jar в папку plugins/ сервера.
3. Убедись, что установлен LuckPerms.
4. Перезапусти сервер.
5. Проверь работу командой:

   /checkplayer <ник>

---

🔍 Совместимость

Платформа	Версия
Paper	1.21.10
LuckPerms	v5.5

---

📜 Лицензия

Проект распространяется под лицензией MIT.