For the complete documentation index, see llms.txt. This page is also available as Markdown.

🧱 Collision Conflicts

Collision conflicts involve .ybn collision dictionaries.

When is it a conflict?

Conflict Tool reports a collision conflict when two or more resources reference the same collision dictionary but contain different collision payloads.

The scanner compares the actual collision data rather than just checking whether the filename or reference appears more than once.

If two resources contain the same untouched collision data, that is not a conflict.

Why this matters

Only one version of the collision can win the streaming race.

That means load order can silently decide which walls, floors, holes, or other collision surfaces players actually get.

Resolution

The tool can strip the losing physics reference so the chosen collision version applies consistently.

Collision overlay

While reviewing .ybn conflicts, press V to toggle the collision overlay.

The overlay draws the contested collision against the vanilla collision in-world, making it easier to see what changed before choosing a resolution.

Last updated