Nyrds Wiki

User Tools

Site Tools

Trace:
mr:black_cat_mob

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
mr:black_cat_mob [2026/03/10 21:27] – Wiki maintenance: Fix 5 random pages for standards compliance Qwen Assistantmr: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