Encounters Mechanic (Machine-Readable Reference)

• Entity Kind: Encounters
• Entity Type: Game Mechanic / System
• Namespace: Game mechanics, not a specific entity
• Related Systems: Mobs, Traps, NPCs, Level Objects, Level Generation

Encounters in Remixed Dungeon refer to all interactive events between the player character and dungeon elements. This mechanic encompasses the systems that govern how the player interacts with hostile, neutral, and friendly entities, as well as environmental features.

• Mobs (`mobs_overview.txt`) - Active enemies that engage in combat
  • Standard mobs with AI behavior
  • Boss mobs with unique mechanics
  • Special challenge mobs
• Traps (`traps_mechanic.txt`) - Hidden mechanisms triggered by player actions
  • Pressure plates, dart traps, gas traps, alarm traps, etc.
• Hostile NPCs - NPCs that attack on sight (e.g., certain quest NPCs)

• Passive Mobs - Entities that don't attack unless provoked (e.g., Statue)
• Utility Mobs - Special interaction mobs (e.g., Mimics disguised as items)
• Environmental Hazards - Blob effects (toxic gas, paralytic gas, fire, etc.)

• NPCs (`npcs_overview.txt`) - Non-player characters offering services
  • Shopkeepers (various shop types)
  • Quest NPCs (Wandmaker, Ghost, etc.)
  • Service NPCs (Blacksmith, etc.)
• Ally Mobs - Temporary or permanent companions
  • Pets (from scrolls, items, or class abilities)
  • Summoned allies (from spells, artifacts)
  • Charmed enemies

• Level Objects (`level_objects_overview.txt`) - Interactive dungeon features
  • Fountains (healing, dew, etc.)
  • Altars (sacrifice, blessings)
  • Pedestals (item placement)
  • Barricades, statues, wells, chests
• Terrain Features - Passive environmental effects
  • Water, grass, lava, chasms
  • Secret doors, hidden passages
• Stairs/Transitions - Level progression mechanics
  • Regular stairs, special level entrances

• Attack/Defense Skills: `attackSkill()`, `defenseSkill()`
• Damage Calculation: Min/Max damage, accuracy, evasion
• Status Effects: Buffs/debuffs applied during encounters
• Special Attacks: Surprise attacks, critical hits, ranged attacks

• Mob AI States: Passive, Aggressive, Hunting, Fleeing
• Target Selection: Player priority, ally targeting
• Pathfinding: A* navigation, flying/swimming movement
• Group Behavior: Pack tactics, summoning, leader mechanics

• Action Types: Attack, Use Item, Talk, Search, Disarm, Pick Up
• Context Sensitivity: Different actions based on target type
• Quest Integration: Special interactions for quest progression

• Bestiary.json: Mob spawn rates and level assignments
  • Path: `assets/levelsDesc/Bestiary.json`
• Level Objects: Individual JSON configs in `assets/levelObjects/`
• Mob Descriptions: Individual configs in `assets/mobsDesc/`
• Hero Classes: `assets/hero/initHeroes.json` (starting equipment, known items)

• Custom Mob Behaviors: Scripts in `scripts/mobs/`
• Trap Behaviors: Scripts in `scripts/traps/`
• NPC Dialogues/Quests: Scripts in `scripts/npcs/`
• Level Object Interactions: Scripts in `scripts/objects/`

• Mob Base Class: Mob.java
• Mob Factory: MobFactory.java
• Level Generation: Level.java
• AI System: MobAi.java
• Trap System: Trap.java
• NPC System: NPC.java
• Level Objects: LevelObject.java

• Mobs Overview: Mobs
• Traps: Traps
• NPCs: NPCs
• Level Objects: Level Objects
• Combat: Combat
• Hero Classes: Hero Classes
• Affinity System: Magic Affinities