? StaffMonitor

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper spigot

标签： management social utility

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