Added

• Added 99 mod and protocol definitions, bringing the built-in database to 169 definitions.
• Added coverage for all 240 submitted plugin-message channels across 102 observed namespaces.
• Added definitions for FTB Chunks, FTB Library, FTB Teams, JEI, VoxelMap, Emotecraft, Easy Anvils, Easy Magic, Open Parties and Claims, and many more.
• Added Fabric Menu API and Pick Up Notifier patterns to their existing definitions.
• Added a dependency-free mod-definition generator that accepts discovered-channels.json, pasted channel lists, plain text, or stdin.

Changed

• The full bundled definition database is now copied to an editable mods.yml in the plugin data directory when the file does not already exist.
• Server owners can add definitions directly to mods.yml and apply them with /md reload.
• /md reload now reloads both config.yml and mods.yml.
• Existing external mods.yml files are never overwritten during plugin updates.
• Invalid mods.yml edits keep the last successfully loaded definitions active.
• Shared protocol namespaces such as minecraft, forge, and adventure use exact channel matches where namespace-wide wildcards could cause incorrect identification.

Upgrade notes

Replace the existing platform-specific JAR and restart the server or proxy. If no external mods.yml exists, one will be generated automatically. Existing configuration and definition files are preserved.

Velocity

Added

• Per-Session Mod Tracking

  • Each session now records which mods the player was using
  • /md info displays the full mod list for each session
  • Useful for tracking mod usage changes over time

• Delta Compression for Sessions

  • Sessions use smart delta compression to minimize storage
  • First session stores full mod list
  • Subsequent sessions store only changes (added/removed) if < 3 mods changed
  • Large changes (3+ mods) trigger a new full snapshot
  • Unchanged sessions store only time data

• Enhanced /md info Display

  • Shows firstSeen timestamp
  • Shows total playtime formatted (e.g., "1h 30m")
  • Sessions display reconstructed mod list with duration

Changed

• Storage Efficiency
  • Typical player with same mods across 100 sessions: ~3KB (was ~25KB)
  • ~88% reduction in storage for players with stable mod configurations
  • Backwards compatible with existing data (old sessions show as-is)

Example Detection Entry

{
  "uuid": "f999e944-a15d-4287-bff4-34f63a97832e",
  "username": "PlayerName",
  "mods": ["Simple Voice Chat", "Jade", "Minimap"],
  "channels": ["unknown:channel"],
  "firstSeen": "2026-01-16T17:28:01Z",
  "lastSeen": "2026-01-18T12:00:00Z",
  "totalTimePlayedSeconds": 3600,
  "sessionCount": 4,
  "sessions": [
    {"joinTime": "2026-01-16T17:27:59Z", "leaveTime": "2026-01-16T17:30:00Z", "durationSeconds": 121, "mods": ["Jade", "Voice Chat"]},
    {"joinTime": "2026-01-17T10:00:00Z", "leaveTime": "2026-01-17T10:30:00Z", "durationSeconds": 1800, "added": ["Minimap"]},
    {"joinTime": "2026-01-17T14:00:00Z", "leaveTime": "2026-01-17T14:20:00Z", "durationSeconds": 1200},
    {"joinTime": "2026-01-18T12:00:00Z", "leaveTime": "2026-01-18T12:08:00Z", "durationSeconds": 479, "removed": ["Jade"]}
  ]
}

Velocity

Added

• Session Tracking

  • Tracks totalTimePlayedSeconds across all sessions
  • Records sessionCount for each player
  • Maintains sessions array with join/leave times and duration for each session

• Clickable Player Names

  • Player names in /md players are now clickable
  • Click to run /md info <player> automatically
  • Hover text shows "Click to view channels"

Changed

• Simplified Action Config

  • Replaced action: kick/log/both with simple kick: true/false
  • Detections are now ALWAYS logged regardless of kick setting
  • Cleaner config, same functionality

• Smarter Detection Logging

  • Only creates new JSON entry when player's modlist changes
  • Returning players with same mods just add session info to existing entry
  • Reduces file size and improves readability

• Separated Mods and Channels

  • mods field now contains resolved mod names (e.g., "Simple Voice Chat")
  • channels field now only contains unrecognized/unknown channels
  • /md info command updated to show both sections separately

• Internal Improvements

  • Replaced manual JSON parsing with Gson library
  • Atomic file writes (write to .tmp, then move) prevents corruption
  • Batched I/O with 30-second flush interval reduces disk writes
  • Memory cleanup task removes stale player data every 5 minutes
  • Proper shutdown handling ensures pending writes are flushed

Fixed

• Console no longer shows TextComponentImpl{...} blobs for admin notifications

Example Detection Entry

{
  "uuid": "f999e944-a15d-4287-bff4-34f63a97832e",
  "username": "PlayerName",
  "mods": ["Simple Voice Chat", "Noxesium", "AppleSkin", "Fabric API"],
  "channels": ["civ:handshake", "civ:class_xp"],
  "firstSeen": "2026-01-16T17:28:01Z",
  "lastSeen": "2026-01-16T17:32:04Z",
  "totalTimePlayedSeconds": 243,
  "sessionCount": 2,
  "sessions": [
    {"joinTime": "2026-01-16T17:27:59Z", "leaveTime": "2026-01-16T17:28:01Z", "durationSeconds": 2},
    {"joinTime": "2026-01-16T17:29:20Z", "leaveTime": "2026-01-16T17:32:04Z", "durationSeconds": 241}
  ]
}

Velocity

Added

• Log All Channels Mode

  • New log-all-channels config option to log ALL channel registrations to file
  • Tracks every mod channel a player registers, not just blocked ones
  • No console logging for better performance

• /md info <player> Command

  • View all registered channels for a specific player
  • Shows current session channels and historical data
  • Color-coded output: red = blocked, green = allowed
  • Displays resolved mod names alongside raw channel strings

• /md discovered Command

  • Lists all unique channels ever discovered on the server
  • Useful for documentation and discovering new mods
  • Persists across server restarts

• Discovered Channels File

  • New discovered-channels.json file tracks all unique channels ever seen
  • JSON array format for easy parsing
  • Automatically updated when new channels are registered

• Smart Mod Name Resolution

  • Channel-to-mod resolution now works for ALL mods in mods.yml, not just blocked ones
  • Detection logs show pretty mod names (e.g., "Simple Voice Chat" instead of "voicechat:state")
  • Unknown channels remain as raw strings for identification

Changed

• Consolidated Player Entries

  • detections.json now uses one entry per player (updated in place)
  • Multiple channels from the same mod are grouped together
  • Format changed from "channels" to "mods" array with resolved names

• /md players Command

  • Now shows all registered channels when log-all-channels is enabled
  • Displays channel count per player
  • Added hint to use /md info <player> for details

• /md status Command

  • Now shows Log All Channels setting status

• Help Command

  • Updated to show all new commands
  • Commands now displayed with /md shorthand

Example Detection Entry

{"uuid":"f999e944-a15d-4287-bff4-34f63a97832e","username":"PlayerName","mods":["AppleSkin","Simple Voice Chat","Noxesium","Flashback","civ:class_xp"],"lastSeen":"2026-01-16T12:00:00Z"}

Example Discovered Channels

[
  "xaerominimap:main",
  "voicechat:state",
  "noxesium-v2:server_info",
  "fabric:registry/sync"
]

Velocity