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 整合包
• 拥有复杂默认键位设计的大型整合包
• 希望保证首次游玩体验的整合包项目

反馈与支持

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

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

你可以在遵守 Minecraft EULA 以及本模组 MIT License 的前提下，将本模组自由加入你的整合包中。