Core Settings

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

Setting	What it does	Default
`configVersion`	Managed automatically by the mod. Do not edit. Tracks which plugin version last wrote the config.	Auto
`configFormatVersion`	Config 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`
`enabledByDefault`	When `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

Setting	What it does	Default
`isDebugModeEnabled`	Enables detailed logging for spawn scans, ability decisions, damage events, and all 12 event types. Turn this off in production to reduce log noise.	`true`
`debugMobRuleScanIntervalSeconds`	How often (in seconds) the debug logger reports mob rule scan statistics.	`5`

Integrations

Integrations:
  RPGLeveling:
    enabled: true

Setting	What it does	Default
`RPGLeveling.enabled`	Enables 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.

Getting Started

Admin UI

File Configuration

Developer API

Reference

Global Config (root core.yml)

System Config (base/core.yml)

Reconcile

Debug

Integrations

​Global Config (root core.yml)

​System Config (base/core.yml)

​Reconcile

​Debug

​Integrations

Global Config (root core.yml)

System Config (base/core.yml)

Reconcile

Debug

Integrations