🚨 Loreport - Modern Report System for Minecraft

Loreport is a powerful and user-friendly plugin for Minecraft servers that provides a complete report system with Discord integration and beautiful GUI interface.

✨ Key Features

📝 Simple Report System

• Intuitive command /report <player> <reason>
• Spam protection with configurable cooldown
• Limit on number of reports per player
• Report reason length validation

🎨 Beautiful GUI Interface

• Convenient interface for viewing all reports
• Player head display for better visualization
• Pagination for large report lists
• Auto-updating interface

📊 Detailed Statistics

• /report stats <player> command for viewing statistics
• History of all reports on a player
• Last online time information
• Detailed information about each report

🔔 Discord Integration

• Automatic Discord notifications via webhook
• Beautifully formatted messages with complete information
• Instant administrator notifications about new reports

🗄️ Flexible Database

• SQLite - for small servers, requires no configuration
• PostgreSQL - for large servers with high load
• Automatic table creation on first launch
• Optimized queries for high performance

🌐 Fully Customizable

• All messages can be changed in configuration
• Minecraft color code support
• Flexible limitation and cooldown settings
• GUI and notification customization

🎯 Compatibility

• Minecraft versions: 1.19.2 - 1.21.4
• Server software: Paper, Purpur, Pufferfish
• Java: 17+
• Operating systems: Windows, Linux, macOS

🚀 Commands

Command	Description	Permission
/report <player> <reason>	Submit a report on player	lorep.report
/report gui	Open GUI with reports	lorep.admin
/report stats <player>	Player report statistics	lorep.admin

Aliases: /rep, /reports

🔐 Permissions

• lorep.report - Send reports (default: all players)
• lorep.admin - Access to GUI and statistics (default: operators)
• lorep.* - All plugin permissions

⚙️ Quick Setup

1. Download the plugin and place in plugins/ folder
2. Restart server
3. Configure Discord webhook in config.yml:

webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

1. Configure PostgreSQL database if needed
2. Done! Players can use /report

📈 Performance

The plugin is optimized for servers of any size:

• Asynchronous database operations
• Caching of frequently used data
• Minimal impact on server performance
• Connection pool support for PostgreSQL

🛠️ For Developers

Loreport provides an API for integration with other plugins:

• Events for tracking new reports
• Methods for programmatically adding reports
• PlaceholderAPI integration
• Detailed API documentation

🆘 Support

• Documentation: Full documentation included with plugin
• Issues: Codeberg Issues
• Discussions: Codeberg Discussions

📄 License

This project is licensed under GPL-3.0, which means:

• ✅ Free to use
• ✅ Modify source code
• ✅ Commercial use
• ✅ Distribution

---

🚨 Loreport - Современная система репортов

Loreport - это мощный и удобный плагин для Minecraft серверов, который предоставляет полноценную систему репортов с интеграцией Discord и красивым GUI интерфейсом.

✨ Основные возможности

📝 Простая система репортов

• Интуитивно понятная команда /report <игрок> <причина>
• Защита от спама репортов с настраиваемым кулдауном
• Ограничение на количество репортов на одного игрока
• Проверка длины причины репорта

🎨 Красивый GUI интерфейс

• Удобный интерфейс для просмотра всех репортов
• Отображение голов игроков для лучшей визуализации
• Пагинация для больших списков репортов
• Автообновление интерфейса

📊 Подробная статистика

• Команда /report stats <игрок> для просмотра статистики
• История всех репортов на игрока
• Информация о времени последнего онлайна
• Детальная информация о каждом репорте

🔔 Discord интеграция

• Автоматические уведомления в Discord через webhook
• Красиво оформленные сообщения с полной информацией
• Мгновенные уведомления администраторов о новых репортах

🗄️ Гибкая база данных

• SQLite - для небольших серверов, не требует настройки
• PostgreSQL - для больших серверов с высокой нагрузкой
• Автоматическое создание таблиц при первом запуске
• Оптимизированные запросы для высокой производительности

🌐 Полная настраиваемость

• Все сообщения можно изменить в конфигурации
• Поддержка цветовых кодов Minecraft
• Гибкие настройки ограничений и кулдаунов
• Настройка GUI и уведомлений

🎯 Совместимость

• Minecraft версии: 1.19.2 - 1.21.4
• Серверное ПО: Paper, Purpur, Pufferfish
• Java: 17+
• Операционные системы: Windows, Linux, macOS

🚀 Команды

Команда	Описание	Права
/report <игрок> <причина>	Отправить репорт на игрока	lorep.report
/report gui	Открыть GUI с репортами	lorep.admin
/report stats <игрок>	Статистика репортов игрока	lorep.admin

Алиасы: /rep, /reports

🔐 Права доступа

• lorep.report - Отправка репортов (по умолчанию: все игроки)
• lorep.admin - Доступ к GUI и статистике (по умолчанию: операторы)
• lorep.* - Все права плагина

⚙️ Быстрая настройка

1. Скачайте плагин и поместите в папку plugins/
2. Перезапустите сервер
3. Настройте Discord webhook в config.yml:

webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

1. При необходимости настройте базу данных PostgreSQL
2. Готово! Игроки могут использовать /report

📈 Производительность

Плагин оптимизирован для работы на серверах любого размера:

• Асинхронные операции с базой данных
• Кэширование часто используемых данных
• Минимальное влияние на производительность сервера
• Поддержка пула соединений для PostgreSQL

🛠️ Для разработчиков

Loreport предоставляет API для интеграции с другими плагинами:

• События для отслеживания новых репортов
• Методы для программного добавления репортов
• Интеграция с PlaceholderAPI
• Подробная документация API

🆘 Поддержка

• Документация: Полная документация включена в плагин
• Issues: Codeberg Issues
• Обсуждения: Codeberg Discussions

📄 Лицензия

Проект распространяется под лицензией GPL-3.0, что означает:

• ✅ Свободное использование
• ✅ Изменение исходного кода
• ✅ Коммерческое использование
• ✅ Распространение

---

Make your server safer with Loreport! 🛡️

Сделайте свой сервер безопаснее с Loreport! 🛡️

🔗 Source Code / Исходный код • 📚 Documentation / Документация • 🐛 Report Issue / Сообщить о проблеме