HardAntiCheat

HardAntiCheat

A powerful, configurable, server-side anti-cheat engine for Atlyss.

Join the Discord Community

This mod is a server-authoritative anti-cheat designed to block common exploits by making the server the source of truth for player actions. It is highly configurable, allowing hosts to tailor the detections to their server's specific mods and balance.

All detected infractions are logged with player details in the BepInEx\plugins\HardAntiCheat\HardAntiCheat_InfractionLog.txt file for server admin review.

⚡ New in v2.0+: auto-whitelisting, human-readable kick messages, vanilla client support, live settings reload, and server-wide broadcast announcements!

✨ Key Features

• 🔐 Server-Authoritative Verification: All checks run on the server; clients cannot bypass them.
• 🧩 Mod List Verification: Via CodeTalker, verifies client-loaded mods against blacklists/whitelists.
• 🌩️ Integration: Auto-whitelists all mods published; blocks deprecated/flagged mods.
• 👤 Human-Readable Logs: Kick messages show ModName (GUID) vVersion for easy blacklisting/whitelisting.
• 🎮 Vanilla Client Support: Players without mods can join seamlessly; only modded clients are verified.
• ⚙️ Live Settings Reload: Change configs in-game via EasySettings—no restart required.
• 📢 Server Broadcasts: Kick/ban announcements appear in cyan chat for all players via [HAC] prefix.
• 🚀 Background Verification: Unknown mods are verified asynchronously after player joins—no handshake timeouts.
• 🔤 Case-Insensitive Matching: GUID lists work regardless of capitalization in config.
• 🛡️ Comprehensive Detections: Movement, XP, cooldowns, spam, revive, teleport, fly, and more.
• 🔗 Connection Limit: Caps simultaneous connections per Steam ID on the server, stopping multi-client "cloner" mods. The limit is enforced at the Steam transport before the game ever sees an extra connection, with a periodic scan as a second layer. Host-only; clients do not need HAC.
• 📊 Attribute Budget: Flags players whose attribute points (unspent plus spent) exceed what their level allows, however they got them. Optional respec with full refund.
• 🎓 Skill Point Budget: Flags players whose unlocked skills cost more skill points than their level has ever handed out. Optional reset with full refund, carried out by the player's client.

Instructions

• Install Dependencies: This mod requires CodeTalker.
• Optional UI: Install EasySettings to configure the mod in-game via the "HAC Settings" tab.
• Run & Config: Run the game once to generate the config file at BepInEx\config\com.HardAntiCheat.sftwre.cfg, or use the in-game UI.

Dependencies & Recommendations

| Mod Name | Status | Description |

|:--- |:---: |:--- |

| CodeTalker | REQUIRED | Handles secure networking for mod verifications. |

| EasySettings | Recommended | Adds an in-game settings menu to configure AntiCheat on the fly. |

| PerfectGuard | Compatible | Compatible soft-dependency for additional exploit protection. |

Configuration Settings

• General

| Setting | Default | Description |

|:--- |:-----------:|:--- |

| Enable AntiCheat | ✅ | Master switch to enable or disable all anti-cheat modules. |

| Disable Detections for Host | ✅ | If true, the player hosting will not be checked. |

| Trusted SteamIDs | | Comma-separated list of 64-bit SteamIDs for users who are exempt from checks. |

| Banned SteamIDs | | Comma-separated list of SteamIDs that are banned from joining immediately. |

| Verification Timeout | 25.0 | Seconds the server waits for a client to send their mod list before assuming vanilla. |

| Max Log File Size (MB) | 5 | Archives the infraction log on startup if it exceeds this size. |

• Mod Lists

Configure which mods are allowed, required, or forbidden. All GUIDs are case-insensitive.

| Setting | Default | Description |

|:--- |:---: |:--- |

| Enable Required Mods | ❌ | If true, clients MUST have the mods listed in Required Mod GUIDs or be kicked. |

| Required Mo