Forge Weapon Energy Lab

Eight energy guns for GTFO.

Report bugs on GitHub, or find me on the GTFO Modding Discord as nainfini.

Weapons

Forge Beam

Hold fire for a continuous beam. No recoil.

Forge Chain Arc

Lightning that jumps from the first target to up to three more nearby enemies.

Forge Flamethrower

A short flame cone that hits everything inside it. No recoil.

Forge Charge Orb

Hold to charge, release to fire an orb that explodes on impact. More charge, bigger blast.

Forge Shock Orb

Hold to charge, release to fire an orb that flies through enemies and shocks the ones nearby.

Forge Blast Gun

A visible shell that flies along your aim and explodes at the first thing it touches.

Forge Ricochet Disc

Discs that bounce off walls up to four times.

Forge Gravity Core

Fires a core that opens a gravity field, pulling enemies in and damaging them.

Stats

Installation

Install with r2modman; it also installs BepInExPack_GTFO, MTFO, ForgeCore, ForgeUI, ForgeAudio and ForgeVisual. Names and descriptions are in English and Chinese and follow the Language setting in NAinfini.ForgeUI.cfg (by default the game's language). MTFO marks the game as modded, which turns off achievements and public matchmaking, so these guns stay out of official play. Everyone in the lobby needs the same version and the same tuning changes.

Tuning

Every number is listed in BepInEx/config/ForgeWeapon_EnergyLab/tuning-defaults.json. To change one, copy only that value into tuning-overrides.json in the same folder, for example:

{
  "weapons": {
    "forge.energylab.blast": { "damage": 40, "blastRadius": 3 }
  }
}

Restart the game after editing. Values you did not copy follow each update's defaults. If an entry has a mistake, only that gun keeps its normal values and the log names the field. An entry for a gun that is not installed (for example a removed extension) is ignored with one log line.

Extra guns

Other packages can add more energy guns as data files; their guns appear in the same loadout list and can be tuned in the same files. Everyone in the lobby must install the same extensions, otherwise energy weapons stay off between the players who differ.

License

MIT. The effect bundle ships in ForgeVisual (CC0). The sounds were made with Adobe Firefly (commercial use permitted); the Blast Gun's shot and explosion are the Ordnance grenade launcher's sounds, with their credits in Assets/Audio/License.txt.

Modding the guns: see the developer guide.

Changelog

1.0.1

Changes since the first upload. Version 1.0.1 because it is released early; it needs ForgeCore, ForgeUI, ForgeAudio and ForgeVisual 1.0.0.

• Effects are rebuilt from selected effect slots, with new beam, arc, black hole and shock orb looks.
• The Flame and Black Hole default tuning changed: Flame AmmoPerRound 1.614 to 1.8 and Damage 2.695 to 2.4; Black Hole Damage 6.75 to 9.
• Weapons fire again after the second level; scopes have no lens glass; guns can be held under the handguard.
• The Blast Gun's explosion is now the same heavy blast as the grenade launcher, lifted off the surface it hits.
• The guns hold better: the left hand follows the game's own grip and is pulled back along the gun into reach.
• Energy Lab's own sounds load before other energy packs, and a gun whose sound finishes loading late still gets it.

Interface changes

• No public signature was removed. The public default values of FlameTuning and BlackHoleTuning changed (above); set the fields explicitly if you relied on the old numbers.

1.0.0

First stable release.

• Eight energy guns: Beam, Chain Arc, Flamethrower, Charge Orb, Shock Orb, Blast Gun, Ricochet Disc and Gravity Core.
• Weapons are defined in ForgeEnergyLab/*.json data files (any mod folder named ForgeEnergyLab); the eight built-in guns are the first file, and others add guns the same way without code. A loadout that used an earlier build's guns must be chosen again.
• Beam and Flamethrower have no recoil; the other six have light recoil.
• Back hits, weakspots and armor work the same as with normal guns.
• Bots can use all eight guns, with their effects and sounds.
• The Blast Gun fires a visible shell that flies at 40 m/s and explodes at the first terrain, enemy or player it touches, so a target that steps into its path is hit and one that moves away is missed.
• The Blast Gun and Beam have no range limit; the Chain Arc (16 m) and Flamethrower (8 m) keep theirs.
• The Blast Gun's shot and explosion use the Ordnance grenade launcher's sounds.
• Gun icons are drawn by the game's own icon renderer from each gun's model, with the same shading and size as vanilla gun icons.
• Sounds play through ForgeAudio and effects through ForgeVisual, mixed with the other Forge mods and following the game's sound-effects volume.
• Gun names and descriptions are in English and Chinese and switch with the language without restarting. Players using different languages still match each other's gear, and the chat notice about a different Energy Lab build or tuning is translated too.
• The Charge Orb and Shock Orb leave your sight clear while charging; other players see the full charge effect on you.
• The beam, flame and charging orb stay on the muzzle while you strafe.
• BepInEx/config/ForgeWeapon_EnergyLab/tuning-overrides.json holds only the values you change; tuning-defaults.json lists every value.
• Requires ForgeCore, ForgeUI, ForgeAudio, ForgeVisual and MTFO. MTFO marks the game as modded and turns off achievements and public matchmaking, so these guns stay out of official play; without MTFO, Energy Lab does not load.
• The source code and Unity effect project are on GitHub. Media are local-only and are not included in Git.