UnifiedKeybinds/UnifiedOptions

If you're reading this, I bothered to publish it (and document it)

What does it do 🤔

Unifies options.txt and keybinds for all minecraft instances with the mod installed into a single file that is used by all versions.

Put simply, in a diagram

Without the mod installed

With the mod installed

How to use it 🤔🤔

The mod should function out of the box.

When the mod is installed, it will move most options.txt options into universal.txt which can be found in your home directory:

Windows users: %userprofile%/MinecraftOptions
Linux users (and I assume macos, never used it): ~/MinecraftOptions

Default options? YOSBR?? 🤨

The mod also has a feature kinda like YOSBR and default options, but instead of copying configs from a folder within the modpack directory, it copies from MinecraftOptions/<version>/extras. You could use this, for example to automatically copy your journeymap config into all your modpacks so that your map always looks the same, or disable immersive engineering's cluttery tag tooltips.

Configuring it 🤔🥱🙄

The mod should function out of the box, but you can configure what options are synchronized, move where options are stored and completely disable the mod.

The config file is found at MinecraftOptions/config.toml. It explains what each option does.

If you want to reset your config, just delete config.toml and the mod will generate a new one.

By default, the following options are not synchronized:

tutorialStep
- This mod disables the tutorial.
overrideWidth
overrideHeight
resourcePacks
incompatibleResourcePacks
renderDistance
simulationDistance
fullscreen
fullscreenResolution

You can add or remove options (or keybinds) to/from the blacklist. Blacklisted options will be stored in the vanilla options.txt.

You can change where universal.txt and extras are read from by changing directory, under synchronization. config.toml cannot be moved.

1.12

If you open a 1.12 options.txt, you will see your controls formatted with numbers, like this:

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

And if you open a 1.16 options.txt, you will see your controls formatted with named keys, like this:

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 1.12 version of this mod converts any numerical values into the modern named keys automatically. Note that 1.16 and higher versions do not support this, so if you want to convert a 1.12 options.txt, load it with the 1.12 version of this mod.

Use in modpacks?

yes

Maven packages for use in a developer environment

Add this to your repositories

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

And add this to your dependencies

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

List of versions: https://codeberg.org/PORTB/-/packages/maven/portb-unifiedoptions/versions

UnifiedOptions