Options Rewriter
by Sjym
Options Rewriter applies a modpack's provided options.txt on first launch, so players start with the pack's own keybindings and client settings.
What it does
On the first launch after installation, Options Rewriter replaces the player's options.txt with the one shipped in the modpack. This restores keybindings and client settings that an import would otherwise reset. A flag file is created when the rewrite finishes, so later customizations made by the player are not overwritten on subsequent starts.
The rewrite can also be triggered manually from the mod's configuration. A configuration screen lets a modpack creator save the current settings as a reusable template, and the replacement can be run again whenever needed. Restart prompts are shown after the change, and the replacement happens silently otherwise.
Options Rewriter runs on the client only, so a server does not need it and players install it on their own game. It is built for Forge and NeoForge, published for 1.18.2 – 1.21.11, and released under the MIT License as open source.
Key features
Automatic first-launch rewrite
The modpack's options.txt is written over the player's file the first time the game starts with the mod installed.
Preserved player changes
Once the rewrite has run, a flag file stops it from repeating, so later changes to controls and settings remain.
Template saving
The configuration screen can capture the current settings as a template for reuse across modpack releases.
Manual trigger
The rewrite can be started again from the configuration whenever a modpack needs its controls restored.
Compatibility
Latest build for each game version and loader.
1.21.x2 of 2 versions with builds
1.20.x6 of 6 versions with builds
1.19.x3 of 3 versions with builds
1.18.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Large modpacks
Packs with many keybindings and carefully designed default controls can ship those defaults so every player starts the same way.
Reliable first-launch setup
Modpack creators who need a predictable initial configuration can rely on the rewrite happening once, at first launch.
Who it’s for: Modpack creators who ship custom controls and client settings, and players who import a pack and want its defaults to stay in place.
Questions
Does Options Rewriter need to be installed on the server?
Will the rewrite overwrite changes a player makes later?
Which loaders does Options Rewriter support?
Can the rewrite be run again after the first launch?
In the catalog
Options Rewriter is one of 8,016 Management mods on ModsFinder, and one of 2,698 Management mods for Forge. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
Options Rewriter is a lightweight client-side utility mod designed for Minecraft modpacks. The rewrite process only happens once and creates a flag file after completion, preventing the player's later customizations from being overwritten. A configuration screen is also provided for saving templates and manually…
Official listing
- Modrinth page
- modrinth.com/mod/options-rewriter
- Owner
- Sjym
- Published
- 2026-07-16
- Updated on Modrinth
- 2026-07-18
- Facts verified
- 2026-10-15