Breath Weapon
by TheMrSuit
Breath Weapon is a Forge library for 1.20.1 that renders GeckoLib models, custom particles and beams, so mod authors can add effects without writing rendering code.
What it does
Breath Weapon is a library that lets other mods draw GeckoLib models, special lighting and particle effects. Models are referenced by a GeckoLib.geo.json path and texture, and an optional animation file, animation name and rotation speed in degrees per tick can be set. Particles are defined in JSON files placed in a mod's datapacks, under a path such as data/mymod/particles/energy blast.json, and a guide explains how to integrate the particle system.
Installation requires only Forge for 1.20.1, with files published under the beta channel. The mod runs on client and server, so both sides need it. Breath Weapon is released under the MIT License but is not open source. Files were first published on 2026-05-09 and most recently updated on 2026-05-13, with the latest Forge file at version 0.0.9.
Key features
GeckoLib model rendering
Renders GeckoLib models with a texture and an optional named animation that plays on demand.
Glow and pulsing light
Particles can carry a constant glow or a pulsing brightness, with several light modes for dynamic lighting.
Tapered beams
Beams can narrow or widen along their length, and their endpoints can follow a target as it moves.
Simple and complex particles
Flat sparks, sparkles and dust sit alongside full 3D models with animation for explosions and magical effects.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Energy weapons
Lasers, energy blasts and tracers can be built as beams or billboards between two points.
Magic effects
Custom models with animation and glowing particles can represent spells and abilities triggered from spawning code.
Who it’s for: Mod developers who want custom particles, beams and GeckoLib models in their own mods. Players do not need it unless a mod they use requires it.
How it compares
GeoAnim is a Forge mod for 1.20.1 that is client-side only and not open source under All rights reserved, so it needs nothing on servers. DucLib is a Forge library for 1.19.2 – 1.20.1 that is open source under the MIT License and runs on client and server. SnAssets Library - Particles covers Fabric, Forge and NeoForge for 1.20 – 26.2, and is not open source under All rights reserved.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Breath Weapon | Forge | 1.20.1 | Client and server | 2026-05-13 |
| GeoAnim | Forge | 1.20.1 | Client-side only | 2026-08-28 |
| DucLib | Forge | 1.19.2 – 1.20.1 | Client and server | 2024-04-13 |
| SnAssets Library - Particles | Fabric, Forge and NeoForge | 1.20 – 26.2 | Client or server, optional | 2026-08-08 |
Questions
Does Breath Weapon need to be installed on the server?
Which loaders does Breath Weapon support?
Where are custom particle definitions placed?
In the catalog
Breath Weapon is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from TheMrSuit
Similar mods
What the author says
This guide explains how to integrate the BreathWeapon particle system into your Minecraft mod to create custom particles without writing complex rendering code. That's it! The particle will render with default texture and physics.
Official listing
- Modrinth page
- modrinth.com/mod/breath-weapon
- Owner
- TheMrSuit
- Published
- 2026-05-09
- Updated on Modrinth
- 2026-05-13
- Facts verified
- 2026-10-15