Options Rewriter

Options Rewriter is a lightweight client-side utility mod designed for Minecraft modpacks.

When importing a modpack, Minecraft or third-party launchers may sometimes reset the options.txt file, causing carefully configured keybindings and client settings from the modpack creator to be lost.

This mod allows modpack creators to include a prepared options.txt template and automatically rewrite it back into the instance on the first launch, restoring the intended keybindings and client settings.

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 triggering the rewrite process.

Features

Restore modpack keybindings after import-related resets
Automatically rewrite a provided options.txt on first launch
Preserve player changes after the initial setup
Save current settings as a reusable template
Manually trigger rewriting through configuration
Supports restart prompts or silent replacement
Client-side only, no server installation required

Use Cases

Modpacks where keybindings may be lost after importing
Large modpacks with carefully designed default controls
Modpack creators who want a reliable first-launch setup

Feedback & Support

Found a bug or have a suggestion? Please report it here:

https://github.com/s-j-y-m/Options_Rewriter/issues

You are free to include this mod in your modpack, provided that you comply with the Minecraft EULA and this mod's MIT License.

简体中文

Options Rewriter 是一个面向 Minecraft 整合包的小型客户端工具 Mod。

在导入整合包时，Minecraft 或部分启动器可能会因为初始化流程等原因重置 options.txt 文件，导致整合包作者预先配置好的键位和客户端设置丢失。

本 Mod 允许整合包作者提供准备好的 options.txt 模板，并在玩家首次启动时自动将其重新覆写回实例目录，恢复作者设计好的键位绑定和客户端设置。

覆写操作只会执行一次，并在完成后生成标记文件，避免之后重复修改玩家自己的设置。同时提供配置界面，方便保存模板以及手动重新执行覆写。

功能

修复整合包导入后键位设置丢失的问题
首次启动自动重新覆写 options.txt
保留玩家后续自行修改的设置
可将当前设置保存为模板
支持通过配置界面重新执行覆写
支持覆写后提示重启或静默处理
纯客户端 Mod，无需安装服务器端

适用场景

导入后可能丢失键位的 Minecraft 整合包
拥有复杂默认键位设计的大型整合包
希望保证首次游玩体验的整合包项目

反馈与支持

发现问题或有功能建议？欢迎提交反馈：