LeavePulse
Документація Власники

Діагностика

Використовуйте діагностику Агента LeavePulse для перевірки шлюзу, токенів, мережі, вайтлисту та стану середовища.

На цій сторінці
  1. Як запустити діагностику
  2. Основні вузли перевірки
  3. 1. Шлюз (Gateway)
  4. 2. Мережа (Network)
  5. 3. Реєстрація середовища (Enrollment)
  6. 4. Вайтлист (Whitelist)
  7. Поширені помилки та рішення
  8. Набори тестів (Suites)

Діагностика LeavePulse — це вбудована система самоперевірки, яка аналізує стан Агента та його зв'язок із платформою.

Як запустити діагностику

Використовуйте це на Paper, Spigot, Folia, Fabric або NeoForge.

Експорт діагностики
/leavepulse diagnostics export

Короткий аліас: /lpa

Команда створює детальний звіт у форматі JSON. Файл зберігається за шляхом: plugins/LeavePulseVerified/diagnostics/latest.json

Основні вузли перевірки

1. Шлюз (Gateway)

Перевіряє активність WebSocket-сесії.

  • Missing Token: Агент не має токена для входу. Рішення: виконайте команду connect.
  • Expired Token: Токен застарів. Рішення: Агент зазвичай оновлює його сам, але якщо ні — перепідключіть сервер.
  • WebSocket URL: Перевірка правильності адреси шлюзу (wss://...).

2. Мережа (Network)

Перевіряє доступність сервісів LeavePulse із вашого сервера.

  • DNS Resolution: Чи може сервер знайти api.leavepulse.com.
  • TCP Reachability: Чи не блокує брандмауер (firewall) вихідні з'єднання на порти 80/443.

3. Реєстрація середовища (Enrollment)

Важливий крок для безпеки, де Агент генерує ключі підпису.

  • Missing Environment ID: Середовище ще не зареєстроване.
  • Key Mismatch: Ключі в конфігу не збігаються з тими, що очікує сайт.

4. Вайтлист (Whitelist)

  • Binding Check: Чи знає Агент, яку саме форму вайтлисту з сайту він має використовувати.
  • Sync Status: Стан останньої успішної синхронізації списку гравців.

Поширені помилки та рішення

ПовідомленняAction Hint (Підказка до дії)
malformed tokenВиконайте перепідключення (/leavepulse connect).
endpoint unreachableПеревірте вихідний трафік на сервері або зв'яжіться з хостингом.
missing server_idАгент не знає, до якого сервера він належить. Виконайте connect.
filesystem read-onlyНадайте Агенту права на запис у папку плагіна.

Набори тестів (Suites)

Для швидкої перевірки конкретного модуля без експорту файлу:

  • /leavepulse diagnostics suite leavepulse.network — статус мережі.
  • /leavepulse diagnostics suite leavepulse.whitelist — статус вайтлисту.
  • /leavepulse diagnostics suite leavepulse.gateway — статус шлюзу.