corpse_definition

Defines the visual model and display options for corpses. You can create multiple definitions for different contexts (e.g., a custom 3D model for boss kills, a different model for PvP deaths).

Fields

Field	Type	Default	Description
definitionRef	Ref<EntityDefinition>	—	Entity definition to use for the corpse model. Empty = default player model.
displayName	String	<red>☠ {player}'s corpse	Display name above the corpse. Use {player} for the dead player's name.
verticalOffset	Double	0.0	Vertical offset from the death location (in blocks).
rotationMode	Enum	RANDOM	How the corpse should be rotated: RANDOM, FACE_KILLER, FACE_FORWARD.
showDisplayName	Bool	true	Whether to show a floating name above the corpse.
overrideDuration	Int	0	Duration override for this corpse type. 0 = use global setting.
playDeathAnimation	Bool	true	Play a death animation on spawn (if the model supports it).
deathAnimationName	String	death	Animation name to play on spawn.

Entity Definition Dropdown

The definitionRef field shows a dropdown selector in the Tapwriter editor, filtered to show only entity definitions from these backends:

• entity_definition — EntityExtension (player NPC, zombies, etc.)
• modelengine_definition — ModelEngine (Blockbench 3D models)
• bettermodel_definition — BetterModel (Blockbench 3D models)
• btcmob_npc_definition — BTC Mob NPC
• mythicmob_npc_definition — MythicMobs NPC

When a definition uses a model that supports player skins (e.g., Blockbench models with skin texture), the dead player's skin is automatically applied.

Notes

• If no corpse_definition entry exists, a default PLAYER entity is used.
• The first corpse_definition entry found by Query.find<>() is used.
• This is a Manifest entry.