Player report system for Paper: Discord integration, GUI and database support
Причина: ConfigManager.getGuiItem() читал material через Material.getMaterial() и при любом нераспознанном имени (minecraft:player_head, опечатка, отсутствующий ключ) молча подставлял Material.STONE — предмет вкладки античита рисовался обычным блоком без единой записи в лог. - ConfigManager: материал через Material.matchMaterial (принимаются minecraft:player_head и любой регистр), неизвестный/пустой материал больше не превращается в STONE — пишется предупреждение в консоль и берётся осмысленный материал по умолчанию; предупреждение о ненастроенном gui.items выдаётся один раз за сессию - новый пакет gui/item: AnticheatItems, ReportItems, PlayerHeads, EntrySlots — голова всегда получает профиль игрока (без профиля клиент рисует блок), записи раскладываются по свободным строкам, нижний ряд 45-53 зарезервирован под кнопки, пересечений слотов больше нет - тексты фолбэка GUI перенесены из кода в config.yml/messages.yml - цвета переведены на Adventure (TextFormat), org.bukkit.ChatColor убран - PostgreSQL: player_uuid передаётся как UUID — детальный вид античита и сводка в причине репорта падали с "operator does not exist: uuid = character varying" - бинарь собирается под Paper 26.1.2 / Java 25 (paper-api 26.1.2; константы Enchantment.DURABILITY и ARROW_DAMAGE в этой версии больше не существуют) - в списке репортов появилась кнопка вкладки античита (anticheat_open) - тесты: MaterialParsingTest, EntrySlotsTest, TextFormatTest |
||
|---|---|---|
| .github | ||
| .settings | ||
| config/checkstyle | ||
| docs | ||
| gradle/wrapper | ||
| modrinth | ||
| src | ||
| .classpath | ||
| .gitignore | ||
| .jqwik-database | ||
| .project | ||
| build.gradle.kts | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| SECURITY.md | ||
| settings.gradle.kts | ||
LoReport
Modern player report system with Discord integration, GUI and database support for Paper servers.
English
Overview
LoReport is a modern and performant player report system for Minecraft servers. It features an intuitive GUI, Discord webhook integration, statistics, and supports both SQLite and PostgreSQL databases.
Features
| Feature | Description |
|---|---|
| Report system | /report <player> <reason> with cooldown and limits |
| GUI interface | Browse and manage reports in an inventory menu |
| Player heads | Visual player identification in GUI |
| Pagination | Navigate large report lists |
| Statistics | Per-player report history and stats |
| Discord integration | Instant webhook notifications with embeds |
| SQLite | Zero-config database for small servers |
| PostgreSQL | Scalable database for large servers |
| Async database | All DB operations off the main thread |
| Localization | Fully customizable messages |
| SQL injection protection | All queries use PreparedStatement |
| PlaceholderAPI | Report stats in other plugins |
Commands
| Command | Permission | Description |
|---|---|---|
/report <player> <reason> |
lorep.report |
Report a player |
/report gui |
lorep.admin |
Open reports GUI |
/report stats <player> |
lorep.admin |
View player report stats |
/report ac |
lorep.admin |
Open the anticheat (ServGuard) GUI |
/rep |
lorep.report |
Alias for /report |
Dependencies
- Required: Paper 1.19.2+, Java 21+
- Optional: PlaceholderAPI
- Database: SQLite 3.47+ (default) or PostgreSQL 12+
Installation
- Drop the jar into
plugins/ - Restart the server
- Configure Discord webhook in
plugins/Loreport/config.yml:webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
Русский
Обзор
LoReport - современная и производительная система репортов для Minecraft серверов. Включает интуитивный GUI, Discord webhook интеграцию, статистику и поддержку SQLite и PostgreSQL.
Возможности
| Возможность | Описание |
|---|---|
| Система репортов | /report <игрок> <причина> с кулдауном и лимитами |
| GUI интерфейс | Просмотр и управление репортами в меню |
| Головы игроков | Визуальная идентификация в GUI |
| Пагинация | Навигация по большим спискам |
| Статистика | История репортов по каждому игроку |
| Discord интеграция | Мгновенные уведомления через webhook с embed |
| SQLite | Встроенная БД без настройки |
| PostgreSQL | Масштабируемая БД для крупных серверов |
| Асинхронная БД | Все запросы вне основного потока |
| Локализация | Полностью настраиваемые сообщения |
| Защита от SQL-иньекций | Все запросы через PreparedStatement |
| PlaceholderAPI | Статистика репортов в других плагинах |
Команды
| Команда | Право | Описание |
|---|---|---|
/report <игрок> <причина> |
lorep.report |
Отправить репорт |
/report gui |
lorep.admin |
Открыть GUI репортов |
/report stats <игрок> |
lorep.admin |
Статистика репортов игрока |
/report ac |
lorep.admin |
GUI античита (ServGuard) |
Зависимости
- Обязательные: Paper 1.19.2+, Java 21+
- Опциональные: PlaceholderAPI
- База данных: SQLite 3.47+ (по умолчанию) или PostgreSQL 12+
Установка
- Положите jar в папку
plugins/ - Перезапустите сервер
- Настройте Discord webhook в
plugins/Loreport/config.yml:webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
Links
License
GNU General Public License v3.0