YetAnotherConfigLib Mod FAQ
10 questions players actually ask, answered.
How do I start making a config screen for my mod?
Create a new YetAnotherConfigLib builder instance and add option groups using `.addOptionGroup()`, then register it to your mod's config screen factory. The library handles all the menu rendering and layout automatically.
What's the difference between a category and an option group?
Categories are visual sections within a single screen that organize related options together, while option groups are the top-level containers you add to your builder—you can have multiple groups that appear as tabs or separate sections depending on your layout.
Can I add search/filter functionality to my config screen?
YetAnotherConfigLib doesn't include built-in search, but you can organize options into well-named categories and use clear tooltips to help players find settings quickly without needing a search feature.
How do I make a config option that only shows up when another option is enabled?
Use conditional rendering by setting a requirement or predicate on your option that checks the state of the parent setting—this keeps the screen clean by hiding irrelevant options dynamically.
What happens if my config file gets corrupted or deleted?
YetAnotherConfigLib will use your default values defined in the builder when the config file is missing or invalid, so your mod won't crash—players can then reconfigure their settings normally.
Can I use YetAnotherConfigLib with mods that use other config systems?
Yes, YetAnotherConfigLib is a library that only handles the menu UI—it doesn't conflict with other config systems since each mod manages its own settings file independently.
How do I add a slider vs. a text input for numeric options?
Use the appropriate option type when building—sliders are ideal for bounded values with a defined range, while text inputs work better for unbounded numbers or when you need precise manual entry.
Will using YetAnotherConfigLib make my mod load slower?
No, YetAnotherConfigLib is lightweight and only loads the config menu when players open it—it doesn't affect your mod's startup time or runtime performance.
How do I save changes without restarting the game?
YetAnotherConfigLib automatically writes changes to your config file when players adjust settings, and you can bind those changes directly to your mod's live settings so they take effect immediately.
Can I add custom buttons or actions to my config screen?
YetAnotherConfigLib focuses on configuration options rather than custom actions, but you can add buttons that trigger config resets or open external links by using action-based option types if your use case supports it.