Differences

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

--- mr:kunai_throw_spell [2026/03/04 13:57] – Wiki analysis: Fix compliance issues for 5 random pages Qwen Assistant
+++ mr:kunai_throw_spell [2026/03/04 14:00] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Kunai Throw Spell - Code References ======
+===== Entity Information =====
+  * **Entity Kind**: kunai_throw_spell
+  * **Entity Type**: Spell
+  * **Namespace**: mr: (machine-readable)
+===== Lua Script Implementation =====
+  * **Script Location**: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/scripts/spells/KunaiThrow.lua|KunaiThrow.lua]]
+  * **Script Dependencies**:
+    * scripts/lib/commonClasses (RPD)
+    * scripts/lib/spell (spell.init)
+===== Spell Configuration =====
+<code lua>
+desc = function ()
+    return {
+        image         = 3,
+        imageFile     = "spellsIcons/rogue.png",
+        name          = "KunaiThrow_Name",
+        info          = "KunaiThrow_Info",
+        magicAffinity = "Rogue",
+        targetingType = "self",
+        level         = 2,
+        castTime      = 0.01,
+        spellCost     = 5
+    }
+end
+</code>
+===== Spell Behavior =====
+<code lua>
+cast = function(self, spell, caster)
+    local n = spellTier(caster)  -- Returns 1, 2, or 3 based on caster skill level
+    local enemies = caster:visibleEnemies()
+    if enemies == 0 then
+        return false
+    end
+    local ownPos = caster:getPos()
+    for i = 1, n do
+        local tgt = caster:randomEnemy()
+        RPD.zapEffect(ownPos,tgt:getPos(),"Kunai")
+        tgt:damage(math.random( n, n + caster:lvl()*n ), caster)
+    end
+    return true
+end
+</code>
+===== Damage Calculation =====
+  * **Base Damage**: math.random(n, n + caster:lvl()*n) where n = spellTier(caster)
+  * **spellTier Formula**: math.min(caster:skillLevel() - 2 + 1, 3)
+  * **Damage Range**: n to (n + caster_level * n)
+  * **Maximum Projectiles**: 3 (based on caster skill level)
+===== String Resources =====
+<code xml>
+<string name="KunaiThrow_Name">Kunai Throw</string>
+<string name="KunaiThrow_Info">This Deadly Kunai throw will be done extremely fast, so fast that you won't even be able to select a target.
+True Masters able to throw more than one Kunai at once.</string>
+</code>
+===== Related Files =====
+  * **Sprite**: spell_KunaiThrow.png, kunai_throw_spell_icon.png
+  * **Item Sprite**: item_Kunai.png, kunai_item.png
+  * **Affinity**: Rogue affinity (magicAffinity = "Rogue")
+===== API Functions Used =====
+  * caster:skillLevel() - Returns the caster's skill level
+  * caster:visibleEnemies() - Returns count of visible enemies
+  * caster:randomEnemy() - Returns a random enemy target
+  * caster:getPos() - Returns caster's position
+  * caster:lvl() - Returns caster's level
+  * RPD.zapEffect(from, to, effectName) - Creates zap effect
+  * target:damage(amount, source) - Applies damage to target
+===== Tags =====
+{{tag> mr spell kunai_throw rogue spell_code}}