Differences

This shows you the differences between two versions of the page.

--- mr:heart_of_darkness_buff [2026/03/27 21:47] – Wiki maintenance: Fix broken links and improve mr: namespace page Qwen Assistant
+++ mr:heart_of_darkness_buff [2026/03/27 21:47] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Heart Of Darkness Buff - Code References ======
+===== Java Classes =====
+Actual implementation found in:
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/nyrds/pixeldungeon/items/guts/HeartOfDarkness.java|HeartOfDarkness.java]] - Contains the HeartOfDarkness artifact and HeartOfDarknessBuff class
+===== Implementation Details =====
+Full class implementation:
+<code java>
+package com.nyrds.pixeldungeon.items.guts;
+import com.nyrds.pixeldungeon.ml.R;
+import com.nyrds.pixeldungeon.mobs.guts.SpiritOfPain;
+import com.nyrds.platform.util.StringsManager;
+import com.watabou.pixeldungeon.actors.Char;
+import com.watabou.pixeldungeon.actors.mobs.Mob;
+import com.watabou.pixeldungeon.items.rings.Artifact;
+import com.watabou.pixeldungeon.items.rings.ArtifactBuff;
+import com.watabou.pixeldungeon.ui.BuffIndicator;
+public class HeartOfDarkness extends Artifact {
+	public HeartOfDarkness() {
+		imageFile = "items/artifacts.png";
+		image = 18;
+	}
+	@Override
+	public boolean isIdentified() {
+		return true;
+	}
+	@Override
+	public ArtifactBuff buff() {
+		return new HeartOfDarknessBuff();
+	}
+	public static class HeartOfDarknessBuff extends ArtifactBuff {
+		@Override
+		public int icon() {
+			return BuffIndicator.DARKVEIL;
+		}
+		@Override
+		public String name() {
+            return StringsManager.getVar(R.string.DarkVeilBuff_Name);
+        }
+		@Override
+		public String desc() {
+            return StringsManager.getVar(R.string.DarkVeilBuff_Info);
+        }
+		@Override
+		public int defenceProc(Char defender, Char enemy, int damage) {
+			int defenderPos = defender.getPos();
+			int spiritPos = defender.level().getEmptyCellNextTo(defenderPos);
+			if (defender.level().cellValid(spiritPos)) {
+				SpiritOfPain spirit = new SpiritOfPain();
+				spirit.setPos(spiritPos);
+				Mob.makePet(spirit, defender.getId());
+				defender.level().spawnMob(spirit, 0, defenderPos);
+			}
+			return damage;
+		}
+	}
+}
+</code>
+===== Key Methods =====
+  * **icon()** - Returns BuffIndicator.DARKVEIL for the buff icon
+  * **name()** - Returns localized buff name from DarkVeilBuff_Name string resource
+  * **desc()** - Returns localized buff description from DarkVeilBuff_Info string resource
+  * **defenceProc()** - Called when the wearer takes damage; spawns a SpiritOfPain pet nearby
+===== Behavior =====
+The HeartOfDarknessBuff is automatically applied when the hero equips the Heart of Darkness artifact. Its primary function is:
+  * Triggers on damage taken (via defenceProc method)
+  * Spawns a SpiritOfPain mob as a pet adjacent to the defender
+  * The SpiritOfPain is allied with the hero (created via Mob.makePet())
+  * Requires a valid empty cell next to the hero for spawning
+===== String Resources =====
+<code xml>
+<!-- English (values/strings_all.xml) -->
+<string name="DarkVeilBuff_Name">Dark veil</string>
+<string name="DarkVeilBuff_Info">A veil of darkness surrounds the owner, summoning a spirit every time damage is taken.</string>
+<!-- Russian (values-ru/strings_all.xml) -->
+<string name="DarkVeilBuff_Name">Тёмная вуаль</string>
+<string name="DarkVeilBuff_Info">Вуаль тьмы окружает владельца, призывая духа каждый раз при получении урона.</string>
+</code>
+===== Related Entities =====
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/nyrds/pixeldungeon/items/guts/HeartOfDarkness.java|HeartOfDarkness]] - Parent artifact item
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/nyrds/pixeldungeon/mobs/guts/SpiritOfPain.java|SpiritOfPain]] - Mob spawned by the buff
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/rings/Artifact.java|Artifact]] - Base class for artifact items
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/rings/ArtifactBuff.java|ArtifactBuff]] - Base class for artifact buffs
+===== JSON Configuration =====
+None - This buff is implemented purely in Java without JSON configuration.
+===== Lua Scripts =====
+None - This buff is implemented purely in Java without Lua scripting.