Skip to content

Add server-side anti-cheat framework (movement/physics/spell/item det…#387

Open
Krilliac wants to merge 1 commit into
mangoszero:masterfrom
Krilliac:feature/anticheat-core
Open

Add server-side anti-cheat framework (movement/physics/spell/item det…#387
Krilliac wants to merge 1 commit into
mangoszero:masterfrom
Krilliac:feature/anticheat-core

Conversation

@Krilliac

@Krilliac Krilliac commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

…ection + enforcement)

Introduces a config-gated, server-side anti-cheat / movement-validation framework. OFF by default (AntiCheat.Enable = 0) — fully inert until enabled.

Core pieces:

  • AntiCheatMgr: central scoring manager. Detectors only observe and score via a single RecordViolation() ingress; the manager owns ALL enforcement. Score decays over time and escalates through capped actions (log -> GM alert -> rubberband to last validated position -> kick), with an optional account-level autoban accumulator (escalating ban durations, slow hourly decay).
  • MovementAnticheat: per-player validator running cheap, event-driven detectors on each movement packet — fly/flag-spoof (water-walk/hover/slow-fall/transport/ swim, aura- or grant-aware), teleport/blink, speed, acceleration gate, vertical climb, root/stun-break, opcode-legality, no-clip (VMap LoS), jump (infinite/ mid-air), fall-damage suppression, packet burst, client-timestamp regression, bot-movement heuristic, and spell-cast timing (GCD bypass + cast spam).
  • PhysicsValidator: side-effect-free terrain-plausibility stage (float-above / below-surface), invoked only on suspicion to stay off the hot path.

Integration: movement validation in the movement opcode handler; spell-injection, item-in-trade, GO-use and NPC interaction-distance hooks; cast-timing hook; server-granted movement flags recorded in the Player Set* setters so the flag-spoof detectors don't fire on legit grants; a rolling latency EWMA fed from CMSG_PING for latency-aware tolerances. GM commands: .anticheat status / report / reload / warn / jail / unjail / delete. Violations persist to character_anticheat_violation; account autoban state to account_anticheat.

Time-sync, the spoof/test GM tooling, and the violation-marker visualizer are follow-ups that build additively on this core.


This change is Reviewable

@codacy-production

codacy-production Bot commented Jun 21, 2026

Copy link
Copy Markdown

Not up to standards ⛔

🔴 Issues 2 high

Alerts:
⚠ 2 issues (≤ 0 issues of at least minor severity)

Results:
2 new issues

Category Results
Compatibility 2 high

View in Codacy

🟢 Metrics 275 complexity · 2 duplication

Metric Results
Complexity 275
Duplication 2

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

…ection + enforcement)

Introduces a config-gated, server-side anti-cheat / movement-validation
framework. OFF by default (AntiCheat.Enable = 0) — fully inert until enabled.

Core pieces:
- AntiCheatMgr: central scoring manager. Detectors only observe and score via
  a single RecordViolation() ingress; the manager owns ALL enforcement. Score
  decays over time and escalates through capped actions (log -> GM alert ->
  rubberband to last validated position -> kick), with an optional account-level
  autoban accumulator (escalating ban durations, slow hourly decay).
- MovementAnticheat: per-player validator running cheap, event-driven detectors
  on each movement packet — fly/flag-spoof (water-walk/hover/slow-fall/transport/
  swim, aura- or grant-aware), teleport/blink, speed, acceleration gate, vertical
  climb, root/stun-break, opcode-legality, no-clip (VMap LoS), jump (infinite/
  mid-air), fall-damage suppression, packet burst, client-timestamp regression,
  bot-movement heuristic, and spell-cast timing (GCD bypass + cast spam).
- PhysicsValidator: side-effect-free terrain-plausibility stage (float-above /
  below-surface), invoked only on suspicion to stay off the hot path.

Integration: movement validation in the movement opcode handler; spell-injection,
item-in-trade, GO-use and NPC interaction-distance hooks; cast-timing hook;
server-granted movement flags recorded in the Player Set* setters so the
flag-spoof detectors don't fire on legit grants; a rolling latency EWMA fed from
CMSG_PING for latency-aware tolerances. GM commands: .anticheat status / report /
reload / warn / jail / unjail / delete. Violations persist to
character_anticheat_violation; account autoban state to account_anticheat.

Time-sync, the spoof/test GM tooling, and the violation-marker visualizer are
follow-ups that build additively on this core.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@AppVeyorBot

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants