diff --git a/src/main/java/world/bentobox/bskyblock/Settings.java b/src/main/java/world/bentobox/bskyblock/Settings.java
index 2f7342e..6d65181 100644
--- a/src/main/java/world/bentobox/bskyblock/Settings.java
+++ b/src/main/java/world/bentobox/bskyblock/Settings.java
@@ -475,18 +475,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 islands.")
     @ConfigEntry(path = "island.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 island's death penalty.")
     @ConfigEntry(path = "island.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 %bskyblock_deaths% placeholder.")
+    @ConfigComment("Since Level 2.29.0, island levels use per-island death tracking and are not affected by this setting.")
     @ConfigEntry(path = "island.deaths.team-join-reset")
     private boolean teamJoinDeathReset = true;
 
-    @ConfigComment("Reset player death count when they start a new island or reset an island")
+    @ConfigComment("Reset player death count when they start a new island or reset an island.")
+    @ConfigComment("This only affects BentoBox's own per-player death count.")
+    @ConfigComment("Since Level 2.29.0 the Level addon clears an island's own death record automatically when it is reset or deleted.")
     @ConfigEntry(path = "island.deaths.reset-on-new-island", since = "1.6.0")
     private boolean deathsResetOnNewIsland = true;
 
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index ae156f1..df820e2 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -485,12 +485,18 @@ island:
       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 islands.
     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 island'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 %bskyblock_deaths% placeholder.
+    # Since Level 2.29.0, island levels use per-island death tracking and are not affected by this setting.
     team-join-reset: true
-    # Reset player death count when they start a new island or reset an island
+    # Reset player death count when they start a new island or reset an island.
+    # This only affects BentoBox's own per-player death count.
+    # Since Level 2.29.0 the Level addon clears an island's own death record automatically when it is reset or deleted.
     # Added since 1.6.0.
     reset-on-new-island: true
 protection: