Death Lesson

Death Lesson is a quality-of-life Forge mod that turns player deaths into useful recap reports.

Instead of only showing the vanilla death message, Death Lesson explains what killed you, what damage led up to the death, which source contributed the most, and what could have helped you survive. It is designed for survival worlds, multiplayer servers, and modpacks where deaths can come from many different sources.

Learn from the death. Fix the mistake. Survive the next one.

What does it do?

When a player dies, Death Lesson creates a report based on recent server-side damage events. The report can show:

• The fatal damage source
• A timeline of recent damage before death
• The largest recent damage contributor
• Gear and armor worn at the time of death
• Main hand and offhand items
• Totem placement checks
• Status effects active at death
• Practical prevention tips
• Unknown and modded damage sources handled safely

For example, if lava dealt most of the damage but a skeleton landed the final hit, Death Lesson can explain that clearly instead of only showing the final death message.

Features

• Tracks recent player damage server-side
• Creates a death report when a player dies
• Shows the final hit and recent contributing damage
• Highlights when the biggest damage source was different from the fatal hit
• Provides practical prevention hints
• Includes a readable damage timeline
• Includes a gear snapshot at death
• Includes active status effects
• Supports unknown and modded damage sources defensively
• Sends a concise chat summary after death
• Adds a clickable [View Death Lesson] chat action
• Adds a Death Lesson button to the vanilla death screen when a report exists
• Includes a polished client-side report screen when installed on the client
• Works server-authoritatively in multiplayer

Prevention tips

Death Lesson gives conservative, practical suggestions based on what happened before death.

Depending on the situation, it may suggest things like:

• Fire Resistance for lava or fire deaths
• Feather Falling or Slow Falling for fall damage
• Shields or Projectile Protection for arrows and other projectiles
• Blast Protection or distance for explosions
• Water Breathing or Respiration for drowning
• Armor checks when important gear was missing or damaged
• Totem placement reminders
• Safer handling of magic, wither, poison, void, suffocation, and other damage types

The mod does not claim that a tip would have guaranteed survival. It is meant to help players understand likely prevention options.

Commands

Death Lesson includes simple player commands:

• /deathlesson last
  Shows your most recent detailed death report and opens the GUI when available.

• /deathlesson summary
  Shows a short recap of your most recent death.

• /deathlesson clear
  Clears your stored death report and recent damage cache.

• /deathlesson debug
  Shows raw technical report details for troubleshooting.

Config options

Death Lesson includes configurable options for tracking, display, and report detail.

Available options include:

• trackingWindowTicks
  How many recent server ticks of damage are tracked. Default: 400

• maxDamageEvents
  Maximum stored damage events per player. Default: 12

• enableChatSummary
  Enables the post-death chat summary.

• enableDeathScreenButton
  Enables the Death Lesson button on the death screen.

• enableDetailedTimeline
  Enables detailed damage timeline entries.

• enableDebugDetails
  Enables raw technical details.

• enableDeathLessonScreen
  Enables the custom report screen.

• enableClientScreen
  Allows the client GUI to open.

• showCoordinatesInReport
  Shows positions in timeline entries.

• compactMode
  Uses tighter GUI spacing.

• useColorEmphasis
  Enables color accents.

• maxTimelineEntriesShown
  Caps displayed timeline rows.

Damage types handled

Death Lesson can recognize and report many common damage categories, including:

• Lava
• Fire
• Fall damage
• Projectiles
• Explosions
• Magic
• Wither
• Poison
• Drowning
• Starvation
• Suffocation
• Freezing
• Void damage
• Contact damage
• Anvils
• Falling blocks
• Mob attacks
• Player attacks
• Unknown or modded damage sources

Unknown damage sources are reported cautiously instead of crashing the mod.

Multiplayer behavior

Death Lesson is server-authoritative.

The server tracks player damage and creates the death report. Each report is only sent to the player who died.

Recommended installation:

• Singleplayer: install on the client
• Dedicated server: install on the server
• Best multiplayer experience: install on both server and clients
• Server-only: chat summaries and commands work, but the client GUI is not available
• Client-only on a server without the mod: reports are not generated

Known limitations

Death Lesson is designed to be educational, not a perfect combat simulator.

Known limitations:

• It does not perform exact survival math.
• Prevention tips are suggestions, not guarantees.
• Modded armor, accessories, and damage systems may affect outcomes in ways the mod cannot fully inspect.
• Extra equipment APIs such as Curios, Trinkets, or Baubles are not directly inspected.
• Unknown modded damage is handled cautiously and may have less specific advice.

Version info

• Minecraft: 1.20.1
• Loader: Forge
• Forge target: 47+
• Mod version: 1.0.0
• Mod ID: deathlesson
• License: All Rights Reserved
• Creator: Iljas

Death Lesson

Death Lesson turns player deaths into useful learning reports.

Instead of only seeing the vanilla death message, you get a practical recap showing what killed you, what damage led up to the death, what contributed the most, and what could help you avoid the same mistake next time.

It is built for Forge 1.20.1 and is especially useful in survival worlds, multiplayer servers, and modpacks with lots of different damage sources.

Features

• Server-side tracking of recent player damage
• Death reports generated when a player dies
• Fatal damage source detection
• Recent damage timeline
• Largest damage contributor detection
• Gear snapshot at death
• Active status effect snapshot
• Totem placement checks
• Practical prevention hints
• Chat summary after death
• Clickable [View Death Lesson] chat action
• Death Lesson button on the vanilla death screen when a report exists
• Polished client-side report GUI when installed on the client
• Defensive support for unknown and modded damage sources

Why use it?

Minecraft death messages only tell part of the story.

Sometimes the final hit is not the real reason you died. Lava may have done most of the damage, but a skeleton might land the last arrow. A fall might kill you because your boots were missing Feather Falling. A totem might have saved you, but only if it had been in your hand or offhand.

Death Lesson helps explain those details in a readable way.

What the report can show

A Death Lesson report may include:

• What killed you
• What damaged you recently
• Whether the final hit was different from the biggest damage source
• A timeline of damage events
• Armor and held items at death
• Active status effects
• Totem state
• Practical survival tips
• Technical details through /deathlesson debug

The goal is not to blame the player. The goal is to make the next attempt easier.

Prevention hints

Death Lesson gives practical suggestions based on the damage you took.

Examples include:

• Fire Resistance for lava or fire deaths
• Feather Falling or Slow Falling for fall damage
• Shields or Projectile Protection for projectiles
• Blast Protection or safer distance for explosions
• Water Breathing or Respiration for drowning
• Armor checks when important gear was missing or damaged
• Totem placement reminders
• Cautious advice for magic, wither, poison, void, suffocation, freezing, and modded damage

Suggestions are conservative. The mod does not promise that a tip would have guaranteed survival.

Commands

• /deathlesson last
  Shows your most recent detailed report and opens the GUI when available.

• /deathlesson summary
  Shows a short recap of your most recent death.

• /deathlesson clear
  Clears your stored report and recent damage cache.

• /deathlesson debug
  Shows raw technical report details.

Config

Death Lesson includes configurable tracking and display options:

• trackingWindowTicks — recent damage tracking window. Default: 400
• maxDamageEvents — max stored damage events per player. Default: 12
• enableChatSummary — enables post-death chat summaries
• enableDeathScreenButton — enables the Death Lesson button on the death screen
• enableDetailedTimeline — enables detailed timeline entries
• enableDebugDetails — enables raw technical details
• enableDeathLessonScreen — enables the custom report screen
• enableClientScreen — allows the client GUI to open
• showCoordinatesInReport — shows positions in timeline entries
• compactMode — uses tighter GUI spacing
• useColorEmphasis — enables color accents
• maxTimelineEntriesShown — caps displayed timeline rows

Multiplayer

Death Lesson is server-authoritative.

The server tracks damage and creates reports. Each report is only sent to the player who died.

Recommended setup:

• Singleplayer: install on the client
• Dedicated server: install on the server
• Best multiplayer setup: install on both server and clients
• Server-only: chat reports and commands work, but the GUI is unavailable
• Client-only on a server without the mod: reports are not generated

Damage types

Death Lesson handles common vanilla damage categories, including:

• Lava
• Fire
• Fall damage
• Projectiles
• Explosions
• Magic
• Wither
• Poison
• Drowning
• Starvation
• Suffocation
• Freezing
• Void damage
• Contact damage
• Anvils
• Falling blocks
• Mob attacks
• Player attacks
• Unknown or modded damage sources

Unknown and modded sources are handled defensively so the report can still be generated safely.

Known limitations

• Death Lesson does not perform exact survival math.
• Prevention tips are educational suggestions, not guarantees.
• Some modded armor, accessories, and damage systems may not expose enough information for perfect analysis.
• Extra equipment APIs such as Curios, Trinkets, or Baubles are not directly inspected.
• Unknown modded damage may produce less specific advice.

Version

• Minecraft: 1.20.1
• Loader: Forge
• Forge: 47+
• Mod version: 1.0.0
• Mod ID: deathlesson
• License: MIT
• Creator: Iljas