HealthRegenMod

HealthRegenMod - Health Regeneration and One-Shot Protection Mod

Overview

HealthRegenMod is a BepInEx mod for the REPO game that provides powerful health management features, including unlimited health, health regeneration, and one-shot kill protection.

Features

🛡️ Core Features

• God Mode: Complete immunity to all damage, health never decreases
• Max Health Adjustment: Customizable maximum health (1-10,000,000)
• Health Regeneration: Automatic health regeneration per frame with customizable speed

🚫 One-Shot Protection

• One-Shot Kill Immunity: Prevent instant death from single attacks
• Damage Limiting: Cap maximum damage from single hits
• Minimum Health Protection: Maintain at least specified health when taking fatal damage

⚙️ Configuration Options

• Full in-game configuration menu
• Adjustable parameters for all features
• Support for hot-reloading configurations

🔌 API Interface

• Complete API for other mods
• Support for dynamic adjustment of all settings
• Thread-safe API calls

Installation

Prerequisites

• BepInEx 5.4.x or higher installed
• Game version: REPO

Installation Steps

• Download the latest HealthRegenMod.dll
• Copy HealthRegenMod.dll to REPO/BepInEx/plugins/ directory
• Launch the game

Configuration

Configuration File Location

REPO/BepInEx/config/hyy.HealthRegenMod.cfg

Configuration Details

General Settings

• EnableLogging: Enable debug logging (Default: false)
• ShowDebugInfo: Show debug information on screen (Default: false)

Gameplay

• EnableGodMode: Enable God Mode (Default: true)
• MaxHealth: Maximum health value (Range: 1-10,000,000, Default: 10000)
• HealthRegenPerFrame: Health regenerated per frame (Range: 0-1000, Default: 0)

Damage Protection

• EnableOneShotProtection: Enable one-shot kill protection (Default: true)
• OneShotMinHealth: Minimum health to remain after massive damage (Range: 1-1000, Default: 1)
• MaxSingleDamage: Maximum damage that can be taken in a single hit (Range: 0-10000, 0=unlimited, Default: 500)

API Documentation

Basic Usage

using HealthRegenMod;

// Set maximum health

HealthRegenAPI.SetMaxHealth(50000);

// Enable God Mode

HealthRegenAPI.SetGodMode(true);

// Set health regeneration rate

HealthRegenAPI.SetHealthRegenRate(10);

Advanced Features

// Enable one-shot protection

HealthRegenAPI.SetOneShotProtection(true);

// Set minimum health to remain

HealthRegenAPI.SetOneShotMinHealth(100);

// Set maximum single damage

HealthRegenAPI.SetMaxSingleDamage(1000);

// Get current player health

int health = HealthRegenAPI.GetPlayerHealth();

// Directly set player health

HealthRegenAPI.SetPlayerHealth(1000);

Error Handling

try

{

if (!HealthRegenAPI.SetMaxHealth(50000))

{

// Handle failure

}

}

catch (Exception ex)

{

// Handle exception

}

In-Game Usage

Enabling/Disabling Features

• Launch the game
• Press F1 to open BepInEx configuration menu
• Find "HealthRegenMod" configuration
• Adjust desired settings
• Settings are saved automatically

Recommended Configurations

Beginner Friendly

EnableGodMode = true

HealthRegenPerFrame = 0

EnableOneShotProtection = true

MaxSingleDamage = 1000

Challenge Mode

EnableGodMode = false

HealthRegenPerFrame = 5

EnableOneShotProtection = true

MaxSingleDamage = 500

OneShotMinHealth = 10

Hardcore Mode

EnableGodMode = false

HealthRegenPerFrame = 0

EnableOneShotProtection = false

Frequently Asked Questions

Q: The mod is not working, what should I do?

A: Check the following:

• BepInEx is correctly installed
• HealthRegenMod.dll is in the correct directory
• Game version matches
• Check BepInEx console logs

Q: How to confirm the mod is loaded?

A: Check the BepInEx console when launching the game, you should see similar messages:

[Info] HealthRegenMod loaded successfully!

Q: Do I need to restart the game after changing configurations?

A: No, configurations take effect immediately. However, some settings may require reloading the game scene.

Q: Is it compatible with other mods?

A: This mod uses Harmony for patching and is theoretically compa