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 enabled
• Local collision
• Debug boxes
• Body width
• Body depth
• Body height
• Head width
• Head depth
• Head height
• Platform clearance
• Head top estimate
• Max size cap
• Tiny disable
• Stick to carrier
• Rotate with carrier
• Whitelist 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:

Aliases:

• /col
• /collision
• /pcollision

Stick / Anchor Commands

Stick mode tries to keep you attached to the player you are standing on.

Rotation commands:

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.

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.

Short whitelist aliases:

• /boxwl
• /cwl
• /wl

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.

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/

• Made by AzraeL0534

Special Thanks to:

• Nessie for EasySettings
• Soggy_Pancake for AtlyssCommandLib