TROUBLESHOOTING

Troubleshooting

• Plugin Not Loading:

  • Verify that the plugin JAR is placed in the server’s plugins folder and that you’re running a compatible server version (Paper/Spigot 1.20.6–1.21.x).

  • Check your server console for any error messages during startup.

  • Ensure you’re using Java 17 or higher.

• Commands Not Working:

  • Confirm that you (or your moderators) have the required permission owlscheck.use or are designated as OP.

  • Double-check your command syntax; for example, use /check <player> got, not /check got <player>.

  • Reload or restart the server after making configuration changes.

• Player Not Frozen / Missing On-Screen Messages:

  • Ensure that no conflicting plugins override movement or event cancellations.

  • Verify that your language files include keys like check-freeze-title and check-freeze-subtitle.

  • Check if your client properly supports title messages.

• Timer Issues / Auto-Ban Not Triggering:

  • Confirm the check-time value in your config.yml is set correctly.

  • Check for any scheduling errors in your console.

  • Make sure that the player remains online; if they disconnect, the plugin will ban them immediately.

• GUI Not Opening or Displaying Incorrectly:

  • Ensure that you’re executing /check gui as a player (this command won’t work from the console).

  • Verify that your messages_<lang>.yml file includes a check-gui-title key.

  • Check for inventory-related errors in the server logs.

• Discord Integration (if used):

  • Make sure the discord-webhook URL in config.yml is correct.

  • Ensure your server has internet access to communicate with Discord’s servers.

• General Advice:

  • Always review the server logs for specific error messages.

  • If a problem persists, try reloading the plugin or restarting the server.

  • Update to the latest version of the plugin if available, as improvements and bug fixes are often included in new releases.

These steps should help you identify and resolve common issues with OwlsCheck. RU

• Плагин не загружается:

  • Убедитесь, что JAR-файл находится в папке plugins и что сервер работает под совместимой версией (Paper/Spigot 1.20.6–1.21.x).

  • Проверьте консоль сервера на наличие ошибок при запуске.

  • Убедитесь, что установлена Java 17 или выше.

• Команды не работают:

  • Проверьте, что у вас есть разрешение owlscheck.use или что вы являетесь OP.

  • Убедитесь, что синтаксис команд правильный (например, /check <игрок> got, а не /check got <игрок>).

  • После изменения конфигурационных файлов перезапустите сервер.

• Игрок не замораживается / не отображаются Title:

  • Проверьте, нет ли конфликтующих плагинов, переопределяющих события.

  • Убедитесь, что в языковых файлах присутствуют ключи check-freeze-title и check-freeze-subtitle.

  • Проверьте поддержку Title-сообщений у клиента.

• Проблемы с таймером / авто-баном:

  • Проверьте значение check-time в config.yml.

  • Убедитесь, что задачи планировщика корректно запускаются и не возникает ошибок при их отмене.

  • Если игрок отключается, плагин автоматически банит его — это может быть нормальным поведением.

• GUI не открывается или отображается некорректно:

  • Команда /check gui должна выполняться от имени игрока, а не из консоли.

  • Убедитесь, что в языковом файле задан ключ check-gui-title.

  • Проверьте консоль на ошибки, связанные с инвентарем.

• Discord Integration:

  • Если используется интеграция, проверьте правильность URL вебхука в config.yml (ключ discord-webhook).

  • Убедитесь, что сервер имеет доступ в интернет для отправки уведомлений. Эта документация поможет вам правильно установить, настроить и использовать плагин OwlsCheck, а также устранить возможные проблемы. Если возникнут вопросы или потребуется дополнительная настройка, обращайтесь за поддержкой.