**\u00a0\ud83d\udcd8 UltimateStaffManagement – Complete Documentation<\/p>\n
—<\/p>\n
\u00a0\ud83c\udfaf Plugin Overview<\/p>\n
\u00a0What is UltimateStaffManagement?<\/p>\n
**UltimateStaffManagement** is an enterprise-grade staff time tracking plugin designed specifically for Minecraft Paper servers running versions 1.21 through 1.21.11. It provides server administrators with powerful tools to monitor, analyze, and manage staff member activity with precision and ease.<\/p>\n
Unlike basic time-tracking solutions, UltimateStaffManagement intelligently differentiates between **active work time** and **idle\/AFK time**, giving you accurate insights into actual staff productivity rather than just login duration.<\/p>\n
—<\/p>\n
\u00a0\ud83c\udf1f Key Features (Complete List)<\/p>\n
\u00a01\ufe0f\u20e3 Intelligent Session Management<\/p>\n
\u00a0Automatic Session Tracking
\n– **Auto Clock-In:** Sessions start automatically when players with `usm.track` permission join the server
\n– **Auto Clock-Out:** Sessions end gracefully when players disconnect or when the server shuts down
\n– **Manual Override:** Staff can manually clock in\/out using commands for flexible scheduling
\n– **Session Persistence:** All active sessions are immediately saved during unexpected server crashes
\n– **Multi-Session Support:** Tracks unlimited historical sessions per player<\/p>\n
\u00a0Session Data Captured
\n“`yaml
\nFor Each Session:
\n\u00a0 \u251c\u2500\u2500 Unique Session ID
\n\u00a0 \u251c\u2500\u2500 Player UUID & Name
\n\u00a0 \u251c\u2500\u2500 Start Timestamp (millisecond precision)
\n\u00a0 \u251c\u2500\u2500 End Timestamp (millisecond precision)
\n\u00a0 \u251c\u2500\u2500 Total Active Time (milliseconds)
\n\u00a0 \u251c\u2500\u2500 Total Idle Time (milliseconds)
\n\u00a0 \u251c\u2500\u2500 Session Notes (timestamped entries)
\n\u00a0 \u2514\u2500\u2500 Activity Percentage Calculation
\n“`<\/p>\n
—<\/p>\n
\u00a02\ufe0f\u20e3 Advanced AFK\/Activity Detection<\/p>\n
\u00a0Movement-Based Detection
\nThe plugin uses a sophisticated multi-factor detection system:<\/p>\n
**Tracked Parameters:**
\n– **X, Y, Z Coordinates** – Detects physical movement (0.1 block precision)
\n– **Yaw (Head Rotation Horizontal)** – Tracks left\/right head movement (1\u00b0 precision)
\n– **Pitch (Head Rotation Vertical)** – Tracks up\/down head movement (1\u00b0 precision)
\n– **World Changes** – Instant detection of teleportation\/dimension changes<\/p>\n
**Detection Algorithm:**
\n“`java
\nMovement Detected IF:
\n\u00a0 \u251c\u2500\u2500 X\/Y\/Z change > 0.1 blocks OR
\n\u00a0 \u251c\u2500\u2500 Yaw change > 1.0 degrees OR
\n\u00a0 \u251c\u2500\u2500 Pitch change > 1.0 degrees OR
\n\u00a0 \u2514\u2500\u2500 World change detected<\/p>\n
Status Update:
\n\u00a0 \u251c\u2500\u2500 ACTIVE: Any movement detected within timeout period
\n\u00a0 \u2514\u2500\u2500 IDLE: No movement for configured duration (default: 600 seconds)
\n“`<\/p>\n
\u00a0Time Tracking Mechanism
\n– **Tick Rate:** Checks every 20 ticks (1 second) for optimal performance
\n– **Time Accumulation:** Every second adds 1000ms to either active or idle counter
\n– **Real-Time Updates:** Status changes are reflected immediately in GUIs
\n– **Configurable Thresholds:** Fully customizable sensitivity settings<\/p>\n
—<\/p>\n
\u00a03\ufe0f\u20e3 Enterprise Database Management<\/p>\n
\u00a0SQLite Support (Default)<\/p>\n
**Advantages:**
\n– \u2705 **Zero Configuration:** Works immediately after installation
\n– \u2705 **Portable:** Single database file, easy to backup
\n– \u2705 **No Dependencies:** No external database server required
\n– \u2705 **WAL Mode:** Write-Ahead Logging for data integrity
\n– \u2705 **Automatic Backups:** Daily backup rotation (configurable)<\/p>\n
“`<\/p>\n
\u00a0MySQL Support (Optional)<\/p>\n
**Perfect For:**
\n– Multi-server networks (BungeeCord\/Velocity)
\n– Centralized data management
\n– Advanced querying and reporting
\n– Large player bases (500+ concurrent)<\/p>\n
**Configuration Example:**
\n“`yaml
\nstorage-type: mysql<\/p>\n
mysql:
\n\u00a0 host: db.yournetwork.com
\n\u00a0 port: 3306
\n\u00a0 database: staff_tracking
\n\u00a0 username: minecraft
\n\u00a0 password: securePassword123
\n\u00a0\u00a0
\n\u00a0 pool:
\n\u00a0 \u00a0 maximum-pool-size: 10 \u00a0 \u00a0 \u00a0 Max concurrent connections
\n\u00a0 \u00a0 minimum-idle: 2 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Idle connections maintained
\n\u00a0 \u00a0 connection-timeout: 30000 \u00a0 \u00a030 seconds
\n\u00a0 \u00a0 idle-timeout: 600000 \u00a0 \u00a0 \u00a0 \u00a0 10 minutes
\n\u00a0 \u00a0 max-lifetime: 1800000 \u00a0 \u00a0 \u00a0 \u00a030 minutes
\n\u00a0\u00a0
\n\u00a0 use-ssl: true \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Encrypted connections
\n“`<\/p>\n
\u00a0HikariCP Connection Pooling<\/p>\n
**Performance Benefits:**
\n– \u26a1 **Sub-millisecond connection acquisition**
\n– \ud83d\udd04 **Automatic connection recycling**
\n– \ud83d\udee1\ufe0f **Connection leak detection**
\n– \ud83d\udcca **Real-time pool statistics**
\n– \ud83d\udd27 **Configurable pool sizing**<\/p>\n
**Async Architecture:**
\n“`
\nPlayer Action
\n\u00a0 \u00a0 \u2193
\nMain Thread (No Blocking)
\n\u00a0 \u00a0 \u2193
\nAsync Task Queue
\n\u00a0 \u00a0 \u2193
\nHikariCP Thread Pool
\n\u00a0 \u00a0 \u2193
\nDatabase Operation
\n\u00a0 \u00a0 \u2193
\nCallback to Main Thread
\n\u00a0 \u00a0 \u2193
\nResult Displayed
\n“`<\/p>\n
\u00a05\ufe0f\u20e3 Comprehensive Command System<\/p>\n
\u00a0Player Commands (Detailed)<\/p>\n
\u00a0`\/stafftime` (Main Dashboard)
\n“`yaml
\nPermission: usm.use
\nAliases: \/st, \/clock, \/staffclock<\/p>\n
Usage: \/stafftime<\/p>\n
Description:
\n\u00a0 Opens the main interactive dashboard GUI showing:
\n\u00a0 – Current session statistics
\n\u00a0 – Real-time activity status
\n\u00a0 – Quick access to history and notes<\/p>\n
Behavior:
\n\u00a0 \u251c\u2500\u2500 If Active Session: Shows live stats
\n\u00a0 \u251c\u2500\u2500 If No Session: Displays “Not clocked in” with instructions
\n\u00a0 \u2514\u2500\u2500 Permission Check: Requires usm.use<\/p>\n
Sound Effect: BLOCK_CHEST_OPEN (0.5 volume)<\/p>\n
Example Output: [Opens 9-slot GUI]
\n“`<\/p>\n
\u00a0`\/stafftime clockin` (Manual Session Start)
\n“`yaml
\nPermission: usm.use
\nAliases: \/st clockin, \/clock in<\/p>\n
Usage: \/stafftime clockin<\/p>\n
Description:
\n\u00a0 Manually starts a new time tracking session for the player.
\n\u00a0 Useful for staff who don’t have auto-tracking enabled.<\/p>\n
Validation Checks:
\n\u00a0 \u251c\u2500\u2500 Already has session? \u2192 Error message
\n\u00a0 \u251c\u2500\u2500 Permission check: usm.use
\n\u00a0 \u2514\u2500\u2500 Player-only command<\/p>\n
Success Message:
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 \u2713 Clock-In Successful”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “Your work session has started.”
\n\u00a0 “Session will be tracked until you clock out or disconnect.”
\n\u00a0 “”
\n\u00a0 “View your stats: \/stafftime”<\/p>\n
Sound Effect: BLOCK_NOTE_BLOCK_PLING (1.0 volume, 2.0 pitch)<\/p>\n
Database Action: Creates new session record (async)
\n“`<\/p>\n
\u00a0`\/stafftime clockout` (Manual Session End)
\n“`yaml
\nPermission: usm.use
\nAliases: \/st clockout, \/clock out<\/p>\n
Usage: \/stafftime clockout<\/p>\n
Description:
\n\u00a0 Manually ends the current active session and displays
\n\u00a0 a detailed summary of the work period.<\/p>\n
Validation Checks:
\n\u00a0 \u251c\u2500\u2500 No active session? \u2192 Error message
\n\u00a0 \u251c\u2500\u2500 Permission check: usm.use
\n\u00a0 \u2514\u2500\u2500 Player-only command<\/p>\n
Success Output:
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 \u2713 Clock-Out Successful”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “”
\n\u00a0 “Session Summary:”
\n\u00a0 “”
\n\u00a0 ” \u00a0\u26a1 Active Time: 2h 15m 30s”
\n\u00a0 ” \u00a0\u23f8 Idle Time: 18m 42s”
\n\u00a0 ” \u00a0\u23f1 Total Time: 2h 34m 12s”
\n\u00a0 ” \u00a0\ud83d\udcca Activity: 87.5%”
\n\u00a0 “”
\n\u00a0 “Your session has been saved to the database.”<\/p>\n
Sound Effect: ENTITY_EXPERIENCE_ORB_PICKUP<\/p>\n
Database Actions:
\n\u00a0 \u251c\u2500\u2500 Save session to usm_sessions table
\n\u00a0 \u251c\u2500\u2500 Update user totals in usm_users table
\n\u00a0 \u2514\u2500\u2500 Remove from active sessions cache
\n“`<\/p>\n
\u00a0`\/stafftime addnote Usage: \/stafftime addnote Description: Validation Checks: Note Format: Success Message: Sound Effect: ENTITY_ITEM_PICKUP (0.5 volume, 1.5 pitch)<\/p>\n Use Cases: —<\/p>\n \u00a0Admin Commands (Detailed)<\/p>\n \u00a0`\/stafftime top [days]` (Leaderboard) Usage:\u00a0 Description: Parameters: Output Format: Medal Icons: Database Query: Processing: Async (displays loading message) \u00a0`\/stafftime list` (Live Staff Monitor) Usage: \/stafftime list<\/p>\n Description: GUI Features: Console Output: Use Cases: \u00a0`\/stafftime adjust Usage:\u00a0 Examples: Parameters: Time Conversions: Validation: Confirmation Display: Logging: Use Cases: —<\/p>\n \u00a06\ufe0f\u20e3 Permission System (Complete)<\/p>\n \u00a0Permission Hierarchy Tree \u00a0Permission Descriptions<\/p>\n **usm.*** (Parent Permission) Grant Command (LuckPerms): Use Case: Server owners and senior administrators **usm.use** (Basic Access) Does NOT Allow: Grant Command: Use Case: All players (for personal time tracking) **usm.track** (Auto-Tracking) Grant Command: Use Case: ONLY grant to actual staff members<\/p>\n Example Setup: **usm.admin** (Admin Commands) Does NOT Allow: Grant Command: Use Case: Server moderators and administrators **usm.adjust** (Time Modification) Security Warning: Grant Command: Use Case: Senior admins for corrections only \u00a0Recommended Permission Setups<\/p>\n **Setup 1: Small Server (10-50 players)** Staff Group (Moderators): Admin Group (Administrators): Commands: **Setup 2: Large Network (100+ players)** Commands: \u00a0PlaceholderAPI Support (Planned v1.1)<\/p>\n **Planned Placeholders:** Usage Example (Scoreboard): \u00a01\ufe0f\u20e32\ufe0f\u20e3 Support & Resources<\/p>\n \u00a0Official Resources<\/p>\n **\ud83d\udc1b Bug Reporting:** —<\/p>\n \u00a01\ufe0f\u20e33\ufe0f\u20e3 Technical Specifications<\/p>\n **Plugin Information:** Dependencies: File Size: Performance: A plugin to track your working cycle of your staffs……<\/p>\n","protected":false},"featured_media":161598,"template":"","meta":{"_minecraft_slug":"ultimatestaffmanagement","_minecraft_project_id":"ROhPGyKn","_minecraft_author":"geturplugins","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":31,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ultimatestaffmanagement.zip","_minecraft_size_bytes":18669659,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:02:12.886908Z","_minecraft_date_created":"2026-02-15T06:04:39.649515Z","_minecraft_date_modified":"2026-02-12T06:19:56.643525Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ultimatestaffmanagement","_minecraft_icon_attachment_id":161598,"_minecraft_imported_at":"2026-06-09T15:33:14+00:00","_minecraft_import_hash":"ca231cc764c80b3d8aa0da2edfbe7493","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,123],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-161597","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-technology","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`yaml
\nPermission: usm.use
\nAliases: \/st addnote, \/clock note<\/p>\n
\nExample: \/stafftime addnote Handled 5 player reports<\/p>\n
\n\u00a0 Adds a timestamped note to the current active session.
\n\u00a0 Notes are saved with the session and visible in history.<\/p>\n
\n\u00a0 \u251c\u2500\u2500 No active session? \u2192 Error message
\n\u00a0 \u251c\u2500\u2500 Message empty? \u2192 Show usage
\n\u00a0 \u251c\u2500\u2500 Message > 200 chars? \u2192 Error message
\n\u00a0 \u251c\u2500\u2500 Notes > 50 per session? \u2192 Error message
\n\u00a0 \u2514\u2500\u2500 Permission check: usm.use<\/p>\n
\n\u00a0 Stored: “[14:35:22] Handled 5 player reports”
\n\u00a0 Timestamp: HH:mm:ss format (configurable)<\/p>\n
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 \ud83d\udcdd Note Added”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “”
\n\u00a0 “Note: Handled 5 player reports”
\n\u00a0 “”
\n\u00a0 “This note will be saved with your session.”<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Document player reports handled
\n\u00a0 \u251c\u2500\u2500 Record ban appeals reviewed
\n\u00a0 \u251c\u2500\u2500 Note server events assisted
\n\u00a0 \u251c\u2500\u2500 Log important decisions made
\n\u00a0 \u2514\u2500\u2500 Track tickets resolved
\n“`<\/p>\n
\n“`yaml
\nPermission: usm.admin
\nAliases: \/st top, \/clock leaderboard<\/p>\n
\n\u00a0 \/stafftime top \u00a0 \u00a0 \u00a0 \u00a0 \u00a0(defaults to 7 days)
\n\u00a0 \/stafftime top 30 \u00a0 \u00a0 \u00a0 (last 30 days)
\n\u00a0 \/stafftime top 1 \u00a0 \u00a0 \u00a0 \u00a0(last 24 hours)<\/p>\n
\n\u00a0 Displays a ranked leaderboard of staff members by
\n\u00a0 ACTIVE time (idle time excluded) for the specified period.<\/p>\n
\n\u00a0 \u251c\u2500\u2500 days: Integer (1-365)
\n\u00a0 \u251c\u2500\u2500 Default: 7 days
\n\u00a0 \u2514\u2500\u2500 Shows top 10 results<\/p>\n
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 \ud83c\udfc6 Top Staff – Last 7 Days”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “”
\n\u00a0 “\ud83e\udd47 1 PlayerOne – 45h 30m 15s”
\n\u00a0 “\ud83e\udd48 2 PlayerTwo – 38h 15m 42s”
\n\u00a0 “\ud83e\udd49 3 PlayerThree – 32h 45m 10s”
\n\u00a0 ” \u00a0 4 PlayerFour – 28h 20m 30s”
\n\u00a0 ” \u00a0 5 PlayerFive – 25h 55m 18s”
\n\u00a0 ” \u00a0 6 PlayerSix – 22h 10m 45s”
\n\u00a0 ” \u00a0 7 PlayerSeven – 20h 30m 22s”
\n\u00a0 ” \u00a0 8 PlayerEight – 18h 45m 50s”
\n\u00a0 ” \u00a0 9 PlayerNine – 15h 20m 12s”
\n\u00a0 ” \u00a0 10 PlayerTen – 12h 35m 40s”
\n\u00a0 “”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “Showing top 10 staff members”<\/p>\n
\n\u00a0 \u251c\u2500\u2500 \ud83e\udd47 1st Place (Gold)
\n\u00a0 \u251c\u2500\u2500 \ud83e\udd48 2nd Place (Silver)
\n\u00a0 \u2514\u2500\u2500 \ud83e\udd49 3rd Place (Bronze)<\/p>\n
\n\u00a0 SELECT u.name, SUM(s.active_millis) as total
\n\u00a0 FROM usm_sessions s
\n\u00a0 JOIN usm_users u ON s.uuid = u.uuid
\n\u00a0 WHERE s.start_timestamp >= [cutoff]
\n\u00a0 GROUP BY s.uuid
\n\u00a0 ORDER BY total DESC
\n\u00a0 LIMIT 10<\/p>\n
\n“`<\/p>\n
\n“`yaml
\nPermission: usm.admin
\nAliases: \/st list, \/clock active<\/p>\n
\n\u00a0 For players: Opens an interactive GUI with player heads
\n\u00a0 For console: Displays formatted chat list<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Player heads with skins
\n\u00a0 \u251c\u2500\u2500 Real-time status indicators
\n\u00a0 \u251c\u2500\u2500 Session duration displays
\n\u00a0 \u251c\u2500\u2500 Activity percentages (color-coded)
\n\u00a0 \u251c\u2500\u2500 Note counts
\n\u00a0 \u2514\u2500\u2500 Manual refresh button<\/p>\n
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 \ud83d\udccb Currently Active Staff”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “”
\n\u00a0 “1. PlayerOne – 2h 34m (Activity: 92.3%)”
\n\u00a0 ” \u00a0 Active: 2h 15m | Idle: 18m”
\n\u00a0 “”
\n\u00a0 “2. PlayerTwo – 1h 45m (Activity: 78.5%)”
\n\u00a0 ” \u00a0 Active: 1h 22m | Idle: 22m”
\n\u00a0 “”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “Total: 2 staff member(s) active”<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Monitor current staff availability
\n\u00a0 \u251c\u2500\u2500 Check who’s actively working
\n\u00a0 \u251c\u2500\u2500 Identify idle staff members
\n\u00a0 \u251c\u2500\u2500 Plan shift coverage
\n\u00a0 \u2514\u2500\u2500 Performance oversight
\n“`<\/p>\n
\n“`yaml
\nPermission: usm.admin (requires usm.adjust)
\nAliases: \/st adjust, \/clock modify<\/p>\n
\n\u00a0 \/stafftime adjust
\n\u00a0 \/stafftime adjust Steve add 3600000 active
\n\u00a0 \u00a0 \u2192 Adds 1 hour to Steve’s active time
\n\u00a0\u00a0
\n\u00a0 \/stafftime adjust Alex remove 1800000 idle
\n\u00a0 \u00a0 \u2192 Removes 30 minutes from Alex’s idle time
\n\u00a0\u00a0
\n\u00a0 \/stafftime adjust Bob add 7200000 active
\n\u00a0 \u00a0 \u2192 Adds 2 hours to Bob’s active time<\/p>\n
\n\u00a0 \u251c\u2500\u2500 player: Player name (online or offline)
\n\u00a0 \u251c\u2500\u2500 operation: “add” or “remove”
\n\u00a0 \u251c\u2500\u2500 amount: Milliseconds (1 hour = 3600000)
\n\u00a0 \u2514\u2500\u2500 type: “active” or “idle”<\/p>\n
\n\u00a0 \u251c\u2500\u2500 1 minute \u00a0= 60,000 ms
\n\u00a0 \u251c\u2500\u2500 5 minutes = 300,000 ms
\n\u00a0 \u251c\u2500\u2500 10 minutes = 600,000 ms
\n\u00a0 \u251c\u2500\u2500 30 minutes = 1,800,000 ms
\n\u00a0 \u251c\u2500\u2500 1 hour = 3,600,000 ms
\n\u00a0 \u251c\u2500\u2500 2 hours = 7,200,000 ms
\n\u00a0 \u2514\u2500\u2500 24 hours = 86,400,000 ms<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Player exists check
\n\u00a0 \u251c\u2500\u2500 Amount > 0 check
\n\u00a0 \u251c\u2500\u2500 Valid operation check
\n\u00a0 \u251c\u2500\u2500 Valid type check
\n\u00a0 \u2514\u2500\u2500 Permission verification<\/p>\n
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 ” \u00a0 Time Adjustment”
\n\u00a0 “\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550”
\n\u00a0 “”
\n\u00a0 “Player: Steve”
\n\u00a0 “Operation: ADD”
\n\u00a0 “Amount: 1h 0m 0s”
\n\u00a0 “Type: ACTIVE”
\n\u00a0 “”
\n\u00a0 “\u23f3 Processing adjustment…”
\n\u00a0 “\u2713 Time adjustment applied successfully!”<\/p>\n
\n\u00a0 Logs to console:
\n\u00a0 “[ADJUST] AdminName added 1h 0m 0s active time for Steve”<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Correct tracking errors
\n\u00a0 \u251c\u2500\u2500 Compensate for server downtime
\n\u00a0 \u251c\u2500\u2500 Reward bonus time
\n\u00a0 \u251c\u2500\u2500 Fix database issues
\n\u00a0 \u2514\u2500\u2500 Manual corrections
\n“`<\/p>\n
\n“`
\nusm.* (OP)
\n\u2502
\n\u251c\u2500 usm.use (TRUE) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 \u00a0\u251c\u2500 usm.clockin \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502 PLAYER
\n\u2502 \u00a0\u251c\u2500 usm.clockout \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502 PERMISSIONS
\n\u2502 \u00a0\u251c\u2500 usm.addnote \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502
\n\u2502 \u00a0\u2514\u2500 usm.history \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2502
\n\u2502 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502
\n\u251c\u2500 usm.track (FALSE) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524 STAFF
\n\u2502 \u00a0\u2514\u2500 [Enables auto-tracking] \u00a0 \u00a0 \u00a0\u2502 PERMISSION
\n\u2502 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2502
\n\u2514\u2500 usm.admin.* (OP) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n\u00a0 \u00a0\u251c\u2500 usm.admin
\n\u00a0 \u00a0\u251c\u2500 usm.top
\n\u00a0 \u00a0\u251c\u2500 usm.list
\n\u00a0 \u00a0\u2514\u2500 usm.adjust
\n“`<\/p>\n
\n“`yaml
\nDescription: Grants all plugin permissions
\nDefault: OP only
\nChildren:
\n\u00a0 – usm.use
\n\u00a0 – usm.track
\n\u00a0 – usm.admin
\n\u00a0 – usm.adjust<\/p>\n
\n\u00a0 \/lp user
\n“`<\/p>\n
\n“`yaml
\nDescription: Access to dashboard and basic commands
\nDefault: True (all players)
\nAllows:
\n\u00a0 – \/stafftime (dashboard)
\n\u00a0 – \/stafftime clockin
\n\u00a0 – \/stafftime clockout
\n\u00a0 – \/stafftime addnote<\/p>\n
\n\u00a0 – Auto-tracking on join
\n\u00a0 – Admin commands<\/p>\n
\n\u00a0 \/lp group default permission set usm.use true<\/p>\n
\n“`<\/p>\n
\n“`yaml
\nDescription: Enables automatic session tracking
\nDefault: False (must be granted)
\nBehavior:
\n\u00a0 – Auto clock-in on join
\n\u00a0 – Auto clock-out on quit
\n\u00a0 – Requires usm.use permission also<\/p>\n
\n\u00a0 \/lp user
\n\u00a0 1. Create staff group: \/lp creategroup staff
\n\u00a0 2. Grant tracking: \/lp group staff permission set usm.track true
\n\u00a0 3. Add user: \/lp user PlayerName parent add staff
\n“`<\/p>\n
\n“`yaml
\nDescription: Access to administrative features
\nDefault: OP only
\nAllows:
\n\u00a0 – \/stafftime top
\n\u00a0 – \/stafftime list
\n\u00a0 – View all player data<\/p>\n
\n\u00a0 – Time adjustments (requires usm.adjust)<\/p>\n
\n\u00a0 \/lp user
\n“`<\/p>\n
\n“`yaml
\nDescription: Ability to modify player time records
\nDefault: OP only
\nAllows:
\n\u00a0 – \/stafftime adjust command
\n\u00a0 – Add\/remove time from any player<\/p>\n
\n\u00a0 Only grant to highly trusted administrators!<\/p>\n
\n\u00a0 \/lp user
\n“`<\/p>\n
\n“`yaml
\nDefault Group (All Players):
\n\u00a0 – usm.use: true<\/p>\n
\n\u00a0 – Inherits: default
\n\u00a0 – usm.track: true<\/p>\n
\n\u00a0 – Inherits: staff
\n\u00a0 – usm.admin: true
\n\u00a0 – usm.adjust: true<\/p>\n
\n\u00a0 \/lp creategroup staff
\n\u00a0 \/lp group staff parent add default
\n\u00a0 \/lp group staff permission set usm.track true
\n\u00a0\u00a0
\n\u00a0 \/lp creategroup admin
\n\u00a0 \/lp group admin parent add staff
\n\u00a0 \/lp group admin permission set usm.admin true
\n\u00a0 \/lp group admin permission set usm.adjust true
\n“`<\/p>\n
\n“`yaml
\nGroups:
\n\u00a0 default:
\n\u00a0 \u00a0 – No USM permissions (not tracked)
\n\u00a0\u00a0
\n\u00a0 helper:
\n\u00a0 \u00a0 – usm.use: true
\n\u00a0 \u00a0 – usm.track: true
\n\u00a0\u00a0
\n\u00a0 moderator:
\n\u00a0 \u00a0 – Inherits: helper
\n\u00a0 \u00a0 – usm.admin: true
\n\u00a0\u00a0
\n\u00a0 admin:
\n\u00a0 \u00a0 – Inherits: moderator
\n\u00a0 \u00a0 – usm.adjust: true
\n\u00a0\u00a0
\n\u00a0 owner:
\n\u00a0 \u00a0 – usm.*: true<\/p>\n
\n\u00a0 \/lp creategroup helper
\n\u00a0 \/lp group helper permission set usm.use true
\n\u00a0 \/lp group helper permission set usm.track true
\n\u00a0\u00a0
\n\u00a0 \/lp creategroup moderator
\n\u00a0 \/lp group moderator parent add helper
\n\u00a0 \/lp group moderator permission set usm.admin true
\n\u00a0\u00a0
\n\u00a0 \/lp creategroup admin
\n\u00a0 \/lp group admin parent add moderator
\n\u00a0 \/lp group admin permission set usm.adjust true
\n“`
\n\u00a0\ud83d\udd1f Integration & API<\/p>\n
\n“`yaml
\n%usm_session_duration% \u00a0 \u00a0 \u00a0 \u00a0\u2192 “2h 34m 12s”
\n%usm_session_active% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2192 “2h 15m 30s”
\n%usm_session_idle% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2192 “18m 42s”
\n%usm_session_activity% \u00a0 \u00a0 \u00a0 \u00a0\u2192 “87.5%”
\n%usm_session_status% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2192 “Active” \/ “Idle”
\n%usm_total_active% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2192 “145h 30m 15s”
\n%usm_total_idle% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\u2192 “12h 45m 20s”
\n%usm_rank_position% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2192 “3”
\n%usm_notes_count% \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u2192 “5”<\/p>\n
\n\u00a0 – &aSession: &f%usm_session_duration%
\n\u00a0 – &aStatus: &f%usm_session_status%
\n\u00a0 – &aActivity: &f%usm_session_activity%
\n“`<\/p>\n
\n– [Discord](geturplugins)<\/p>\n
\n“`yaml
\nName: UltimateStaffManagement
\nVersion: 1.0.0
\nAuthor: geturplugins
\nLicense: AllRightsReserved
\nLanguage: Java 21<\/p>\n
\n\u00a0 \u251c\u2500\u2500 Paper API: 1.21-1.21.11 (Required)
\n\u00a0 \u251c\u2500\u2500 HikariCP: 5.1.0 (Bundled)
\n\u00a0 \u251c\u2500\u2500 SQLite JDBC: 3.45.1.0 (Bundled)
\n\u00a0 \u251c\u2500\u2500 MySQL Connector: 8.3.0 (Optional)
\n\u00a0 \u2514\u2500\u2500 Adventure API: 4.x (Provided by Paper)<\/p>\n
\n\u00a0 \u251c\u2500\u2500 JAR Size: ~1.5 MB
\n\u00a0 \u251c\u2500\u2500 With Dependencies: ~3.2 MB
\n\u00a0 \u2514\u2500\u2500 Database (SQLite): Grows ~50KB per 1000 sessions<\/p>\n
\n\u00a0 \u251c\u2500\u2500 RAM Usage: 30-50MB (100 active sessions)
\n\u00a0 \u251c\u2500\u2500 CPU Impact: < 0.1% per 50 tracked players\n\u00a0 \u251c\u2500\u2500 TPS Impact: None (async operations)\n\u00a0 \u2514\u2500\u2500 Database Speed: < 10ms per query (SSD)\n\nCompatibility:\n\u00a0 \u2705 Paper 1.21 - 1.21.11\n\u00a0 \u2705 Purpur 1.21+\n\u00a0 \u26a0\ufe0f \u00a0Spigot 1.21 (Limited Adventure API)\n\u00a0 \u274c Bukkit (Not supported)\n\u00a0 \u274c Folia (Not yet supported)\n```\n\n---\n\n**\ud83d\udcca Statistics (Example Server)**\n\n**Server Profile:**\n- Type: Roleplay Server\n- Players: 150 concurrent\n- Staff: 25 tracked members\n- Database: MySQL\n- Uptime: 99.8%\n\n**Results:**\n```yaml\nPerformance Metrics:\n\u00a0 \u251c\u2500\u2500 Average Session Length: 3h 15m\n\u00a0 \u251c\u2500\u2500 Total Sessions Tracked: 12,450\n\u00a0 \u251c\u2500\u2500 Database Size: 145 MB\n\u00a0 \u251c\u2500\u2500 Query Response Time: < 5ms\n\u00a0 \u2514\u2500\u2500 Zero TPS impact\n\nStaff Insights:\n\u00a0 \u251c\u2500\u2500 Most Active Staff: 45h\/week\n\u00a0 \u251c\u2500\u2500 Average Activity Rate: 82.3%\n\u00a0 \u251c\u2500\u2500 Total Hours Tracked: 15,230h\n\u00a0 \u2514\u2500\u2500 Notes Recorded: 3,847\n\nResource Usage:\n\u00a0 \u251c\u2500\u2500 Plugin RAM: 42 MB\n\u00a0 \u251c\u2500\u2500 Database Connections: 8 active\n\u00a0 \u251c\u2500\u2500 Thread Pool: 4 threads\n\u00a0 \u2514\u2500\u2500 CPU Usage: 0.08%\n```\n\n---\n\n\u00a0\ud83c\udf93 Summary\n\n**UltimateStaffManagement** is the most comprehensive staff tracking solution for Minecraft servers, offering:\n\n\u2705 **Precision Tracking** - Millisecond-accurate time tracking with active\/idle differentiation \u00a0\n\u2705 **Zero Performance Impact** - Fully asynchronous operations with HikariCP pooling \u00a0\n\u2705 **Beautiful GUIs** - Interactive dashboards with real-time updates \u00a0\n\u2705 **Enterprise Database** - SQLite and MySQL support with automatic backups \u00a0\n\u2705 **Powerful Analytics** - Leaderboards, performance metrics, and detailed reports \u00a0\n\u2705 **Flexible Configuration** - 100+ config options for complete customization \u00a0\n\u2705 **Developer Friendly** - Full Java API with extensive documentation \u00a0\n\u2705 **Production Ready** - Battle-tested architecture with comprehensive error handling \u00a0\n\n**Perfect for:**\n- Roleplay servers requiring staff hour tracking\n- Networks needing centralized time management\n- Communities managing volunteer staff\n- Professional servers with paid staff positions\n- Any server wanting detailed activity analytics\n\n---\n\n\n**\ud83c\udfc6 The Ultimate Solution for Staff Management \ud83c\udfc6**\n\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"