Dynamic Debris & Unit Removal

This mod improves game performance by deleting robots/animals and useless, loose debris of various sizes if the game's FPS drop below a certain threshold.

NOTE

This mod is not intended for use in Survival game modes - It is meant for situations like for example having fun with explosions and destruction in Creative Mode, to keep the game from lagging out from all the loose explosion/destruction debris. Using this in Survival mode may have unwanted effects.

How to use

Just subscribe to the mod and enable it in your world. That's it! When loading a world with it, you should see a green chat message confirming that the mod is loaded and running.

The mod will then run in the background and, if your FPS drop below 50, it will delete small pieces of debris and/or robots/animals to bring the performance back. It also does some basic checks to make sure it doesn't accidentally delete a vehicle or other important creations. Creations that are attached to the ground are never deleted.

How it works

If you have more than 50 FPS, the mod "sleeps", aka it does nothing (to save performance).

If you have less than 50 FPS, the mod activates and, in certain intervals, searches the map for small pieces of loose debris and checks the amount of units (robots/animals) in the world. If it finds debris or there are too many units, it will delete (some of) those until the FPS rise again.

The mod works different depending on the current FPS - there are 5 "steps":

** over 50 FPS:** The mod "sleeps", it does not search for debris and nothing is deleted.

** 40 - 50 FPS:** The mod searches for debris every 12 seconds. Debris with a size of 2 x 2 x 2 blocks or less will be deleted. Up to 225 units are allowed in the world.

** 30 - 40 FPS:** The mod searches for debris every 8 seconds. Debris with a size of 4 x 4 x 4 blocks or less will be deleted. Up to 150 units are allowed in the world.

** 20 - 30 FPS:** The mod searches for debris every 5 seconds. Debris with a size of 6 x 6 x 6 blocks or less will be deleted. Up to 100 units are allowed in the world.

** under 20 FPS FPS:** The mod searches for debris every 3 seconds. Debris with a size of 8 x 8 x 8 blocks or less will be deleted. Up to 50 units are allowed in the world.

NOTE

The mod has two "removal modes" - limited and unlimited! The default mode is 'limited'.

In limited mode, the mod will NOT delete various parts (engines, thrusters, etc.) and units (woc, worm). This mode is meant for use in Survival, as it will not delete expensive parts like thrusters or engines and will not delete animals like wocs and worms. The full list of ignored/non-ignored parts in this mode will be added later.

In unlimited mode, the mod will delete anything that fits the current "step". This mode is meant for use in Creative, as parts like thrusters or engines are free and can easily be replaced there.

You can change the removal mode for the current world by using the settings tool.

tags: debris, lag, fps, anti-lag, performance, clean