!(https://cf.way2muchnoise.eu/versions/822208.svg) # 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 !(https://cdn-raw.modrinth.com/data/GGd1161d/images/b7bf08dc12e81b08fba79d6e6d17c7de1c11dc87.png) ### With the mod installed !(https://cdn-raw.modrinth.com/data/GGd1161d/images/0fb3e993070cc511d3555e35baf7c16346c3ac79.png) # 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 <h1 id="maven">Maven packages for use in a developer environment</h1> Add this to your repositories ```groovy repositories { maven { url "https://codeberg.org/api/packages/PORTB/maven" } } ``` And add this to your dependencies ```groovy 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