diff --git a/src/main/java/world/bentobox/skygrid/Settings.java b/src/main/java/world/bentobox/skygrid/Settings.java
index 0649be2..2535f3b 100644
--- a/src/main/java/world/bentobox/skygrid/Settings.java
+++ b/src/main/java/world/bentobox/skygrid/Settings.java
@@ -412,18 +412,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 areas.")
     @ConfigEntry(path = "area.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 an area's death penalty.")
     @ConfigEntry(path = "area.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 %skygrid_deaths% placeholder.")
+    @ConfigComment("Since Level 2.29.0, area levels use per-area death tracking and are not affected by this setting.")
     @ConfigEntry(path = "area.deaths.team-join-reset")
     private boolean teamJoinDeathReset = true;
 
-    @ConfigComment("Reset player death count when they start reset")
+    @ConfigComment("Reset player death count when they start a new area or reset an area.")
+    @ConfigComment("This only affects BentoBox's own per-player death count.")
+    @ConfigComment("Since Level 2.29.0 the Level addon clears an area's own death record automatically when it is reset or deleted.")
     @ConfigEntry(path = "area.deaths.reset-on-new-island")
     private boolean deathsResetOnNewIsland = true;
 
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index 2ed0ead..27b27f6 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -1259,12 +1259,18 @@ area:
       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 areas.
     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 an area'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 %skygrid_deaths% placeholder.
+    # Since Level 2.29.0, area levels use per-area death tracking and are not affected by this setting.
     team-join-reset: true
-    # Reset player death count when they start reset
+    # Reset player death count when they start a new area or reset an area.
+    # This only affects BentoBox's own per-player death count.
+    # Since Level 2.29.0 the Level addon clears an area's own death record automatically when it is reset or deleted.
     reset-on-new-island: true
 protection:
   # Geo restrict mobs.