Player report system for Paper: Discord integration, GUI and database support
Find a file
loki5512344 574fcf8eea
fix: предметы GUI античита — головы игроков вместо камней
Причина: 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
2026-10-21 16:12:31 +02:00
.github docs: Добавлены GitHub шаблоны и политики 2026-04-12 22:57:59 +02:00
.settings chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
config/checkstyle chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
docs feat: major update v1.1.0 - improved documentation, configuration and compatibility 2026-02-03 14:01:34 +01:00
gradle/wrapper Implement tasks 1-6: project setup, config, database, webhook, commands 2025-12-19 12:18:59 +01:00
modrinth feat: add modrinth documentation for publishing 2026-02-03 14:02:26 +01:00
src fix: предметы GUI античита — головы игроков вместо камней 2026-10-21 16:12:31 +02:00
.classpath chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
.gitignore chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
.jqwik-database Implement tasks 1-6: project setup, config, database, webhook, commands 2025-12-19 12:18:59 +01:00
.project chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
build.gradle.kts fix: предметы GUI античита — головы игроков вместо камней 2026-10-21 16:12:31 +02:00
CODE_OF_CONDUCT.md docs: Добавлены GitHub шаблоны и политики 2026-04-12 22:57:59 +02:00
CONTRIBUTING.md feat: major update v1.1.0 - improved documentation, configuration and compatibility 2026-02-03 14:01:34 +01:00
gradlew chore: unify checkstyle, fix violations, cleanup bin/ 2026-07-12 00:59:18 +02:00
gradlew.bat Implement tasks 1-6: project setup, config, database, webhook, commands 2025-12-19 12:18:59 +01:00
LICENSE feat: major update v1.1.0 - improved documentation, configuration and compatibility 2026-02-03 14:01:34 +01:00
README.md feat: anticheat integration (ServGuard summary + tab), server attribution, Folia readiness 2026-10-19 17:10:09 +02:00
SECURITY.md docs: Добавлены GitHub шаблоны и политики 2026-04-12 22:57:59 +02:00
settings.gradle.kts Initial project setup with Gradle 2025-12-19 12:07:40 +01:00

LoReport

Modern player report system with Discord integration, GUI and database support for Paper servers.

Java Paper Folia License version

English | Русский


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

  1. Drop the jar into plugins/
  2. Restart the server
  3. 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+

Установка

  1. Положите jar в папку plugins/
  2. Перезапустите сервер
  3. Настройте Discord webhook в plugins/Loreport/config.yml:
    webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
    

License

GNU General Public License v3.0