Differences

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

--- mr:black_cat_mob [2026/02/19 00:11] – Fix broken links and add missing metadata to 5 wiki pages Qwen Assistant
+++ mr:black_cat_mob [2026/03/10 21:27] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Black Cat Mob - Code References ======
+**Entity Kind**: `BlackCat`
+**Entity Type**: Mob (NPC - Neutral/Friendly)
+**Description**: Black Cat is a friendly, immortal NPC mob that appears in fortune shops and special levels. It has passive AI behavior and cannot be killed.
+===== Java Classes =====
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/nyrds/pixeldungeon/mobs/common/CustomMob.java|CustomMob.java]] - Base class for JSON-defined mobs like Black Cat
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/actors/mobs/Mob.java|Mob.java]] - Base mob class
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/actors/Char.java|Char.java]] - Base character class
+===== JSON Configuration =====
+Black Cat is defined in JSON configuration at `RemixedDungeon/src/main/assets/mobsDesc/BlackCat.json`:
+<code json>
+{
+   "defenseSkill": 3,
+   "attackSkill": 8,
+   "exp": 2,
+   "maxLvl": 4,
+   "dmgMin": 1,
+   "dmgMax": 4,
+   "dr": 1,
+   "attackDelay": 1,
+   "ht": 10,
+   "baseSpeed": 1,
+   "spriteDesc": "spritesDesc/BlackCat.json",
+   "scriptFile": "scripts/npc/BlackCat",
+   "aiState": "Passive",
+   "fraction": "NEUTRAL",
+   "friendly": true,
+   "immortal": true
+}
+</code>
+**Configuration Notes**:
+  * `friendly: true` - Cannot be targeted by player attacks
+  * `immortal: true` - Cannot be killed
+  * `aiState: "Passive"` - Passive AI behavior, wanders randomly
+  * `fraction: "NEUTRAL"` - Neutral faction, doesn't attack other mobs
+  * `ht: 10` - Has 10 hit points (but cannot die due to immortal flag)
+**Level Spawns**: Black Cat appears in fortune-related levels:
+  * `levelsDesc/Fortune_2021_03.json`
+  * `levelsDesc/FortuneShop.json`
+  * `levelsDesc/Fortune.json`
+===== String Resources =====
+**English** (`values/strings_all.xml`):
+<code xml>
+<string name="BlackCat_Name">Black cat</string>
+<string name="BlackCat_Gender">feminine</string>
+<string name="BlackCat_Name_Objective">cat</string>
+<string name="BlackCat_Desc">This is a black cat</string>
+<string name="BlackCat_AiStatus">This cat is doing ordinary cat things</string>
+<string name="BlackCat_Phrases_0">Prrrrrrr</string>
+<string name="BlackCat_Phrases_1">Meow...</string>
+<string name="BlackCat_Phrases_2">Meow!</string>
+</code>
+**Russian** (`values-ru/strings_all.xml`):
+<code xml>
+<string name="BlackCat_Name">Чёрная кошка</string>
+<string name="BlackCat_Gender">feminine</string>
+<string name="BlackCat_Name_Objective">кошку</string>
+<string name="BlackCat_Desc">Это чёрная кошка</string>
+<string name="BlackCat_AiStatus">Эта кошка делает обычные кошачьи дела</string>
+<string name="BlackCat_Phrases_0">Фрррр</string>
+<string name="BlackCat_Phrases_1">Мяу...</string>
+<string name="BlackCat_Phrases_2">Мяу!</string>
+</code>
+**Other Languages**: Black Cat is localized in all supported languages including Indonesian, Greek, Spanish, French, German, Portuguese, Italian, Japanese, Korean, Chinese, Polish, Ukrainian, Hungarian, Turkish, and Malay.
+===== Lua Scripts =====
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/scripts/npc/BlackCat.lua|BlackCat.lua]] - NPC behavior script
+  * [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/assets/scripts/ai/BlackCat.lua|BlackCat AI]] - Behavior patterns and food seeking
+**Script Behavior**: The Black Cat Lua script implements:
+  * Passive wandering behavior
+  * Random meowing phrases
+  * Food-seeking behavior (attracted to food items)
+  * Special interaction when player offers food
+===== Related mr Entities =====
+  * [[mr:npc|NPC (Base Class)]] - NPC behavior base
+  * [[mr:custom_mob|Custom Mob System]] - JSON-defined mob system
+  * [[mr:fortune_shop_level|Fortune Shop Level]] - Level where Black Cat spawns
+  * [[mr:mob_ai|Mob AI System]] - AI state machine