FatedEncounters
Guarantee field NPC and postgame encounters once per run. Per-NPC toggles and optional random biome assignment; configurable in r2modman.
| Last updated | 6 hours ago |
| Total downloads | 14 |
| Total rating | 1 |
| Categories | Mods Misc |
| Dependency string | MarcoAntolini-FatedEncounters-0.3.2 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
SGG_Modding-ReLoad
Provides helpers for managing hot reloading and waiting for the right time to load
Preferred version: 1.0.2
LuaENVY-ENVY
A plugin to allow ReturnOfModding plugins greater control of their environment.
Preferred version: 1.2.0
SGG_Modding-ModUtil
Utility mod for mod interactions within lua for SGG's games
Preferred version: 4.0.1
README
Fated Encounters
Thunderstore · Report a bug · Request a feature
A Hades II mod that guarantees NPC encounters you would normally miss on a run—field combats (Nemesis, Artemis, Heracles, Icarus, Athena) and, after True Ending, Zagreus’s Infernal Contract and the Neo-Chronos clearing.
Install with r2modman or Thunderstore. Requires Hell2Modding and the dependencies listed on the package page.
How it works
- Field NPCs: Turn on each NPC under
fieldNPCsin config. Each enabled NPC is guaranteed once per run. The mod forces their field encounter in an eligible biome after you enter that biome, then stops tracking them for the rest of the run.- Default: The biome is whichever eligible region you reach first on your route.
- Optional (
randomizeFieldNPCBiome): At run start, each NPC is assigned one random eligible biome and is only forced there (you must still visit that biome).
- Zagreus: After True Ending, can guarantee the Infernal Contract once per run where that content is unlocked.
- Chronos: After True Ending, can guarantee the Neo-Chronos clearing encounter once per run.
Configuration
Settings are managed with Chalk and appear in r2modman → Config (or in your profile’s ReturnOfModding/config/ as MarcoAntolini-FatedEncounters.cfg).
Note: Config files persist even if you uninstall the mod. Delete or reset MarcoAntolini-FatedEncounters.cfg manually for a clean slate.
Options
| Option | Type | Default | Description |
|---|---|---|---|
enabled |
bool | true |
Master switch for the entire mod. When false, hooks do not run. |
fieldNPCs.Nemesis |
bool | true |
Guarantee meeting Nemesis once this run. |
fieldNPCs.Artemis |
bool | true |
Guarantee meeting Artemis once this run. |
fieldNPCs.Heracles |
bool | true |
Guarantee meeting Heracles once this run. |
fieldNPCs.Icarus |
bool | true |
Guarantee meeting Icarus once this run. |
fieldNPCs.Athena |
bool | true |
Guarantee meeting Athena once this run. |
randomizeFieldNPCBiome |
bool | false |
At run start, assign each enabled field NPC a random eligible biome (only forced there). When false, use the first eligible biome you enter. |
guaranteeZagContract |
bool | true |
After True Ending: guarantee Zagreus Infernal Contract once per run when unlocked for that run. |
guaranteeChronosClearing |
bool | true |
After True Ending: guarantee Neo-Chronos clearing once per run. |
debugLog |
bool | false |
Print [FatedEncounters] messages to the game console (useful when reporting bugs). |
Examples
- All field NPCs, no postgame:
enabled = true, allfieldNPCs.* = true,guaranteeZagContract = false,guaranteeChronosClearing = false. - Only Nemesis and Artemis: enable only those two under
fieldNPCs, disable the rest. - Random biomes each run:
randomizeFieldNPCBiome = truewith the NPCs you want enabled; usedebugLogto see assigned biomes in the console. - Chronos only (no field NPCs): all
fieldNPCs.* = false,guaranteeChronosClearing = true(requires True Ending on your save). - Disable everything temporarily:
enabled = false.
Contributing
Contributions are welcome—bug reports, feature ideas, docs, and code.
- Thunderstore page — install, versions, and dependencies.
- Contributing guide — dev setup (r2modman symlink), change expectations, and releases.
- Report a bug — use the template so we can reproduce issues.
- Request a feature — describe behavior and config ideas.
- Open a pull request — see the PR checklist in
.github/pull_request_template.md.
For general Hades II modding help (loader, dependencies, other mods), the Hades II Modding Discord is a good place to ask.
License
MIT — see LICENSE.
