StaffMonitor

🧠 StaffMonitor – Advanced Staff Activity Tracking Plugin

StaffMonitor is a modern, high-performance Minecraft plugin designed to fully track staff activity with real-time playtime monitoring, detailed session logging, and a sleek GUI-based interface.

Built for scalability and optimized for large servers, it uses asynchronous database operations (SQLite/MySQL) and a clean modular architecture to ensure zero lag.

🚀 CORE FEATURES

👨‍💼 Permission-Based Staff Detection

A player is only considered staff if they have the following permission:

StaffMonitor.staff

• Full LuckPerms integration
• Automatic validation on join
• Secure and abuse-resistant tracking system

⏱️ REAL-TIME PLAYTIME TRACKING

StaffMonitor tracks staff activity in real time:

Tracking starts automatically when a player receives staff permission Tracking stops when permission is removed or player leaves Live updating playtime system (no delays or resets)

📊 Time formats supported:

• seconds
• minutes
• hours
• days

Example:

1h 24m 32s

📊 ADVANCED SESSION SYSTEM

Every staff session is fully recorded:

• login timestamp
• logout timestamp
• session duration

• Complete session history
• Configurable session limit (e.g. last 10 sessions)
• Detailed session viewer in GUI

📅 PLAYTIME CATEGORIES

Staff activity is automatically grouped into:

• 🟢 Daily
• 🔵 Weekly
• 🟣 Monthly
• 🟡 Total (never resets)

• Automatic resets based on time cycles
• Historical data preservation system

🖥️ MODERN GUI SYSTEM

Open staff statistics using:

/staffmonitor <player>

🎨 Features:

• player head with real skin
• online/offline status indicator
• interactive filter buttons:
  • Today
  • Week
  • Month
  • All Time

• Dynamic selection highlighting
• Instant data refresh when switching filters
• Clean, symmetrical, professional design

📜 SESSION HISTORY GUI

• displays recent sessions visually
• detailed session breakdown:
  • start time
  • end time
  • duration

• Clickable entries for deeper details
• Scalable for large datasets

⚙️ AUTO SAVE SYSTEM

• configurable save intervals
• automatic data persistence
• async saving (no server lag)
• prevents data loss on crash

🔄 RELOAD COMMAND

/staffmonitor reload

• reloads config.yml
• reloads language.yml
• no server restart required

💾 DATABASE SUPPORT

Supported databases:

• SQLite (default)
• MySQL (optional)

Staff Data:

• UUID
• player name
• total playtime
• daily / weekly / monthly playtime
• last join / last quit

Session Data:

• UUID
• join timestamp
• quit timestamp
• duration

⚙️ CONFIGURATION

Fully customizable via config.yml:

• database type (SQLite/MySQL)
• auto-save interval
• session history limit
• GUI titles and messages

🌐 LANGUAGE SUPPORT

All messages are configurable in language.yml:

• player not found
• not staff
• no permission

🔐 PERMISSIONS

Command permission:

StaffMonitor.use

Staff tracking permission:

StaffMonitor.staff

⚡ PERFORMANCE

• fully asynchronous database operations
• UUID-based tracking system
• thread-safe design
• optimized for large servers
• no main-thread blocking

🚀 Requirements

• Paper / Spigot 1.20+
• Java 17+
• Server-side only (no client mods required)

🎯 FINAL GOAL

StaffMonitor provides a complete professional solution for:

• tracking staff activity in real time
• detailed session logging
• structured playtime analytics
• modern GUI-based inspection
• efficient staff management tools

❤️ Support

If you need help or want to suggest features, feel free to reach out.