Skip to content

Config editor

The Config page is a structured editor for mod settings. Instead of opening .cfg files in Notepad and hoping you don't break the parser, you get a UI with the right control for each setting type.

What it edits

Most BepInEx-based mods write a .cfg file in the game's BepInEx/config/ folder. The format looks like:

ini
[General]
## Enable the feature.
# Setting type: Boolean
# Default value: true
EnableFeature = true

## How aggressive (1-10).
# Setting type: Int32
# Default value: 5
# Acceptable value range: From 1 to 10
Aggressiveness = 7

Zephyr parses these files - the comments included - and renders each setting with the right UI:

  • Booleans -> ON / OFF toggle button
  • Ints / floats -> number input (with min/max enforced when the file declares a range)
  • Enums -> dropdown
  • Strings -> text field
  • Flag enums -> multi-select

For files Zephyr can't parse, the editor shows the parse error rather than a structured view; an Open file action in the page header opens the raw file in your OS's default editor.

The view

Config editor

The left sidebar lists every config file in your active profile. Search filters the list. Click a file to load its settings. Settings are grouped by section, with the original mod-author description shown above each control.

Editing

Change a value, the file is saved instantly. There's no Save button.

Reset to default

When a setting has a default declared in the file, an undo icon appears next to its name that restores the parsed # Default value:.

Mod hasn't generated its config yet?

A common gotcha: many BepInEx mods only write their config file the first time the game runs with the mod loaded. If you don't see a mod's config in the list, launch the game once and come back.

Per-profile

Configs are profile-scoped. The same mod can be configured differently in two profiles, no conflict.

Opening the file directly

If you need to hand-edit something Zephyr can't represent, the Open file button in the page header opens the selected file in your OS's default editor.

Released under GPL-3.0.