poorvith-mp/skills-gamedev / skills/anti-cheat
anti-cheat
UnverifiedEnforce server authority and defend against speed hacks, memory editing, and exploits. For networking setup, see unity-multiplayer. Use when defending games against exploits or hacks.
anti-cheat
Core Philosophy
In multiplayer games, the client is fundamentally compromised. The game executable runs in a hostile environment controlled by the user: memory can be modified via Cheat Engine, network packets can be intercepted, and GPU rendering pipelines can be injected with custom shaders. True anti-cheat engineering does not rely on invasive kernel drivers alone; it is built on an uncompromising architectural foundation: Server Authority. The client only sends input intentions; the authoritative server simulates physics, validates mechanics, and adjudicates reality.
4-Step Server-Authoritative Anti-Cheat Architecture
Step 1: Server Authority & Movement Validation
- Never Trust Client Coordinates:
- The client must never send absolute positional updates (
player.position = x, y, z). - The client sends raw input vectors (Move forward, Jump, Delta time). The server simulates physics and returns authoritative state.
- The client must never send absolute positional updates (
- Speed-Hack & Teleportation Prevention:
- Server tracks positional displacement per tick: $$\Delta d \le v_{text{max}} imes \Delta t + \epsilon_{text{threshold}}$$
- If displacement exceeds maximum legal speed plus latency buffer, snap the player back to their last validated server position and flag anomalous telemetry.
- Ray-Swept Collision Bounds:
- Verify movement vectors using server-side ray sweeps to prevent clipping through solid geometry ("noclip" cheats).
Step 2: Combat & Action Validation
- Fire Rate & Ammo Accounting:
- Track weapon state strictly on the server: cooldown timer between shots, reload animations, magazine capacity.
- Instantly drop firing requests if the time delta between shots is lower than the weapon's configured firing delay.
- Lag Compensation & Rewind Bounds:
- For hitscan weapons, the server maintains a circular buffer of past entity positions (typically 1,000ms).
- When a client claims a hit at timestamp $T$, the server rewinds player hitboxes to timestamp $T$, performs a raycast, and validates line-of-sight.
- Security Bound: Cap maximum backward rewind at 200ms. If client latency exceeds 200ms, hits are rejected to prevent players behind cover from being shot by lagging clients.
Step 3: Statistical Heuristics & Aimbot Detection
- Angular Velocity & Entropy Analysis:
- Human aim exhibits micro-adjustments, tremors, and acceleration/deceleration curves.
- Aimbots snap instantaneously: angular velocity $ o \infty$, angular acceleration approaches a single-frame delta, and angular path entropy drops to zero.
- Log server-side telemetry on crosshair angular snap speed; flag players who consistently snap within 1 frame across $> 30^\circ$ angles.
Step 4: Memory Obfuscation & Heartbeat Integrity
- Encrypted In-Memory Variables:
- Obfuscate high-value memory addresses (Player Health, Ammo, Gold) using dynamic XOR bitmasks changed every game tick.
- Deterministic Simulation Hashes:
- Run cryptographic checksums on loaded map geometry and weapon config tables at match start to detect modified local asset files.
Deliverable Format: Anti-Cheat System Specification (ANTI-CHEAT-SPEC.md)
# Server-Authoritative Anti-Cheat Architecture: [Game Title]
## 1. Authority Model & Tick Rates
- **Server Tick Rate**: 64 Hz (15.625ms per tick)
- **Authority Scope**: Movement, Combat, Inventory, State Machine (100% Server Authoritative)
- **Lag Compensation Window**: Capped at 180ms maximum rewind
## 2. Real-Time Input Validation Rules
| Mechanic | Client Payload | Server Validation Logic | Enforcement Action |
|---|---|---|---|
| Movement | Input Vector + View Angles | Swept-sphere collision + max velocity cap | Hard snapback to last valid pos |
| Fire Weapon | Shoot Event + Target ID | Check ammo count > 0 & cooldown timer expired | Drop packet silently; log warning |
| Reload | Reload Request | Check reload duration >= 2.4s before resetting ammo | Reset reload progress on interrupt |
## 3. Server-Side Heuristic Detection Thresholds
- **Snap Angle**: > 45° angular displacement in <= 1 frame (15.6ms).
- **Hit Ratio**: Headshot ratio > 78% across 10 consecutive matches triggers manual review.
- **Speed Variance**: Accumulated distance delta > 1.15x theoretical max over 3 seconds.
Worked Example: Stopping Speed Hacks in a Fast-Paced Shooter
- Exploit: Cheaters modified client
Time.timeScaleto move 3x faster than normal players. - Server Fix: Implemented server-side distance delta accumulation over rolling 20-tick windows.
- Result: Cheaters were clamped to legal speed caps and rubber-banded backward; exploit neutralized with zero false-positive kicks for high-ping players.
Verification Checklist
- All positional movement and combat actions adjudicated on the server.
- Lag compensation rewinds capped at $\le 200text{ms}$.
- Weapon fire rates, reload timers, and ammo pools tracked server-side.
- Heuristic telemetry detects unnatural angular snap velocities.
- Asset checksums verify local map and weapon files before match entry.
Anti-Patterns
- Client-Authoritative Hits: Trusting the client when it sends "I hit Player B for 100 damage", inviting trivial memory-injection cheats.
- Unbounded Lag Compensation: Letting 500ms ping players shoot people who ran behind concrete walls 2 seconds ago.
- Client-Only Anti-Cheat: Relying exclusively on client-side scanning software without server-side validation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |