Save, reuse, and share your Minecraft settings across instances and versions.
Universal Config is a client-side mod that lets you save your Minecraft settings, keybinds, and mod configuration files as reusable profiles and share them across different instances and Minecraft versions.
You no longer need to reconfigure your keybinds and mod settings every time you create a new instance.
- Save your current settings as a profile
- Store keybinds and other
options.txtsettings - Store mod configuration files from the
configfolder - Browse saved profiles from an in-game interface
- Review profile contents before applying them
- Duplicate, export, and delete profiles
- Set a default profile
- Schedule a profile to be applied on the next launch
- Restore previous settings from a backup
Universal Config does not simply overwrite your entire options.txt file.
Instead, saved settings are merged into your current configuration individually, allowing settings that only exist in the current instance to remain untouched.
Keybinds are also handled separately for better compatibility.
Your current configuration is backed up before a scheduled profile is applied.
Universal Config is not designed to copy an entire Minecraft instance.
The following data is not included in profiles:
- Mods
- Worlds
- Logs
- Crash reports
- Resource packs
- Shader packs
- Screenshots
Universal Config is specifically designed for sharing and reusing Minecraft configurations.
Profiles can be used across different Minecraft versions and instances.
However, full compatibility cannot always be guaranteed, as it depends on the mods being used and their configuration formats.
Some settings may not work correctly if the required mod is not installed or if a mod update has changed its configuration format.
Universal Config shows profile information and compatibility warnings before a profile is applied so you can review what will be changed.
Open Universal Config from the Minecraft title screen.
From the profile screen, you can:
- Save your current settings as a new profile
- Browse existing profiles
- Select a profile saved from another instance
When you select a profile, you can review the following information before applying it:
- The Minecraft version the profile was created with
- Mod loader
- Whether the profile contains keybinds, Minecraft client settings, and/or mod configuration files
- Compatibility warnings
Once confirmed, the selected profile is scheduled to be applied the next time Minecraft starts.
Your current configuration is backed up beforehand, and the profile is merged into your settings before Minecraft loads them.
Profiles can be:
- Created
- Duplicated
- Opened in their folder
- Deleted
- Set as the default profile
Profiles are stored in the portable .ucp format and can be moved to another PC or shared with other players.
By default, shared profiles are stored in the following locations:
%APPDATA%\.universal-config\
~/.universal-config/
You can change the profile storage location from the Universal Config screen, but using the default location is recommended for most users.
Official distribution pages:
Found a bug, have a feature idea, or want to request compatibility with another Minecraft version, mod loader, launcher, modpack, or mod?
Please use the appropriate GitHub Issue form:
- Bug report — report crashes, broken behavior, profile application problems, or other defects
- Feature request — suggest new functionality or improvements
- Compatibility / version support — request support for a Minecraft version, mod loader, launcher, modpack, or another mod
When reporting a bug, include the Minecraft version, mod loader, Universal Config version, reproduction steps, and relevant logs or crash reports whenever possible.
Bug reports, compatibility reports, feature suggestions, and pull requests are welcome.
Before opening a new issue, please check the existing issues to avoid duplicates.