Creature struct (creature_pool / DAT_0049bf38)¶

This document tracks the main creature pool used by crimsonland.exe.

Pool facts:

• Entry size: 0x98 bytes.
• Pool size: 0x180 entries.
• Base address: creature_pool (DAT_0049bf38).

Struct view (creature_t)¶

creature_pool is typed as creature_t (0x98 bytes).

typedef struct creature_t {
    unsigned char active;
    unsigned char _pad0[3];
    float phase_seed;
    unsigned char state_flag;
    unsigned char collision_flag;
    unsigned char _pad1[2];
    float collision_timer;
    float hitbox_size;
    float pos_x;
    float pos_y;
    float vel_x;
    float vel_y;
    float health;
    float max_health;
    float heading;
    float target_heading;
    float size;
    float hit_flash_timer;
    float tint_r;
    float tint_g;
    float tint_b;
    float tint_a;
    int force_target;
    float target_x;
    float target_y;
    float contact_damage;
    float move_speed;
    float attack_cooldown;
    float reward_value;
    unsigned char _pad2[4];
    int type_id;
    int target_player;
    unsigned char _pad3[4];
    int link_index;
    float target_offset_x;
    float target_offset_y;
    float orbit_angle;
    float orbit_radius;
    int flags;
    int ai_mode;
    float anim_phase;
} creature_t;

Key helpers:

• creature_alloc_slot (FUN_00428140) finds a free slot and seeds defaults.
• creature_spawn (FUN_00428240) spawns a creature and writes position/type/heading.
• creature_update_all (FUN_00426220) is the primary update loop (movement, targeting, AI, attacks).
• creatures_none_active (FUN_00428210) scans the pool and returns nonzero when empty.

Field map (medium confidence):

Global counters:

• creature_spawned_count increments on each creature_alloc_slot call (total spawns).
• creature_kill_count increments on creature death paths (used by the HUD progress ratio).
• creature_active_count is recomputed each creature_update_all pass.
• creature_update_tick is a global tick counter used to throttle some target updates.
• plaguebearer_infection_count increments on Plaguebearer contagion kills and caps spread.

Spawn slots (used by creature_update_all when creature_link_index selects a slot):

• creature_spawn_slot_table — spawn slot entry array (0x20 slots); owner points to the owning creature (used for collision and cleared on owner death).
• creature_spawn_slot_count — current spawn count (creature_spawn_slot_table[i].count).
• creature_spawn_slot_limit — max spawns before the slot stops (creature_spawn_slot_table[i].limit).
• creature_spawn_slot_interval — seconds between spawns (creature_spawn_slot_table[i].interval_s).
• creature_spawn_slot_timer — countdown timer to the next spawn (creature_spawn_slot_table[i].timer_s).
• creature_spawn_slot_template — spawn template id passed to creature_spawn_template (creature_spawn_slot_table[i].template_id).

Survival reward tracking (globals):

• survival_recent_death_pos — up to 3 recent creature death positions (recorded in creature_handle_death).
• survival_recent_death_count — increments with deaths (caps at 6) and gates the survival weapon reward check in survival_update.
• survival_reward_handout_enabled — one-time survival handout gate (cleared after the handout or after 3 death samples).
• survival_reward_fire_seen — set when the player fires; blocks the survival reward checks in survival_update.
• survival_reward_damage_seen — set on player damage; blocks the survival reward checks in survival_update.

See also¶

• Creature spawning
• Creature AI
• Creature animations