Config Menus for Forge

📖 About:

Config Menus for Forge allows for editing config files for all mods directly in-game without having to ever touch a single file again.

📚 Contents:

Most notably, this mod allows for: editing all of Forge's config types (including server configs, as well as syncing with an online server and other players), setting default configs to be used when creating new worlds, a powerful and immersive search, proper handling for editing lists with various data types, an easy to use interface for dealing with all configs added by a single mod at a glance, and much more.

When opening a mods config menu you'll be greeted with a file selection screen listing all config files added by the mod. The restore defaults button allows for resetting a single config file as a whole (you can tell a config has been modified when it's name is in italics). There is also a button for opening the actual config file in an editor. The copy to defaults button allows you to set this config as a default config to be used whenever the config is recreated (mainly useful for server configs when creating new worlds).

When a config is open, you'll find a big list with all config options and categories. The button to the right of every option will restore it's default value. When an option is hovered, a tooltip will provide additional information, including the internal key, description, range, allowed values, and the default value. On the bottom, the cancel button can be used for discarding changes, the done button will save all changes to the config file.

The path bar on top shows where you currently are within the active config file. But there's more: It also functions as a navigation bar. You can click on previous categories to go back to them.

Searching is quite fancy, the current query is highlighted, and found entries are sorted accordingly. Results will be located in the current, as well as all subsequent categories. And best of all, the search field can be cleared again with a simple left-click.

Editing more complex values such as strings, enums and lists is done via a separate screen. In this case, an enum value can be chosen from a list where all choices can be viewed at a glance.

Editing lists on the other hand looks quite a bit different. All values are entered as strings and will be converted and checked automatically. Sometimes, the type of a list cannot be determined by Config Menus for Forge, so you'll be promted to choose the type yourself, or edit the option directly in the config file instead (not yet implemented). Also lists cannot be saved when invalid entries have been added, they need to be manually corrected before that.

This message is shown when attempting to edit server configs from the main menu as they are not loaded yet (they're only loaded when inside of a world).

This message is shown when playing on an online server. Server configs can only be edited by server operators. When doing so, they'll be synced back to the server and from there to all other clients. In singleplayer no warnings are shown and no syncing happens as everything is done locally.

💡 FAQ:

Q: Can I edit server configs with this mod?
A: YES!

Q: Can I edit server configs while on a multiplayer server?
A: Yes again! The only limitations are that you need to be an operator on that server, and Config Menus for Forge needs to be installed server-side as well.

Q: I'm unable to edit server configs! It always says "Data for this config hasn't been loaded yet".
A: Server configs can only be edited while playing inside of a world. To access the mod list screen from inside a world, you need to install a separate mod. I highly recommend my own mod Better Mods Button for that purpose.

Q: I can't edit Forge's client config!
A: You have OptiFine installed, Forge's client config can't be used then. This has nothing to do with Config Menus for Forge.

Q: I'm a server owner and I don't want anyone to edit the server's configs while it is running.
A: Simply don't install Config Menus for Forge on your server, everything but editing server configs will still work for your players.

Q: I'm a mod developer and I already added custom backgrounds for Configured. Do I need to do it for this mod again?
A: No, Config Menus for Forge uses the resources provided by mods for Configured as well. There are other developer options planned for the future though. In case you're unsure about adding a custom background to the config menus for your mod, check out the instructions on the mod page for Configured.

Q: I'm a developer and I want my mod to use these config menus. What do I need to do?
A: Nothing really. Just ask your users to install this mod alongside yours. You don't need to add a dependency or anything like that.

Q: I'm already using the Configured mod by MrCrayfish for editing configs in-game, why would I consider installing this instead?
A: Configured is a great mod, but unfortunately there are a number of shortcomings which led to this mod being made. These shortcomings are mainly: missing ability to edit server configs, and to set default configs; inconvenient handling of configs when there are multiple files per mod; config files being saved immediately whenever any option is edited, lacking any way to discard changes, while also leading to the config reloading and executing a bunch of logic needlessly way too often.

Q: What about a Fabric port?
A: Not available.

🏆 Credits:

Developing Config Menus for Forge was helped and inspired by:

• The amazing MrCrayfish for making his beautiful Configured mod, allowing players to configure their mods in-game for the very first time on Forge 1.13+. Config Menus for Forge has obviously been greatly inspired by this mod, in fact it originally started out as nothing less than a port of it. Since then the mod has been rewritten from the ground up, only small bits are still reminiscent of Configured, most notably the very pretty and effective main config screen layout.
• UnitedMel for allowing me to use the cute player icon from their BetterMenu resource pack

Похожие моды

Yprastitel Discord Chat (MDC) Bloodhatam’s more sounds Baritone Malek’s Infinity Gauntlet Mesh Impersonate Enchanting Commands