corpse_definition
Defines the model, name, rotation and lifetime of a corpse.
Several definitions can coexist. When a player dies, the definition with the highest priority
whose worlds filter accepts the death world wins — so a corpse in the nether can look different
from one in the overworld.
Fields
| Field | Type | Default | Description |
|---|---|---|---|
definitionRef | Ref<EntityDefinition> | empty | Entity definition used for the model. Empty = plain player model wearing the victim's skin. |
displayName | Var<String> | <red>☠ {player}'s corpse | Name shown above the corpse. {player} is the dead player's name. |
showDisplayName | Var<Bool> | true | Show the floating name above the corpse. |
verticalOffset | Var<Double> | 0.0 | Vertical offset from the death location, in blocks. |
rotationMode | Enum | RANDOM | RANDOM, FACE_KILLER or FACE_FORWARD. |
overrideDuration | Var<Int> | 0 | Seconds before corpses of this type expire. Overrides the global setting when above 0. |
playDeathAnimation | Var<Bool> | true | Play the model's death animation when the corpse appears. |
deathAnimationName | Var<String> | death | Animation to play on spawn. Only used by model backends that expose named animations. |
worlds | List<String> | empty | Worlds this definition applies to. Empty = every world. |
priority | Int | 0 | Highest priority wins when several definitions match. |
Supported model backends
definitionRef accepts an entity definition from any of:
| Backend | Tag |
|---|---|
| EntityExtension | entity_definition |
| ModelEngine | modelengine_definition |
| BetterModel | bettermodel_definition |
| BTC Mob NPC | btcmob_npc_definition |
| MythicMobs NPC | mythicmob_npc_definition |
Notes
- The corpse is rendered once per viewer, so every player nearby sees it, each with their own
copy of the model. Visibility uses the engine's
entity.show-rangesetting. - With no
definitionRef, the corpse is a plain player entity in the vanilla dying pose, wearing the dead player's skin and armour. - With a model backend,
deathAnimationNameis pushed as an animation instead of the vanilla pose. Backends that do not expose named animations ignore it.