Skip to content

Latest commit

 

History

History
23 lines (16 loc) · 1.19 KB

File metadata and controls

23 lines (16 loc) · 1.19 KB

Keybind Fix

Keybind Fix is a client-side utility mod that prevents modded controls and unrecognised settings from resetting to default values on startup.

Why does this happen?

  1. When Minecraft boots up, it immediately overwrites options.txt to save early safety and telemetry flags.
  2. Because mods load asynchronously in parallel, their keybindings haven't registered yet when this early save happens.
  3. Minecraft sees your custom mod keybinds in options.txt, assumes they are unknown or corrupted settings, and deletes them.
  4. By the time mod loading finishes, the custom keys are already gone from disk.

How it works

Keybind Fix solves this in the background:

  • Preserves Settings: Backs up all unrecognised keybind lines from options.txt on startup.
  • Prevents Deletion: Restores and appends your modded settings back to the end of the file whenever an early save triggers.
  • Applies Controls: Automatically triggers a reload of the options file after all mods have finished loading, applying your customised controls cleanly.

Compatibility

  • Minecraft: 1.21.1
  • NeoForge: 21.1.230 or newer
  • Client-side only. Safe to run on servers (it will disable itself).