promotional bannermobile promotional banner
premium banner
A library mod for better and easier custom explosions

Description

ExplosionLib is a server-side library mod that provides a custom explosion simulation, designed to make large explosions look more realistic. It offers configurable options for:

  • Generating fire in the crater.
  • Placing netherrack under some fire for persistence.
  • Forcing fire generation in certain explosions (like beds or ghast fireballs).
  • Spawning debris that flies outward from the crater.

The mod is fully compatible with singleplayer and includes a config to disable fire, persistent fire, and debris. ExplosionLib can replace vanilla explosions with the custom simulation if enabled in the config.

Developers can integrate ExplosionLib by adding it as a dependency via Cursemaven in their build.gradle, then using the ExplosionHandler.explode() method:

ExplosionHandler.explode(new ExplosionContext(
       ExplosionContext.SimulationType.POLYHEDRAL,
       level,
       pos,
       power,
       fire,
       forceFire,
       persistentFire,
       debris,
       source
));
  • SimulationType can be POLYHEDRAL for the custom explosion or VANILLA to use the default Minecraft explosion behavior.
  • For vanilla explosions, forceFire determines whether fire is generated, ensuring that some effects (like beds or ghast fireballs) always spawn fire, regardless of the config.

This allows you to use a single method for both vanilla and custom explosions, giving you flexibility and visual fidelity for large-scale effects.

If you need more help with the mod I have a discord

If you want to play on a server with your friends to experience fancy explosions together then you should get a server from Apex Hosting, they provide powerful hardware, good for making huge explosions and by using code APEX25 you can get 25% off your first month of hosting, just click the banner below! And by using Apex Hosting you support me to make more mods like these!

Apex Hosting Banner