🧠 StaffMonitor

[!(https://wsrv.nl/?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fnpm%2F%40intergrav%2Fdevins-badges%403%2Fassets%2Fcozy%2Fdonate%2Fkofi-singular_vector.svg&n=-1)](https://ko-fi.com/alekkss_/tip)

# 🧠 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.

!(https://cdn.modrinth.com/data/cached_images/500cfaeb041b64b9c7e55601fee15a36174dc514.png)

## 🚀 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 ```

!(https://cdn.modrinth.com/data/cached_images/2edc0c21d03d23287c9c776902cb2360fd8575eb.png)

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

!(https://cdn.modrinth.com/data/cached_images/f5751ffbffd044be74b71ff9f4396ff24fe4beb9.png)

## ⚙️ 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.