You are viewing a potentially older version of this package. View all versions.
s0apy-HardAntiCheat-2.0.0 icon

HardAntiCheat

Anti-cheat plugin for Atlyss multiplayer. (In Public Testing)

Date uploaded 10 months ago
Version 2.0.0
Download link s0apy-HardAntiCheat-2.0.0.zip
Downloads 161
Dependency string s0apy-HardAntiCheat-2.0.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2304 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2304
Marioalexsan-PerfectGuard-1.1.0 icon
Marioalexsan-PerfectGuard

Work in progress anti-exploit plugin for Atlyss multiplayer.

Preferred version: 1.1.0
Soggy_Pancake-CodeYapper-2.2.0 icon
Soggy_Pancake-CodeYapper

A simple library to abstract away networking

Preferred version: 2.2.0

README

HardAntiCheat

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

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 needs.

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

Instructions

In order to utilize this plugin, you must install it and load the game once for the configuration file to be generated. Once loaded, close the game and head into BepInEx\Configs (or if you use a mod manager, you should be able to edit the config from its UI). Once there, look for a file named HardAntiCheat.cfg (the exact name is based on the mod's GUID).

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 Adds a client-side perfect guard / parry mechanic to combat.

General Configurations

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 for infractions. Recommended for admin commands.
Max Log File Size (MB) 5 If the infraction log exceeds this size on server startup, it will be archived and a new, clean log will be created.

Movement Detections

Setting Default Description
Enable Teleport/Distance Checks Checks if players are moving faster than physically possible, preventing speed hacks and teleportation.
Max Effective Speed 100.0 The maximum plausible speed (units per second) a player can move. Increase this if lagging players get false flagged.
Movement Grace Buffer 10.0 A flat distance buffer added to the calculation to account for dashes, knockbacks, and small lag spikes.
Movement Time Threshold 5.5 The time (in seconds) between position checks. Higher values are more lenient on lag but less precise.
Enable Fly/Infinite Jump Checks Checks if players are airborne for an impossibly long time and if their max jump stat has been illegally modified.
Enable Base Speed Stat Audits Prevents players from illegally modifying their base movement speed by reverting it to their spawn speed.
Jump Threshold 8 Your threshold to jump cooldown

Stat Detections

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 amount of XP a player can gain in a single transaction. Adjust based on your server's max XP rewards.

Combat Detections

Setting Default Description
Enable Skill Cooldown Checks Prevents using skills faster than their cooldowns allow. Dynamically accounts for cooldown-reducing effects like Haste.
Enable Self-Revive Checks Prevents players from reviving themselves or replenishing their stats while dead.

Punishments

Setting Default Description
Enable Punishment System Enables the server to automatically take action against cheating players. Punishments are announced in server chat.
Infractions Until Action 5 Number of infractions allowed before action is triggered.
Action Type Kick The action to take (Kick or Ban) when the infraction limit is reached.

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_EResultInvalidParam errors 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 BlacklistedModGUIDs config.
  • 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 NullReferenceException errors 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, and Time Threshold configs.
  • 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.