Collision Compatibility
When running multiple SPOONI mappings on the same RedM server, you may encounter collision conflicts that prevent players from entering buildings or cause other physics issues. This guide explains why this happens and how to fix it.
What is a Collision?
In Red Dead Redemption 2, every solid surface in the world has an invisible collision mesh — the data that stops players and objects from falling through floors, walls, and other geometry.
Rockstar does not create individual collision files per building. Instead, they bundle collision data for entire areas, districts, or neighborhoods into a single large collision file (.ybn). This means one file can cover dozens of buildings at once.
Why Conflicts Occur
When a SPOONI mapping modifies or adds geometry to an area, it ships its own custom collision file to match. This works perfectly when you only have one mapping in that area.
The problem arises when two or more mappings cover overlapping areas — each brings its own collision file for the same underlying Rockstar collision zone. When loaded together, these files overwrite each other, resulting in:
- Players unable to enter buildings
- Objects falling through floors
- Invisible walls or missing surfaces
- Incorrect physics in affected areas
The Solution: Update Folder
Each SPOONI resource that has collision compatibility concerns ships with an update folder. Inside this folder you'll find subfolders named after every other SPOONI mapping that conflicts with it, plus an all folder for convenience if you own all of the conflicting mappings.
spooni_example_mapping/
├── stream/
│ └── (active collision files)
└── update/
├── all/
│ └── (combined collision files for all conflicts)
├── spooni_other_mapping_a/
│ └── (collision files merged for this pair)
└── spooni_other_mapping_b/
└── (collision files merged for this pair)IMPORTANT
The collision files in the update folder are merged versions that contain the correct collision data for both resources. You must copy them into every affected resource — not just one.
Step-by-Step Fix
1. Identify which mappings you have installed
Check which SPOONI mappings are running on your server that could share collision areas with the resource you are configuring.
2. Choose the correct subfolder
Navigate into the update folder of your SPOONI resource:
- If you own all of the listed conflicting mappings → use the
allsubfolder - If you only own some of them → use the subfolder that matches each specific mapping you have
3. Copy the collision files
Take all files from the chosen subfolder and copy them.
4. Paste into stream folders — overwrite in both resources
You need to paste and overwrite the files in two places:
- The
streamfolder of this resource (the one containing theupdatefolder) - The
streamfolder of each other affected mapping
WARNING
Overwriting is intentional. The new files replace the individual collision files with a merged version that works for both resources simultaneously.
5. Restart the server
After copying all files, restart your server for the changes to take effect.
Example
You have both spooni_blackwater_reborn and spooni_railroad installed. Both cover overlapping collision areas near Blackwater.
- Open
spooni_blackwater_reborn/update/ - Open the
spooni_railroad/subfolder inside it - Copy all
.ybnfiles from that subfolder - Paste and overwrite into
spooni_blackwater_reborn/stream/ - Paste and overwrite into
spooni_railroad/stream/ - Restart the server
Both mappings now share the merged collision file and players can enter all buildings correctly.
TIP
If you are still experiencing issues after following these steps, open a ticket in the SPOONI Discord and include a list of all your currently installed SPOONI mappings.
