NeoOrigins Client Config Reference

Per-client (not per-world, not server-controlled) options live in the TOML file config/neoorigins/client.toml in your game directory. They affect only your own client — UI skin, HUD layout, and how many named hotkeys are registered — and are safe to differ from player to player on the same server.

The file is created with defaults on first launch. Edit it while the game is closed, or change values in-game via the mod’s config screen (Mods → NeoOrigins → Config) where exposed.

[ui] — selection / info screens

Option	Type	Default	Description
theme_override	string	""	Force a specific UI theme id (e.g. neoorigins:parchment, examplepack:dark_woods) regardless of what the server’s datapacks declared. Only takes effect when the named theme is actually loaded. Empty = follow the server / datapack-declared theme. See THEMING.md.
classic_picker_style	bool	false	Revert the origin/class selection screens to the original flat high-contrast skin (dark panels, light text, vanilla font) instead of the parchment scroll. Enable if the parchment theme’s brown-on-paper text is hard to read.
show_origin_editor	bool	false	Show the in-game Origin Editor button on the origin info screen for all players, not just those in Creative. The editor is a pack-authoring tool, creative-only by default. Enable if you author origins in survival or want testers to reach it without /gamemode.
default_sort	enum	CLASS	Initial sort order for the origin selection / info screens, used until you cycle the on-screen sort button (your cycled choice then wins for the rest of the session). Values: CLASS (grouped by mod/namespace, alphabetical within), NAME_ASC (flat alphabetical), NAME_DESC (flat reverse-alphabetical), IMPACT_ASC (by origin impact: none → low → medium → high).

[hud] — heads-up display

Option	Type	Default	Description
hide_hud_bars	bool	true	Hide the vanilla hunger / air HUD bars for origins that don’t consume them (e.g. Automaton hunger; Merling / Kraken / Automaton air). Turn off to keep vanilla bars visible regardless of origin.
show_cooldown_countdown	bool	true	Master switch for the numeric seconds drawn on cooldown icons. Packs opt individual powers in via "cooldown_countdown": true; set this to false to suppress all countdown numbers on this client.
cooldown_countdown_opacity	int (0–100)	70	Opacity, in percent, of the countdown seconds drawn on cooldown icons. 100 = fully opaque, 0 = invisible. Values below 5 render as 5 (the font renderer drops text below that).
hud_ability_display	enum	ALL_ACTIVE_ABILITIES	What the ability HUD cluster shows besides live cooldowns. ALL_ACTIVE_ABILITIES: every keybind ability with an icon keeps a persistent slot — full-bright while idle, cooldown sweep while recharging, bright/dim for toggles. COOLDOWNS_AND_TOGGLES: cooldown slots only while recharging, plus icon-bearing toggle powers (bright = on, dimmed = off).
always_show_ability_icons	bool	false	Force every icon-bearing ability to stay on the HUD cluster even while off cooldown (as if each power declared "always_show_icon": true). Default false: idle cooldown icons disappear unless the power itself opts in.

The cooldown icon and countdown fields that powers declare (cooldown_icon, cooldown_countdown, always_show_icon) are documented in POWER_TYPES.md; the switches above are the per-client overrides for them.

[hotkeys]

Option	Type	Default	Description
pool_size	int (1–256)	32	Number of named-keybind slots registered at client startup. Each pack-declared "key": "translation.key.id" on an active power consumes one slot; the Controls screen shows that many unassigned “Hotkey N” entries. Increase if your packs declare more than 32 distinct keys. This is a client setting — keybinds register at startup, so the slot count is chosen locally and cannot be dictated by the server.