SCorpse

SCorpse

SCorpse is a lightweight and secure corpse system for Minecraft Fabric servers.

When a player dies, their inventory is safely stored inside a persistent corpse instead of being dropped on the ground. SCorpse also provides corpse tracking, temporary owner protection, optional Trinkets support, recovery tools, and automatic multilingual support.

Requirements

Requirement	Version
Minecraft	1.20.1 & 1.21.1
Mod Loader	Fabric
Fabric Loader	0.18.4 or newer
Fabric API	Required
Java	Java 17/21
Installation	Client and Server

SCorpse must be installed on both the Minecraft client and the server.

The same mod JAR is used on both sides.

Main Features

• Persistent corpses after player death
• Safe inventory storage
• Player corpse visual
• Corpse Compass after respawning
• Death coordinates in chat
• Distance indicator on the HUD
• Temporary corpse highlighting
• Owner-only protection period
• Automatic corpse cleanup
• Optional Trinkets and Artifacts support
• Persistent server-side storage
• Automatic language detection
• Multiplayer support

Corpse System

When a player dies with keepInventory disabled, SCorpse creates a corpse at the death location.

The player's inventory is stored before the original inventory is cleared, helping prevent item loss.

Corpse items are stored using persistent server data instead of depending entirely on the visual corpse entity.

This means the visual corpse can be reconstructed when its chunk is loaded again.

Corpse Inventory

Interact with a corpse to open its inventory.

The corpse uses a large container interface for recovering the player's items.

When optional Trinkets-compatible mods are installed, additional equipment can be stored separately under:

Artifacts & Extras

Players can switch between the normal inventory and the additional equipment page directly from the corpse interface.

Corpse Compass

After respawning, the player receives a Corpse Compass linked specifically to the corpse created by their most recent death.

The compass:

• Points toward the corpse
• Stores the corpse coordinates
• Displays the target position in its lore
• Shows the distance to the corpse on the HUD
• Can be dropped and stored normally
• Remains linked to its original corpse

Right-clicking with the Corpse Compass temporarily highlights the corresponding corpse, making it easier to locate.

If the corpse no longer exists, the associated compass becomes invalid and is automatically removed when used.

Death Location

When a corpse is created, SCorpse sends the death coordinates directly to the player.

Example:

You died. Your corpse is at: -1024 72 1380

Server operators can also use the coordinates as a quick reference.

Corpse Privacy

New corpses are temporarily protected from other players.

For the first 25 minutes, only the owner can access the corpse.

If another player attempts to open it during this period, SCorpse displays the remaining protection time.

After the protection period expires, other players may access the corpse.

The owner can always access their own corpse.

Persistent Item Protection

SCorpse stores corpse inventories independently from the visual entity.

The visual corpse is also protected against normal damage and common entity removal methods.

If the visual entity disappears while the stored corpse still exists, SCorpse can recreate it when the corresponding chunk becomes available again.

Automatic Cleanup

A corpse remains available while it still contains items.

After every inventory page becomes completely empty, the corpse starts a short cleanup timer.

The empty corpse is automatically removed after approximately 15 seconds.

This prevents empty corpses from permanently accumulating around the world.

Trinkets Compatibility

SCorpse includes optional integration with Trinkets.

When Trinkets is installed, compatible equipped items are captured during death and stored with the corpse.

They can be accessed through the separate:

Artifacts & Extras

page.

Trinkets is optional and is not required for SCorpse to work.

keepInventory Compatibility

SCorpse respects Minecraft's keepInventory gamerule.

When:

keepInventory = true

SCorpse does not create a corpse and does not modify the player's inventory.

When:

keepInventory = false

the normal SCorpse death system is used.

Automatic Language Detection

SCorpse automatically uses the language selected by each player in Minecraft.

There is no separate language setting inside the mod.

Currently included languages:

Language	Minecraft Code
English	en_us
Portuguese, Brazil	pt_br
Spanish	es_es
Japanese	ja_jp
Simplified Chinese	zh_cn
Hindi	hi_in
Arabic	ar_sa

Different players connected to the same server can use different languages at the same time.

Server-Side Safety

Important corpse operations are handled and validated by the server.

The client interface does not directly control corpse data.

Stored information includes:

• Corpse owner
• Corpse location
• Creation time
• Main inventory
• Additional equipment
• Privacy timer
• Corpse Compass association
• Corpse visual state

This information persists across normal server restarts.

Installation

Client

1. Install Minecraft 1.21.1.
2. Install Fabric Loader.
3. Install Fabric API.
4. Place SCorpse-1.0.0.jar inside the mods folder.
5. Start Minecraft.

Server

1. Install a Fabric 1.21.1 server.
2. Install Fabric API.
3. Place the same SCorpse-1.0.0.jar inside the server mods folder.
4. Start the server.

SCorpse is designed to use the same mod JAR on both client and server.

Project Information

Mod: SCorpse

Version: 1.0.0

Author: Silas T.

Minecraft: 1.20.1 / 1.21.1

Loader: Fabric

Java: 17/21

License: All Rights Reserved