A little bit about me and this project/Disclaimer

I started coding in 2026 and am still learning. AI assistance was used for organization, planning, debugging, and understanding/fixing errors. Unless clarified otherwise, the rest is not AI. Apologies for any misunderstanding or lack of clarification.

ATLYSS Player Collision

Adds local-client player collision to ATLYSS. You can bump into other players, stand on head or chest platforms, use stick mode while riding, and tune boxes in EasySettings.

This is not server-authoritative physics. Each client creates and handles its own collision boxes.

Requirements

• BepInExPack
• EasySettings
• AtlyssCommandLib
• CodeYapper

Main Features

• Green body colliders around remote players.
• Yellow head platforms so players can stand on each other.
• Optional chest platform mode.
• Static and Dynamic box modes.
• Emote-friendly stick mode for sitting/emoting while riding.
• Old strict stick behavior for players who prefer stronger holding.
• Race, scale, visible-renderer, and pose-aware box sizing.
• Tiny-player safety that hides body/head/chest boxes with reason=tiny.
• Whitelist controls.
• Compatible-client /remove, whitelist sync, and pose helper messages through CodeYapper.
• Performance options for distance limits, nearest-player caps, and debug wire control.
• Three box preset slots.

Quick Commands

Useful aliases:

• /col, /collision, /pcollision
• /anchor, /ca
• /boxwhitelist, /boxwl, /cwl, /wl
• /boxsave 1, /boxload 1, /boxdel 1, /boxpresets

Box Modes

Static boxes are the default. They are more stable and cheaper.

Dynamic boxes update from renderer/body-mesh measurements more often. They can follow race, scale, and pose changes more closely, but cost more performance.

Only one mode can be enabled at a time. If the config ever ends up invalid, the mod fixes it automatically and prefers Static boxes.

Static mode can briefly use Dynamic-style measurement after scale changes, sit/emote pose changes, visual pose drift, or occasional refreshes. This helps correct placement without leaving Static mode on expensive measuring all the time.

Stick Modes

Emote stick is the default. It is designed to avoid interrupting sitting and emoting while still following the carrier.

Old strict stick behavior is stronger and more forceful. Use it if you prefer tighter holding over emote freedom.

Only one stick safety mode can be enabled at a time. If the config is invalid, the mod fixes it automatically and prefers Emote stick.

Chest Platforms

Chest mode moves the standing platform from the head area to a lower-middle chest target. It uses detected chest/body renderers when possible and falls back to scale-aware body sizing when needed.

EasySettings includes chest width, depth, thickness, height, and forward offset controls.

EasySettings

The mod adds a Player Collider tab.

Common controls:

• Local collision
• Mod enabled
• Debug wires
• Static boxes / Dynamic boxes
• Stick to carrier
• Rotate with carrier
• Emote stick / Old strict stick behavior
• Whitelist mode
• Push strength / Max push
• Limit boxes by distance
• Reduce rendered boxes
• Max rendered boxes

Collapsed tuning groups:

• Body box
• Head platform
• Chest platform
• Stick/runtime safety
• Size limits/presets

Performance Tips

For lower-end systems:

• Use Static boxes.
• Turn on Limit boxes by distance.
• Turn on Reduce rendered boxes and use a cap around 6-10.
• Keep debug wires off unless testing.
• Leave UseBakedPoseBounds=false unless you are testing exact pose bounds.

Dynamic boxes, baked pose bounds, debug wires, and crowded servers can cost more performance.

Multiplayer Notes

• Collision is local-client only.
• Every player needs the mod for their own collision experience.
• CodeYapper helper messages only work with compatible clients.
• Unmodded or incompatible clients will not receive remote remove, whitelist, or pose helper packets.
• Pose helper packets can improve collider placement for sitting/emoting, but they do not force ATLYSS visuals to match on every client.

Diagnostics

Use /collider status all when testing scale, race, static/dynamic mode, chest placement, tiny-player safety, or pose issues.

Useful fields:

• boxMode
• measure
• scale
• tiny
• chest
• poseLowered
• remotePose
• bodyTop
• headTop
• reason

Tiny players should show reason=tiny and should not have visible colliders or wires.

Known Issues

• Collision is not server-authoritative.
• Stick mode can still jitter during lag, fast movement, or some pose transitions.
• Some custom races, accessories, or unusual model setups may need manual tuning.
• Sitting/emoting can look different between clients.
• Chest forward offset assumes the model's local forward direction matches the visible character.
• Old configs with a nonzero Max size cap may still cap giant players until set back to 0.

Manual Install

Install the required dependencies, then place AtlyssPlayerCollision.dll in:

BepInEx/plugins/AtlyssPlayerCollision/

• Made by AzraeL0534

Special Thanks

• Nessie for EasySettings
• Soggy_Pancake for AtlyssCommandLib
• Soggy_Pancake for CodeYapper
• The BepInEx team for BepInExPack

Changelog

1.0.3

• Added clearer Static/Dynamic box mode handling. Only one can be active at a time, and invalid configs are fixed automatically.
• Improved Static boxes with short Dynamic-style correction bursts for scale changes, sitting, emoting, lowered poses, and occasional refreshes.
• Added compatible-client pose helper sync through CodeYapper so colliders can better follow sitting/emoting even when ATLYSS visuals do not match on other clients.
• Renamed Unsafe stick to Emote stick and made it better for sitting/emoting without making it as strict as Old strict stick.
• Improved Static head placement, chest platform placement, chest sizing, and chest tuning controls.
• Reinforced race/scale handling and tiny-player safety for body, head, and chest boxes.
• Added better /collider status all diagnostics for box mode, measurement type, pose state, remote pose state, scale, tiny status, and hide reason.
• Reduced some runtime overhead to help lower-end systems without changing box placement or stick behavior.
• Updated README and manifest text to better explain the current feature set.

Notes

• Collision is still local-client only.
• Pose helper sync improves collider placement, but it does not force ATLYSS animations to visually match on every client.
• For better performance, use Static boxes, keep debug wires off, and enable distance/nearest-player limits in crowded areas.

1.0.2

• Added CodeYapper support for compatible-client /remove requests.
• Added whitelist policy sync for compatible clients.
• Added local/remote whitelist diagnostics and remoteWhitelist hide reasons.
• Split the green body box from the head platform so the body collider can be disabled while the platform stays active.
• Improved EasySettings organization and renamed the body toggle to Green body box.
• Kept stick behavior focused on sit/emote-friendly vertical slack.
• Updated package docs and dependencies for CodeYapper.

1.0.1

• Fixed /remove rider detection.
• Fixed whitelist mode so listed players keep boxes and non-listed players are hidden/non-solid locally.
• Removed the need to add your own Steam64 ID to the whitelist.
• Fixed /collider on and EasySettings recovery after toggles were disabled.
• Added distance limits and nearest-player box reduction for performance.
• Added better hide reasons in /collider status all.
• Reorganized EasySettings so common controls are easier to find.

1.0.0

• Initial Thunderstore release.
• Added local-client player collision boxes for ATLYSS.
• Added green body colliders and yellow head platforms.
• Added dynamic sizing for race, scale, large characters, visual model changes, and pose changes where possible.
• Added stick/anchor mode with optional carrier rotation.
• Added rider body suppression while standing on your head platform.
• Added /remove <player name>, whitelist commands, box presets, EasySettings controls, and basic diagnostics.

Known Issues

• Collision is local-client only and is not server-authoritative.
• Every player needs the mod for their own collision experience.
• Stick/anchor riding can still jitter during lag, fast movement, or some pose transitions.
• Custom races, accessories, and unusual model setups may need manual tuning.
• Debug wires, Dynamic boxes, baked pose bounds, and crowded sessions can cost performance.