MineStaff v1.2.1

MineStaff v1.2 - Major Update
New Security Features, Spy Tools & Enhanced Investigation Capabilities​

What's New in v1.2

Two-Factor Authentication (2FA/TOTP)
Dramatically enhance your staff security with industry-standard TOTP authentication!

Code:

/staff2fa enable - Set up 2FA with authenticator app
/staff2fa confirm <code> - Verify and activate 2FA
/staff2fa disable - Remove 2FA from your account
/staff2fa status - Check your 2FA status

• Supports Google Authenticator, Authy, Microsoft Authenticator, and other TOTP apps
• Adds an extra layer of protection beyond passwords
• Prevents unauthorized access even if credentials are compromised
• Per-staff member configuration

Offline Player Inspection
No more waiting for players to log in! Investigate offline players anytime.

Code:

/inspectoffline <player> - View offline player's inventory
/inspectoffline <player> ec - View offline player's ender chest

• Access full inventory data even when players are offline
• Perfect for investigating rule violations after the fact
• View armor, hotbar, and all inventory slots
• Ender chest inspection support

Command Spy & Social Spy
Monitor server activity in real-time with powerful spy tools!

Code:

/commandspy - Toggle command monitoring
/socialspy - Toggle private message monitoring

• Command Spy: See all commands executed by players in real-time
• Social Spy: Monitor private messages (/msg, /tell, etc.)
• Helps detect rule violations, staff impersonation, and suspicious behavior
• Filter spam and focus on important activity
• Permission-based access (staffmode.spy)

Evidence Attachment System
Build comprehensive cases with evidence links directly in reports!

Code:

/evidence <reportId> add <url> - Attach screenshot/video evidence
/evidence <reportId> list - View all evidence for a report

• Link screenshots, videos, or documents to reports
• Build thorough cases for serious violations
• Evidence visible to all staff reviewing the report
• Supports any URL (Imgur, YouTube, Google Drive, etc.)

Player Notes System
Keep detailed records and share context with your staff team!

Code:

/notes <player> add <note> - Add a note to player's record
/notes <player> list - View all notes for a player
/notes <player> remove <index> - Delete a specific note

• Create persistent notes about players
• Share important context with other staff members
• Ideal for tracking warnings, behavior patterns, or special circumstances
• Searchable and organized by player

Enhanced Player Profiles
All investigation tools in one convenient GUI!

Code:

/profile <player> - Open comprehensive player profile

• View player history, notes, infractions, and reports in one place
• Quick access to inventory, ender chest, and stats
• Streamlined investigation workflow
• One-click access to all moderation actions

Staff Duty Mode
Separate staff duties from casual play!

Code:

/staffduty or /duty - Toggle staff duty mode

• Automatically enables Staff Mode and duty status
• Notify players when staff are actively on duty
• Integrates with PlaceholderAPI for duty status displays
• Perfect for larger teams with on/off duty rotations



Security & Performance Improvements

Enhanced Security:
• BCrypt Password Hashing - Industry-standard password protection for staff login
• TOTP Two-Factor Authentication - Additional security layer with authenticator apps
• Improved Config Validation - Better error handling for disabled modules
• Runtime Library Loading - Secure dependency management

Report System Enhancements:
• SQL Persistence for Network Reports - Cross-server report syncing
• Claim Timeout Tracking - Auto-release unclaimed reports after timeout
• Report Update Propagation - Real-time updates across network bridges
• Redis & Proxy Messenger Integration - Seamless BungeeCord/Velocity support

Staff Tools Refinements:
• CPS Check Staff Tool - Added to staff mode toolbar for quick access
• Separate Staff List Commands - Distinct GUI (/stafflistgui) and text (/stafflist) versions
• Inspector GUI Polish - Removed redundant UUID from title for cleaner interface
• Config-Driven Service Reloading - Smoother /staffreload experience

Bug Fixes:
Fixed JsonAuditLogger method signatures
Fixed null pointer in LoginGuardListener during reload
Fixed staff login disabled config not being respected
Improved random teleport cooldown messaging
Better event handling for staff mode toggles



New Commands Summary

Code:

/staff2fa <enable|confirm|disable|status> - Manage 2FA authentication
/inspectoffline <player> [ec] - Inspect offline players
/commandspy - Monitor all player commands
/socialspy - Monitor private messages
/evidence <reportId> add/list - Manage report evidence
/notes <player> add/list/remove - Player notes system
/profile <player> - Comprehensive player profile
/staffduty - Toggle duty mode

New Permissions

Code:

staffmode.spy - Access command spy and social spy
staffmode.notes - Manage player notes
staffmode.profile - View player profiles
staffmode.duty - Toggle staff duty mode

Use Cases

Scenario 1: Investigating a Cheating Report
1. Use /profile PlayerName to see their full history
2. Check /inspectoffline PlayerName to view their suspicious items
3. Review /notes PlayerName list for past warnings
4. Attach evidence with /evidence <id> add <screenshot-url>

Scenario 2: Monitoring Suspicious Activity
1. Enable /commandspy to watch for exploit commands
2. Use /socialspy to detect coordinated rule-breaking
3. Add notes with /notes PlayerName add "Suspicious behavior detected..."

Scenario 3: Going On Duty
1. Use /staffduty to activate duty mode
2. Receive duty-specific alerts and permissions
3. Access all investigation tools instantly



Upgrade Instructions

1. Backup your plugins/MineStaff/ folder
2. Stop your server
3. Replace MineStaff.jar with v1.2
4. Start your server (new config options will auto-generate)
5. Run /staffreload to verify everything loaded
6. Grant new permissions to staff as needed

Config Changes:
The config.yml will automatically update with new 2FA settings and evidence system options. Your existing configurations will be preserved.



Coming Soon

We're actively developing:
• Session recording and playback
• Advanced analytics dashboard
• Webhook integrations for Discord/Slack
• Custom alert rules engine
• Multi-language support

Enjoying MineStaff? Leave a review and let us know what features you'd like to see next! ​

Version: 1.2
Compatibility: Minecraft 1.20.x - 1.21.x (Paper/Purpur/Spigot)
Dependencies: None required | Optional: LiteBans, PlaceholderAPI

New update!!

Updated code and fix minor issues.

Revamped the entire code and added new features.