UnifiedOptions

If you're reading this description, it means I've taken the time to publish and document this mod.

Core Functionality

The mod unifies options.txt files and keybind settings for all Minecraft installations where it's present, creating a single configuration file used by all game versions.

Visual Representation of Mod Operation

Without the Mod Installed

With the Mod Installed

Simple Usage

The mod works immediately after installation without additional configuration. When activated, most parameters from options.txt are moved to the universal.txt file located in the home directory:

• Windows users: %userprofile%/MinecraftOptions
• Linux and macOS users: ~/MinecraftOptions

Additional Features

The mod provides functionality similar to YOSBR and default settings, but with a difference: instead of copying configurations from a folder within the modpack directory, it copies from MinecraftOptions/<version>/extras. This allows, for example, automatically transferring Journeymap settings to all modpacks so the map always looks the same, or disabling annoying tag tooltips in Immersive Engineering.

Parameter Configuration

Although the mod works out of the box, you can configure which specific parameters are synchronized, change the location of settings files, or completely disable the mod's functionality.

The configuration file is located at MinecraftOptions/config.toml and contains explanations for each parameter.

To reset settings, simply delete the config.toml file - the mod will create a new one.

By default, the following parameters are NOT synchronized:

• tutorialStep
  • The mod disables the tutorial guide.

You can add or remove parameters (including keybindings) from the blacklist. Blocked options will be saved in the standard options.txt file.

The location of the universal.txt file and additional settings can be changed via the directory parameter in the synchronization section. The config.toml file cannot be moved.

Version 1.12 Features

In Minecraft version 1.12, control settings are displayed in numerical format:

key_key.jump:57
key_key.sneak:42
key_key.sprint:16
key_key.drop:211
key_key.inventory:20
key_key.chat:28
key_key.playerlist:0

In version 1.16 and above, key names are used:

key_key.jump:key.keyboard.space
key_key.sneak:key.keyboard.left.shift
key_key.sprint:key.keyboard.left.control
key_key.drop:key.keyboard.q
key_key.inventory:key.keyboard.e
key_key.chat:key.keyboard.t
key_key.playerlist:key.keyboard.tab

The mod version for 1.12 automatically converts numerical values to modern key names. Versions for 1.16 and above do not support this function, so to convert an options.txt file from 1.12, you need to use the corresponding mod version.

Usage in Modpacks

Yes, can be used.

Maven Packages for Developers

Add to repositories:

repositories {
    maven { url "https://codeberg.org/api/packages/PORTB/maven" }
}

And add to dependencies:

dependencies {
    //example: portb:unifiedoptions:1.19.4-1.1
    runtimeOnly fg.deobf("portb:unifiedoptions:<MC VERSION>-<MOD VERSION>")
}