ModLog Plugin

Server-side verification and monitoring plugin for Minecraft servers.

---

📌 Summary

Item	Description
Type	Server-side plugin
Purpose	Client verification, moderation & logging
Works With	ModLog Mod (client-side)
Edition	Java Edition (Paper / Spigot compatible)
Bedrock	Ignored automatically (Geyser/Floodgate)
Accounts	Offline & Online

---

🧩 Overview

ModLog Plugin is a server-side moderation and verification plugin that receives client environment data from ModLog Mod and processes it for logging, monitoring, and anti-cheat purposes.

The plugin allows server administrators to:

• Inspect player mods and resource packs
• Monitor client-side changes in real time
• Enforce server join rules
• Receive notifications in-game or via Discord webhooks

The plugin does not modify gameplay and runs independently in the background.

---

🔗 Required Client Mod

This plugin requires players to use ModLog Mod.

Resource	Link
ModLog Mod	https://modrinth.com/mod/modlog-mod

Servers may deny access to Java players who attempt to join without the required mod.

---

📊 Received Client Data

The plugin processes the following information sent by the client mod:

Data	Description
Username	Player name
Mods	List of loaded client mods
Resource Packs	Enabled & disabled resource packs
Version	Minecraft client version

No personal or system-level data is collected.

---

🔐 Server Enforcement & Behavior

Feature	Behavior
Join verification	Player data checked on join
Missing mod	Player may be blocked
Change tracking	Resource pack changes detected
Notifications	In-game & Discord supported

This system helps detect:

• X-Ray via suspicious resource packs
• Unauthorized client mods
• Modified client environments
• Version mismatches

---

⚙️ Configuration

The plugin is fully configurable using a single YAML configuration file.

📄 Full Configuration

discord:
  enabled: false
  bot-token: ""
  channel-id: ""

notifications:
  join:
    enabled: true
    # supported: all, mods, resourcepack_all, resourcepack_enabled, resourcepack_disabled, version
    types: "all"

  resourcepack-change:
    enabled: true
    # supported: all, show-enabled, show-disabled
    types: "all"