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 的前提下，将本模组自由加入你的整合包中。