Modding

Jupiter Hell offers modding support. Steam Workshop support is now available. You can also manually manage mods in your game folder.

# Resources for modding

* Want to ask questions or get involved? Visit the Discord server's modding channel.
* Official documentation available on the GitHub chaosforgeorg/jh-mods Wiki. Contributions welcome.
	+ How to start modding
	+ Steam Workshop tutorial

## Modding quickstart

To create a mod follow this basic outline:

1. Create a folder for your mod
2. Create a `main.lua` in your mod's folder. This will be ran automatically during game startup.
3. Put some code in `main.lua`. Example: `nova.log("Loading Cool Mod")`

# Installing Mods

Take your mod folder, e.g. `HellpediaCE` and copy the folder (not just its contents) into the `mods` folder in your Jupiter Hell game directory; for Mac users, navigate to your Jupiter Hell app, right click, select "show package contents", navigate to Contents > MacOS, and put the downloaded mod folder into mods folder found there.

# List of Published Mods

*This list is in alphabetical order.*

* Angel of choice - choose from 3 random traits on level up
* Assemblies traits - add an "assembler" traits heavily inspired by the assemblies in DoomRL
* Berserk Globe - add a Berserk Globe inspired by the DRL berserk pack which will randomly replace health globes. Gives defensive boost, speed boost and massive melee damage increase, but prevents you from using ranged weapons while active.
* Better Fireangel - buffs Fireangel Technician mastery by causing it to lower resistance on 100% fire resistance enemies at level 2 and 3
* Completionist Trial - adds a trial in which you have to do every single level from every moon and all their branches
* Elevator Confirmer - Confirm before leaving the current level
* Flashbang Grenade - Adds a new grenade that briefly slows enemies, resets their awareness and shortens their vision range for seeing the player.
* Grenade Launcher Thwunk Sound - Changes the grenade launcher sounder effect to a Quake 2 style THWUNK sound
* HellpediaCE (Community Edition) (downlink link, version without spoiler) - Help menu replacement offering the following data at your fingertips:
	+ the branches in Callisto, Europa, Io and Dante, their mechanisms, their perks and rewards
	+ the paths to uniques in the Purgatory and a map
	+ the descriptions of all unique and exotics weapons, the relics and the perks
	+ the perks you can get from mod packs through Whizkid
	+ bosses descriptions and advice
* JoviSec PDA - get access to the map of the moon whenever you want
* Jovisec Postal Service - terminals let you post equipment to yourself to be retrieved at later stations.
* Mega challenges pack (download link) - Many additional challenge modes, including:
	+ Angel of Charon: you are sent to remove all traces of demonic activity. Indeed, you are a CRI soldier!
	+ Angel of Volatility: every floor has a volatile storage, enemies are unstable
	+ Angel of Hell: an eventful adventure (at least two events by level)
	+ Angel of Carpentry: what if you were not a soldier but a humble carpenter?
	+ Angel of Real Time: in combat, you have only 1s to decide what to do
	+ Angel of No Retreat: you cannot move away from enemies that you see unless moving towards another enemy
* More Exalted Traits - adds 20 now exalted traits to increase variety of exalted spawns.
* New Enemy Arch Field - add a late game melee fiend variant
* New Enemy Cultist - adds several new late game fanatic variants
* New Enemy Drone Printer - adds a new robotic enemy that spawns moon dependent drones inspired by the DRL Pain/Agony elementals
* New Enemy Medusaling - adds a fast swarming melee enemy designed to encourage shotgun usage inspired by the DRL lost souls
* New Enemy Paladin - adds a set of melee former variants designed to threaten melee and 1 shot kill builds
* New Enemy Wither Watcher - adds a very late game Watcher variant designed to increase the end game challenge
* Para-medic class - A  new class
* Quality of Life fixes - fixed a bunch of perks/mod packs that don't work, or actively harm the player (e.g. loading feed nailgun and onyx pack medifibre)
* Reload from ground - allow to reload directly from ground
* Saveable / readable purgatory - Make purgatory saveable and disable its visual effect
* Tourism Trial - adds a trial with disabled enemy AI so you can explore the moons and view the models up close.