Understanding ModConfig Types

The NeoForge / Minecraft Forge config system features four / three dedicated types of configs specified by ModConfig.Type. Depending on the scope and timing you want your config values to be available, you will have to choose one or multiple types for your project.

To help select the correct type, here is a basic overview of differences between all of them.

Common Config Type

• Physical Loading Environment: Client & Server
• Loading Point: Mod Loading
• Config File Location: .minecraft/config
• Synchronized to Logical Clients: ❌

Client Config Type

• Physical Loading Environment: Client
• Loading Point: Mod Loading
• Config File Location: .minecraft/config
• Synchronized to Logical Clients: ❌

Server Config Type

• Physical Loading Environment: Client & Server
• Loading Point: World Loading
• Config File Location: .minecraft/config (NeoForge, while still allowing for manual per-world overrides), .minecraft/saves/<world>/serverconfig (Minecraft Forge, per-world)
• Synchronized to Logical Clients: ✅

Startup Config Type (NeoForge only)

• Physical Loading Environment: Client & Server
• Loading Point: Game Loading
• Config File Location: .minecraft/config
• Synchronized to Logical Clients: ❌