Maps & Prop Conflicts
Manage duplicate placements, clean up stream folders, and resolve physical entity overlaps in the game world.
🗑️ Duplicate File Cleanup
- Multiple map folders streaming identical collision or placement files waste server memory and cause visual glitches.
- The dashboard identifies duplicates and lets you disable redundant copies cleanly while keeping the desired version active.
- Duplicates are grouped by what they actually are, Collision, Occlusion, Prop and Asset files, so you can start with the ones causing the bug you're chasing. A side list shows which resources are involved in the most conflicts, giving you an obvious place to start.
- Where two copies can be safely combined, the tool merges them instead of making you throw one away. See Merging & Resolving Conflicts.
⚡ Review & Fix All
Rather than clicking through conflicts one at a time, open the batch review. It lists every duplicate the scan found, with the recommended copy already selected for each one:
- Switch the recommendation between newest and largest in one click.
- Override any individual row with your own choice.
- Anything the tool judges too risky to decide for you is pre-set to skip, so a bulk fix never guesses on your behalf.
- One Apply resolves everything you approved, with a single restorable backup.
🧱 Prop Placement Conflicts
- Different map packs can decorate the same spot without ever sharing a filename. Those clashes get their own tab, with a review of exactly which props move where before anything is written. See Prop Placement Conflicts.
🎥 Live In-World Map Editor
- Access a 3D editor camera directly in-game to inspect physical intersections, floating items, or duplicate props.
- Interactive 3D handles let you click, drag, reposition, rotate, or hide entities on the fly.
- All changes are saved as persistent overrides, allowing you to clean up map bugs dynamically without modifying the original source files.
- A live list of nearby conflicts sits beside the camera, click any entry to fly straight to it. You can also run the duplicate-file scan and apply fixes without leaving the editor.
🧊 Collision Mesh Viewer
Collision is invisible by design, which is what makes a bad .ybn so hard to chase, you can feel the wall but never see it.
The Collision button in the editor (or V) draws it. It reads the collision files themselves and renders their actual surface in the world in red, so a duplicated or misplaced collision becomes something you can simply look at and fly around.
- Only the clashing collisions near the camera are drawn, so you see the problem rather than every wall on the map.
- The mesh follows you as you fly, refreshing itself as you move.
- Draw distance and detail are tunable in
shared/server_config.luaunderConfig.CollisionOverlay.
Pair it with the Probe below: the viewer shows you where the bad collision is, the probe tells you which file and resource it came from.
🎯 Invisible Wall Tracing (Collision Probe)
The hardest map bug to chase is the one you can't see: a wall, floor or ramp that blocks players with nothing there to look at. The Probe tool in the editor traces it for you.
Fly to the spot and choose whichever suits the situation:
| Tool | Use it when |
|---|---|
| Click the surface | You can aim at the invisible wall from outside it |
| Probe under me | You're standing inside the collision and can't aim at a face |
| Collisions nearby | You can't aim at all, sweeps everything around the camera and lists the nearest first |
The probe reports where it hit, what kind of surface it is, and, crucially, which collision file and resource it came from, so you know exactly which pack to fix. From the result you can jump straight to that file's cleanup view.
While you're there, the same panel surfaces two other common culprits around you:
- Stacked props: the same object duplicated in one spot (the flickering you see). Fly to it, or remove the duplicate on the spot.
- Invisible collision props: props that render invisibly but still block movement. Hide one to switch its collision off; it's reversible any time.
🌫️ Occlusion Files
Some map files hold no props at all, they tell the engine what it can skip drawing behind buildings. When two packs ship different versions, they can't be prop-merged, so the tool shows a plain side-by-side comparison of what each copy contains and lets you keep the one matching the build you're running.
Clothing Conflicts
Resolve overlapping clothing assets, clean up stream folders, and preview custom wardrobes before you decide anything.
Prop Placement Conflicts
Two map packs can decorate the same corner of the city without ever sharing a filename. Conflict Resolver catches those too, it looks at the props themselves, not just the files that hold them.