🧠 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/Bukkit 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.
