VanillaConfig Mod Wiki & Guide

Get the files on 9Minecraft

Contents (6)

Overview
Guides
Frequently asked questions
Dependencies
Gallery
You May Also Like

Overview

VanillaConfig (v26.1.2 for Minecraft) is a backend library and API developed by TreSet. It is designed to streamline the creation, management, and visual presentation of mod configurations. By providing a unified framework, it ensures that all dependent mods—such as Better Statistics Screen, Better Advancements, and Simple Compass—feature a consistent, high-quality settings menu that integrates seamlessly with the native Minecraft 'Options' aesthetic.

As a library mod, VanillaConfig does not add standalone gameplay elements like mobs, blocks, or biomes. Instead, it serves as a critical dependency for other mods, handling the complex logic of saving, loading, and migrating user settings while providing a robust GUI for players to interact with.

Guides

Step-by-step, in-game.

Create and Register Your First Configuration FileSetting Up Your Config Class Start by creating a central configuration class in your mod. This class will hold all…Generate and Customize an In-Game Configuration ScreenAccessing the Config Screen VanillaConfig can automatically generate a user-friendly configuration screen that…React to Configuration Changes in Your ModUsing Callbacks to Stay in Sync VanillaConfig provides callback hooks so your mod can respond when settings change,…Update Your Config Without Losing Player SettingsUnderstanding Config Versioning When you add, remove, or change configuration options, increment your config file's…

Frequently asked questions

How do I find my config file after installing this mod?

VanillaConfig saves configuration files to your game's config folder (usually `.minecraft/config/`), organized by mod ID. Look for a file named after the mod you're configuring—it will be in a human-readable format like JSON or TOML depending on the mod's setup.

Can I edit my config file directly in a text editor?

Yes, VanillaConfig stores configs in plain text formats that you can edit manually. After saving your changes, restart the game or reload the config through the in-game menu for the changes to take effect.

What happens if I delete my config file?

VanillaConfig will regenerate the config file with all default values the next time the mod loads. This is useful if your config becomes corrupted, but you'll lose any custom settings you had.

Do I lose my settings when a mod updates?

No—VanillaConfig includes a migration system that preserves your existing settings when mods update. If the mod author added new options or changed the config structure, migration code runs automatically to adapt your old config to the new format.

See all 20 VanillaConfig questions ›