Skip to main content

Corpse Extension

Spawns a player corpse at death location with the player’s skin and full inventory.

The Corpse Extension creates a visible corpse at the death location of any player. The corpse displays the player’s skin, stores their inventory and experience, and can be looted by right-clicking. It supports multiple entity backends for the visual model, including EntityExtension, ModelEngine, BetterModel, BTC Mob NPC, and MythicMobs NPC.

Multi-Backend Models

Use any entity definition from 5 supported backends as the corpse visual model.

Skin Reflection

Automatically applies the dead player’s skin to the corpse entity.

Key Features

  • Death Corpse Spawn: Automatically spawns a corpse at death location with the player’s skin.
  • Inventory Storage: Saves the player’s full inventory (main, armor, offhand) in the corpse.
  • Right-Click Loot: Right-click the corpse to drop all items and experience at its location.
  • GUI Preview: Sneak + right-click to open a preview GUI (configurable).
  • Configurable Duration: Corpses expire after a configurable time (default: 300 seconds).
  • PvP Protection: Optional owner-only looting (onlyOwnerCanLoot).
  • Death Effects: Blood particles, soul particles, and death sounds on spawn.
  • Red Glow Effect: Subtle red dust particles around the corpse.
  • Respawn Notification: Notifies the dead player of their corpse location on respawn.
  • Trigger System: Execute actions at ON_SPAWN, ON_LOOT, and ON_EXPIRE events.
  • Entity Definition Dropdown: Select any registered entity definition in the Tapwriter editor.

Dependencies

ExtensionUsage
EntityExtensionMandatory. Provides the fallback PLAYER entity.
BasicExtensionMandatory. Core extension dependency.
ModelEngineExtensionOptional. Blockbench 3D models via ModelEngine.
BetterModelExtensionOptional. Blockbench 3D models via BetterModel.
BTCMobNPCExtensionOptional. BTC Mob NPC entity definitions.
MythicMobsNPCExtensionOptional. MythicMobs NPC entity definitions.
GUIExtensionOptional. Advanced GUI integration for inventory preview.

Configuration

The extension has three entry types:
EntryTypeDescription
corpse_settingsManifestGlobal settings (duration, particles, loot behavior).
corpse_definitionManifestPer-corpse model definition and display options.
corpse_actionActionEvents triggered during corpse lifecycle.

Quick Start

  1. Install the extension JAR in your server’s extensions/ directory.
  2. Reload Typewriter with /tw reload TypeWriter-CorpseExtension.
  3. Kill a player — a corpse appears with their skin and inventory.
  4. Right-click the corpse to loot it.
  5. Optionally: create a corpse_definition entry to use a custom 3D model.
  6. Optionally: create corpse_action entries to trigger actions on spawn/loot/expire.

Entry Reference

See the detailed entry pages for each entry type: