c

Author: LostPizzaMan

…nt/docs/en/guides/plugin/death-event.mdx …/en/guides/plugin/player-death-event.mdxcontent/docs/en/guides/plugin/death-event.mdx renamed to content/docs/en/guides/plugin/player-death-event.mdx content/docs/en/guides/plugin/death-event.mdx renamed to content/docs/en/guides/plugin/player-death-event.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Death Event"
+title: "Player Death Event"
 description: "Learn how to use the OnDeathSystem."
 authors:
     - name: "Bird"
@@ -56,6 +56,8 @@ public class TestDeathSystem extends DeathSystems.OnDeathSystem {
 
 ### 1. Extend the Death System
 
+Start by creating a new class that extends `DeathSystems.OnDeathSystem`. This allows your system to automatically react whenever an entity dies.
+
 ```java
 public class TestDeathSystem extends DeathSystems.OnDeathSystem {
 ```
@@ -64,6 +66,8 @@ public class TestDeathSystem extends DeathSystems.OnDeathSystem {
 
 ### 2. Define Which Entities This System Applies To
 
+Override the `getQuery()` method to filter for the entities you want. In this case, we only want **players**:
+
 ```java
 @Nonnull
 @Override
@@ -72,42 +76,54 @@ public Query<EntityStore> getQuery() {
 }
 ```
 
-* Filter entities to **players only**
+<Callout>
+`Query.and(...)` allows you to combine multiple filters if needed.
+</Callout>
 
 ---
 
 ### 3. Listen for the Death Event
 
+The `onComponentAdded` method is called automatically whenever a `DeathComponent` is added to an entity matching your query.
+
 ```java
 @Override
 public void onComponentAdded(
         @Nonnull Ref ref,
         @Nonnull DeathComponent component,
         @Nonnull Store store,
         @Nonnull CommandBuffer commandBuffer
-) {
+)
 ```
 
-This method is automatically called when:
-
-* A `DeathComponent` is added to an entity matching your query (players)
-
 ---
 
 ### 4. Get the Player Component
 
+Use the `Store` to retrieve the `Player` component from the entity that just died:
+
 ```java
 Player playerComponent = (Player) store.getComponent(ref, Player.getComponentType());
 ```
 
-* Fetches the `Player` component from the dead entity
+This lets you access information such as the player's display name.
 
 ---
 
 ### 5. Get Death Damage Information
 
+The `DeathComponent` contains information about the damage that killed the player:
+
 ```java
 Damage deathInfo = component.getDeathInfo();
 ```
 
-* Lets you access death info such as amount and source
+You can then check:
+
+```java
+if (deathInfo != null) {
+    Universe.get().sendMessage(Message.raw("Damage amount: " + deathInfo.getAmount()));
+}
+```
+
+This provides the **amount of damage** and the **source of the death**.