This package has been marked as deprecated, and it's suggested another
alternative is used.
You are viewing a potentially older version of this package.
View all versions.
HardAntiCheat
Anti-cheat plugin for Atlyss multiplayer. (In Public Testing)
| Date uploaded | 8 months ago |
| Version | 2.2.1 |
| Download link | s0apy-HardAntiCheat-2.2.1.zip |
| Downloads | 197 |
| Dependency string | s0apy-HardAntiCheat-2.2.1 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2304
Marioalexsan-PerfectGuard
Work in progress anti-exploit plugin for Atlyss multiplayer.
Preferred version: 1.1.0
README
HardAntiCheat
A powerful, configurable, server-side anti-cheat engine for Atlyss.
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 the mod and run the game once to generate the configuration file.
- Close the game.
- Navigate to
BepInEx\configand open the file namedHardAntiCheat.cfg. - Adjust the settings as needed for your server. Using a configuration manager mod to edit these values in-game is also supported.
Recommended Mods
These mods are not required dependencies but are confirmed to be compatible and can enhance the server experience alongside HardAntiCheat.
| Mod Name | Description |
|---|---|
| PerfectGuard | Work in progress anti-exploit mod for server hosts. |
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. Recommended for admins. |
Trusted SteamIDs |
✅ | A comma-separated list of 64-bit SteamIDs for users who should be exempt from all anti-cheat checks. |
Max Log File Size (MB) |
5 | If the infraction log exceeds this size on startup, it will be archived. |
Enable Client Verification |
✅ | If true, kicks players who don't have HardAntiCheat installed. |
Verification Timeout |
25 | How many seconds the server will wait for a client to verify before kicking them (if Client Verification is enabled). |
Movement Detections
This module validates player movement to prevent speed, teleport, and fly hacking.
| Setting | Default | Description |
|---|---|---|
Enable Teleport/Distance Checks |
✅ | Checks if players are moving faster than physically possible based on distance over time. |
Max Effective Speed |
100.0 | The maximum speed (units/sec) used in the distance check. Increase this if lagging players or certain skills cause false flags. |
Movement Grace Buffer |
10.0 | A flat distance buffer added to the distance check to account for dashes, knockbacks, and lag spikes. |
Movement Time Threshold |
5.5 | The time (in seconds) between position checks. Higher values are more lenient on lag but less precise. |
Teleport Distance Threshold |
50.0 | Any movement flagged by the distance check that also covers more than this distance is logged as a "Teleport" instead of "Speed". |
Enable Fly/Infinite Jump Checks |
✅ | Detects players airborne for too long. Uses a vertical stall heuristic to intelligently ignore legitimate ledge grabs and climbing. |
Enable Base Speed Stat Audits |
✅ | Prevents players from illegally modifying their base movement speed. Uses the Speed Tolerance Multiplier to allow for buffs. |
Speed Tolerance Multiplier |
3.0 | Allows player speed to exceed their base speed by this multiplier (e.g., 3.0 = 200% bonus speed) before being clamped. |
Jump Threshold |
8 | The maximum number of consecutive jumps a player can perform before needing to touch the ground. |
Speed Hack Detection Cooldown |
2.0 | Cooldown (in seconds) before another speed stat infraction is logged for the same player. Prevents log spam. |
Jump Hack Detection Cooldown |
2.0 | Cooldown (in seconds) before another jump stat infraction is logged for the same player. |
Airborne Hack Detection Cooldown |
10.0 | Cooldown (in seconds) before another airborne infraction is logged for the same player. |
Stat Detections
This module validates changes to player stats like experience and levels.
| Setting | Default | Description |
|---|---|---|
Enable Experience/Level Checks |
✅ | Prevents players from gaining huge amounts of XP or multiple levels at once. |
Max Plausible XP Gain |
77000 | The maximum XP a player can gain in a single transaction. Adjust based on your server's max XP rewards. |
Max Plausible Currency Gain |
50000 | The maximum amount of Currency a player can add via a direct command. Catches /currency cheats. |
Combat Detections
This module enforces server-side authority over combat actions.
| Setting | Default | Description |
|---|---|---|
Enable Skill Cooldown Checks |
✅ | Prevents using skills faster than their cooldowns allow. Dynamically accounts for cooldown-reducing effects. |
Enable Self-Revive Checks |
✅ | Prevents players from reviving themselves or replenishing their stats while dead. |
Punishments
Configure automatic server actions for players who accumulate too many infractions.
| Setting | Default | Description |
|---|---|---|
Enable Punishment System |
✅ | Enables the server to automatically kick or ban cheating players. Punishments are announced in server chat. |
Infractions Until Action |
5 | Number of infractions allowed before the selected punishment is triggered. |
Action Type |
Kick | The action to take (Kick or Ban) when the infraction limit is reached. |
Logging
Control the level of detail in the infraction logs.
| Setting | Default | Description |
|---|---|---|
Enable Detailed Logs |
✅ | Master switch for detailed infraction logs. If false, only punishments are logged. |
Log Player Name |
✅ | Include the player's name in detailed logs. |
Log Player ID |
✅ | Include the player's SteamID/netId in detailed logs. |
Log Infraction Details |
✅ | Include the specific reason/details of the infraction. |
Log Infraction Count |
✅ | Include the player's current warning count in the log entry. |
CHANGELOG
Changelog
v2.3.x - The Stability & Behavioral Overhaul - 1/18/26
Major Networking & Logic Rewrite
- Fixed Connection Issues: Switched handshake networking to Binary P2P (SteamNetworkingMessages). This resolves the
k_EResultInvalidParamerrors and prevents players from timing out while loading into the server. - Integrity Logic Change: Removed "Strict Hashing" integrity checks which were causing false positives for vanilla players or those with different mod versions.
- New Mod Enforcement: Switched to a Blacklist System. The server now accepts all mods by default and only kicks clients if they have a specific GUID listed in the
BlacklistedModGUIDsconfig. - New Behavioral Detections:
- Infinite Stamina: Detects players sprinting without losing stamina.
- Consumable Spam: Prevents using items faster than humanly possible (Macro detection).
- Weapon Swap Spam: Prevents animation canceling via rapid weapon switching.
- Parry Botting: Detects inhuman block input speeds.
- Crash Fixes: Resolved
NullReferenceExceptionerrors in the movement validation patch. - Stability: Added a safety delay to the handshake to ensure the player object is fully initialized before checking.
- Bug Fixes:
-
- fixed a bug that was lingering like a fly, server reinit re registration
Old Updates
Public Test Updates (Pre-v2.3.0)
- Codetalker Update: Updated dependencies to latest version - 1/17/26
- Validation Improvements: Made validation abide by Thunderstore policy (reading names + GUIDs) - 11/22/25
- Game Update: Updated compatibility for latest game patch - 1/11/26
- Fixes: Fixed missing detections and extended verification length - 10/14/25
- SteamID: Added Whitelist/Blacklist for SteamIDs - 10/12/25
v2.2.0 - Refactory
- Fixed "Players getting railed on skill init" bug.
- Fixed fly/movement checks and host boolean logic.
- Added logging configuration choices.
- Patched Teleportation by call.
- Airborne Check: Added height limiting check.
- Revive Fix: Fixed revive detection logic (Angela's Tears requirement).
- Currency: Added Currency Add Check back.
- Syncing: Added CodeTalker Anti-Cheat Syncing.
v1.0.7 - Bugfix
- Fixed skill initialization issues.
v1.0.6 - Stability & Feedback
- Fixed Critical Initialization Bug: Dynamic Haste ID detection moved to correct loading point.
- Log Archiving: Added automatic log archiving to prevent massive file sizes.
- Announcements: Added public punishment announcements to chat.
- Confirmation: Added server start confirmation message.
v1.0.5 - Lag Compensation Fix
- Movement: Overhauled movement detection to be tolerant of lag.
- Config: Added
Max Effective Speed,Grace Buffer, andTime Thresholdconfigs. - Speed Hack: Improved detection using dynamic baseline recording.
- Vulnerability Fix: Corrected cast time validation for instant-cast skills.
- Paths: Standardized log file paths.
v1.0.4
- Intelligent Skill cooldown check improvement.
- Flagged speedhack properly.
v1.0.3
- General bug fixes.
v1.0.2
- Airborne check re-enabled.
v1.0.0
- Initial release.
