modpacks.ch by CreeperHost No ads. Just mods.
Back to mods
Falling blocks spawn manager project artwork

Vintage Story Mod DB · Vintage Story mod

Falling blocks spawn manager

▣ Falling Blocks Spawn Manager Limits the number of unstable rock, soil, gravel, and sand blocks falling simultaneously when collapses are enabled. Also merges dropped item stacks left behind by mass collapses. ✅ Benefits ⚡ Reduces CPU Load Limits the num

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Falling blocks spawn manager release should I use?

Updated 12 days ago
Latest stable file 0.3.0
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

Falling blocks spawn manager 0.3.0 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Falling blocks spawn manager required on the client, server, or both?

It must be installed on the client. Installation on the dedicated server is optional.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This release supports both sides, but the source does not require it on the server.

Understand Vintage Story dependencies Read the Vintage Story installation guide

What else does Falling blocks spawn manager 0.3.0 need?

0.3.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Falling blocks spawn manager without breaking your instance.

Built for Falling blocks spawn manager 0.3.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.3.0. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.3.0. It opens that exact file at the source.

About this project

What does Falling blocks spawn manager add?

▣ Falling Blocks Spawn Manager

Limits the number of unstable rock, soil, gravel, and sand blocks falling simultaneously when collapses are enabled. Also merges dropped item stacks left behind by mass collapses.

✅ Benefits

⚡

Reduces CPU Load

Limits the number of falling blocks during large and frequent collapses, preventing drops in server TPS and player FPS.

🏃

Instant End on Distance

Immediately ends collapses if a player moves too far away (usually more than 128 blocks) to avoid server overload from idle entities.

🛡️

Prevents Chunk Load Collapses

Prevents collapses from occurring when loading new chunks, including those caused by generation mods.

📏

Distance-Based Non-Player Control

Prevents collapses caused by non-players beyond 128 blocks from any player.

📦

Item Drop Fallback

If an unstable block cannot land or there is no space, it will fall to the ground as an item.

🧱

Item Stack Merging

Mass collapses leave many dropped items on the ground, which can heavily hurt player FPS. Nearby stacks of the same item are merged into fewer entities, following vanilla stacking rules.

⚙️

Configurable Limits

Default limit is 200 (500 for 1.22). In the FallingSpawnManagerConfig configuration file you can raise this number for servers.

ℹ️ Note: This mod is essentially an implementation of a PR I made that was rejected by the developers.

🎬 Videos

❌ Before

▶ Watch Video 1

✅ After — Sand Landslides

Large quantities of sand with a limit of 5000 entities.
▶ Watch Video 2

✅ After — Rock Falls

▶ Watch Video 3

✅ After — Instant Simulation

Demonstration of instant simulation when the player moves away.
▶ Watch Video 4

✅ After — Item Stack Merging

Demonstration of dropped item stacks being merged after a mass collapse.
▶ Watch Video 5

⚙️ Configuration settings (FallingSpawnManagerConfig.json)

Falling blocks:

  • MaxFallingLimit — maximum number of falling block entities at the same time (default: 500, range: 10-10000)
  • MaxInstantPerTick — how many instant simulations of falls (for blocks out of players' sight) are processed per manager tick (default: 100, range: 1-10000)
  • StuckTimeoutMs — watchdog against the vanilla bug "Falling block entity does not settle". A falling entity that stays alive longer than this time without landing is forcibly placed at its current position (default: 15000 ms, range: 0-120000). 0 disables the watchdog.

Item stack merging:

  • ItemClumpEnabled — enables merging of dropped item stacks (default: true)
  • ItemClumpRadius — horizontal search radius for nearby items, in blocks (default: 5.0, range: 0.25-8)
  • ItemClumpVerticalRadius — vertical search radius, in blocks. A small value prevents merging between floors (default: 2.0, range: 0.25-8)
  • ItemClumpDelayMs — delay after an item spawns or loads, and between retries if it is still moving (default: 1500 ms, range: 250-60000)
  • ItemClumpMaxSettleAttempts — how many times to retry while an item has not landed yet (default: 20, range: 1-200)
  • ItemClumpMaxAttemptsPerTick — merge attempts per manager tick (250 ms). Spreads the load when many items appear at once (default: 25, range: 1-1000)
  • ItemClumpMaxGroupSize — maximum number of items merged in one group (default: 32, range: 2-256)
  • ItemClumpBlacklist — list of item/block codes that are never merged (default: empty). Supports * wildcards ("game:gear-*") and regex with @ prefix. Case-insensitive. A code without a domain is treated as vanilla ("gear-rusty" = "game:gear-rusty").
  • ItemClumpDebug — writes merge statistics to the log every 10 seconds, for diagnostics (default: false)

The file is created in the server's ModConfig folder when the world is loaded with the mod at least once. Restart the server after applying changes. Invalid values are clamped to the allowed range.

🔄 Compatibility

✓ Compatible

🏔️

Any worldgen mods

🙏 Credits

The item stack merging feature was inspired by Salty´s Item Clumps by SaltyWater, and is used here with the author's permission. It was added because mass block collapses can leave a huge number of dropped items on the ground, which can heavily impact players' FPS. The implementation here is independent: queue-based, with a per-tick budget and no per-collision patches. Thanks to SaltyWater for the original idea.

Project description from Vintage Story Mod DB.

Pick your setup

Falling blocks spawn manager releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

10 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Falling blocks spawn manager versions and loaders

9 of 9 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.

Keep browsing

See more mods

Like this one? One of these might be worth a look.