summaryrefslogtreecommitdiff
path: root/include/dungeon_entity.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/dungeon_entity.h')
-rw-r--r--include/dungeon_entity.h277
1 files changed, 243 insertions, 34 deletions
diff --git a/include/dungeon_entity.h b/include/dungeon_entity.h
index 9f3033c..e7d0fc1 100644
--- a/include/dungeon_entity.h
+++ b/include/dungeon_entity.h
@@ -1,44 +1,227 @@
#ifndef GUARD_DUNGEON_ENTITY_H
#define GUARD_DUNGEON_ENTITY_H
-struct subStruct_8048524
+#include "item.h"
+#include "constants/move.h"
+
+struct DungeonEntityData
{
- /* 0x0 */ u8 unk0;
- /* 0x1 */ u8 unk1;
- /* 0x2 */ s16 species;
- /* 0x4 */ s16 transformSpecies;
+ // This has different purposes for Pokémon, items, and traps.
+ // Pokemon: MovementFlag
+ // Items: ItemFlag
+ // Traps: TrapType
+ /* 0x0 */ u8 flags;
+ /* 0x1 */ bool8 moving;
+ /* 0x2 */ u16 entityID; // Pokémon species or item ID.
+ // Everything from here on only applies to Pokémon.
+ /* 0x4 */ u16 transformSpecies; // Shows a different Pokémon when using Transform.
/* 0x6 */ bool8 isEnemy;
/* 0x7 */ bool8 isLeader;
- /* 0x8 */ u8 shopKeeper;
+ /* 0x8 */ u8 shopkeeperMode;
/* 0x9 */ u8 level;
- /* 0xA */ u16 partyIndex;
+ /* 0xA */ u8 partyIndex; // Leader is 0, partner is 1, etc.
+ u8 fillB;
/* 0xC */ u16 IQ;
/* 0xE */ s16 HP;
- /* 0x10 */ s16 maxHP;
- /* 0x12 */ s16 bossHPBackup;
- u8 fill14[0x46 - 0x14];
+ /* 0x10 */ u16 maxHP;
+ // Bosses have higher HP than normal for their level. This is the max HP they would normally have given their level.
+ /* 0x12 */ u16 originalHP;
+ /* 0x14 */ u8 attack;
+ /* 0x15 */ u8 specialAttack;
+ /* 0x16 */ u8 defense;
+ /* 0x17 */ u8 specialDefense;
+ /* 0x18 */ u32 expPoints;
+ // Temporary stat boosts/drops from effects like Growl or Swords Dance.
+ // These start at 10 and are in the range [1, 19].
+ /* 0x1C */ s16 attackStage;
+ /* 0x1E */ s16 specialAttackStage;
+ /* 0x20 */ s16 defenseStage;
+ /* 0x22 */ s16 specialDefenseStage;
+ /* 0x24 */ s16 accuracyStage;
+ /* 0x26 */ s16 evasionStage;
+ // // When a Fire-type move is used on a Pokémon with Flash Fire, this value increases the power of the Pokémon's Fire-type moves.
+ /* 0x28 */ s16 flashFireBoost;
+ u8 fill2A[0x2C - 0x2A];
+ // These start at 0x1000, and are halved by certain moves like Screech to lower the corresponding stat.
+ /* 0x2C */ s32 attackMultiplier;
+ /* 0x30 */ s32 specialAttackMultiplier;
+ /* 0x34 */ s32 defenseMultiplier;
+ /* 0x38 */ s32 specialDefenseMultiplier;
+ u8 fill3C[0x3E - 0x3C];
+ /* 0x3E */ u8 hiddenPowerType;
+ u8 fill3F;
+ /* 0x40 */ u8 joinLocation; // Uses the dungeon index in dungeon.h.
+ u8 fill41[0x44 - 0x41];
+ /* 0x44 */ u16 action;
/* 0x46 */ s8 facingDir;
- u8 fill47[0x8C - 0x47];
- u8 unk8C[4];
- u8 fill90[0xA4 - 0x90];
+ u8 fill47;
+ // Additional parameter alongside actionIndex. Used for things like indiciating which move a Pokémon should use from its moveset.
+ /* 0x48 */ u8 actionUseIndex;
+ u8 fill49[0x4C - 0x49];
+ // Position of the Pokémon the last time it threw an item.
+ /* 0x4C */ s16 lastItemThrowPositionX;
+ /* 0x4E */ s16 lastItemThrowPositionY;
+ u8 fill50[0x58 - 0x50];
+ // Position of the target that the Pokémon wants throw an item at.
+ /* 0x58 */ s16 itemTargetPositionX;
+ /* 0x5A */ s16 itemTargetPositionY;
+ /* 0x5C */ u8 type1;
+ /* 0x5D */ u8 type2;
+ /* 0x5E */ u8 ability1;
+ /* 0x5F */ u8 ability2;
+ // Same format as ItemSlot struct.
+ /* 0x60 */ u8 heldItemFlags;
+ /* 0x61 */ u8 heldItemNumItems;
+ /* 0x62 */ u8 heldItemIndex;
+ u8 fill63[0x68 - 0x63];
+ /* 0x68 */ s16 previousPosition1X;
+ /* 0x6A */ s16 previousPosition1Y;
+ /* 0x6C */ s16 previousPosition2X;
+ /* 0x6E */ s16 previousPosition2Y;
+ /* 0x70 */ s16 previousPosition3X;
+ /* 0x72 */ s16 previousPosition3Y;
+ /* 0x74 */ s16 previousPosition4X;
+ /* 0x76 */ s16 previousPosition4Y;
+ /* 0x78 */ u8 movementAction;
+ /* 0x79 */ bool8 notAdjacentToTarget;
+ /* 0x7A */ bool8 hasTarget;
+ /* 0x7B */ bool8 turnAround;
+ /* 0x7C */ u16 targetPokemonSpawnIndex;
+ u8 fill7E[0x80 - 0x7E];
+ /* 0x80 */ u32 targetPokemon;
+ u8 fill84[0x88 - 0x84];
+ /* 0x88 */ s16 targetMovePositionX;
+ /* 0x8A */ s16 targetMovePositionY;
+ // Bitwise flags corresponding to selected IQ skills.
+ /* 0x8C */ u8 IQSkillsSelected[4]; // IQ skills selected in the IQ skills menu.
+ /* 0x90 */ u8 IQSkillsEnabled[4];
+ /* 0x94 */ u8 tactics;
+ u8 fill95[0xA4 - 0x95];
/* 0xA4 */ u8 clientFlags;
- u8 fillA5[0xAC - 0xA5];
- /* 0xAC */ u8 statusCondition;
- u8 fillAD[0xF7 - 0xAD];
+ u8 fillA5[0xA8 - 0xA5];
+ // Statuses are split into groups based on which ones can't overlap.
+ // See status.h for which statuses are in each group.
+ /* 0xA8 */ u8 sleepStatus;
+ /* 0xA9 */ u8 sleepStatusTurnsLeft;
+ u8 fillAA[0xAC - 0xAA];
+ /* 0xAC */ u8 nonVolatileStatus;
+ /* 0xAD */ u8 nonVolatileStatusTurnsLeft;
+ /* 0xAE */ u8 nonVolatileStatusDamageTimer;
+ u8 fillAF;
+ /* 0xB0 */ u8 immobilizeStatus;
+ u8 fillB1[0xB8 - 0xB1];
+ /* 0xB8 */ u8 immobilizeStatusTurnsLeft;
+ /* 0xB9 */ u8 immobilizeStatusDamageTimer;
+ u8 fillBA[0xBC - 0xBA];
+ /* 0xBC */ u8 volatileStatus;
+ /* 0xBD */ u8 volatileStatusTurnsLeft;
+ u8 fillBE[0xC0 - 0xBE];
+ /* 0xC0 */ u8 chargingStatus;
+ /* 0xC1 */ u8 chargingStatusTurnsLeft;
+ /* 0xC2 */ u8 chargingStatusMoveIndex; // The position of the move in the Pokémon's moveset that triggered the status.
+ u8 fillC3;
+ /* 0xC4 */ u8 protectionStatus;
+ /* 0xC5 */ u8 protectionStatusTurnsLeft;
+ u8 fillC6[0xC8 - 0xC6];
+ /* 0xC8 */ u8 waitingStatus;
+ /* 0xC9 */ bool8 enemyDecoy; // True if the Pokémon is a decoy and a wild Pokémon (i.e., not an allied Pokémon).
+ u8 fillCA;
+ /* 0xCB */ u8 waitingStatusTurnsLeft;
+ /* 0xCC */ u8 cursedDamageTimer;
+ u8 fillCD[0xD0 - 0xCD];
+ /* 0xD0 */ u8 linkedStatus;
+ u8 fillD1[0xD9 - 0xD1];
+ /* 0xD9 */ u8 linkedStatusTurnsLeft;
+ /* 0xDA */ u8 linkedStatusDamageTimer;
+ u8 fillDB;
+ /* 0xDC */ u8 moveStatus;
+ /* 0xDD */ u8 moveStatusTurnsLeft;
+ u8 fillDE[0xE0 - 0xDE];
+ /* 0xE0 */ u8 itemStatus;
+ u8 fillE1[0xE4 - 0xE1];
+ /* 0xE4 */ u8 transformStatus;
+ /* 0xE5 */ u8 transformStatusTurnsLeft;
+ u8 fillE6[0xE8 - 0xE6];
+ /* 0xE8 */ u8 eyesightStatus;
+ u8 fillE9;
+ /* 0xEA */ u8 eyesightStatusTurnsLeft;
+ u8 fillEB;
+ /* 0xEC */ bool8 muzzledStatus;
+ /* 0xED */ u8 muzzledTurnsLeft;
+ u8 fillEE[0xF0 - 0xEE];
+ /* 0xF0 */ bool8 radarStatus;
+ /* 0xF1 */ bool8 scanningStatus;
+ /* 0xF2 */ bool8 stairSpotterStatus;
+ u8 fillF3;
+ /* 0xF4 */ bool8 grudgeStatus;
+ /* 0xF5 */ bool8 exposedStatus;
+ u8 fillF7;
/* 0xF7 */ bool8 isBoss;
- u8 fillF8[0xFB - 0xF8];
+ u8 fillF8[0xFA - 0xF8];
+ /* 0xFA */ u8 terrifiedTurnsLeft; // Doubles as a bool for whether the Pokémon is terrified.
u8 unkFB;
- u8 fillFC[0x112 - 0xFC];
+ /* 0xFC */ bool8 forceUseItem; // If true, an AI Pokémon is forced to try using their held item next turn. Unknown when this is set in regular gameplay.
+ /* 0xFD */ u8 perishSongTimer; // When this reaches 0, the Pokémon faints from Perish Song. Doubles as a bool for whether the Pokémon is afflicted by Perish Song.
+ u8 fillFE[0x100 - 0xFE];
+ /* 0x100 */ u8 targetingDecoy; // If the Pokémon is targeting a decoy, this indicates whether the decoy target is a team or wild Pokémon.
+ u8 fill101[0x104 - 0x101];
+ /* 0x104 */ u8 movementSpeed;
+ u8 fill105[0x108 - 0x105];
+ // The turn counter for movement speed up/down is split into five timers each. Multiple timers are used if the Pokémon is affected by multiple
+ // speed-up/slow effects at once, like using Agility twice.
+ /* 0x108 */ u8 speedUpTurnsLeft[5];
+ /* 0x10D */ u8 slowTurnsLeft[5];
/* 0x112 */ u8 stockpileCount;
- u8 fill113[0x13C - 0x113];
+ u8 fill113;
+ // When true, an AI Pokémon will move in a random direction every turn.
+ // Unclear where this is set in-game; it is not set by statuses (e.g., confusion) or mission clients.
+ /* 0x114 */ bool8 moveRandomly;
+ u8 fill115[0x118 - 0x115];
+ /* 0x118 */ struct PokemonMove moves[4];
+ /* 0x138 */ u8 struggleMoveFlags;
+ u8 fill139[0x13C - 0x139];
/* 0x13C */ u32 belly;
- u8 fill140[0x15C - 0x140];
+ /* 0x140 */ u32 maxBelly;
+ /* 0x144 */ bool8 movingIntoTarget; // True if an AI Pokémon is following another Pokémon and is already adjacent to them.
+ /* 0x145 */ bool8 recalculateFollow; // Used by the AI to defer a movement decision until after all other Pokémon have moved.
+ u8 fill146;
+ /* 0x147 */ bool8 waiting; // True if an AI Pokémon decided to do nothing this turn.
+ /* 0x148 */ bool8 attacking;
+ u8 fill149[0x14E - 0x149];
+ /* 0x14E */ u16 visualFlags;
+ /* 0x150 */ u16 previousVisualFlags;
+ u8 fill152[0x15C - 0x152];
u8 unk15C;
u8 unk15D;
u8 unk15E;
u8 unk15F;
- u8 fill160[0x174 - 0x160];
+ u8 fill160[0x16C - 0x160];
+ /* 0x16C */ s16 targetPositionX;
+ /* 0x16E */ s16 targetPositionY;
+ /* 0x170 */ s16 posPixelX;
+ /* 0x172 */ s16 posPixelY;
u32 unk174;
+ u8 fill178[0x184 - 0x178];
+ // Previous value of targetPosition for movement, 1 and 2 moves ago.
+ /* 0x184 */ s16 previousTargetMovePosition1X;
+ /* 0x186 */ s16 previousTargetMovePosition1Y;
+ /* 0x188 */ s32 previousTargetMovePosition2X;
+ /* 0x18C */ s32 previousTargetMovePosition2Y;
+ /* 0x190 */ u8 lastMoveDirection; // The last direction that the Pokémon moved in.
+ u8 fill191[0x194 - 0x191];
+ // Number of tiles that the Pokémon moved last, multiplied by 0x100.
+ /* 0x194 */ s32 lastMoveIncrementX;
+ /* 0x198 */ s32 lastMoveIncrementY;
+ /* 0x19C */ u8 walkAnimationCounter; // Set when the Pokémon starts moving, and counts down until the Pokémon's walk animation stops.
+ u8 fill19D[0x1F4 - 0x19D];
+ /* 0x1F4 */ u8 numMoveTiles; // Number of tiles to move in a turn. Can be greater than 1 if the user's movement speed is boosted.
+ u8 fill1F5;
+ /* 0x1F6 */ bool8 notMoving;
+ u8 fill1F7[0x1FA - 0x1F7];
+ /* 0x1FA */ u8 mobileTurnTimer; // When a Pokémon can pass through walls in a hallway, this counts up to 200 before the Pokémon turns in a random direction.
+ u8 fill1FB;
+ /* 0x1FC */ u16 expGainedInTurn; // Used to accumulate experience when multiple enemies are defeated in one turn.
+ u8 fill1FE[0x208 - 0x1FE];
};
// Used for Pokémon, items, and traps.
@@ -57,7 +240,7 @@ struct DungeonEntity
/* 0x14 */ s32 prevPosPixelX;
/* 0x18 */ s32 prevPosPixelY;
u8 fill1C[0x20 - 0x1C];
- /* 0x20 */ bool8 active; // Turned off when a Pokémon faints.
+ /* 0x20 */ bool8 visible; // Turned off when a Pokémon faints.
u8 fill21[0x25 - 0x21];
/* 0x25 */ u8 roomIndex;
// The global spawn index counter starts at 10. Each Pokémon that spawns increments the counter and
@@ -89,10 +272,10 @@ struct DungeonEntity
u8 fill52[0x54 - 0x52];
/* 0x54 */ u16 spriteGlobalIndex;
u8 fill56[0x6C - 0x56];
- /* 0x6C */ u8 facingDirection;
- /* 0x6D */ u8 facingDirection2; // Duplicate of 0x6C?
+ /* 0x6C */ u8 facingDir;
+ /* 0x6D */ u8 facingDir2; // Duplicate of 0x6C?
u8 fill6D[0x70 - 0x6D];
- struct subStruct_8048524 *unk70;
+ /* 0x70 */ struct DungeonEntityData *entityData;
};
enum EntityType
@@ -102,16 +285,42 @@ enum EntityType
ENTITY_TRAP = 3
};
-enum FacingDirection
+enum MovementFlag
+{
+ MOVEMENT_FLAG_SWAPPED_PLACES = 1 << 5,
+ MOVEMENT_FLAG_SWAPPED_PLACES_PETRIFIED = 1 << 15 // Set if the Pokémon is petrified and the leader cures them by swapping places.
+};
+
+enum ShopkeeperMode
+{
+ SHOPKEEPER_FRIENDLY = 1,
+ // These two modes trigger if an explosion damages the shopkeeper. The shopkeeper attacks the side that damaged it.
+ SHOPKEEPER_AGGRESSIVE_TO_WILD = 2,
+ SHOPKEEPER_AGGRESSIVE_TO_PLAYER = 3
+};
+
+enum MovementAction
+{
+ MOVEMENT_ACTION_FOLLOW = 1,
+ MOVEMENT_ACTION_WANDER = 2,
+ MOVEMENT_ACTION_RUN_AWAY_WANDER = 3,
+ MOVEMENT_ACTION_EXIT_ROOM = 4,
+ MOVEMENT_ACTION_RUN_AWAY_FROM_ENEMY = 5,
+ MOVEMENT_ACTION_FACE_RANDOM_DIRECTION = 6,
+ MOVEMENT_ACTION_TAKE_ITEM = 7
+};
+
+enum ClientFlag
+{
+ CLIENT_FLAGS_CLIENT = 1, // Used for mission clients that need rescuing.
+ CLIENT_FLAGS_DONT_MOVE = 3 // Used for Diglett in the Skarmory boss fight.
+};
+
+enum VisualFlag
{
- SOUTH,
- SOUTHEAST,
- EAST,
- NORTHEAST,
- NORTH,
- NORTHWEST,
- WEST,
- SOUTHWEST
+ // Set if Run Away's visual effect (green smoke cloud) has been triggered on this floor.
+ // Prevents the effect from showing again if the Pokémon stops running away and then starts running away again.
+ VISUAL_FLAG_RUN_AWAY = 2
};
#endif
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-06 04:07:31 +0000