UnifiedOptions
by PORTB
UnifiedOptions keeps selected settings from options.txt in one shared file, so a player's controls and options carry across Minecraft versions and modpacks.
What it does
Before the game reads options.txt, the mod can copy a shared universal.txt file into the game's home directory and merge it in. The list of options kept in sync is set in config.toml, and the file that holds the shared values can be moved to another directory inside the synchronization setup. Settings outside that list stay under the normal options.txt file for each install.
Key bindings are the main case: a file written by the 1.12 release stores controls as numbers, while 1.16 and later use named keys. The mod converts 1.12 numerical values to the modern named form automatically, and it can also load a 1.12 options.txt from a 1.16 or later install when that file is needed again. Players who run a modpack can use an extras directory to supply default values, so a pack's map and tooltip settings are applied on first launch without copying configs by hand.
The mod can be disabled completely, or its generated config.toml can be deleted so that a new default one is created. Its set of synchronized options and the location of the universal file are both set in that config. The mod is distributed under the GNU Lesser General Public License v3.0 only and is open source, with public source code and an issue tracker.
Key features
Shared options file
Selected options from options.txt are kept in a universal.txt file that copies into each install's home directory.
Configurable synchronization
The config.toml file lists which options are synchronized and where the universal file is read from.
Modpack extras directory
Default values placed in an extras directory are applied so a pack can ship preset options.
Tutorial suppression
The mod disables the tutorial prompts that appear in a new world.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Default Options is a client-side mod for Fabric, Forge and NeoForge across 1.18 – 26.3, released under All rights reserved and not open source. HTTP Request runs on client and server for Forge 1.20.1 under the MIT License and is not open source. Emery's MaterialTweaker is also client and server on Forge 1.20.1 under the MIT License, and is not open source either. UnifiedOptions is the only one here that is open source and client-side on Forge across 1.12.2 – 1.20.1.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| UnifiedOptions | Forge | 1.12.2 – 1.20.1 | Client-side only | 2023-06-14 |
| Default Options | Fabric, Forge and NeoForge | 1.18 – 26.3 | Client-side only | 2026-09-16 |
| HTTP Request | Forge | 1.20.1 | Client and server | 2025-10-01 |
| Emery's MaterialTweaker | Forge | 1.20.1 | Client and server | 2026-07-07 |
Questions
Does UnifiedOptions need to be installed on a server?
Which Minecraft versions does UnifiedOptions support?
How does a 1.12 options file work with newer versions?
In the catalog
UnifiedOptions is one of 36,990 Utility mods on ModsFinder, and one of 14,575 Utility mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from PORTB
Similar mods
What the author says
If you're reading this, I bothered to publish it (and document it) 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/ /extras. You could use this, for example to automatically copy your journeymap…
Official listing
- Modrinth page
- modrinth.com/mod/unifiedoptions
- Owner
- PORTB
- Published
- 2023-04-17
- Updated on Modrinth
- 2023-06-14
- Facts verified
- 2026-10-15
