Skip to content

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 all subfolder
  • 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:

  1. The stream folder of this resource (the one containing the update folder)
  2. The stream folder 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.

  1. Open spooni_blackwater_reborn/update/
  2. Open the spooni_railroad/ subfolder inside it
  3. Copy all .ybn files from that subfolder
  4. Paste and overwrite into spooni_blackwater_reborn/stream/
  5. Paste and overwrite into spooni_railroad/stream/
  6. 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.