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

HardAntiCheat

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

Date uploaded a week ago
Version 2.4.2
Download link s0apysfederati0n-HardAntiCheat-2.4.2.zip
Downloads 39
Dependency string s0apysfederati0n-HardAntiCheat-2.4.2

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
Nessie-EasySettings-1.1.8 icon
Nessie-EasySettings

A mod API for easily adding options to the settings menu.

Preferred version: 1.1.8

README

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

  1. Install Dependencies: This mod requires CodeTalker.
  2. Optional UI: Install EasySettings to configure the mod in-game via the "HAC Settings" tab.
  3. 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.

CHANGELOG

Changelog

v2.4.x - Menu Overhaul - 3/3/26

  • Changed Enable Mod Blacklist to false by default.

  • Added the Nessie.ATLYSS.EasySettings soft dependency.

  • Implemented the AddSettings UI so you can configure everything in-game (including text fields for SteamIDs and blacklists, and dropdowns for punishment types).

  • Updated README.md fully.

  • Bug Fixes:

    • Should fix the bug where the menu is straight up not appearing
Old Updates

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
    • Updated Readme for more clarification (2/14)

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.