ModLogs 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:
# master switch for all Discord webhook notifications
enabled: false
# bot token used to create/validate webhooks in target channels
bot-token: ""
# fallback channel for any event that does not define its own channel
# recommended to keep this empty when you configure channelid per event
channel-id: ""
notifications:
join:
# in-game admin notification switch
enabled: true
# supported: all, mods, resourcepack_all, resourcepack_enabled, resourcepack_disabled, version
# you can use either a string ("all") or a yaml list
types: "all"
# Discord controls
discord-enabled: true
channelid: ""
resourcepack-change:
# in-game admin notification switch
enabled: true
# supported: all, show-enabled, show-disabled
# you can use either a string ("all") or a yaml list
types: "all"
# Discord controls
discord-enabled: true
channelid: ""
freecam:
# in-game admin notification switch
enabled: true
# when enabled, admins with modlogs.notify can see a live floating marker for active freecam users
admin-view: true
# Discord controls
discord-enabled: true
# supported: all, start, stop
discord-types: "all"
channelid: ""
viewer:
# if true, /modlog show only works for online targets
require-online-player: false
# show how old the last snapshot is in /modlog show output
show-last-update: true
