Overview#
Corpse Complex is a highly versatile utility mod designed to overhaul the default Minecraft death mechanics. Unlike the vanilla 'Keep Inventory' gamerule, which is a binary toggle, Corpse Complex allows for granular control over what happens when a player dies.
The mod is primarily configuration-driven, providing a suite of options to balance difficulty and player progression. It is particularly useful for modpack creators who want to penalize death without the total loss of items, or for those who wish to implement RPG-like mechanics such as respawn debuffs or hunger persistence.
Mechanics#
The core of Corpse Complex lies in its modification of the death event. It intercepts the standard death process to apply custom logic based on the configuration file.
Inventory Management
The mod can be configured to preserve specific parts of a player's inventory while dropping others. This allows for a 'partial keep inventory' system. For example, a player might keep their armor and hotbar but drop the contents of their main inventory.
Experience Control
Vanilla Minecraft typically drops a small fraction of a player's total experience upon death, capping the drop at a low level. Corpse Complex allows for:
- Experience Retention: Keeping a percentage of total XP.
- Experience Loss: Setting a specific percentage of XP to be destroyed.
- Drop Customization: Adjusting how much XP is dropped as orbs for retrieval.
Hunger and Saturation
In vanilla, players respawn with full hunger. Corpse Complex can change this to:
- Persistent Hunger: Respawning with the same hunger level the player had at the moment of death.
- Minimum Hunger: Ensuring players respawn with at least a certain amount of hunger to prevent 'death-looping' for food.
- Saturation Control: Managing the saturation levels independently of hunger.
Respawn Effects
To simulate 'death sickness' or provide a grace period, the mod can apply potion effects to players immediately upon respawning. These are fully customizable in terms of duration and amplifier.
Configuration#
The configuration is divided into several categories. Below is a breakdown of the primary settings available in the configuration file.
Inventory Settings
| Option | Description |
|---|---|
keepInventory |
If true, the mod will handle inventory retention based on sub-settings. |
keepArmor |
Whether armor remains equipped upon death. |
keepHotbar |
Whether items in the hotbar are preserved. |
keepMainhand |
Whether the item held in the main hand is preserved. |
keepOffhand |
Whether the item held in the offhand is preserved. |
keepMainInventory |
Whether the main inventory slots (excluding hotbar) are preserved. |
limitToSoulbound |
If true, only items with the Soulbound enchantment are kept. |
Experience Settings
| Option | Description |
|---|---|
keepExperience |
If true, players will retain their experience levels. |
experienceLossRate |
The percentage of experience lost upon death (0.0 to 1.0). |
experienceDropRate |
The percentage of experience dropped as orbs (0.0 to 1.0). |
experienceMaxDrop |
The maximum amount of experience that can be dropped as orbs. |
Hunger Settings
| Option | Description |
|---|---|
respawnHunger |
The hunger value a player has after respawning (0-20). |
respawnSaturation |
The saturation value a player has after respawning. |
keepHunger |
If true, the player respawns with the hunger they had when they died. |
minRespawnHunger |
The minimum hunger level a player can respawn with. |
Effects Settings
| Option | Description |
|---|---|
respawnPotionEffects |
A list of potion effects applied on respawn (e.g., minecraft:weakness;600;0). |
Enchantments#
Corpse Complex includes a built-in enchantment to assist with item retention.
Soulbound
- Max Level: I
- Description: Items enchanted with Soulbound will remain in the player's inventory after death, regardless of other global inventory settings.
- Application: Can be applied to tools, weapons, armor, and other holdable items via an Anvil or Enchanting Table (if enabled in config).
- Consumable: The mod can be configured so that the Soulbound enchantment is removed or its level is reduced after it saves an item once.
Compatibility#
Corpse Complex is designed with modded environments in mind and includes native support for several popular inventory-expanding mods. This ensures that items stored in special slots are handled according to the mod's death rules.
Supported modded slots include:
- Curios API: All items in Curio slots (rings, necklaces, belts, etc.) can be configured to be kept or dropped.
- Baubles: Support for legacy versions using the Baubles mod.
- Cosmetic Armor Reworked: Options to keep or drop cosmetic armor sets.
- Trinkets: Support for the Trinkets API on compatible loaders.
Commands#
The mod provides administrative commands to manage settings in-game without requiring a server restart.
/corpsecomplex reload: Reloads the configuration file from the disk. This is useful for testing changes to death penalties immediately./corpsecomplex version: Displays the current version of the mod installed on the client and server.
