Skip to content

Glowstick0017/OutwardStatusUtility

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Outward Status Utility

A BepInEx mod for Outward that allows you to apply multiple status effects to your character with a single keypress.

Features

  • ๐ŸŽฏ 16 Granular Categories - Enable exactly the effects you want
  • ๐Ÿ“Š 260+ Status Effects - Complete database organized by identifier names
  • โšก Instant Application - Press F9 (configurable) to apply all enabled effects
  • ๐Ÿงน Instant Removal - Press Numpad7 (configurable) to remove all status effects
  • ๐ŸŽฎ 10 Positive Effect Categories - Boons, buffs, recovery, runes, and more
  • โš ๏ธ 6 Negative Effect Categories - Hexes, debuffs, DOTs, diseases (disabled by default)
  • ๐Ÿ”ง Custom Effect Lists - Add specific effect names for precise control or modded content
  • ๐Ÿ“ Fully Configurable - All settings via BepInEx config file or Outward Config Manager
  • โœ… Name-Based Matching - Effects are matched by their exact identifier names for reliability
  • Safe by Default - Harmful effects disabled by default

Installation

Prerequisites

  1. Install BepInEx 5.x for Outward
  2. Run the game once after installing BepInEx to generate configuration files

Manual Installation

  1. Download the latest release
  2. Extract OutwardStatusUtility.dll into BepInEx/plugins/ folder in your Outward directory
  3. Run the game

Configuration

Press F5 in-game (if you have Outward Config Manager installed) or manually edit the config file at:

BepInEx/config/com.Glowstick.outwardstatusutility.cfg

Configuration Categories

General Settings

  • Apply Status Key: The key to press to apply effects (Default: F9)
  • Remove Status Key: The key to press to remove all effects (Default: Numpad7)

๐ŸŸข Positive Effect Categories (Enabled by Default)

  • Enable Boons - Major magical blessings (Rage, Discipline, Bless, Cool, Warm, Mist, Possessed)
  • Enable Recovery Effects - Health/Stamina/Mana regeneration
  • Enable Combat Buffs - Attack Up, Protection, Speed Up, Resistance
  • Enable Special Buffs - Exalted, Energized, Prime, Elemental Buffs
  • Enable Food Buffs - Positive food/drink effects
  • Enable Misc Effects - Gift of Blood, Corruption Recovery, etc.

๐Ÿ”ต Positive Effects (Disabled by Default)

  • Enable Imbuements - Weapon/shield elemental imbues (may interfere with your imbues)
  • Enable Rune Effects - Magical rune blessings (some are quest/story related)
  • Enable Rest Effects - Tent and inn rest bonuses (can cause sleep/drowsy)
  • Enable Environmental Effects - Temperature/weather resistances

๐Ÿ”ด Negative Effect Categories (All Disabled by Default)

โš ๏ธ WARNING: These effects can harm, debuff, or kill your character!

  • Enable Hexes โš ๏ธ - Confusion, Pain, Chill, Haunted, Doom, Curse
  • Enable Debuffs โš ๏ธ - Slow Down, Dizzy, Weaken, Sapped, Cripple
  • Enable DOTs โš ๏ธ - Bleeding, Burning, Poisoned, Immolate, Plague
  • Enable Extreme Negatives โš ๏ธโš ๏ธ - DANGEROUS! Petrified, Corruption, Freezing
  • Enable Food Debuffs โš ๏ธ - Starving, Hungry, Parched, Drunk
  • Enable Diseases โš ๏ธ - Infection, Indigestion, Fever, Withdrawal

๐Ÿ› ๏ธ Custom Effects

  • Enable Custom Effects - Toggle for custom effect list
  • Custom Status Names - Comma-separated list of effect identifier names (e.g., Rage,Discipline,Cool,Alert)

How It Works

The mod uses identifier name matching to apply status effects precisely:

  1. You enable categories (e.g., Boons, Combat Buffs) or add custom effect names
  2. When you press F9, the mod collects all effect names from enabled categories
  3. It searches through all game status effects and matches by IdentifierName
  4. Only effects with matching names are applied to your character
  5. Press Numpad7 to instantly remove all active status effects

This approach ensures:

  • โœ… Accurate Category Filtering - Only effects from enabled categories are applied
  • โœ… Modded Effect Support - Works with custom effects by their identifier name
  • โœ… Reliable Matching - Uses the game's internal naming system
  • โœ… Full Control - See exactly which effects are applied via debug logs

Status Effects Database

The mod includes 260+ status effects organized into 16 categories by their identifier names.

๐Ÿ“Š View Complete Status Effect List

โœ… Positive Effects (Enabled by Default)

  • Boons - Rage, Discipline, Bless, Cool, Warm, Mist, Possessed (and amplified versions)
  • Recovery Effects - Health/Stamina/Mana recovery (multiple tiers)
  • Combat Buffs - Attack Up, Protection, Speed Up, Impact/Damage Resistance, Stability Up
  • Special Buffs - Exalted, Energized, Prime, Elemental Buffs, KillStreak
  • Food Buffs - Full, Refreshed, Gaberry Wine, PureWater, HealingWater
  • Misc Effects - Gift of Blood, Corruption Recovery, Life Drain, various resistances

๐Ÿ”ต Positive Effects (Disabled by Default)

  • Imbuements - Currently empty list (can be added via custom effects)
  • Rune Effects - Wolf/Shim/Egoth/Dez/Fal Runes, Runic Lantern/Blade/Protection
  • Rest Effects - Tent and inn rest bonuses (27 effects)
  • Environmental Effects - Temperature and weather resistances (10 effects)

โš ๏ธ Negative Effects (All Disabled by Default)

โš ๏ธ WARNING: These effects can harm, debuff, or kill your character!

  • Hexes - Confusion, Pain, Chill, Haunted, Doom, Curse (reduces damage and resistances)
  • Debuffs - Slow Down, Dizzy, Weaken, Sapped, Cripple (movement and combat penalties)
  • DOTs - Bleeding, Burning, Poisoned, Immolate, Plague (damage over time)
  • Extreme Negatives - Petrified, Corruption, Freezing, Aetherbomb (VERY DANGEROUS!)
  • Food Debuffs - Starving, Hungry, Parched, Drunk
  • Diseases - Infection 1-3, Indigestion 1-2, Fever, Withdrawal, Leywilt, Hunch

Usage

  1. Load into the game with your character
  2. Press F9 (or your configured key) to apply status effects from enabled categories
  3. Press Numpad7 (or your configured key) to remove all status effects
  4. All effects from enabled categories will be applied instantly
  5. Check the console log (BepInEx console) or in-game notification to see results

Usage Examples

๐Ÿงช Testing Build Synergies

  • Enable: Boons, Combat Buffs, Special Buffs
  • Test your build with all positive effects active

๐Ÿ”ฅ Challenge Mode

  • Enable: Hexes, Debuffs, DOTs
  • Create a hardcore challenge with multiple negative effects

๐ŸŽจ Specific Effect Combo

  • Disable all categories
  • Enable Custom Effects: Rage,Discipline,Cool,Alert,Exalted
  • Apply only the exact effects you want

๐Ÿงน Quick Reset

  • Press Numpad7 to instantly clear all status effects
  • Perfect for testing or removing unwanted effects

Finding Status Effect Names

To add custom status effects, use their exact identifier names:

๐Ÿ“Š View Complete Status Effect List

Example Custom Names:

Rage,Discipline,Bless,Alert,Exalted,Speed Up

Important Notes:

  • Names are case-sensitive - must match exactly
  • Use commas to separate multiple effect names
  • No quotes needed around names
  • Works with modded effects if you know their identifier names

Building from Source

Prerequisites

  1. Install .NET SDK (for .NET Framework 4.7.2 support)
  2. Clone this repository
  3. Reference your Outward game's Managed folder DLLs in the project

Build Commands

# Restore packages
dotnet restore

# Build the project
dotnet build -c Release

Output will be located at: bin/Release/net472/OutwardStatusUtility.dll

Project Structure

OutwardStatusUtility/
โ”œโ”€โ”€ Plugin.cs                    # Main mod logic
โ”œโ”€โ”€ OutwardStatusUtility.csproj  # Project file
โ”œโ”€โ”€ status_identifiers.txt       # Complete list of status effect names
โ”œโ”€โ”€ thunderstore/                # Thunderstore package files
โ”‚   โ”œโ”€โ”€ README.md
โ”‚   โ”œโ”€โ”€ manifest.json
โ”‚   โ””โ”€โ”€ icon.png
โ””โ”€โ”€ bin/Release/net472/          # Build output

Troubleshooting

Status effects not applying?

  • Check the BepInEx console for error messages
  • Verify you're in-game with a loaded character
  • Make sure at least one effect category is enabled in the configuration

Game crashes?

  • Disable "Extreme Negatives" category if enabled
  • Reduce number of simultaneous effects
  • Check if custom status names are valid

Key not responding?

  • Check if the key is already bound to another mod or game function
  • Try changing the key in the configuration file

Custom effect not working?

  • Verify the identifier name is correct and case-sensitive
  • Check the complete effect list
  • Enable "Custom Effects" toggle in config
  • For modded effects, check the mod's documentation for exact names

Credits

  • Built with BepInEx
  • Uses HarmonyLib for runtime patching
  • Inspired by the Outward modding community

License

MIT License - See LICENSE file for details

Changelog

See CHANGELOG.md for detailed version history.

Links

About

Utility for enabling specific status effects in the game Outward.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages