MythicRPG's Death Control system replaces vanilla death handling with three configurable layers:

• Drop Rules — pick which inventory slots drop on death and override that decision per-item with KeepFilters and DropFilters.
• Experience Loss Rules — control how much archetype XP and vanilla XP a player loses on death, with separate floors for each.
• Graveyards — define respawn points and pick the best one for each death (priority + closest match).

All three are independent. You can use one without the others — for example, drop nothing on death but still send the player to a graveyard.

Where to configure

DropRules and ExperienceLoss live in config-rpg.yml under Configuration.Profiles.DeathControl. Graveyards live in pack files at <pack>/graveyards/*.yml and are managed at runtime with the graveyards command.

Configuration:
  Profiles:
    DeathControl:
      DropRules:
        Default:
          DropArmor: true
          DropHotbar: true
          DropMainInventory: true
          DropOffhand: true
          KeepFilters: []
          DropFilters: []
      ExperienceLoss:
        Default:
          RPGPercent: 0
          RPGFlat: 0
          RPGLevelFloor: 0
          VanillaPercent: 1.0
          VanillaFlat: 0
          VanillaLevelFloor: 0
          DropVanillaXp: true

The Default block under either section is the fallback for every player. You can add named override blocks alongside Default — when the player dies, the highest-priority override whose Conditions: match is selected; if no override matches, Default applies.

Drop Rules

Each rule decides which slots drop on death, then lets you override that per-item.

DropRules:
  Default:
    DropArmor: true
    DropHotbar: true
    DropMainInventory: true
    DropOffhand: true
    KeepFilters: []
    DropFilters: []
    Priority: 0
    Conditions: []
  Hardcore:
    DropArmor: true
    DropHotbar: true
    DropMainInventory: true
    DropOffhand: true
    KeepFilters:
    - 'MythicItem: SOULBOUND_*'      # never drop soulbound items
    DropFilters:
    - 'NbtTag: cursed'               # always drop "cursed" items, even from kept slots
    Priority: 10
    Conditions:
    - archetype{group=class;type=hardcore}

Per-item resolution order

For each item in the player's inventory:

1. If a KeepFilter matches → kept (returned on respawn).
2. Else if a DropFilter matches → dropped.
3. Else the slot's drop toggle decides.

KeepFilter always beats DropFilter on the same item — write filters knowing that "keep" is the conservative answer.

Filter Syntax

Filters are written as a single line of the form Type: comma,separated,values. Three filter types are supported:

A malformed filter line is logged and skipped — it does not break the rest of the rule.

Trigger

When a drop rule applies, MythicRPG fires the ~onDeathDropsFiltered trigger on the dying profile. Variables: keptItems, forcedItems, and drop-rule (the rule id that matched).

Experience Loss Rules

Each rule controls archetype XP loss, vanilla XP loss, and whether vanilla XP orbs spawn.

ExperienceLoss:
  Default:
    RPGPercent: 0.10            # lose 10% of banked archetype xp
    RPGFlat: 0
    RPGLevelFloor: 1            # never go below archetype level 1
    VanillaPercent: 0.5         # lose half of vanilla level
    VanillaFlat: 0
    VanillaLevelFloor: 0
    DropVanillaXp: false        # don't spawn xp orbs
    Priority: 0
    Conditions: []

If VanillaPercent: 0 AND VanillaFlat: 0, the player keeps all vanilla XP (and no orbs spawn regardless of DropVanillaXp). If both RPGPercent: 0 AND RPGFlat: 0, archetype XP is preserved.

Trigger

When an XP-loss rule applies, MythicRPG fires the ~onExperienceLost trigger. Variables: rpgLost, vanillaLevelLost, and xp-rule (the rule id that matched).

Graveyards

A graveyard is a respawn point with optional conditions. When a player dies, MythicRPG picks one based on:

1. Filter to graveyards in the same world as the death location whose target world is loaded.
2. Filter by the rule's Conditions: matching the dying profile.
3. Sort by Priority (highest first), then by distance to the death location (closest first).
4. The first match wins. If no graveyard matches, vanilla respawn behavior is used.

Graveyards are stored in pack files; the simplest workflow is to use the in-game commands.

Graveyard YAML format

SpawnTown:
  World: world
  X: 100.5
  Y: 64.0
  Z: -200.5
  Yaw: 90.0
  Pitch: 0.0
  Priority: 0
  Conditions: []
DesertOutpost:
  World: world
  X: 1500.5
  Y: 70.0
  Z: 800.5
  Priority: 10
  Conditions:
  - archetype{group=race;type=desertfolk}

Graveyard Commands

Aliases: graveyard, gy (e.g. /mythicrpg gy list world).

All four require the mythicrpg.command.admin permission.

Trigger

When a player respawns at a graveyard, MythicRPG fires the ~onRespawnAtGraveyard trigger with the variable graveyard set to the matched graveyard id.