A little bit about me and this project/Disclaimer
I have been coding and learning how to code since the start of 2026, so I am still new and learning as I go. Please do not assume every part of this project was made by someone with years of experience.
AI assistance has also been used while working on this project for things like organization, planning, debugging, understanding/fixing errors. Unless clarified the rest is not AI. Apologies in advance for any misunderstanding or lack of clarification.
ATLYSS Player Collision
ATLYSS Player Collision adds local-client collision boxes to other players so you can bump into them, stand on their head platform, use stick/anchor mode while riding, and tune the box sizes through EasySettings.
This mod is meant to make player-to-player interaction feel more physical and playful. It does not add server-authoritative physics and it does not send custom collision packets.
ATLYSS Player Collision requires:
- BepInExPack
- EasySettings
- AtlyssCommandLib
What This Mod Does
- Adds green body collision boxes around remote players.
- Adds yellow head/platform boxes above remote players so others can stand on them.
- Dynamically sizes boxes based on player race, visible model, scale, and pose when possible.
- Supports very large players and old configs with
Max size cap migrated back to uncapped defaults.
- Automatically disables collision boxes for extremely tiny players at or below the configured tiny-player threshold.
- Adds stick/anchor mode so a rider can stay attached to another player's head platform.
- Supports optional rider rotation with the carrier.
- Suppresses the rider's green body collider while they are detected on your head platform, while keeping their yellow platform available.
- Keeps the carrier's green body collider active.
- Adds whitelist controls for players who want only selected Steam64 IDs to have colliders.
- Adds three box-size preset slots for quick tuning.
- Adds EasySettings controls for sizing, debug wires, whitelist, stick behavior, runtime ranges, and safety settings.
Multiplayer / Netcode Notes
This mod is local-client only.
Each player needs the mod installed for their own collision experience. If you install the mod, you can collide with the boxes that your client creates around other players. Another player without the mod will not automatically experience your local collision.
The mod uses the normal networked ATLYSS Player objects that already exist. It does not add server-authoritative collision physics. Because of that, exact behavior may differ between clients, especially in crowded sessions, during lag, or while players are using custom scale/race mods.
EasySettings
ATLYSS Player Collision adds a Player Collider tab through EasySettings.
Settings are backed by the normal BepInEx config file, so they can also be edited manually after first launch.
Useful settings include:
Mod enabledLocal collisionDebug boxesBody widthBody depthBody heightHead widthHead depthHead heightPlatform clearanceHead top estimateMax size capTiny disableStick to carrierRotate with carrierWhitelist enabled
Most numeric tuning sliders support wide positive and negative ranges. Unsafe values are clamped internally so a bad setting should not create invalid collider sizes.
For giant players, keep Max size cap at 0 unless you intentionally want to cap collider size.
Commands
Main commands:
| Command |
Description |
/collider on |
Enable local collision |
/collider off |
Disable local collision |
/collider toggle |
Toggle local collision |
/collider debug |
Toggle debug wireframes |
/collider status |
Show local collider diagnostics |
/collider status all |
Show diagnostics for all tracked players |
/collider reset |
Reset box tuning settings |
/collider panic |
Emergency disable and reset grace period |
/collider help |
Show command help |
Aliases:
/col/collision/pcollision
Stick / Anchor Commands
Stick mode tries to keep you attached to the player you are standing on.
| Command |
Description |
/stick on |
Enable stick/anchor mode |
/stick off |
Disable stick/anchor mode |
/stick status |
Show stick status |
/anchor on |
Enable stick/anchor mode |
/anchor off |
Disable stick/anchor mode |
/anchor status |
Show anchor status |
/ca on |
Short alias for anchor on |
/ca off |
Short alias for anchor off |
/ca status |
Short alias for anchor status |
Rotation commands:
| Command |
Description |
/stick rotate on |
Rotate rider with carrier turns |
/stick rotate off |
Stop rotating rider with carrier turns |
/anchor rotate on |
Rotate rider with carrier turns |
/anchor rotate off |
Stop rotating rider with carrier turns |
/anchor rotate status |
Show rotation setting |
Stick/anchor behavior is best-effort. ATLYSS animations, emotes, sitting, dashing, lag, and custom scale changes can still make riding imperfect.
Head-Box Removal
If someone is detected on your head platform, you can list or remove them locally.
| Command |
Description |
/remove |
List players detected on your head box |
/remove <player name> |
Remove a detected rider from your head box |
/collider remove <player name> |
Same as /remove <player name> |
This is local only. It moves the detected rider from your client view and gives a short grace period.
Whitelist
Whitelist mode lets you limit who gets active colliders.
When whitelist is enabled, both your local Steam64 ID and the remote player's Steam64 ID need to be allowed for collision interaction to happen on your client.
| Command |
Description |
/collider whitelist on |
Enable whitelist mode |
/collider whitelist off |
Disable whitelist mode |
/collider whitelist status |
Show whitelist status |
/boxallow <player name or steam64> |
Add a player |
/boxdeny <player name or steam64> |
Remove a player |
/boxlist |
List saved Steam64 IDs |
Short whitelist aliases:
Collider command aliases:
/collider allow <player name or steam64>/collider deny <player name or steam64>/collider list
Box Presets
You can save up to three box tuning presets.
| Command |
Description |
/save boxpreset 1 |
Save current box settings to slot 1 |
/save boxpreset 2 |
Save current box settings to slot 2 |
/save boxpreset 3 |
Save current box settings to slot 3 |
/load boxpreset 1 |
Load slot 1 |
/load boxpreset 2 |
Load slot 2 |
/load boxpreset 3 |
Load slot 3 |
Extra aliases:
/boxsave 1/boxload 1/boxdel 1/boxpresets/collider preset save 1/collider preset load 1/collider preset delete 1/collider preset list
Known Issues / Potential Problems
- Large custom races and extreme player scale values are best-effort. The mod measures visible renderers and transforms, but some custom models may expose unusual renderer or bone layouts.
- Sitting, laying, and emotes may not always move ATLYSS bones/renderers the same way they move the visible character.
- Stick/anchor can still jitter in some pose states or during heavy lag.
- Collision is not server-authoritative. Each client needs the mod for their own collision behavior.
- Debug wireframes and frequent pose measuring may cost performance in crowded servers.
- Accessories, weapons, wings, horns, tails, hair, or custom parts can sometimes affect measurements if they are named in unexpected ways.
- If an old config has
Max size cap set to a deliberate nonzero value, giant players may still be capped until it is set back to 0.
Useful troubleshooting commands:
/collider reset/collider debug/collider status/collider status all/collider panic
Manual Install
Install BepInExPack for ATLYSS.
Install the required dependencies:
- EasySettings
- AtlyssCommandLib
Place AtlyssPlayerCollision.dll in:
BepInEx/plugins/AtlyssPlayerCollision/
Special Thanks to:
- Nessie for EasySettings
- Soggy_Pancake for AtlyssCommandLib
