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

# Disable Mod for a Specific World/Instance

> How to turn off RPG Leveling (HUD, XP, scaling, stats) for specific worlds or instances such as minigame dungeons.

# How to Disable the Mod for a Specific World/Instance

You can disable RPG Leveling for **specific worlds or instances** (e.g. a minigame dungeon, PvP arena, or story instance) so that in those places the plugin has **no effect**: no HUD, no XP, no level scaling, no stat-based modifiers. Players keep their level and stats when they leave; only the **gameplay impact** of the mod is turned off while they are in that world.

***

## When to Use This

* **Minigame / arena worlds** - You want vanilla combat and no level display in that instance.
* **Story or tutorial instances** - You don’t want level scaling or XP there.
* **Dungeons where you want vanilla difficulty** - Keep the dungeon as the mod author intended, without RPG Leveling scaling.

***

## How It Works

* **World = instance** - Each playable world (open world, dungeon instance, etc.) is identified by an **instance id** (e.g. the dungeon name). The plugin matches that id against [Instance Level Config](config-instances).
* **Per-instance flag** - In `InstanceLevelConfig.json`, each instance entry can have **`DisableRPGLeveling`**. When set to **`true`** for that instance, the plugin does nothing there: no HUD, no XP gain, no monster level scaling, no damage/defense/mining/stamina modifiers, no death reset. When the player leaves, the mod works again as usual.

***

## Steps

### 1. Find the instance id

You need the **exact instance id** the game uses for that world:

* **Dungeons / mod instances** - Enter the world and check the **HUD**: it often shows the instance name (e.g. *"Yungs\_HyDungeons\_Skeleton\_Dungeon (Lvl 55–75)"*). The id is the part before the level range. You can also add a temporary instance entry with a guess, run **`/lvl reload`**, and see if the HUD shows your level range; if not, try a different id (some mods document it).
* **Main world** - If your main world appears in Instance Level Config (e.g. as `"Id": "default"`), you can set **`DisableRPGLeveling`** on that entry to disable the mod on the main world (not common).

### 2. Open Instance Level Config

**File:** `mods/Zuxaw_RPGLeveling/InstanceLevelConfig.json`

If the instance is not in the list yet, add an entry with **`Id`**, **`LevelMin`**, **`LevelMax`**, and **`DisableRPGLeveling`**. If it already exists (e.g. for level ranges), just add or change **`DisableRPGLeveling`**.

### 3. Set DisableRPGLeveling to true

For the instance you want to disable the mod in, set:

```json theme={null}
"DisableRPGLeveling": true
```

**Example - disable RPG Leveling in the Skeleton Dungeon:**

```json theme={null}
{
  "Version": "0.2.7",
  "Instances": [
    {
      "Id": "default",
      "LevelMin": 1,
      "LevelMax": 25,
      "EntityOverrides": [],
      "DisableRPGLeveling": false
    },
    {
      "Id": "Yungs_HyDungeons_Skeleton_Dungeon",
      "LevelMin": 55,
      "LevelMax": 75,
      "EntityOverrides": [],
      "DisableRPGLeveling": true
    }
  ]
}
```

Here, the **Skeleton Dungeon** has the mod disabled; the **default** (main) world keeps the mod enabled.

### 4. Apply changes

Run **`/lvl reload`** (`rpgleveling.command.reload`) so the config is reloaded without restarting the server. If you prefer, you can restart the server instead.

***

## What Is Disabled in That World

When **`DisableRPGLeveling`** is **`true`** for an instance:

| Feature                         | Disabled in that world                     |
| ------------------------------- | ------------------------------------------ |
| **Level/XP HUD**                | Not shown; hidden while in that instance.  |
| **Nameplate level**             | No "Lvl. X" on players or mobs.            |
| **XP gain**                     | No XP from kills or block break.           |
| **Monster level scaling**       | No HP/damage scaling by level.             |
| **Player damage/defense stats** | No bonus from your allocated stats.        |
| **Mining/woodcutting bonus**    | No stat-based block damage bonus.          |
| **Stamina regen/consumption**   | No stat-based stamina effects.             |
| **Death reset**                 | Reset level on death does not apply there. |

Player **level and stats are not removed** - they are unchanged. Only the **effect** of the mod is off in that world; when the player leaves, everything works again.

***

## See Also

* [Instance Level Config](config-instances) - Full config reference and **`DisableRPGLeveling`** field
* [Configuration Overview](config-overview) - Reloading config with **`/lvl reload`**
* [Dungeon Mod Setup](dungeon-mod-setup) - Adding and configuring dungeon instances