Skip to main content
RPGMobs uses two core configuration files: a root core.yml for global settings and base/core.yml for system-level configuration.

​
Global Config (root core.yml)

The root core.yml contains settings that apply to the entire mod, independent of any world or overlay. 
configVersion: "3.260303.0"
configFormatVersion: 3
enabledByDefault: true
SettingWhat it doesDefault
configVersionManaged automatically by the mod. Do not edit. Tracks which plugin version last wrote the config.Auto
configFormatVersionConfig layout version. When this value is lower than the version expected by the mod, all config files (base, world overlays, instance overlays) are wiped and regenerated with fresh defaults. This is not tied to plugin versions - it only changes when the config architecture breaks. Do not edit.3
enabledByDefaultWhen true, worlds without a specific overlay file use the base config. When false, RPGMobs is disabled for unmatched worlds.true

​
System Config (base/core.yml)

base/core.yml contains system-level settings shared across all worlds.

​
Reconcile

When you reload configuration with /rpgmobs reload or save from the Admin UI, existing elites in the world are automatically reconciled to match the new settings. Each elite re-evaluates its mob rule on its next tick - if the rule was removed, the elite is despawned; if the rule changed, equipment is re-applied. Mobs loaded from saved chunks after a config change are reconciled when they load.

​
Debug

Debug:
  isDebugModeEnabled: true
  debugMobRuleScanIntervalSeconds: 5
SettingWhat it doesDefault
isDebugModeEnabledEnables detailed logging for spawn scans, ability decisions, damage events, and all 12 event types. Turn this off in production to reduce log noise.true
debugMobRuleScanIntervalSecondsHow often (in seconds) the debug logger reports mob rule scan statistics.5

​
Integrations

Integrations:
  RPGLeveling:
    enabled: true
SettingWhat it doesDefault
RPGLeveling.enabledEnables the RPGLeveling integration for tier-scaled XP and minion XP reduction. Requires RPGLeveling to be installed. When active, a separate rpgleveling.yml file is generated with XP balance settings. XP settings are also overlayable per-world.true
See Compatibility - RPGLeveling for full configuration details.