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