diff --git a/src/main/java/world/bentobox/poseidon/Settings.java b/src/main/java/world/bentobox/poseidon/Settings.java
index 687ef5d..e696ac4 100644
--- a/src/main/java/world/bentobox/poseidon/Settings.java
+++ b/src/main/java/world/bentobox/poseidon/Settings.java
@@ -567,18 +567,24 @@ public class Settings implements WorldSettings {
 
     // Deaths
     @ConfigComment("Whether deaths are counted or not.")
+    @ConfigComment("If false, BentoBox does not count deaths and the Level addon does not record deaths against realms.")
     @ConfigEntry(path = "realm.deaths.counted")
     private boolean deathsCounted = true;
 
     @ConfigComment("Maximum number of deaths to count. The death count can be used by add-ons.")
+    @ConfigComment("Since Level 2.29.0 this also caps how many deaths each member can contribute to a realm's death penalty.")
     @ConfigEntry(path = "realm.deaths.max")
     private int deathsMax = 10;
 
-    @ConfigComment("When a player joins a team, reset their death count")
+    @ConfigComment("When a player joins a team, reset their death count.")
+    @ConfigComment("This only affects BentoBox's own per-player death count, used by the %poseidon_deaths% placeholder.")
+    @ConfigComment("Since Level 2.29.0, realm levels use per-realm death tracking and are not affected by this setting.")
     @ConfigEntry(path = "realm.deaths.team-join-reset")
     private boolean teamJoinDeathReset = true;
 
-    @ConfigComment("Reset player death count when they start a new realm or reset and realm")
+    @ConfigComment("Reset player death count when they start a new realm or reset a realm.")
+    @ConfigComment("This only affects BentoBox's own per-player death count.")
+    @ConfigComment("Since Level 2.29.0 the Level addon clears a realm's own death record automatically when it is reset or deleted.")
     @ConfigEntry(path = "realm.deaths.reset-on-new-realm")
     private boolean deathsResetOnNewIsland = true;
 
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index 0be2f28..022ef62 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -608,12 +608,18 @@ realm:
       require-confirmation: true
   deaths:
     # Whether deaths are counted or not.
+    # If false, BentoBox does not count deaths and the Level addon does not record deaths against realms.
     counted: true
     # Maximum number of deaths to count. The death count can be used by add-ons.
+    # Since Level 2.29.0 this also caps how many deaths each member can contribute to a realm's death penalty.
     max: 10
-    # When a player joins a team, reset their death count
+    # When a player joins a team, reset their death count.
+    # This only affects BentoBox's own per-player death count, used by the %poseidon_deaths% placeholder.
+    # Since Level 2.29.0, realm levels use per-realm death tracking and are not affected by this setting.
     team-join-reset: true
-    # Reset player death count when they start a new realm or reset and realm
+    # Reset player death count when they start a new realm or reset a realm.
+    # This only affects BentoBox's own per-player death count.
+    # Since Level 2.29.0 the Level addon clears a realm's own death record automatically when it is reset or deleted.
     reset-on-new-realm: true
   customranks: {}
 protection: