Differences

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

--- mr:hooked_dagger_item [2025/12/25 18:23] – auto lint fix Mikhael
+++ mr:hooked_dagger_item [2026/03/29 15:15] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Hooked Dagger Item - Code References ======
+The **Hooked Dagger** is a Lua-scripted melee weapon item in Remixed Dungeon. It is a dagger-type weapon that causes bleeding on hit.
+===== Java Classes =====
+This entity is implemented entirely in Lua. No Java class exists for this item.
+The item uses the common Lua item framework:
+  * `scripts/lib/commonClasses.lua` - Common RPD Lua classes
+  * `scripts/lib/item.lua` - Base item implementation for Lua items
+===== JSON Configuration =====
+This entity does not have a separate JSON configuration file. Item properties are defined in the Lua script.
+Item properties from Lua script:
+  * **Image index:** 3 (from items/daggers.png sprite sheet)
+  * **Image file:** items/daggers.png
+  * **Name string key:** HookedDagger_Name
+  * **Info string key:** HookedDagger_Info
+  * **Price:** 17 gold
+  * **Equipment slot:** Weapon slot (RPD.Slots.weapon)
+  * **Required STR:** 9
+  * **Attack delay factor:** 1.0
+  * **Accuracy factor:** 1.0
+  * **Damage roll:** level * 1 to level * 2 (scales with item level)
+===== String Resources =====
+<code xml>
+<string name="HookedDagger_Name">[Name]</string>
+<string name="HookedDagger_Info">[Description]</string>
+</code>
+Note: Actual string values should be verified in the game's string resource files:
+  * English: `RemixedDungeon/src/main/res/values/strings_all.xml`
+  * Russian: `RemixedDungeon/src/main/res/values-ru/strings_all.xml`
+  * Other languages in their respective values-XX directories
+===== Lua Scripts =====
+**Main Script:** [[https://github.com/NYRDS/remixed-dungeon/blob/master/scripts/items/HookedDagger.lua|HookedDagger.lua]]
+**Key Functions:**
+<code lua>
+-- Item description
+desc = function()
+    return {
+        image = 3,
+        imageFile = "items/daggers.png",
+        name = "HookedDagger_Name",
+        info = "HookedDagger_Info",
+        price = 17,
+        equipable = RPD.Slots.weapon
+    }
+end
+-- Melee weapon flag
+goodForMelee = function()
+    return true
+end
+-- Visual name (returns "Wand" - may be a placeholder)
+getVisualName = function()
+    return "Wand"
+end
+-- Attack animation class
+getAttackAnimationClass = function()
+    return "staff"
+end
+-- Damage calculation (scales with item level)
+damageRoll = function(item, user)
+    local lvl = item:level()
+    return math.random(lvl, lvl*2)
+end
+-- Attack proc: applies Bleeding buff for 3 turns
+attackProc = function(item, attacker, defender, damage)
+    RPD.affectBuff(defender, "Bleeding", 3)
+    return damage
+end
+-- Required strength
+typicalSTR = function()
+    return 9
+end
+</code>
+**Special Abilities:**
+  * **Bleeding Proc:** On hit, applies the Bleeding buff to the target for 3 turns
+  * **Level Scaling:** Damage scales with item level (1-2 damage per level)
+  * **Dual-wielding:** Can be equipped in main weapon slot, blocks left hand slot
+===== Related Entities =====
+**Buffs:**
+  * [[mr:bleeding_buff|Bleeding Buff]] - Applied on hit
+**Similar Items:**
+  * Other daggers in the `scripts/items/` directory
+  * Melee weapons that apply status effects
+===== Code References =====
+  * Lua: [[https://github.com/NYRDS/remixed-dungeon/blob/master/scripts/items/HookedDagger.lua|HookedDagger.lua]]
+  * Lua Library: [[https://github.com/NYRDS/remixed-dungeon/blob/master/scripts/lib/commonClasses.lua|commonClasses.lua]]
+  * Lua Library: [[https://github.com/NYRDS/remixed-dungeon/blob/master/scripts/lib/item.lua|item.lua]]
+{{tag> mr code reference item weapon lua melee dagger}}