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 может привести к неполному обновлению конфигурации, кэшированию данных и непредсказуемому поведению.

PreviousInstallation

Last updated