Collision Destruction Physics

The development is frozen right now, but it may be continued in the future!

---

Anyone is welcome to make continuations/reworks/forks/etc. of this mod. There will be no 'copyright claims' or something similar from the dev team, pinky promise.

---

To make the mod work you need to place the activator block somewhere in the world

This mod is computationally expensive. This means that this mod can and will at some point lag your game

Settings

When you press E on the activator block, you will see the settings menu. Here you can:

1. Change presets

2. Make your own preset, save, load and apply it to server

3. Break the game

• Destruction Level: Change the preset to one of the following: extreme, hard, default, medium, low

• Use Angular Velocity: Change how spinning objects react. If they are spinning fast enough, they will not break

• Use Shape Durability: When two creations collide, the damage will depend on a durability of the blocks

• Acceleration Insensitivity: How much change in acceleration must the creation experience before the destruction is applied

• Special force Threshold: Main settings. Min - minimum force (acceleration*mass) object must experience to start breaking blocks. Max - Maximum force object can withstand before it will start exploding (Use Explosions must be turned on). Max Part Stability Force - Maximum force object can withstand before parts will start breaking.

• Collision Factor: Multiplier for radius of damage caused by creation to creation collision

• Acceleration Limit Factor: Sort of threshold. When it's set to 0 or less, only decelerating objects will break

• Halfwork: Optimization feature. When it's on, collisions will be calculated every second tick

• Dynamic Work Factor: When it's on, script will decide how many physical shapes it will check based on creations mass

• Manual Work Factor: When not 0, it will decide how many shapes the script will check. If it's set not to 0, the Dynamic Work Factor will be ignored

• Create Debris: Self explanatory

• Autoclean Debris: Self explanatory

• Autoclean Lone Shapes: Self explanatory

• Directional Destruction: Destruction using raycasts (allows for local destruction and destruction between creations). None - disabled, Addition - merged with standard (random) destruction, Only - use only raycasts for destruction

• Use Explosions: When creation's force is more than Max force, the creation will explode

• Apply Current Settings: Apply current preset

• Reset Settings: Resets current settings without applying

• Save Settings to Preset: Saves current preset to your mod folder

• Load Custom Preset: Load your saved preset without applying it

• Preset Name: Change your custom preset name. To apply it you must save your preset!

• Preset Creator: Not a setting, will display creator's name of the current preset

• Receive Client Data: Only for host. Whether players can apply settings or not

Change logs

v1
Update: 25.02.2022
Feature - The lighter the body, the harder it would break. Piston engines are now more stable
Feature - Instead of deleting, parts may be detached and then deleted after 10 seconds
Feature - Parts that fell underground will be deleted
Fix - Script works correctly after restart

v2
Update: 06.03.2022
Rework - Detached or single parts will be deleted up to 30 seconds. Parts that fell underground will no longer be deleted

v3.0.0
Update: 15.05.2022
SCRIPT OVERHAUL
Feature - GUI and settings
Feature - Explosions on high velocity impacts
Feature - Creation to Creation collision damage (kinda wonky at the moment)
Feature - Added Work Factor to reduce amount of the code executions
Fix - Propellers and piston engines are now stable (can be changed in settings)

And much more...

v3.0.1
Update: 15.05.2022
Hotfix - Something fixed in script for gui

v3.0.2
Update: 15.05.2022
Hotfix - Fixed compatibility with Scrap Mechanic version 0.5.1

v3.0.3
Update: 19.05.2022
Rework - New presets
Rework - New activator block model
Feature - Directional Destruction modes: None - disabled, Addition - merged with standard (random) destruction, Only - use only local destructions
--
[b]Fix - Bridges won't destroy your world anymore[/b] (Explosions are now fixed)
[i]Temorary ruined compatibility with Scrap Mechanic version 0.5.1 again[/i]

v3.0.4
Update: 19.05.2022
Hotfix - Fixed compatibility with Scrap Mechanic version 0.5.1 again

v3.0.5
Update: 20.05.2022
Feature - Added destruction deactivators

v3.0.6
Update: 21.05.2022
Hotfix - Something fixed in script for physics

v3.0.7
Update: 02.01.2025
Hotfix - Fixed script crash that occurred when attempting to create wedge debris for the game versions 0.7.X

v3.0.8
Update: 28.01.2025
Fix - Fixed script crash that occurred when attempting to create 0 width block debris

Involved bros:

• dushaman - Assisted in math

• twardowsky - General mod idea