Wiki 9Minecraft Wiki 9Minecraft
Configuration Api Wiki › Guides › Managing Server-Synchronized and Locked Settings

Managing Server-Synchronized and Locked Settings

Understanding Server Synchronization

When you connect to a multiplayer server that runs supported mods, Configuration API automatically manages settings across the connection.

  • Automatic Sync: Important server configuration properties are synchronized directly from the server to your connected client.
  • Gameplay Consistency: This ensures that server-side mechanics and values remain identical for all connected players without requiring you to manually download or match text configuration files.

Recognizing Server-Locked Options

To prevent multiplayer desynchronization and rule conflicts, the menu restricts certain settings while connected to a server.

  • Grayed-Out Controls: Any configuration option that is enforced by the server will appear grayed out on your screen. You will not be able to interact with these sliders, toggles, or input fields.
  • Client-Side Adjustments: Settings that only affect your local client remain completely interactable. Only properties governed strictly by the server are locked to ensure stable, conflict-free gameplay.