Death Control

Death is a Forge mod for Minecraft 1.20.1 that lets you fully control death, respawn, and elimination mechanics for events, minigames, and custom server formats.
It includes four modes (normal, president, battleroyal, military) plus admin commands for timers, hearts, teams, and mode-specific behavior.

Main Features

• Multiple death systems switchable per world
• Configurable death timers (base, multiplier, optional max cap)
• Global and per-player hearts configuration
• President mode with president lives, target list, and respawn point selection
• Battleroyal team-lives system with per-team overrides
• Military mode with knockout, revive, final death phase, team respawns, and Simple Voice Chat mic blocking while down/dead

Command Reference

All commands (except /afk and /stats) require OP level 2.
════════════════════════════════════════════════════════════════

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GENERAL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/death start
Starts the game in the currently configured mode. Resets statistics, sets all players to Survival, and displays the start screen. In Battle Royale mode, also starts the world border if configured.

/death stop
Ends the active round. Sets all players to Creative, stops all running timers, and unlocks /stats for everyone.

/death mode <normal|president|battleroyal|military|siege>
Switches the active game mode. Takes effect on the next /death start.

/death pause
Pauses the game: saves all player positions and sets them to Creative.

/death resume
Resumes the game: teleports all players back to their saved positions and sets them to Survival.

/death time <seconds>
Sets the base death time in seconds (no multiplier).

/death time <seconds> <multiplier>
Death time with multiplier — increases exponentially per death.
Example: 60 1.5 → 60s, 90s, 135s, ...

/death time <seconds> <multiplier> <maximum>
Same as above, but with an upper limit in seconds.

/death hearts <amount>
Sets the maximum number of hearts globally for all players.

/death hearts <amount> <player>
Sets the maximum number of hearts individually for a specific player.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
STATISTICS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/stats
Opens the statistics book for the executing player. Only available after /death stop or after a natural game end.
(No OP required)

/death stats reset
Resets all statistics and locks /stats again.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PRESIDENT MODE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/death president point <x y z>
Sets the location where normal players are teleported after death.

/death president set <player>
Assigns the president.

/death president set none
Removes the current president.

/death president count <amount>
Sets the number of lives the president has.

/death president list add <player>
Adds a player to the president list (potential victims when the president dies).

/death president list remove <player>
Removes a player from the president list.

/death president list list
Displays all players in the president list.

/death president respawn <p1> <p2> <p3> <p4> <p5>
Sets 5 respawn points for the president. After death, a GUI opens for selection (15 seconds, otherwise random).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BATTLE ROYALE MODE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/death battleroyal standardcount <amount>
Sets the default number of lives for all teams.

/death battleroyal teamcounter set <team> <lives>
Sets the lives of a specific team to a fixed value.

/death battleroyal teamcounter add <team> <amount>
Adds additional lives to a team.

/death battleroyal teamcounter remove <team> <amount>
Removes lives from a team.

/death battleroyal teamcounter list
Displays the current lives of all teams.

/death battleroyal border <start> <end> <seconds>
Configures the world border: shrinks from <start> to <end> over <seconds> seconds on the next /death start. Does not start immediately.

/death battleroyal border off
Stops the active world border movement. The border remains at its current size.

/death battleroyal start
Starts Battle Royale mode directly (alternative to /death start).

/death battleroyal stop
Stops Battle Royale mode directly (alternative to /death stop).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MILITARY MODE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/death military deathtime <seconds>
Sets how long a downed (KO) player can wait for rescue before dying permanently.

/death military revivetime <seconds>
Sets how long a teammate must stay nearby to revive a downed player.

/death military deathpoint <x y z>
Sets the location where permanently dead players are teleported (spectator position during the death timer).

/death military respawn <team> <x y z>
Sets the respawn point for a specific team.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SIEGE MODE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/death siege attackerlives <amount>
Sets the shared life pool of the attackers.

/death siege point <x y z>
Sets the capture point. This is also where the particle beam and capture circle appear.

/death siege attacker <team>
Defines the attacker team.

/death siege defender <team>
Defines the defender team.

/death siege radius <blocks>
Sets the radius of the capture zone in blocks.

/death siege capturetime <seconds>
Sets how long attackers must stay in the zone uninterrupted (without defenders) to win.

/death siege attackerrespawn <x y z>
Sets the respawn point for the attacker team.

/death siege defenderrespawn <x y z>
Sets the respawn point for the defender team.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OTHER COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/afk
Toggles AFK mode for the executing player. Saves inventory and position, switches to Adventure mode, and prevents damage.
When disabled: teleports to a teammate or grants short invulnerability.
(No OP required)

Normal Mode Flow

Players die and respawn using default Minecraft behavior.
No custom elimination or revive logic is applied in this mode.

President Mode Flow

One player is assigned as President with a separate life counter.
When the President dies, they lose a life and can choose from configured respawn points.
When a non-president player dies, custom death timing is applied, and penalties can affect players from the president list depending on setup.

Battleroyal Mode Flow

Teams play with shared/managed life counters.
As long as teammates are alive, dead players can return through the mode’s respawn/spectator flow.
If a team is fully wiped, the team life count is reduced; once lives reach zero, that team is permanently out.
The last team with remaining lives wins the round.

Military Mode Flow

When a player dies, they enter a knockout state at their death location (immobilized, facing still free).
A teammate within 2 blocks can revive them after the configured revive time.
If revived, they stand up at the same spot with 1.5 hearts and 3 seconds invulnerability.
If knockout time expires, they transition to final death, are moved to the configured deathpoint in spectator, and then follow normal /death time final respawn countdown.
After full respawn, they spawn at their team military respawn point (fallback near 0/0 when no team point exists).

Siege Mode Flow

Two teams are defined: attackers and defenders, with attackers having a shared life pool.
Attackers respawn at their configured spawn point as long as their team has remaining lives.
Each attacker death reduces the shared life pool; once it reaches zero, attackers can no longer respawn.

Defenders have unlimited respawns and continuously return to their designated spawn point after death.

The objective is centered around a defined capture point with a configurable radius.
Attackers must stay inside the capture zone without any defenders present for the full capture time.

If at any moment a defender enters the zone, the capture progress is interrupted or reset (depending on implementation). 

Attackers win if they successfully complete the capture within their available lives.
Defenders win if they prevent the capture until the attackers run out of lives.