Configuration

Configuration

OverWatch-ML uses a YAML configuration file located at plugins/OverWatch-ML/config.yml.

Main Configuration Sections

Debug

debug:
  enabled: false  # Set to true for verbose logging

Auto-Updates

check-for-updates: false
notify-admins-on-join: true
modrinth-id: ""

periodic-update-checks:
  enabled: true
  interval-hours: 24

auto-updates:
  enabled: true

Anti-Xray System (Decoy)

decoy:
  enabled: true              # Enable/disable decoy ore system
  oreThreshold: 10          # Ores mined before decoy triggers
  timeWindowTicks: 3600      # Time window (3600 = 1 minute)
  distance: 5.0             # Distance to place decoy
  fieldOffset: 0.5          # Perpendicular offset
  requireBuried: true       # Only place in buried locations
  warnOnDecoy: false        # Warn player when breaking decoy
  revertDelay: 1200         # Time before decoy reverts (ticks)
  maxDistance: 10.0         # Max distance before revert
  searchRadius: 10          # Search radius for buried location
  buriedThreshold: 6        # Required solid adjacent blocks

Staff Alerts

staff:
  oreAlerts: true           # Alert staff on ore mining
  oreResetTime: 36000       # Reset counter time (ticks)
  alertEnabled: true        # Enable alerts

Natural Ores

ores:
  natural:
    - DIAMOND_ORE
    - DEEPSLATE_DIAMOND_ORE
    - GOLD_ORE
    - DEEPSLATE_GOLD_ORE
    - EMERALD_ORE
    - DEEPSLATE_EMERALD_ORE

Punishment System

punishment:
  enabled:
    1: false               # Enable/disable each punishment level
    2: false
    3: false
    4: false
    5: false
    6: false

  autoSave:
    enabled: true
    intervalMinutes: 10
    logging: true

Machine Learning

ml:
  enabled: true
  flag-only: true           # Only flag, don't punish automatically
  trainingSessionDuration: 600
  detectionThreshold: 0.75
  positionUpdateInterval: 20
  min-data-points: 50

  thresholds:
    warning: 60
    auto-punish: 90

  autoAnalysis:
    enabled: true
    suspiciousThreshold: 15
    maxPlayers: 5

  bots:
    autoTraining: false
    maxConcurrentBots: 5
    trainingSessionDuration: 120
    spawnInterval: 30

Automation

automation:
  auto-punish:
    enabled: false
    type: "KICK"

Performance

performance:
  analysis-interval: 100
  max-queue: 20

World Settings

disabled-worlds:
  enabled: false
  worlds: []  # Add world names here

Storage

storage:
  type: yaml  # or sqlite

Language

language: en

Integrations

Discord

integrations:
  discord:
    enabled: false
    bot-token: "YOUR_BOT_TOKEN_HERE"
    notification-channel: "123456789012345678"
    command-channel: "123456789012345678"
    alert-level: "HIGH"

  anticheat:
    enabled: true
    aac:
      enabled: true
    nocheatplus:
      enabled: true

Webhook

webhook:
  url: ""
  alerts:
    xray_detection: true
    suspicious_mining: true
    punishment_applied: true
    staff_actions: false
    appeal_updates: true

Composite Punishments

composite-punishments:
  enabled: true
  escalation-enabled: true
  max-level: 6

Data Management

stats:
  autoSave:
    enabled: true
    intervalMinutes: 10
    logging: false

suspicious:
  autoSave:
    enabled: true
    intervalMinutes: 10
    logging: true

Command Hiding

command-hiding:
  enabled: false
  messages:
    error-line1: "§cUnknown or incomplete command, see below for error"
    error-line2: "§c§n{command}§r§c§o<--[HERE]"

Reloading Configuration

After editing config.yml, reload the plugin:

/owml reload

Or use:

/overwatch reload