Permissions

Permissions

OverWatch-ML uses a comprehensive permission system to control access to various features.

Permission Nodes

Core Permissions

Permission	Description	Default
owml.use	Required for command hiding feature - allows using OverWatch commands	OP
owml.staff	Receive anti-xray alerts and access basic staff features	OP
owml.admin	Administrative functions	OP

GUI Permissions

Permission	Description	Default
owml.gui	Access to main AntiXray staff GUI	OP
owml.gui_playerstats	Access to detailed player mining stats GUI	OP
owml.gui_suspicious	Access to suspicious player GUI	OP
owml.gui_punishment	Access to punishment configuration GUI	OP
owml.gui_oreconfig	Access to ore configuration GUI	OP
owml.gui_ml	Access to ML analysis GUI	OP
owml.gui_config	Access to plugin configuration GUI	OP
owml.gui_webhook	Access to Discord webhook settings	OP
owml.gui_Appeal	Access to Appeal GUI	OP

Feature Permissions

Permission	Description	Default
owml.teleport	Teleport to decoy ore locations by clicking alerts	OP
owml.togglealert	Toggle ore alerts on/off	OP
owml.debug	Enable/disable debug mode	OP
owml.highlight	Highlight decoy ore veins	OP
owml.punish	Direct management of punishment levels	OP
owml.modify	Modify suspicious player count	OP

ML System Permissions

Permission	Description	Default
owml.ml	Access to ML commands	OP
owml.ml.train	Train ML system with player data	OP
owml.ml.analyze	Analyze players for x-ray patterns	OP
owml.ml.report	View analysis reports	OP
owml.ml.toggle	Enable/disable ML system	OP
owml.ml.status	View ML system status	OP

Advanced Feature Permissions

Permission	Description	Default
owml.autoupdate	Use update commands	OP
owml.behavioral	Access to behavioral profiling features	OP
owml.adaptive	Access to adaptive punishment system	OP
owml.interactive	Access to interactive command features	OP
owml.advanced_ml	Access to advanced ML features	OP
owml.data_admin	Access to data management features	OP
owml.fraud_detection	Access to fraud detection features	OP
owml.context_aware	Access to context-aware detection	OP

Permission Groups Example

Here's an example of how to set up permissions in your permissions plugin:

# Staff role
staff:
  permissions:
    - owml.use
    - owml.staff
    - owml.gui
    - owml.gui_playerstats
    - owml.gui_suspicious
    - owml.togglealert
    - owml.punish

# Senior Staff
senior_staff:
  permissions:
    - owml.ml
    - owml.ml.analyze
    - owml.ml.report
    - owml.modify
    - owml.gui_config

# Admin
admin:
  permissions:
    - owml.*

Command Hiding Note

When command-hiding.enabled is set to true in config.yml, players MUST have the owml.use permission to use any OverWatch commands. Players without this permission will see "Unknown command" errors.