FirstGodPerfect

FirstGodPerfect

A highly configurable Hades II mod that upgrades god boons to higher rarities. Supports multiple modes: upgrade the first god in each region, or upgrade only when you have a matching god's keepsake equipped.

Description

This mod enhances your god encounters with flexible configuration options:

• Mode 1 - Always: Upgrades the first god you encounter in each region to your chosen rarity
• Mode 2 - Keepsake Only: Upgrades god boons only when you have that god's keepsake equipped
• Rarity Options: Choose between Heroic (safe, no extra mods) or Perfect (requires BoonBuddy + Perfectionist)
• Keepsake Scaling: Optionally scale boon rarity based on your keepsake level (1-3)

Requirements

Required Dependencies

These are automatically installed by r2modman:

• Hell2Modding (v1.0.71+) - Core mod loader
• SGG_Modding-ENVY (v1.2.0+) - Environment isolation
• SGG_Modding-ModUtil (v4.0.1+) - Modding utilities
• SGG_Modding-Chalk (v2.1.1+) - Configuration management
• SGG_Modding-ReLoad (v1.0.2+) - Hot-reload support

Optional Dependencies

For Perfect rarity support (auto-detected by mod):

• Jowday-Perfectoinist (v0.1.8+) - Adds Perfect rarity functionality
• Jowday-BoonBuddy (v0.3.14+) - Required alongside Perfectoinist

Note: If you set target_rarity = "Perfect" but these mods aren't installed, the mod will automatically fall back to Heroic rarity.

Installation

Method 1: r2modman (Recommended)

• Open r2modman
• Select Hades II as your game
• Search for "FirstGodPerfect" in the mod browser
• Click Install
• (Optional) Install Perfectoinist + BoonBuddy for Perfect rarity support
• Click "Start Modded" to launch the game

Method 2: Manual Installation

• Download the latest release
• Extract to: [Hades II Install]/ReturnOfModding/plugins/shadowofdoom-FirstGodPerfect/
• Ensure all dependencies are installed
• Launch Hades II through r2modman or with mod loader

Configuration

Configuration file location: ReturnOfModding/config/FirstGodPerfect.cfg

You can edit the config file directly or use r2modman's config UI (recommended).

Available Settings

The config uses simple TRUE/FALSE checkboxes in r2modman. Each setting is self-contained - no contradicting pairs!

[config]

Basic Settings

enabled = true # Enable/disable the mod

debug = false # Enable debug logging

=== UPGRADE MODE ===

TRUE = Only with keepsake | FALSE = Always first god in biome

use_keepsake_mode = false

=== TARGET RARITY ===

TRUE = Perfect (cyan) | FALSE = Heroic (blue)

use_perfect_rarity = true

=== KEEPSAKE SCALING (only applies when use_keepsake_mode = true) ===

TRUE = Scale with level (Lv1/2/3) | FALSE = Always max rarity

keepsake_scale_with_level = false

Configuration Options Explained

Basic Settings

• enabled: Master on/off switch for the entire mod
• debug: Enable detailed logging (check ReturnOfModding/LogOutput.log)

use_keepsake_mode

Controls which mode the mod operates in:

FALSE (Default - Always First God Mode)

• Upgrades the first god you encounter in each region
• Works like the classic FirstGodPerfect behavior
• No keepsake required
• Example: First god in Oceanus gets upgraded, first god in Rift gets upgraded, etc.

TRUE (Keepsake Only Mode)

• Upgrades god boons only when you have that specific god's keepsake equipped
• Example: Zeus boons only upgraded if you're wearing Zeus's keepsake (Cloud Bangle)
• Gives you complete control over which god gets boosted
• Works every time you encounter that god (not just first)

use_perfect_rarity

Controls the target upgrade rarity:

FALSE (Heroic Rarity - Safe Mode)

• Upgrades boons to Heroic rarity (blue tier)
• Safe option that works without additional mods
• One level above Epic, two below Perfect

TRUE (Default - Perfect Rarity)

• Upgrades boons to Perfect rarity (cyan tier)
• Requires BoonBuddy + Perfectionist mods installed
• Two levels above Heroic, highest standard rarity
• Auto-falls back to Heroic if required mods not detected

keepsake_scale_with_level

Only applies when use_keepsake_mode =