Options Rewriter

Quick rating

Options Rewriter

No reviews yet

Restore modpack keybindings and client settings after import resets with automatic options.txt rewriting.

QoL & Tweaks
Mod Loaders
Forge
NeoForge
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Required
Server Unsupported

About

Project Details

Type
Mod
License
MIT License
Latest Version
options_rewriter-1.20.1-Forge-1.0.1.jar
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

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

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

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works