Mod Detector Plugin

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