Deo's Portal Gun Mod 2.0.0 for Forge 1.20.1

The first Forge release! It's the full 2.0 rework, built for Forge 1.20.1 (47.1 or newer). The same file also runs on NeoForge 1.20.1.

Needs: GeckoLib 4.4.9 or newer for Forge 1.20.1. Optional: Patchouli, for the in-game field guide.

Portal guns

• Rick's Portal Gun and the Prototype can swap fluids, and they change colour to match whichever fluid is loaded.
• The D0 Gun, Rift Rifle and Spider-Verse Wristband are locked to their own fuel.
• Guns are crafted empty. To load one, use it while holding a vial (or a Dark Matter Capsule) in your other hand. Swapping out a full load gives you the vial back.
• Rift Rifle charge shot: hold use to charge, then let go to open a giant rift that drags nearby mobs and items in. It uses three times the power.
• Every gun is defined by a small JSON file.

Portal fluids

• You can craft portal fluids:
  • Redstone vial + slime ball + glowstone dust → incomplete (bootleg) fluid
  • Incomplete fluid + lime dye + sugar + ender pearl → green fluid
  • Incomplete fluid + blue, purple, yellow or red dye + ender pearl → that colour
  • Echo shard, 2 amethyst shards, green fluid and a redstone block → High-Tier Solid-State Energy Core
• You can also brew them, with vials in the bottle slots:
  • Redstone vial + dragon's breath → incomplete fluid
  • Incomplete fluid + a dye → that colour (lime dye makes green)
  • Green fluid + echo shard → energy core
• Blue portals can't cross dimensions.
• Incomplete fluid works, but it sets travellers on fire, withers them, and sometimes drops them near the destination instead of on it.
• The High-Tier Solid-State Energy Core (energy orb) gives Rick's gun and the Prototype their advanced controls while it's loaded.

Upgrades

• Saved locations and isomorphic controls are upgrades, and each gun unlocks them its own way:
  • Rick's Portal Gun and the Prototype: load the energy core.
  • D0 Gun: fire 25 portals for saved locations, and 75 for isomorphic controls.
  • Rift Rifle: open portals in 3 dimensions for saved locations, and install a Nether Star for isomorphic controls.
  • Spider-Verse Wristband: isomorphic controls are built in. Install a Location Module for saved locations.
• The gun's tooltip shows what's unlocked and how close you are to the rest.

Features

• Recall key (G): opens a portal straight back to where your gun last fired from.
• Link mode: portals stay open for a minute, and each new pair replaces the last.
• Terminal in the gun's screen: type x y z [dimension] to set a destination. The commands coords, dims, dest, link and recall also work.
• Portal Gun Locator: finds guns you've dropped, or lost when you died.
• Look at an open portal to see where it leads.
• Self-destruct: your gun is thrown and blows up 5 seconds later. Catch it after 2 seconds to call it off.
• Server config (config/deos-portal-gun-mod.json): portal lifetimes, cooldowns, power use, the Blender Dimension, scatter, charged-rift pulling and gun tracking.
• Field guide: with Patchouli installed, you get the guide book when you pick up your first vial.
• Sounds for loading, swapping, upgrading, charging and recall.
• Going through a portal cancels fall damage.
• The gun's screens always look the way they do at GUI scale 3, and they update live.

Good to know

• The Forge mod id is deos_portal_gun_mod, because Forge doesn't allow - in mod ids. Items and resources still use deos-portal-gun-mod, so /give commands, recipes and data packs are the same as the Fabric version.
• The community guns (CF's Rick Portal Gun, Donut's Portal Gun Jr, Blue's Sonic, CreNight's Aperture Portal Gun and Light's Remote) are in the separate Deo's Portal Gun Addons mod. That mod is Fabric only for now.