ModsFinder

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.

ForgeClient-side onlyGNU Lesser General Public License v3.0 onlyOpen source1.12.2 – 1.20.1

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

  1. Shared options file

    Selected options from options.txt are kept in a universal.txt file that copies into each install's home directory.

  2. Configurable synchronization

    The config.toml file lists which options are synchronized and where the universal file is read from.

  3. Modpack extras directory

    Default values placed in an extras directory are applied so a pack can ship preset options.

  4. Tutorial suppression

    The mod disables the tutorial prompts that appear in a new world.

Compatibility

Latest build for each game version and loader.

1.20.11.20.1-1.1
1.19.41.19.4-1.1
1.19.31.19.3-1.1
1.19.21.19.2-1.1
1.18.21.18.2-1.1
1.17.11.17.1-1.1
1.16.51.16.5-1.1
1.12.21.12.2-1.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

How it compares

Full comparison

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.

ModLoadersGame versionsEnvironmentUpdated
UnifiedOptionsForge1.12.2 – 1.20.1Client-side only2023-06-14
Default OptionsFabric, Forge and NeoForge1.18 – 26.3Client-side only2026-09-16
HTTP RequestForge1.20.1Client and server2025-10-01
Emery's MaterialTweakerForge1.20.1Client and server2026-07-07

Questions

Does UnifiedOptions need to be installed on a server?

No. It is installed on the player's side alone, so servers need nothing.

Which Minecraft versions does UnifiedOptions support?

Files exist for 1.12.2, 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.3, 1.19.4 and 1.20.1, and the latest Forge file is 1.20.1-1.1.

How does a 1.12 options file work with newer versions?

The mod converts 1.12 numerical key bindings to named keys automatically. A 1.12 options.txt can also be loaded with a 1.12 install, which the author notes recommend for converting controls back.

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

All projects

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…
PORTB, on the Modrinth page

Official listing

Owner
PORTB
Published
2023-04-17
Updated on Modrinth
2023-06-14
Facts verified
2026-10-15

Tags