Common Issues & Fixes

Possible Errors and Fixes / Возможные ошибки и их решения

(English / Русский)

---

English

Common Issues & Fixes

1. Plugin Not Loading or Command Not Registered

   • Issue: The plugin is not visible in /plugins or the command /freedonate does not work.

   • Fix:

     • Ensure that the plugin’s plugin.yml file has the correct main class (e.g., sirBonus.SirBonusPlugin) and that the package structure matches.

     • Verify that your server uses a supported version (Paper/Spigot 1.20+).

     • Important: The plugin must be fully restarted with the server. Do not use /reload as it may cause configuration or resource loading issues.

2. LuckyPerms API Not Found / Integration Issues

   • Issue: Error messages related to LuckPermsProvider.get() or group assignment failures.

   • Fix:

     • Ensure that the LuckyPerms plugin is installed and loaded on your server.

     • Confirm that you are using the correct version of the LuckyPerms API as specified in the plugin’s pom.xml.

     • Check your server logs for any API-related errors.

3. Configuration File Errors

   • Issue: The plugin uses default values or displays error messages like [key not found] instead of your custom texts.

   • Fix:

     • Verify that config.yml and the appropriate messages_*.yml files (based on your language setting) exist in the plugin’s data folder.

     • If you update these files, make sure to restart the server (a full restart is required) so that changes take effect.

4. Cooldown or One-Time Reward Issues

   • Issue: Players are able to trigger the reward multiple times, or the cooldown does not work as expected.

   • Fix:

     • Check your configuration in config.yml for the correct cooldown-seconds value.

     • Ensure that the winners list is saved properly in the winners.yml file.

     • Remember: The reward system is designed so that a player who has successfully won once will not be able to receive the bonus again—even after a server restart.

5. Sound or Title Effects Not Working

   • Issue: The sound or title display appears incorrectly or not at all.

   • Fix:

     • Verify that the sound name in config.yml (e.g., ENTITY_FIREWORK_ROCKET_BLAST) is a valid Minecraft sound.

     • Check that your server version supports the sound effect.

     • Adjust volume and pitch settings if needed.

Full Server Restart Requirement

Important: For proper functioning of sirBonus, it is strictly required that you perform a full server restart whenever you change configurations or update the plugin. Using /reload may lead to incomplete resource loading, cached configuration issues, or unexpected behavior.

---

Русский

Возможные ошибки и их решения

1. Плагин не загружается или команда не зарегистрирована

   • Проблема: Плагин не отображается в списке /plugins или команда /freedonate не работает.

   • Решение:

     • Убедитесь, что файл plugin.yml содержит корректный main класс (например, sirBonus.SirBonusPlugin) и что структура пакетов соответствует указанной.

     • Проверьте, что сервер работает на поддерживаемой версии (Paper/Spigot 1.20+).

     • Важно: Плагин требует полной перезагрузки сервера. Не используйте /reload, так как это может привести к проблемам с загрузкой конфигурации и ресурсов.

2. Проблемы с интеграцией LuckyPerms

   • Проблема: Вы видите ошибки, связанные с вызовом LuckPermsProvider.get() или с назначением групп.

   • Решение:

     • Проверьте, установлен ли плагин LuckyPerms и загружен ли он на сервере.

     • Убедитесь, что версия API LuckyPerms, указанная в pom.xml, соответствует версии установленного плагина.

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

3. Ошибки в файлах конфигурации

   • Проблема: Плагин использует значения по умолчанию или выводит сообщения об ошибке типа [ключ не найден] вместо настроенных текстов.

   • Решение:

     • Проверьте, что файлы config.yml и соответствующие messages_*.yml (в зависимости от выбранного языка) находятся в папке плагина.

     • Если вы вносите изменения, обязательно выполните полную перезагрузку сервера для применения изменений.

4. Проблемы с кулдауном или ограничением по выигрышу

   • Проблема: Игроки могут повторно получать бонус, несмотря на успешный выигрыш, или кулдаун работает некорректно.

   • Решение:

     • Проверьте правильность значения cooldown-seconds в config.yml.

     • Убедитесь, что список победителей сохраняется в файле winners.yml и загружается при старте плагина.

     • Помните, что система бонуса настроена так, что после первого успешного получения бонуса игрок больше не может его получить, даже после перезапуска сервера.

5. Проблемы со звуком и титулами

   • Проблема: Звук или титул не воспроизводятся или отображаются некорректно.

   • Решение:

     • Проверьте, что в config.yml указано правильное название звука (например, ENTITY_FIREWORK_ROCKET_BLAST), и что ваш сервер поддерживает этот звук.

     • Убедитесь, что параметры громкости (sound-volume) и тона (sound-pitch) заданы корректно.

     • Проверьте файлы сообщений для титула и сабтитула (например, reward-title и reward-subtitle).

Требование полной перезагрузки сервера

Важно: Для корректной работы плагина sirBonus обязательно выполняйте полную перезагрузку сервера при изменении конфигурации или обновлении плагина. Использование команды /reload может привести к неполному обновлению конфигурации, кэшированию данных и непредсказуемому поведению.

---