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 performance controls to hide boxes by distance and limit active boxes to the nearest eligible players.
• Adds three box-size preset slots for quick tuning.
• Adds EasySettings controls for sizing, debug wires, whitelist, stick behavior, performance, 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.

Whitelist mode is also local-client only. Your whitelist controls which remote players get active boxes on your client. It cannot force another unmodded or differently configured client to obey your whitelist.

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.

Basic settings include:

• Mod enabled
• Local collision
• Debug wires
• Stick to carrier
• Rotate with carrier
• Whitelist mode
• Push strength
• Max push
• Limit boxes by distance
• Box render distance
• Reduce rendered boxes
• Max rendered boxes

Advanced fit settings are lower in the tab:

• Solid body
• Head platform
• Break distance
• Spawn grace
• Body/head gap
• Platform thickness
• Head top estimate
• Platform clearance
• Body width
• Body depth
• Body height
• Head width
• Head depth
• Head height
• Base width
• Base depth
• Base height
• Width mult
• Depth mult
• Height mult
• Width padding
• Height padding
• Min size
• Max size cap

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.

Performance

• Limit boxes by distance hides boxes and debug wires for remote players farther than Box render distance.
• Box render distance controls the horizontal range used by distance limiting.
• Reduce rendered boxes keeps only the nearest eligible remote players active.
• Max rendered boxes controls the nearest-player cap when reduction is enabled.

Hidden players from these performance options do not keep active body/platform colliders or debug wires, and pose measuring is skipped until they become eligible again.

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, only remote players whose Steam64 IDs are listed get active body/platform boxes on your client. You do not need to add your own Steam64 ID.

Short whitelist aliases:

• /boxwhitelist
• /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/