purpIe-GodPoolManipulator

You want 1 god? No problem. You want all 9? You got it. You want 2 specific ones? Easy.

A Hades 2 mod that gives you complete control over which gods can offer boons during your runs, allowing you to create curated god pools for different playstyles.

Features

God Pool Control

• Selective God Enabling: Choose exactly which gods can offer boons in your runs
• Max Gods Per Run: Set the maximum number of gods that can appear in a single run (1-9)
• Dynamic Pool Management: Enable/disable gods individually for fine-tuned control

Keepsake Integration

• Keepsake Override: Option to allow keepsakes from disabled gods to add them to the current run's pool
• Automatic Pool Expansion: When enabled, keepsakes can dynamically increase your max gods per run

Installation

• Install from Thunderstore mod using any mod manager (e.g., r2modman)

Usage

Basic Setup

1. Enable "God Pool Manipulator" in the mod menu
2. Set your desired "Max Gods Per Run" (default: 4)
3. Check the boxes for gods you want to include in your pool
4. Optionally enable "Keepsakes Add Gods to Pool"

God Selection

The mod supports all major Olympian gods:

• Zeus (Lightning)
• Poseidon (Water)
• Athena (Defense)
• Ares (Attack)
• Aphrodite (Charm/Special)
• Apollo (Ranged/Crit)
• Demeter (DoT/Freeze)
• Hephaestus (Crafting/Blast)
• Hera (Crowd Control)
• Hestia (Healing/Shield)

Keepsake Behavior

When "Keepsakes Add Gods to Pool" is enabled:

• If you get a keepsake from a disabled god, that god becomes available for the rest of the run
• The max gods per run increases by 1 to accommodate the added god
• This allows keepsakes to expand your strategic options mid-run

Configuration Options

Core Settings

• GodPoolManipulator: Master toggle for the mod
• MaxGodsPerRun: Maximum gods that can offer boons (1-9)
• KeepsakeAddsGod: Allow keepsakes to add disabled gods to the pool

God Toggles

Individual boolean settings for each god:

• ZeusUpgrade, PoseidonUpgrade, etc.
• Set to true to include the god in your pool

Technical Details

Function Hooks

• GetEligibleLootNames: Filters the god pool based on enabled gods
• ReachedMaxGods: Uses configurable max instead of hardcoded limit
• GiveLoot: Handles keepsake integration and pool expansion

Data Structures

• CurrentRun.EnabledGodsOverride: Runtime additions to the god pool
• CurrentRun.MaxGodsPerRunOverride: Runtime max gods adjustments

Compatibility

• Requires Hell2Modding framework
• Compatible with boon-modifying mods
• May conflict with mods that alter god selection mechanics
• Works with other purpIe mods (BanManager, etc.)

Troubleshooting

No Boons Appearing

• Ensure at least one god is enabled in your pool
• Check that "God Pool Manipulator" is enabled
• Verify max gods setting isn't too restrictive

Keepsakes Not Working

• Enable "Keepsakes Add Gods to Pool" option
• Confirm the keepsake is from a disabled god
• Check console for debug messages if issues persist

Settings Not Saving

• Ensure Chalk dependency is properly loaded
• Try reloading the mod with ReLoad
• Check file permissions on config.lua

Contributing

Built using Hell2Modding framework. To modify:

1. Edit the Lua files in the mod directory
2. Test changes with ReLoad hot-reloading
3. Follow the existing pattern for adding new gods

Credits

• Created for Hades 2 by Supergiant Games
• Uses Hell2Modding framework and dependencies
• Credits to PonyWarrior (LRevolution) and his mod "PonyQOL2". Part of the code regarding forcing NPC spawns was adapted from his mod.

Version History

• v1.0.0: Initial release with god pool control and keepsake integration</content>