ModLogs Plugin

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： paper

标签： management technology utility

ModLogs Plugin

Server-side verification and monitoring plugin for Minecraft servers.

? Summary

? 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.

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:

No personal or system-level data is collected.

? Server Enforcement & Behavior

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