> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rpgmobs.frotty27.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Settings

> Global system settings for diagnostics, reconciliation, and compatibility.

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.

```yaml theme={null}
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](/config/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

```yaml theme={null}
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

```yaml theme={null}
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](https://www.curseforge.com/hytale/mods/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](/reference/compatibility#rpgleveling) for full configuration details.