bug fix

DeepGuardX v1.7.7 Changelog
Stealth Command Hiding
Permission-Based Command Access

• Introduced an advanced command hiding mechanism with conditional permission requirements
• Permission deepguardx.use becomes CRITICAL only when command hiding is enabled
• When command hiding is disabled, permission restrictions do not apply

Command Hiding Mechanics

• When Disabled (Default):
  • All players can use DeepGuardX commands normally
  • No special permissions required
  • Standard permission checks remain in effect
• When Enabled:
  • Players MUST have deepguardx.use permission to use ANY DeepGuardX commands
  • Unauthorized players receive a generic "Unknown command" error
  • Appears as if the command does not exist at all

Configuration Options

• Added /deepguardx commandhiding command to toggle stealth mode
• Customizable error messages for hidden commands
• Default permission level: Operator (OP)

Supported Command Aliases

• Hidden commands include:
  • /deepguard
  • /dgx
  • /deepguardx
  • /deepguard-xray:deepguard
  • /deepguard-xray:dgx

Important Limitations

• DOES NOT hide plugin from:
  • /pl (Plugins list)
  • /help
  • /about
  • Tab completion
  • Other plugin discovery methods

Usage Notes

• Requires server restart to apply changes
• Operators can configure via console or in-game
• Carefully manage deepguardx.use permission when enabling command hiding

DeepGuard-Xray v1.7.0 - Major Update: The Machine Learning System
I'm thrilled to announce the biggest update yet for DeepGuardXray - version 1.7.0! This major release introduces an advanced machine learning system for X-ray cheat detection, bringing new analysis capabilities to your server. After several weeks of development, this update aims to better distinguish between legitimate mining and cheating behaviors.

New Advanced Machine Learning System

• Smart Mining Style Recognition: The ML system now identifies different mining styles (branch mining, cave exploration, or suspicious patterns) and adjusts its analysis accordingly
• Context-Aware Analysis: Legitimate branch miners won't be falsely flagged for staying at diamond level
• Detailed Reasoning Process: Get comprehensive reports explaining exactly why a player was flagged with step-by-step analysis
• Pre-trained Model: Comes with bundled training data so you can use it immediately
• Auto-analysis System: Automatically analyzes suspicious players based on configurable thresholds

New ML Command System

• /deepguardx ml train <player> <cheater|normal> - Collect training data to improve detection accuracy
• /deepguardx ml analyze <player> - Start analyzing a player's mining behavior
• /deepguardx ml report <player> - View detailed analysis results with suspicion scores
• /deepguardx ml enable/disable - Toggle the ML detection system
• /deepguardx ml status - Check current ML system status and training stats

️ New Staff GUI Interfaces

• ML Analysis Dashboard: Monitor players in real-time with visual suspicion indicators
• Training Data Management: Easily collect and manage training data from normal players and cheaters
• Player Selection Interface: Quickly select players for analysis or training
• Auto-Analysis Settings: Configure thresholds for automatic player monitoring
• Detailed Reports Panel: Browse and view comprehensive detection reports

Enhanced Analysis Features

• Advanced Pattern Recognition: Detects suspicious mining patterns that indicate X-ray
• Y-Level Analysis: Tracks how players navigate vertically and identifies suspicious movements
• Ore Discovery Rate Analysis: Monitors how quickly players find valuable ores
• Mining Focus Detection: Identifies players suspiciously focused on valuable ores
• Movement Pattern Analysis: Analyzes player movements around ore discoveries

️ Technical Improvements

• Optimized Data Collection: Improved performance with throttled movement tracking
• Enhanced Data Management: Better organization and storage of analysis data
• Webhook Integration: Send detection alerts to Discord with detailed analysis
• Reference Statistics: Compare player behavior against trained normal/cheating profiles
• Suspicious Count Tracking: Keep track of suspicious behaviors over time

New Permissions

• deepguardx.ml.train - Permission to train the ML system
• deepguardx.ml.analyze - Permission to analyze players with ML
• deepguardx.ml.report - Permission to view analysis reports
• deepguardx.ml.toggle - Permission to enable/disable the ML system
• deepguardx.ml.status - Permission to check ML system status
• deepguardx.gui_ml - Permission to access the ML Analysis GUI in the staff panel

Bug Fixes

• Fixed false positives for legitimate branch miners
• Resolved issues with player head display in GUI
• Fixed permission handling in command system
• Improved data saving and loading reliability
• Better error handling throughout the system

Note: This is the first implementation of the actual ML system in the plugin - the previous version was merely a prototype. I've tried my best to make it work well, but if you encounter any errors or notice false data in the analysis, please let me know! Your feedback is crucial for improving the accuracy and reliability of the system.

Thank you for your patience during development! This update adds new anti-cheat capabilities for Minecraft servers, and I'm excited to continue improving DeepGuardXray with your feedback.

DeepGuardXray Update Summary
️ Appeal System

• Player Appeal Workflow: Players can use /dgx appeal to contest punishments
• Staff Management GUI: Intuitive interface to review, approve, or deny appeals
• Auto-Punishment Removal: Approved appeals automatically remove punishments
• Staff Responses: Custom feedback can be provided to players
• Persistent Storage: Appeals fully tracked and persist between server restarts
• Status Notifications: Both players and staff receive appeal status updates

Discord Integration

• Appeal Notifications: Player appeals sent to Discord with detailed information:
  • Player name, punishment level, and reason
  • Status updates (approved/denied/under review) with staff responses
  • Color-coded embeds for different appeal statuses
• Admin Action Tracking:
  • Configuration changes by staff members
  • Punishment system modifications
  • Ore tracking adjustments (which ores were added/removed)
  • All changes logged with before/after values
• Branding: Custom Discord avatar

Punishment & Data Persistence

• Complete Data Persistence: All suspicious player counts and punishment data will save after server restarts
• Auto-Save System: 10-minute auto-save cycles for player data
• Punishment Recovery: Active punishments properly resume after server restarts
• Optimized Storage: Efficient YAML-based storage with minimal performance impact
• Admin Control: Punishment removals by admins remain effective through restarts
• Automatic Cleanup: Expired punishments automatically cleared upon reload

Time-Based Mining Detection

• Time-Window Analysis: Detects suspicious mining based on a 2-minute window
• Alert Cooldown: 5-minute cooldown between alerts for same player/ore combination
• Enhanced Staff Notifications: Special formatting for suspicious patterns with "SUSPICIOUS" tag in red
• Smart Alert Toggling: Staff can disable regular alerts while still receiving critical suspicious mining alerts
• Informative Webhooks: Enhanced Discord alerts with pattern detection information

Bug Fixes

• Fixed appeals marked as "Under Review" disappearing from staff GUI
• Fixed player inability to submit new appeals after previous denial
• Fixed appeal system not allowing appeals for new punishments when previous appeal was approved
• Improved appeal status handling for different punishment levels

Added bStats integration to anonymously track server usage.

DeepGuardXray v1.5.0 - Update Summary
Major Feature: Discord Integration

• Real-time Discord Notifications - Get instant alerts for X-ray detection, suspicious mining patterns, punishment actions, and staff activity
• Customizable Webhook Settings - Control which notifications are sent via an easy-to-use GUI
• Detailed Alerts with Action Tracking - See who applied punishments, which staff members made changes, and track suspicious activity with precise timestamps and coordinates

Enhanced User Interface

• Redesigned Staff Control Panel - Completely overhauled main interface with improved visuals, better organization, and a more professional look
• Interactive Elements - Sound effects, hover tooltips, and visual feedback for a more engaging staff experience
• Categorized Management Sections - Separate Analysis & Monitoring from Management & Configuration for better workflow

Improved Punishment System

• Admin Attribution - Punishment records now track which staff member applied each action
• Command Integration - Manual punishments via commands now send Discord notifications
• Streamlined Management - Better organization of punishment settings and options

Suspicious Activity Tracking

• Enhanced Point Management - Complete Discord integration for suspicious point modifications
• Staff Action Logging - Full audit trail of which staff members checked, added, or removed suspicious points
• Improved Command Framework - Better feedback and more robust command handling

Technical Improvements

• Performance Optimization - Fixed several issues with text handling and GUI interactions
• Improved Component Handling - Better processing of Adventure API components for more reliable text extraction
• Enhanced Security - More secure webhook URL handling and permission checks

Other Enhancements

• Staff Permission Controls - More granular permission checking throughout the plugin

We're excited to bring you this major update to DeepGuardXray, focused on better staff communication, improved user experience, and more powerful anti-cheat tools. As always, please report any issues you seen

Change to paper API for better performance

DeepGuard-XRay v1.4.0 - ParanoiaMode Overhaul

What's New
Complete Code Refactoring: completely restructured the punishment system to use a modern, modular architecture that improves performance, maintainability, and expandability.

Major Updates

• Enhanced ParanoiaMode: Completely redesigned from a simple sound effect to a full psychological horror experience
• New "Nightmare Event": Rare terrifying event featuring a Warden with authentic emergence animation and behaviors
• Fixed Compatibility: All particle effects now properly work with Minecraft 1.21.3+ without errors
• Performance Improvements: Added proper activation checks and Y-level restrictions

️ Technical Improvements

• Modular Punishment System: Each punishment type now has its own dedicated handler class
• Separation of Concerns: BlockListener is now significantly leaner with punishment logic properly encapsulated
• Enhanced Extensibility: Adding new punishment types is now as simple as creating a new handler class
• Improved Debugging: Better logging and isolation of punishment logic makes troubleshooting easier

ParanoiaMode Features

• Ghost Mobs: Hostile mobs that appear briefly and sometimes chase players before vanishing
• Whispering Voices: Chilling messages that suggest someone is watching the player
• Visual Hallucinations: Eerie particle effects like shadow figures, glowing eyes, and blood spatters
• Fake Resources: Diamond ore illusions that disappear when approached
• Environmental Effects: Cave-ins, distant mining sounds, and camera shake effects
• Jump Scares: Fake damage effects and sudden mob appearances in peripheral vision

Nightmare Event

• Rare Encounter: Happens randomly to players with ParanoiaMode enabled below Y-0
• Authentic Warden: Features the Warden's proper emergence animation and hunting behavior
• Multi-Phase Experience:
  1. Escalating breaking sounds
  2. Dramatic Warden emergence
  3. Frozen staring contest
  4. Terrifying charge sequence
  5. Blindness phase with chilling message

Technical Improvements

• Y-Level Restriction: Paranoia effects only trigger below Y-30 for thematic appropriateness
• Config Integration: Properly respects punishment system toggles
• Resource Optimization: More efficient effect scheduling and entity management
• Compatibility Fixes: Replaced problematic particle types with compatible alternatives

Notes for Server Owners

• The enhanced ParanoiaMode is significantly more resource-intensive than the previous version
• Not recommended for servers with many simultaneous players (50+)
• GUI now includes proper warnings about potential player discomfort
• Consider disabling for players with heart conditions or sensitivity to psychological horror

For Server Owners

• No Configuration Changes Required: All your existing settings will work with the new system
• Improved Performance: More efficient code structure means better server performance
• Future-Proof: This architecture allows us to add new anti-Xray features much more easily

Requirements

• Minecraft 1.21.4
• Spigot/Paper server
• At least 4GB of server RAM recommended

Key Improvements
Enhanced Path Handling

• Fixed issues with path separators in JAR filenames
• Improved JAR file detection in plugins directory
• Correctly handles different server directory structures

Paper Server Compatibility

• Detects if running on a Paper server
• Safely handles the .paper-remapped folder structure
• Intelligently manages plugin JARs without affecting running server

New Manual Apply Command

• Added /deepguard update apply to manually delete old plugin JAR
• Useful when auto-deletion doesn't work
• Provides clear success/failure feedback

Interactive Chat UI

• Added clickable buttons in chat for all operations:
  • "Click here to auto-update the plugin" - downloads new version
  • "Click here to apply the update now" - removes old version
  • "Click here to restart the server" - for OPs after applying

Improved Error Handling

• Better detection of missing or moved files
• Clear, informative error messages
• Fallback detection methods when expected files aren't found

Enhanced Logging

• Detailed console logs for troubleshooting
• Shows full paths of files being managed
• Logs update status at each step

Usage Instructions

1. Check for updates: /deepguard update check
   Checks if a new version is available
2. Download update: /deepguard update auto
   Downloads the latest version to your plugins directory
3. Apply update: /deepguard update apply
   Removes the old version, so the new version will be used on restart
4. Restart server: Restart to use the new version

Permissions

• deepguardx.staff - See update notifications on join
• deepguardx.autoupdate - Use the update commands

Compatibility

• [NOT TESTED]Works with all server types (Paper, Spigot, etc.)
• Special optimizations for Paper servers

minor fixes for auto update

✨ Key improvement:

• One-Click Updates: Staff members can update the plugin with a single click
• Automatic Notifications: Get notified when new updates are available
• Safe Installation: Updates are applied during server restart to prevent disruption
• Automatic Backups: Previous versions are automatically backed up
• Permission-Based: Only authorized staff can trigger updates

How It Works:

1. Staff members with the appropriate permissions are notified about available updates when they join
2. Updates can be downloaded with a simple click or command
3. The plugin safely installs the update during the next server restart
4. A backup of the previous version is automatically created

Commands:

• /deepguard update check - Check for available updates
• /deepguard update auto - Download and prepare the update for next restart

Permissions:

• deepguardx.staff - Receive update notifications
• deepguardx.autoupdate - Ability to download and apply updates

New Features & Fixes

• New Admin Command: /deepguard punish <set|remove|check> <player> [level] - Apply punishment levels directly to players
• Resource Tax Improvement: Fixed to work properly with all ore quantities and types (75% tax on valuable ores, 50% on regular ores)
• Fool's Gold Enhancement: Now alternates between copper and gold with visual effects
• Cursed Pickaxe Fix: Now consistently breaks tools when mining valuable ores
• Bug Fix: Resource Tax now only applies to ore blocks, not all blocks
• Enhanced Visuals: Added particle effects and sounds to make punishments more noticeable
• Punishment Logic: Fixed issues where punishments would interfere with each other

Performance Improvements

• Reduced task frequency from every 1 minute to every 5 minutes
• Implemented staggered cleanup for less frequent operations
• Optimized player checks to only process active punishments
• Implementation Enhancements
  • Added proper event handlers and cleanup mechanisms
  • Improved player messaging with clearer feedback
  • Added automatic punishment expiration (20-30 minutes)
  • Better fake ore management with duplicate prevention
  • Added safety checks to prevent memory leaks
  • Fake Ore Veins: Implemented 50% chance for valuable ores to turn into stone when mined by punished players.
  • Permanent Mining Debuff: Changed from blocking mining below Y-0 to applying Mining Fatigue II effect, allowing mining but at a greatly reduced speed.
  • Resource Tax: Modified to consistently reduce all block drops by 50% (rounding down), providing proper feedback to the player about what was taken.
  • Fool's Gold: Added system where diamond ore drops gold instead of diamonds for 30 minutes, with subtle messaging to the player.
  • Inventory Drop: Implemented punishment that removes 25% of ore-related items from player inventory permanently when triggered at punishment level 2.
    
  Punishment Clarification
  • Separated "Fake Diamonds" (affects real diamond ore a set number of times)
  • Improved "Fake Ore Veins" (creates visual illusions that disappear when mined)

Added chat integration:

• Created a chat event listener to display warning tags next to player names
  [Untrusted Miner] in level 4
• Made reputation status visible to all players during conversations

• Added a dedicated permission deepguardx.gui_mltoggle to control access to the ML toggle feature in GUI

• Used underscore(_) naming to prevent accidental permission inheritance

• Ensured server operators can always toggle the feature

small improvement for
/deepguard points check <player>
command

What's New:

• Better teleportation system for staff alert
• Added color-coded ore names in staff alerts
• Each ore type now displays with its distinctive color (diamonds in aqua, emeralds in green, etc.)
• Improved readability of alert messages with properly formatted material names

Core System Fixes

• Fixed issue where decoy ore veins weren't being properly tracked in the system
• Resolved compilation error in the decoy placement logic
• Improved detection of hidden blocks to ensure decoys are properly concealed
• Added verification system to prevent tracking of blocks that no longer exist

Highlight Command Fixes

• Fixed visual indicators showing for ore blocks that were already mined
• Added teleportation functionality to return to original position after using any highlight feature
• Resolved conflict when using the "nearest" highlight option multiple times
• Improved player game mode and position management

Performance Improvements

• Optimized internal data structures to reduce memory usage
• Improved tracking system to only monitor blocks that were successfully placed
• Enhanced cleanup procedures to prevent memory leaks during extended server uptime

Additional Improvements

• Better logging for server administrators to track system activity
• Improved error handling when decoy placement fails

Major Performance Improvement:

• ML Analysis toggle now completely stops data collection for true performance gains when disabled
• Basic ore statistics still tracked for player GUI even when ML is off
• Clear "Analysis Disabled" indicators throughout the interface
• ML toggle state persists through server restarts

Bug Fixes:

• Fixed navigation between analysis GUI screens
• Fixed plugin configuration menu functionality
• Improved visual consistency throughout the interface

Admin Benefits:

• Enable ML only when actively investigating suspicious behavior
• Significantly reduced server impact when ML is disabled
• Clearer feedback and status messages for staff

Fix some minor bugs

Fixed the plugin configuration menu

DeepGuardX Update: ML Toggle & Performance Boost

• Added ML Analysis toggle button in Suspicious Activity menu
• Toggle completely disables ML calculations for better performance
• Clear "Analysis Disabled" indicators when ML is off
• Fixed back button navigation in ML GUI
• ML state persists through server restarts

Note: Turn ML off when you want save server resources.

fixed some bug in Punishment System for some function in level 4 and 5

Fixing the duplicate "Warning Message" inside the
Advanced settings for level 1

Adding auto update to the plugin

players that have the
permissions
deepguardx.staff
will get the update massage

Fix some small bugs