OptiFine Version Renaming Tool

• 简体中文
• This is a renaming tool designed for OptiFine versions used with third-party Minecraft launchers.
• The tool uses ASM technology to dynamically modify and rename the folder, .jar file, and .json file within the .minecraft/versions/ directory to a user-defined version name.

Usage

• Ensure that Java Runtime Environment is installed on your device.
• Download the OptiFine installer (OptiFine.jar).
• Run the following command in the terminal to start the OptiFine installer and apply the renaming tool:

java -javaagent:<path/to/OptiFineRenamer.jar>="<custom_version_name>" -jar <path/to/OptiFine.jar>

• After executing the command, the graphical interface of the OptiFine installer will launch as usual. Complete the installation process as normal.
• Once the installation is complete, navigate to the .minecraft/versions/ directory, where you will find the newly generated folder and files renamed to your specified version name.

Example

Assuming Java Runtime Environment and OptiFine installer are ready.

• Run the following command in the terminal:

java -javaagent:C:\Tools\OptiFineRenamer.jar="1.20.1-OptiFine" -jar D:\Downloads\OptiFine_1.20.1_HD_U_I6.jar

• Proceed with the installation in the OptiFine graphical interface as usual.
• After installation, the structure in the .minecraft/versions/ directory will look like this:

.minecraft/
└── versions/
    └── 1.20.1-OptiFine/
        ├── 1.20.1-OptiFine.jar
        └── 1.20.1-OptiFine.json

Notes

1. Version Naming Rules:
   • Use valid file name characters for custom version names.
   • Avoid using reserved characters for the operating system.
2. Tool Compatibility:
   • The tool is designed based on the official OptiFine installer and may not work with modified installer versions.
   • The tool runs only in environments supporting Java.
   • In rare cases, the tool may fail to correctly identify and rename the version.

Disclaimer

This tool is unofficial and is not directly affiliated with the OptiFine team.