- Add comprehensive documentation in docs/ folder - Update README.md with modern design and badges - Improve configuration with new options (GUI, limits, notifications) - Add support for Minecraft 1.19.2-1.21.4 and Java 17+ - Create GPL-3.0 license - Add modrinth/ folder with project description for publishing - Add CONTRIBUTING.md for contributors - Update plugin.yml with aliases and better permissions - Improve build.gradle.kts with better compatibility and encoding - Update .gitignore for cleaner repository
5 KiB
Часто задаваемые вопросы (FAQ)
Установка и настройка
Q: Плагин не загружается, что делать?
A: Проверьте:
- Версию Java (требуется 17+)
- Версию сервера (Paper 1.19.2+)
- Логи сервера на наличие ошибок
- Правильность названия файла плагина
Q: Как настроить Discord уведомления?
A:
- Создайте webhook в настройках Discord канала
- Скопируйте URL webhook
- Вставьте его в
config.ymlв полеwebhook-url - Перезагрузите плагин командой
/reload confirm
Q: Какую базу данных выбрать?
A:
- SQLite - для серверов до 100 игроков, не требует настройки
- PostgreSQL - для больших серверов, лучшая производительность
Использование
Q: Игроки не могут отправлять репорты
A: Проверьте права доступа:
- Убедитесь что у игроков есть право
lorep.report - Проверьте настройки плагина прав (LuckPerms, PermissionsEx и т.д.)
Q: GUI не открывается
A: Проверьте:
- Есть ли у вас право
lorep.admin - Нет ли ошибок в консоли
- Правильно ли настроена база данных
Q: Как удалить репорт?
A: В текущей версии удаление репортов через игру не поддерживается. Можно удалить напрямую из базы данных или ждать следующего обновления.
Q: Можно ли изменить сообщения плагина?
A: Да, все сообщения настраиваются в секции messages файла config.yml.
Производительность
Q: Плагин тормозит сервер
A:
- Переключитесь на PostgreSQL если используете SQLite
- Увеличьте
pool-sizeв настройках PostgreSQL - Проверьте логи на ошибки подключения к БД
Q: Discord уведомления не приходят
A: Проверьте:
- Правильность URL webhook
- Доступность Discord API с вашего сервера
- Логи плагина на наличие ошибок
Совместимость
Q: Работает ли с Spigot?
A: Нет, плагин требует Paper API. Используйте Paper, Purpur или Pufferfish.
Q: Поддерживается ли версия 1.18?
A: Нет, минимальная поддерживаемая версия - 1.19.2.
Q: Работает ли с другими плагинами репортов?
A: Плагин независим, но может конфликтовать с другими системами репортов. Рекомендуется использовать только один плагин репортов.
Разработка
Q: Есть ли API для других плагинов?
A: Да, смотрите документацию API.
Q: Как собрать плагин из исходников?
A:
git clone https://codeberg.org/loki5512344/Loreport.git
cd Loreport
./gradlew shadowJar
Готовый jar будет в папке build/libs/.
Q: Как сообщить об ошибке?
A: Создайте issue на Codeberg с подробным описанием проблемы и логами.
Миграция
Q: Как перенести данные с другого плагина репортов?
A: В текущей версии автоматическая миграция не поддерживается. Обратитесь к разработчику для помощи с миграцией.
Q: Как сделать бэкап репортов?
A:
- SQLite: скопируйте файл
plugins/Loreport/reports.db - PostgreSQL: используйте
pg_dumpдля создания бэкапа базы данных
Поддержка
Q: Где получить помощь?
A:
- Issues - для багов
- Discussions - для вопросов
- Discord сервер разработчика (ссылка в профиле)
Q: Планируются ли новые функции?
A: Да! Планируется:
- Веб-панель для управления репортами
- Система категорий репортов
- Автоматические действия (бан, кик)
- Интеграция с другими плагинами модерации