Applies your curated keybind defaults on the pack’s first launch, saves options, then disables itself so players keep custom binds. Supports modifiers, unbinding, and works with any mod keymapping. No restart needed.
Description
Keybind Overrides is a tiny client-side utility for modpack creators. It applies a curated set of keybind defaults on the very first launch of the pack—without shipping options.txt and without forcing players to restart. On first load it reads config/keybindoverrides-client.toml, overwrites any listed keybinds (vanilla + modded), saves options.txt, then automatically flips applyOverrides to false so players keep their own tweaks afterward. Supports modifiers (Shift/Ctrl/Alt), unbinding via key.keyboard.unknown, and works alongside any mod that registers keymappings. If you need to reapply on an update, just set applyOverrides = true again.
How to use
- Launch once to generate config/keybindoverrides-client.toml.
- Set
applyOverrides = trueand list overrides askey_name:key_value[:MODIFIER](copy from your options.txt). - Ship the pack; first launch applies and disables itself. No restart needed.
Why use it
- Prevents key conflicts across large modpacks.
- Doesn’t wipe player settings on updates (unlike bundling options.txt).
- Immediate effect; no reboot required.