Asteroid Filter API

This API can be used to apply filters to all procedural asteroids as they attempt to spawn. The filters can be used to block individual asteroids from appearing under whatever conditions are defined/registered.

You can create rules to limit asteroid spawning based on:

• Proximity to planets/planetary rings/other objects
• Speed of nearby grids
• A custom 3D distribution curve
• Random number generation
• Current player resources
• Asteroid size or composition
• A timer
• Any other logic desired...

Example

Multiple rules can be registered at once with differing priorities to create a complex ruleset to control asteroid spawning. For instance, you could apply rules with priorities:

• P=0; Restrain asteroids to spawn with a 3D Perlin noise distribution to create random pockets of asteroids surrounded by large voids.
• P=1; Restrain asteroids so that each has a 50% chance of successfully spawning.
• P=5; When near certain planets, asteroids will spawn densely (none are removed), overriding the lower priority rules.
• P=10; Asteroids will not spawn at all when near any grids moving faster than a certain threshold (to prevent collisions).

There are no limit on the number of rules you can apply, so feel free to experiment with different arrangements.

Other Notes

• The system works by catching procedural asteroids as they spawn and then instantly deleting them if they are deemed invalid.
• Asteroid spawns are not guaranteed to be deterministic depending on the rules applied, so you might enter an area and see many asteroids only to return later and find it empty. This does not apply to any asteroids that have been modified. Once an asteroid is changed (i.e. voxels), it will stay in the world forever.
• This system does not spawn any additional asteroids; it can only remove them. Play with higher asteroid density to start with before adding restrictions if you aren't seeing enough of them.
• Multiplayer is fully supported.

Config Values

https://steamcommunity.com/workshop/filedetails/discussion/3218645300/6690735450901827357/

API Guide

https://steamcommunity.com/workshop/filedetails/discussion/3218645300/6690735095222034427/

Mods That Use This

(Asteroid Filter: Grid Speed) https://steamcommunity.com/sharedfiles/filedetails/?id=3219800568 (Asteroid Filter: Clusters) https://steamcommunity.com/sharedfiles/filedetails/?id=3220848664

Other Mods:

https://steamcommunity.com/id/adrsquared/myworkshopfiles/?appid=244850

Join My Discord for Mod Discussion and Bug Reports

Mods by Echthros

Support Future Mods/Updates