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.

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

1. 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.
`Enable Mod Blacklist`	❌	If true, kicks clients who have specific GUIDs loaded (requires CodeTalker handshake).
`Blacklisted Mod GUIDs`		Comma-separated list of forbidden Mod GUIDs (e.g. `com.cheat.menu`).
`Verification Timeout`	25.0	Seconds the server waits for a client to send their mod list before kicking.

2. Movement Detections

Validates player position and physics to prevent speed, teleport, and fly hacking.

Setting	Default	Description
`Enable Teleport Checks`	✅	Checks if players move faster than physically possible based on distance/time.
`Max Effective Speed`	100.0	The max speed used for distance calculations. Increase if legit skills cause rubberbanding.
`Movement Grace Buffer`	10.0	Distance buffer to account for dashes, knockbacks, and lag spikes.
`Teleport Threshold`	50.0	Distance instantly flagged as a "Teleport" rather than a speed violation.
`Enable Fly Checks`	✅	Detects players airborne for too long (10s limit).
`Enable Speed Stat Checks`	✅	Prevents players from illegally modifying their base movement speed stat.
`Jump Threshold`	8	Maximum consecutive jumps allowed before needing to touch the ground.

3. Stats & XP

Validates character progression and resource gain.

Setting	Default	Description
`Enable XP Checks`	✅	Prevents players from gaining impossible amounts of XP.
`Max XP Gain`	77000	Max XP allowed in a single transaction/kill.
`Max XP Rate`	150000	Max total XP allowed within the defined time window.
`XP Window`	30.0	Time window (seconds) for the XP Rate check.

4. Combat & Spam

Enforces cooldowns and prevents macro-spamming of items and actions.

Setting	Default	Description
`Enable Cooldown Checks`	✅	Prevents using skills faster than their base cooldowns allow.
`Enable Revive Checks`	✅	Prevents players from calling self-revive or replenish without authorization (Angela's Tear).
`Enable Spam Checks`	✅	Master switch for input rate limiting (Items, Swaps, Blocks).
`Min Consumable Interval`	0.4	Minimum seconds between using items (prevents potion spam macros).
`Min Weapon Swap Interval`	0.25	Minimum seconds between weapon swaps.
`Min Block Interval`	0.1	Minimum seconds between block inputs (Prevents "Perfect Guard" bots).

5. Punishments

Configure automatic server actions for players who accumulate too many infractions.

Setting	Default	Description
`Enable Auto-Punish`	✅	Automatically kicks or bans players after the limit is reached.
`Infractions Limit`	5	Number of warnings allowed before action is taken.
`Action Type`	Kick	The action to take (`Kick` or `Ban`).

6. Logging

Setting	Default	Description
`Enable Detailed Logs`	✅	Master switch for detailed infraction logs.
`Log Player Name/ID`	✅	Include player identity in logs.
`Max Log File Size (MB)`	5	Archives the log file on startup if it exceeds this size.