Configuration Reference

# Language: en, es, pt, jp, zh
language: en
config-version: 1

updates:
  enabled: true
  auto-update: false
  channel: stable        # stable | beta | dev

cloud: false             # Data cloud relay (beta, off by default)
cloud-cache-ttl-seconds: 300
cloud-queue-batch-size: 5
cloud-queue-flush-interval-seconds: 5

alerts:
  staff-notifications: true
  join-alerts:
    enabled: true        # staff sees banned-player join attempts
  webhooks:
    enabled: false
    url: "YOUR_DISCORD_WEBHOOK_URL"

debug: false

anti-vpn:
  enabled: false
  provider: "guard-cloud"   # guard-cloud | ip-api | proxycheck | ipstack
  api-secret: ""            # only for guard-cloud (optional, higher quota)
  api-key: ""               # required for proxycheck / ipstack
  require-auth: false
  action: KICK              # KICK | BAN | WARN (BAN is not implemented yet)
  check-abuse: true         # block known abusive ranges
  check-tor: true           # block Tor exit nodes
  exempt-staff: true
  exempt-permission: "securityx.antivpn.exempt"

reports:
  enabled: true
  cooldown-seconds: 60
  max-per-hour: 5
  duplicate-detection: true
  require-evidence: true    # in-game evidence is a URL (image/video/log)
  categories:
    cheating:
      subcategories: [KillAura, Fly, Speed, Reach, AutoClicker, Aim Assist, Movement, Other]
    chat:            { subcategories: [Slurs, Threats, Spam, Staff-Disrespect, Other] }
    griefing:        { subcategories: [Stealing, Destroying, Scamming, Other] }
    exploiting:      { subcategories: [Dupe, Crash, Bypass, Other] }
    advertising:     { subcategories: [IP-Sharing, External-Links, Other] }
    harassment:      { subcategories: [Discrimination, Doxing, DDoS-Threats, Other] }
    bugabuse:        { subcategories: [Exploits, Glitches, Other] }
    other:           { subcategories: [Other] }