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

HardAntiCheat

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

By s0apy
https://store.steampowered.com/app/2768430/ATLYSS/
Date uploaded 4 days ago
Version 2.0.2
Download link s0apy-HardAntiCheat-2.0.2.zip
Downloads 27
Dependency string s0apy-HardAntiCheat-2.0.2

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

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

Preferred version: 5.4.2100
Marioalexsan-PerfectGuard-1.0.0 icon
Marioalexsan-PerfectGuard

Work in progress anti-exploit plugin for Atlyss multiplayer.

Preferred version: 1.0.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

  1. Install the mod and run the game once to generate the configuration file.
  2. Close the game.
  3. Navigate to BepInEx\config and open the file named HardAntiCheat.cfg.
  4. 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 Adds a client-side perfect guard / parry mechanic to combat.

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.
Max Log File Size (MB) 5 If the infraction log exceeds this size on startup, it will be archived.

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.

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

Public Test Updates

V2 - Reforctory - Public Test Update (Updated each V2 revision/build)

  • Fixes "Players getting railed on skill init still" FULLY

  • Fixed fly/movement checks

  • Fixed host bool issue

  • Added logging choices depending on user choice

  • Patched Teleportation by call

  • Updated Readme (Vx.x.1)

  • Canofwhoopass Bugfix (Thx homebrewery)

  • Airborne Height limiting check (Allows you to fly within the height limit)

  • Fixed isHost bug

  • Fixed Revive detection logic

  • Added TanukiUtil Mod Detection (W.I.P)

  • In-Game Logical Actions fixes Example:

  • Too Fast?: Attempts to reset.
  • Cooldown modified?: Interrupts your sklill.
  • Died but revived by menu?: You will be unable to revive by a mod menu, use angela's tears instead.

1.0.7 - Bugfix - Public Test Update

  • Players getting railed on skill init

1.0.6 - Stability & Feedback - Public Test Update

  • Fixed Critical Initialization Bug: The dynamic Haste ID detection has been moved to the correct loading point, fixing a startup error where it would fail to find the game's data. The check is now guaranteed to run once, at the right time, and only on the server.
  • Added Automatic Log Archiving: To prevent log files from growing infinitely on long-running servers, the infraction log is now automatically archived on startup if it exceeds a configurable size (default is 5MB).
  • Added Public Punishment Announcements: When a player is automatically kicked or banned, a message is now broadcast to all players on the server, making the anti-cheat's actions transparent.
  • Added Server Start Confirmation: A message is now logged to the server console when the first player spawns, confirming that the anti-cheat modules are active and monitoring.

1.0.5 - Lag Compensation Fix - Public Test Update

  • Overhauled Movement Detection: The teleport/speed check is now significantly more tolerant of network lag, drastically reducing false positive kicks.
  • Added Lag Configuration: Introduced new settings (Max Effective Speed, Movement Grace Buffer, Movement Time Threshold) to allow server admins to fine-tune movement detection for high-latency environments.
  • Improved Speed Hack Detection: The speed stat check is now more intelligent. It dynamically records each player's legitimate speed on spawn and uses that as the baseline, making it more accurate than a fixed value.
  • Fixed Critical Vulnerability: Corrected a major flaw where cast times for standard, instant-cast skills were not being validated. All skill types are now properly checked.
  • Standardized Log Path: The infraction log file path is now always BepInEx\plugins\HardAntiCheat\, ensuring consistent and easy access for server admins.

1.0.4 - Public Test Update

  • Intelligent Skill cooldown check improvement
  • Should flag speedhack properly now

1.0.3 - Public Test Update

  • Fixed bugs

1.0.2 - Public Test Update

  • Airborne check is back
  • Fixed bugs

1.0.1 - Public Test Update

  • Pushed

1.0.0

  • Initial release

Silent Updates

Shh, these are silent updates - just fixes and stuff (Some might not be on here)

  • New logo
  • Tinker Tappers
  • shh CHANGELOG.md incident (x2)
  • scraped damage idea

About

Contact Us Privacy Policy Thunderstore Wiki

Developers

API Docs GitHub Repo Package Format Docs Markdown Preview Manifest Validator

Thunderstore 2024