diff --git a/src/main/java/world/bentobox/caveblock/Settings.java b/src/main/java/world/bentobox/caveblock/Settings.java
index 6dd6abd..ca7f7a2 100644
--- a/src/main/java/world/bentobox/caveblock/Settings.java
+++ b/src/main/java/world/bentobox/caveblock/Settings.java
@@ -533,18 +533,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 caves.")
     @ConfigEntry(path = "cave.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 cave's death penalty.")
     @ConfigEntry(path = "cave.deaths.max")
     private int deathsMax = 10;
 
-    @ConfigComment("Reset player death count when they start a new cave or reset a cave")
+    @ConfigComment("Reset player death count when they start a new cave or reset a cave.")
+    @ConfigComment("This only affects BentoBox's own per-player death count.")
+    @ConfigComment("Since Level 2.29.0 the Level addon clears a cave's own death record automatically when it is reset or deleted.")
     @ConfigEntry(path = "cave.deaths.reset-on-new")
     private boolean deathsResetOnNewIsland = true;
 
-    @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 %caveblock_deaths% placeholder.")
+    @ConfigComment("Since Level 2.29.0, cave levels use per-cave death tracking and are not affected by this setting.")
     @ConfigEntry(path = "cave.deaths.team-join-reset")
     private boolean teamJoinDeathReset = true;
 
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index 041bd39..b53a161 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -405,12 +405,18 @@ cave:
       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 caves.
     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 cave's death penalty.
     max: 10
-    # Reset player death count when they start a new cave or reset a cave
+    # Reset player death count when they start a new cave or reset a cave.
+    # This only affects BentoBox's own per-player death count.
+    # Since Level 2.29.0 the Level addon clears a cave's own death record automatically when it is reset or deleted.
     reset-on-new: true
-    # 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 %caveblock_deaths% placeholder.
+    # Since Level 2.29.0, cave levels use per-cave death tracking and are not affected by this setting.
     team-join-reset: true
 protection:
   # Geo restrict mobs.