CraftersStaff v7.6.2 - Major Feature Update & Complete Overhaul
New Features
Advanced Staff List Menu

• Created a new fully customizable menu: menus/staff_list.yml
• Fixed Player Heads: Menu now correctly renders player skins instead of Steve heads
• Completely translatable by users
• Clean and professional interface for managing online staff
• Easy to customize items, layout, and appearance

New Command: /invsee

• Added /invsee <player> command for quick inventory inspection
• Permission: craftersstaff.invsee
• Faster alternative to the menu-based inventory viewer
• Works with both online and offline players

Mining Alerts System

• Diamond Mining Alerts: Configurable alerts when players mine diamonds
• Netherite Mining Alerts: Configurable alerts for ancient debris/netherite mining
• Customizable threshold for alerts (e.g., alert after 5 diamonds mined)
• Both in-game staff notifications and Discord webhook support
• Helps detect X-ray and suspicious mining patterns
• Full configuration in config.yml

Server Lag Alerts

• Real-time TPS monitoring with automatic alerts
• Alerts when server TPS drops below configured threshold
• In-game notifications for staff members
• Discord webhook integration for remote monitoring
• Customizable TPS threshold and alert intervals
• Helps identify performance issues quickly

Discord Integration Enhanced

• Webhooks for mining alerts (Diamond and Netherite)
• Webhooks for lag/TPS alerts
• Rich embed messages with detailed information
• Configurable webhook URLs per alert type
• Asynchronous sending (doesn't block server)

Non-Destructive Config Updater

• Intelligent configuration migration system
• Automatically adds missing configuration options when updating
• Preserves all existing settings - never overwrites your customizations
• Works for config.yml and all language files
• Seamless updates without manual configuration editing
• Version tracking to prevent duplicate updates

Complete Translation Support

• All new features fully translated in Spanish and English
• message_es.yml and message_en.yml updated
• Easy to add more languages
• Consistent translation system across entire plugin

Bug Fixes
Staff Mode Restriction Messages Silenced

• Removed spam messages when breaking blocks in staff mode
• Removed spam messages when hitting mobs in staff mode
• Cleaner experience - actions are blocked silently
• No more chat clutter while in staff mode

Staff Chat Tags/Prefixes Fixed

• Completely fixed the issue where rank prefixes weren't showing
• Staff chat now correctly displays rank prefixes from Vault/LuckPerms
• Uses the format defined in language files
• Proper placeholder replacement for {rank_prefix}
• Compatible with all permission plugins

Action Bar Format Updated

• New improved format: Invisibility: (✔/✘) Staff Chat: (✔/✘) TPS: 20.00
• More professional and cleaner appearance
• Fully translatable via language files
• Real-time TPS display with 2 decimal precision
• Color-coded status indicators

Help Command Translation

• Fixed /craftersstaff help to use language files
• No more hardcoded English text
• Fully supports Spanish and English
• Consistent with rest of plugin translations

Improvements
Instant Reload System

• /craftersstaff reload now applies ALL changes instantly:
  • Configuration files (config.yml)
  • Language files (message_es.yml, message_en.yml)
  • Menu files (staff_list.yml)
  • Staff mode items
  • All managers and systems
• No server restart needed for any changes
• Faster workflow for server administrators
• Test changes immediately

Player Head Rendering

• Fixed player heads in staff list menu showing correct skins
• Uses proper Bukkit API for skull textures
• Supports both online and offline player skins
• Cached for better performance

Alert System Architecture

• New AlertManager for centralized alert handling
• New MiningListener for ore mining detection
• New LagTask for TPS monitoring
• Modular design for easy expansion
• Performance optimized with async operations

⚙️ New Configuration Options
Mining Alerts Configuration
alerts:
mining:
enabled: true
diamonds:
enabled: true
threshold: 5 # Alert after 5 diamonds
discord-webhook: true
netherite:
enabled: true
threshold: 3 # Alert after 3 ancient debris
discord-webhook: true

Lag Alerts Configuration
alerts:
lag:
enabled: true
tps-threshold: 18.0 # Alert if TPS < 18
check-interval: 60 # Check every 60 seconds
discord-webhook: true

Discord Webhooks
discord:
mining-alerts-url: "your-webhook-url"
lag-alerts-url: "your-webhook-url"

Action Bar Format
action-bar:
format: "&fInvisibility: &7({vanish}) &fStaff Chat: &7({staffchat}) &fTPS: &7({tps})"

New Commands

Command Description Permission
/invsee <player> View player inventory craftersstaff.invsee
New Permissions

• craftersstaff.invsee - Use /invsee command
• craftersstaff.alerts.mining - Receive mining alerts
• craftersstaff.alerts.lag - Receive lag alerts

New Configuration Files
menus/staff_list.yml

• Fully customizable staff list menu
• Control title, size, items, lore
• Support for placeholders
• Easy to translate

Technical Improvements
Code Structure

• New AlertManager class for alert management
• New MiningListener for ore detection
• New LagTask for TPS monitoring
• Better separation of concerns
• Cleaner, more maintainable code

Performance

• Optimized player head rendering with caching
• Async Discord webhook sending
• Efficient TPS calculation
• Minimal impact on server performance

Config Management

• Smart config updater that preserves user settings
• Version tracking in configuration
• Automatic addition of new options
• Backward compatible with old configs

Installation & Update
File: CraftersStaff-v7.6.2.jar

New Installation:

1. Download CraftersStaff-v7.6.2.jar
2. Place in plugins/ folder
3. Restart server
4. Configure as needed
5. Use /craftersstaff reload to apply changes

Updating from Previous Version:

1. Stop server
2. Replace old JAR with CraftersStaff-v7.6.2.jar
3. Start server
4. Config auto-updates - all your settings preserved
5. New options added automatically with defaults
6. Review new features in config.yml

✅ Changes Summary
Added:

• Staff list menu with working player heads
• /invsee command
• Mining alerts (Diamond & Netherite)
• Lag/TPS alerts
• Discord webhooks for alerts
• Non-destructive config updater
• Complete translation system

Fixed:

• Staff chat tags/prefixes not showing
• Player heads showing Steve instead of skins
• Block breaking messages spam in staff mode
• Mob hitting messages spam in staff mode
• Help command not using translations
• Action bar format inconsistencies

Improved:

• Instant reload system for all configs
• Action bar display format
• Alert system architecture
• Config management
• Translation coverage
• Code organization

Optimized:

• Player head rendering
• Alert processing
• Config loading
• Memory usage
• Performance impact

Version: 7.6.2
Compatibility: Minecraft 1.21+ (Paper/Spigot)
Status: Stable Release
Major Update: Yes - Multiple new systems
Breaking Changes: None - Fully backward compatible
Optional Dependencies: Vault, LuckPerms, ProtocolLib (for enhanced features)