Initial openwa-types crate: enums, structs, and RE addresses

Bootstrap the Rust type foundation for WA 3.8.1 reverse engineering:

- Cargo workspace with openwa-types crate
- Enums translated from wkJellyWorm: ClassType (34), TaskMessage (83+),
Weapon (71), SoundId (126), SpriteId (696)
- Fixed-point math newtype (16.16 format, 0x10000 = 1.0)
- CTask and CGameTask struct stubs with compile-time size assertions
- 80+ known addresses: vtables, constructors, gameplay, rendering, sound
- RE documentation: task hierarchy, vtable layouts, memory map

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.gitattributes

@@ -0,0 +1,11 @@
+testdata/** filter=lfs diff=lfs merge=lfs -text
+crates/**/tests/fixtures/** filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.wsc filter=lfs diff=lfs merge=lfs -text
+*.pal filter=lfs diff=lfs merge=lfs -text
+*.wagame filter=lfs diff=lfs merge=lfs -text
+*.WAgame filter=lfs diff=lfs merge=lfs -text
+crates/*/data/** filter=lfs diff=lfs merge=lfs -text
+testdata/**/*.md !text -filter -merge -diff
+testdata/**/.gitignore !text -filter -merge -diff

.gitignore

@@ -0,0 +1,4 @@
+/target
+.claude/
+.mcp.json
+start-mcp.ps1

Cargo.lock

@@ -0,0 +1,7 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "openwa-types"
+version = "0.1.0"

Cargo.toml

@@ -0,0 +1,3 @@
+[workspace]
+members = ["crates/*"]
+resolver = "2"

crates/openwa-types/Cargo.toml

@@ -0,0 +1,5 @@
+[package]
+name = "openwa-types"
+version = "0.1.0"
+edition = "2021"
+description = "Type definitions for Worms Armageddon reverse engineering"

crates/openwa-types/src/address.rs

@@ -0,0 +1,171 @@
+/// Known addresses in WA.exe 3.8.1 (image base 0x00400000).
+///
+/// These addresses are discovered through Ghidra analysis and
+/// cross-referenced with wkJellyWorm/WormKit sources.
+///
+/// All addresses are virtual addresses (VA) as loaded in memory.
+pub mod va {
+    // Segment layout:
+    //   .text:  0x00401000 - 0x00619FFF (code)
+    //   .rdata: 0x0061A000 - 0x00693FFF (read-only data)
+    //   .data:  0x00694000 - 0x008C4157 (read-write data)
+    //   .rsrc:  0x008C5000 - 0x00954FFF (resources)
+    //   .reloc: 0x00955000 - 0x00983FFF (relocations)
+
+    pub const IMAGE_BASE: u32 = 0x0040_0000;
+    pub const TEXT_START: u32 = 0x0040_1000;
+    pub const TEXT_END: u32 = 0x0061_9FFF;
+    pub const RDATA_START: u32 = 0x0061_A000;
+    pub const DATA_START: u32 = 0x0069_4000;
+
+    // === Vtables (in .rdata) ===
+
+    /// CTask vtable - 7 virtual method pointers
+    pub const CTASK_VTABLE: u32 = 0x0066_9F8C;
+    /// CGameTask vtable - extends CTask vtable with 12 more methods
+    pub const CGAMETASK_VTABLE: u32 = 0x0066_41F8;
+    /// CGameTask secondary vtable (at object offset 0xE8)
+    pub const CGAMETASK_VTABLE2: u32 = 0x0066_9CF8;
+
+    // === CTask vtable methods (at CTask__vtable) ===
+
+    /// CTask::vtable0 - initialization/unknown
+    pub const CTASK_VT0_INIT: u32 = 0x0056_2710;
+    /// CTask::Free - destructor/deallocation
+    pub const CTASK_VT1_FREE: u32 = 0x0056_2620;
+    /// CTask::HandleMessage - message dispatch
+    pub const CTASK_VT2_HANDLE_MESSAGE: u32 = 0x0056_2F30;
+    /// CTask::vtable3 - unknown
+    pub const CTASK_VT3: u32 = 0x0056_13D0;
+    /// CTask::vtable4 - unknown (same as vt3 in base)
+    pub const CTASK_VT4: u32 = 0x0056_13D0;
+    /// CTask::vtable5 - unknown
+    pub const CTASK_VT5: u32 = 0x0056_2FA0;
+    /// CTask::vtable6 - unknown
+    pub const CTASK_VT6: u32 = 0x0056_3000;
+    /// CTask::vtable7 - ProcessFrame
+    pub const CTASK_VT7_PROCESS_FRAME: u32 = 0x0056_3210;
+
+    // === CGameTask vtable methods (first 8 override CTask, then 12 new) ===
+
+    /// CGameTask::vtable0 override
+    pub const CGAMETASK_VT0: u32 = 0x004F_F1C0;
+    /// CGameTask::Free override
+    pub const CGAMETASK_VT1_FREE: u32 = 0x004F_EF10;
+    /// CGameTask::HandleMessage override
+    pub const CGAMETASK_VT2_HANDLE_MESSAGE: u32 = 0x004F_F280;
+
+    // === Constructors ===
+
+    /// CTask constructor - initializes base task fields and children list
+    pub const CTASK_CONSTRUCTOR: u32 = 0x0056_25A0;
+    /// CGameTask constructor - calls CTask ctor, sets physics defaults
+    pub const CGAMETASK_CONSTRUCTOR: u32 = 0x004F_ED50;
+    /// CTaskWorm constructor
+    pub const CTASK_WORM_CONSTRUCTOR: u32 = 0x0050_BFB0;
+
+    // === Game entity constructors (from wkJellyWorm) ===
+
+    pub const CTASK_AIRSTRIKE_CTOR: u32 = 0x0055_53C0;
+    pub const CTASK_ARROW_CTOR: u32 = 0x004F_E130;
+    pub const CTASK_CANISTER_CTOR: u32 = 0x0050_1A80;
+    pub const CTASK_CLOUD_CTOR: u32 = 0x0054_82E0;
+    pub const CTASK_CPU_CTOR: u32 = 0x0054_85D0;
+    pub const CTASK_CRATE_CTOR: u32 = 0x0050_2490;
+    pub const CTASK_CROSS_CTOR: u32 = 0x0050_45C0;
+    pub const CTASK_DIRT_CTOR: u32 = 0x0054_EDC0;
+    pub const CTASK_FILTER_CTOR: u32 = 0x0054_F3D0;
+    pub const CTASK_FIRE_CTOR: u32 = 0x0054_F4C0;
+    pub const CTASK_FIREBALL_CTOR: u32 = 0x0055_0890;
+    pub const CTASK_FLAME_CTOR: u32 = 0x0054_F0F0;
+    pub const CTASK_GAS_CTOR: u32 = 0x0055_4750;
+    pub const CTASK_LAND_CTOR: u32 = 0x0050_5440;
+    pub const CTASK_MINE_CTOR: u32 = 0x0050_6660;
+    pub const CTASK_MISSILE_CTOR: u32 = 0x0050_7D10;
+    pub const CTASK_OILDRUM_CTOR: u32 = 0x0050_4AF0;
+    pub const CTASK_OLDWORM_CTOR: u32 = 0x0051_FEB0;
+    pub const CTASK_SCOREBUBBLE_CTOR: u32 = 0x0055_4CA0;
+    pub const CTASK_SEABUBBLE_CTOR: u32 = 0x0055_4FE0;
+    pub const CTASK_SMOKE_CTOR: u32 = 0x0055_51D0;
+    pub const CTASK_SPRITE_ANIM_CTOR: u32 = 0x0054_66C0;
+    pub const CTASK_TEAM_CTOR: u32 = 0x0055_5BB0;
+    pub const CTASK_TURNGAME_CTOR: u32 = 0x0055_B280;
+
+    // === Gameplay functions ===
+
+    pub const CREATE_EXPLOSION: u32 = 0x0054_8080;
+    pub const SPECIAL_IMPACT: u32 = 0x0051_93D0;
+    pub const SPAWN_OBJECT: u32 = 0x0056_1CF0;
+    pub const WEAPON_RELEASE: u32 = 0x0051_C3D0;
+    pub const WORM_START_FIRING: u32 = 0x0051_B7F0;
+    pub const FIRE_WEAPON: u32 = 0x0051_EE60;
+    pub const CREATE_WEAPON_PROJECTILE: u32 = 0x0051_E0F0;
+
+    // === Weapon system ===
+
+    pub const INIT_WEAPON_TABLE: u32 = 0x0053_CAB0;
+    pub const GET_AMMO: u32 = 0x0052_25E0;
+    pub const ADD_AMMO: u32 = 0x0052_2640;
+    pub const SUBTRACT_AMMO: u32 = 0x0052_2680;
+
+    // === Graphics / rendering ===
+
+    pub const CONSTRUCT_DD_GAME: u32 = 0x0056_E220;
+    pub const CONSTRUCT_DD_GAME_WRAPPER: u32 = 0x0056_DEF0;
+    pub const CONSTRUCT_DD_DISPLAY: u32 = 0x0056_9D00;
+    pub const CONSTRUCT_FRAME_BUFFER: u32 = 0x005A_2430;
+    pub const BLIT_SCREEN: u32 = 0x005A_2020;
+    pub const RENDER_DRAWING_QUEUE: u32 = 0x0054_2350;
+    pub const DRAW_LANDSCAPE: u32 = 0x005A_2790;
+    pub const DRAW_SPRITE_GLOBAL: u32 = 0x0054_1FE0;
+    pub const DRAW_BITMAP_GLOBAL: u32 = 0x0054_2170;
+    pub const LOAD_SPRITE: u32 = 0x0052_3400;
+    pub const CONSTRUCT_OPENGL_CPU: u32 = 0x005A_0850;
+    pub const OPENGL_INIT: u32 = 0x0059_F000;
+
+    // === Landscape ===
+
+    pub const CONSTRUCT_PC_LANDSCAPE: u32 = 0x0057_ACB0;
+    pub const REDRAW_LAND_REGION: u32 = 0x0057_CC10;
+    pub const WRITE_LAND_RAW: u32 = 0x0057_C300;
+
+    // === Sound ===
+
+    pub const CONSTRUCT_DS_SOUND: u32 = 0x0057_3D50;
+    pub const PLAY_SOUND_LOCAL: u32 = 0x004F_DFE0;
+    pub const PLAY_SOUND_GLOBAL: u32 = 0x0054_6E20;
+
+    // === Chat / UI ===
+
+    pub const SHOW_CHAT_MESSAGE: u32 = 0x0052_ACB0;
+    pub const ON_CHAT_INPUT: u32 = 0x0052_B730;
+
+    // === Lobby / network ===
+
+    pub const LOBBY_HOST_COMMANDS: u32 = 0x004B_9B00;
+    pub const LOBBY_CLIENT_COMMANDS: u32 = 0x004A_ABB0;
+    pub const SEND_GAME_PACKET_WRAPPED: u32 = 0x0054_1130;
+    pub const FRONTEND_CHANGE_SCREEN: u32 = 0x0044_7A20;
+
+    // === Memory ===
+
+    pub const WA_MALLOC_MEMSET: u32 = 0x0053_E910;
+    pub const WA_FREE: u32 = 0x005D_0D2B;
+
+    // === Game context (DDGame struct offsets) ===
+    // These are offsets from the DDGame base pointer, not absolute addresses.
+    // DDGame pointer is obtained from hookConstructDDGameWrapper param.
+
+    pub mod ddgame_offsets {
+        /// Offset to TurnGame object pointer
+        pub const TURN_GAME: u32 = 0x08;
+        /// Offset to game global state pointer
+        pub const GAME_GLOBAL: u32 = 0x488;
+        /// Offset to PC_Landscape pointer
+        pub const PC_LANDSCAPE: u32 = 0x4CC;
+        /// Offset to weapon table pointer
+        pub const WEAPON_TABLE: u32 = 0x510;
+        /// Offset to weapon panel pointer
+        pub const WEAPON_PANEL: u32 = 0x548;
+    }
+}

crates/openwa-types/src/class_type.rs

@@ -0,0 +1,61 @@
+/// Task/entity classification type.
+///
+/// Stored at offset 0x20 in CTask. Used to identify the concrete type
+/// of a task in the task hierarchy.
+///
+/// Source: wkJellyWorm Constants.h
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(u32)]
+pub enum ClassType {
+    None = 0,
+    Task = 1,
+    GameTask = 2,
+    GameCollisionTask = 3,
+    Control = 4,
+    Game = 5,
+    TurnGame = 6,
+    Filter = 7,
+    Mine = 8,
+    Canister = 9,
+    Team = 10,
+    Missile = 11,
+    Arrow = 12,
+    Animation = 13,
+    Dirt = 14,
+    Crate = 15,
+    Flame = 16,
+    AirStrike = 17,
+    Worm = 18,
+    OldWorm = 19,
+    Drill = 20,
+    Cross = 21,
+    Smoke = 22,
+    Cloud = 23,
+    Fire = 24,
+    Gas = 25,
+    FireBall = 26,
+    SeaBubble = 27,
+    Land = 28,
+    ScoreBubble = 29,
+    OilDrum = 30,
+    Cpu = 31,
+    SpriteAnimation = 32,
+    CollisionManager = 33,
+}
+
+impl ClassType {
+    pub const MAX: u32 = 34;
+}
+
+impl TryFrom<u32> for ClassType {
+    type Error = u32;
+
+    fn try_from(value: u32) -> Result<Self, Self::Error> {
+        if value < Self::MAX {
+            // SAFETY: all values 0..34 are valid variants
+            Ok(unsafe { core::mem::transmute(value) })
+        } else {
+            Err(value)
+        }
+    }
+}

crates/openwa-types/src/fixed.rs

@@ -0,0 +1,92 @@
+use core::ops::{Add, Sub, Mul, Neg};
+
+/// 16.16 fixed-point number used throughout WA for coordinates and velocities.
+///
+/// The game uses `0x10000` (65536) to represent `1.0`.
+/// For example, a position of `0x30000` means 3.0 world units.
+#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Default)]
+#[repr(transparent)]
+pub struct Fixed(pub i32);
+
+impl Fixed {
+    pub const FRACTIONAL_BITS: u32 = 16;
+    pub const SCALE: i32 = 1 << Self::FRACTIONAL_BITS; // 0x10000 = 65536
+
+    pub const ZERO: Self = Self(0);
+    pub const ONE: Self = Self(Self::SCALE);
+
+    #[inline]
+    pub const fn from_raw(raw: i32) -> Self {
+        Self(raw)
+    }
+
+    #[inline]
+    pub const fn to_raw(self) -> i32 {
+        self.0
+    }
+
+    #[inline]
+    pub const fn from_int(n: i32) -> Self {
+        Self(n << Self::FRACTIONAL_BITS)
+    }
+
+    #[inline]
+    pub const fn to_int(self) -> i32 {
+        self.0 >> Self::FRACTIONAL_BITS
+    }
+
+    #[inline]
+    pub fn from_f32(f: f32) -> Self {
+        Self((f * Self::SCALE as f32) as i32)
+    }
+
+    #[inline]
+    pub fn to_f32(self) -> f32 {
+        self.0 as f32 / Self::SCALE as f32
+    }
+}
+
+impl Add for Fixed {
+    type Output = Self;
+    #[inline]
+    fn add(self, rhs: Self) -> Self {
+        Self(self.0 + rhs.0)
+    }
+}
+
+impl Sub for Fixed {
+    type Output = Self;
+    #[inline]
+    fn sub(self, rhs: Self) -> Self {
+        Self(self.0 - rhs.0)
+    }
+}
+
+impl Mul for Fixed {
+    type Output = Self;
+    #[inline]
+    fn mul(self, rhs: Self) -> Self {
+        // Use i64 to avoid overflow during multiplication
+        Self(((self.0 as i64 * rhs.0 as i64) >> Self::FRACTIONAL_BITS) as i32)
+    }
+}
+
+impl Neg for Fixed {
+    type Output = Self;
+    #[inline]
+    fn neg(self) -> Self {
+        Self(-self.0)
+    }
+}
+
+impl core::fmt::Debug for Fixed {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
+        write!(f, "Fixed({:.4} raw=0x{:08x})", self.to_f32(), self.0)
+    }
+}
+
+impl core::fmt::Display for Fixed {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
+        write!(f, "{:.4}", self.to_f32())
+    }
+}

crates/openwa-types/src/lib.rs

@@ -0,0 +1,8 @@
+pub mod class_type;
+pub mod message;
+pub mod weapon;
+pub mod sound;
+pub mod sprite;
+pub mod fixed;
+pub mod task;
+pub mod address;

crates/openwa-types/src/message.rs

@@ -0,0 +1,137 @@
+/// Inter-task message types for the game's event/message passing system.
+///
+/// Tasks communicate by sending these messages through the hierarchy.
+/// Note: there are gaps in the numbering (10, 24-25, 65-66, 82-83, 87, 95).
+///
+/// Source: wkJellyWorm Constants.h
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(u32)]
+pub enum TaskMessage {
+    None = 0,
+    FrameStart = 1,
+    FrameFinish = 2,
+    RenderScene = 3,
+    ProcessInput = 4,
+    UpdateNonCritical = 5,
+    MachineFinished = 6,
+    CrateCollected = 7,
+    StateChecksum = 8,
+    MachineReady = 9,
+    // gap: 10 is unused
+    WormDrowned = 11,
+    FrameNumber = 12,
+    MachineQuit = 13,
+    EnableCheat = 14,
+    PlayerChat = 15,
+    CameraAuto = 16,
+    CursorMoved = 17,
+    GirderChanged = 18,
+    StrikeChanged = 19,
+    TeamVictory = 20,
+    GameOver = 21,
+    ExitMode = 22,
+    Hurry = 23,
+    // gap: 24-25 unused
+    ThinkingShow = 26,
+    ThinkingHide = 27,
+    Explosion = 28,
+    ExplosionReport = 29,
+    MoveLeft = 30,
+    MoveRight = 31,
+    MoveUp = 32,
+    MoveDown = 33,
+    FaceLeft = 34,
+    FaceRight = 35,
+    Jump = 36,
+    JumpUp = 37,
+    FireWeapon = 38,
+    ReleaseWeapon = 39,
+    SkipGo = 40,
+    Freeze = 41,
+    // gap: 42 unused
+    Surrender = 43,
+    DetonateWeapon = 44,
+    MoveWeaponLeft = 45,
+    MoveWeaponRight = 46,
+    SelectFuse = 47,
+    SelectHerd = 48,
+    SelectBounce = 49,
+    SelectCursor = 50,
+    SelectWeapon = 51,
+    StartTurn = 52,
+    PauseTurn = 53,
+    ResumeTurn = 54,
+    FinishTurn = 55,
+    TurnStarted = 56,
+    TurnFinished = 57,
+    SuddenDeath = 58,
+    DamageWorms = 59,
+    RetreatStarted = 60,
+    RetreatFinished = 61,
+    ApplyPoison = 62,
+    SetWorm = 63,
+    KillWorm = 64,
+    // gap: 65-66 unused
+    AdvanceWorm = 67,
+    ShowDamage = 68,
+    EnableWeapons = 69,
+    DisableWeapons = 70,
+    WormMoved = 71,
+    WormDamaged = 72,
+    WeaponReleased = 73,
+    WeaponFinished = 74,
+    SpecialImpact = 75,
+    WeaponCreated = 76,
+    WeaponHoming = 77,
+    WeaponDestroyed = 78,
+    WeaponClaimControl = 79,
+    WeaponReleaseControl = 80,
+    PoisonWorm = 81,
+    // gap: 82-83 unused
+    SetWind = 84,
+    GameText = 85,
+    CreateAnimation = 86,
+    // gap: 87 unused
+    BringForward = 88,
+    RaiseWater = 89,
+    NukeBlast = 90,
+    Armageddon = 91,
+    DetonateCrate = 92,
+    Earthquake = 93,
+    ScalesOfJustice = 94,
+    // gap: 95 unused
+    PauseTimer = 96,
+    ResumeTimer = 97,
+    MoveSpecial = 98,
+    StateWrongChecksum = 99,
+    UpdateTween = 100,
+    ProcessInputTween = 101,
+    TimeReceivedObsolete = 102,
+    Transferred = 103,
+    TransferTimeFreq = 104,
+    UpdatePanelTween = 105,
+    StateWrongInitChecksum = 106,
+    FrameFinishFiller = 107,
+    MachineEvent = 108,
+    InvalidDataCompressed = 109,
+    InvalidDataUncompressed = 110,
+    PacketIndexJump = 111,
+    CancelPending = 112,
+    BulletExplosion = 113,
+    FrameNumberWinsock = 114,
+}
+
+impl TryFrom<u32> for TaskMessage {
+    type Error = u32;
+
+    fn try_from(value: u32) -> Result<Self, Self::Error> {
+        match value {
+            0..=9 | 11..=23 | 26..=41 | 43..=64 | 67..=81 | 84..=86
+            | 88..=94 | 96..=114 => {
+                // SAFETY: all matched values correspond to valid variants
+                Ok(unsafe { core::mem::transmute(value) })
+            }
+            _ => Err(value),
+        }
+    }
+}

crates/openwa-types/src/sound.rs

@@ -0,0 +1,150 @@
+/// Sound effect IDs. Range 1-126, contiguous.
+///
+/// Source: wkJellyWorm Constants.h
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(u32)]
+pub enum SoundId {
+    Morse = 1,
+    CrowdPart1 = 2,
+    CrowdPart2 = 3,
+    NukePart1 = 4,
+    NukePart2 = 5,
+    FrenchAnthem = 6,
+    IndianAnthem = 7,
+    Twang1 = 8,
+    Twang2 = 9,
+    Twang3 = 10,
+    Twang4 = 11,
+    Twang5 = 12,
+    Twang6 = 13,
+    Cough1 = 14,
+    Cough2 = 15,
+    Cough3 = 16,
+    Cough4 = 17,
+    Cough5 = 18,
+    Cough6 = 19,
+    DonorCardAppears = 20,
+    DonorCardCollect = 21,
+    FlameThrowerAttack = 22,
+    FlameThrowerLoop = 23,
+    Freeze = 24,
+    UnFreeze = 25,
+    JetPackStart = 26,
+    JetPackFinish = 27,
+    LongbowImpact = 28,
+    LongbowRelease = 29,
+    NukeFlash = 30,
+    ScalesOfJustice = 31,
+    UnderWaterLoop = 32,
+    VikingAxeImpact = 33,
+    VikingAxeRelease = 34,
+    WormLanding = 35,
+    JetPackLoop1 = 36,
+    JetPackLoop2 = 37,
+    MoleBombDiggingLoop = 38,
+    MoleBombWalkLoop = 39,
+    MoleBombSqueak = 40,
+    SkunkGasLoop = 41,
+    SkunkWalkLoop = 42,
+    SkunkSqueak = 43,
+    Armageddon = 44,
+    StartRound = 45,
+    CameraPan = 46,
+    WalkCompress = 47,
+    WalkExpand = 48,
+    CowMoo = 49,
+    SheepBaa = 50,
+    PigeonCoo = 51,
+    AirStrike = 52,
+    BlowTorch = 53,
+    WormPop = 54,
+    Sizzle = 55,
+    SnotPlop = 56,
+    Splash = 57,
+    Splish = 58,
+    Petrol = 59,
+    WormBurned = 60,
+    SalvationArmy = 61,
+    MagicBullet = 62,
+    WormSpring = 63,
+    VaseSmash = 64,
+    OldWoman = 65,
+    Fuse = 66,
+    Teleport = 67,
+    Communicator = 68,
+    Explosion1 = 69,
+    Explosion2 = 70,
+    Explosion3 = 71,
+    ThrowPowerup = 72,
+    ThrowRelease = 73,
+    RocketPowerup = 74,
+    RocketRelease = 75,
+    SuperSheepRelease = 76,
+    SuperSheepWhoosh = 77,
+    UziFire = 78,
+    MinigunFire = 79,
+    ShotgunFire = 80,
+    ShotgunReload = 81,
+    HandgunFire = 82,
+    Ricochet = 83,
+    Drill = 84,
+    DrillImpact = 85,
+    NinjaRopeFire = 86,
+    NinjaRopeImpact = 87,
+    MineArm = 88,
+    MineTick = 89,
+    MineDud = 90,
+    WeaponHoming = 91,
+    PauseTick = 92,
+    TimerTick = 93,
+    SuddenDeath = 94,
+    KamikazeRelease = 95,
+    BaseballBatRelease = 96,
+    BaseballBatImpact = 97,
+    BaseballBatJingle = 98,
+    DragonBallRelease = 99,
+    DragonBallImpact = 100,
+    FirePunchImpact = 101,
+    HolyDonkey = 102,
+    HolyDonkeyImpact = 103,
+    HolyGrenade = 104,
+    HolyGrenadeImpact = 105,
+    FrozenWormImpact = 106,
+    MineImpact = 107,
+    WormImpact = 108,
+    CrossImpact = 109,
+    CrateImpact = 110,
+    BananaImpact = 111,
+    GirderImpact = 112,
+    GrenadeImpact = 113,
+    OilDrumImpact = 114,
+    CratePop = 115,
+    KeyClick = 116,
+    KeyErase = 117,
+    WormSelect = 118,
+    CursorSelect = 119,
+    WarningBeep = 120,
+    LoadingTick = 121,
+    TeamDrop = 122,
+    TeamBounce = 123,
+    Collect = 124,
+    ThrowPowerdown = 125,
+    RocketPowerdown = 126,
+}
+
+impl SoundId {
+    pub const MIN: u32 = 1;
+    pub const MAX: u32 = 126;
+}
+
+impl TryFrom<u32> for SoundId {
+    type Error = u32;
+
+    fn try_from(value: u32) -> Result<Self, Self::Error> {
+        if value >= Self::MIN && value <= Self::MAX {
+            Ok(unsafe { core::mem::transmute(value) })
+        } else {
+            Err(value)
+        }
+    }
+}

crates/openwa-types/src/sprite.rs

@@ -0,0 +1,720 @@
+/// Sprite/animation frame IDs. Range 1-696 with gaps at 620-621.
+///
+/// Names preserved from the original sprite file names in the game data.
+/// The original names are terse 8-character identifiers from the game's
+/// sprite sheets.
+///
+/// Source: wkJellyWorm Constants.h
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(u32)]
+pub enum SpriteId {
+    Cdrom = 1,
+    CrshairR = 2,
+    CrshairB = 3,
+    CrshairG = 4,
+    CrshairY = 5,
+    CrshairP = 6,
+    CrshairC = 7,
+    SpangleR = 8,
+    SpangleB = 9,
+    SpangleG = 10,
+    SpangleY = 11,
+    SpangleP = 12,
+    SpangleC = 13,
+    Grave1 = 14,
+    Grave2 = 15,
+    Grave3 = 16,
+    Grave4 = 17,
+    Grave5 = 18,
+    Grave6 = 19,
+    ArrowDnR = 20,
+    ArrowDnB = 21,
+    ArrowDnG = 22,
+    ArrowDnY = 23,
+    ArrowDnP = 24,
+    ArrowDnC = 25,
+    ArrowSdR = 26,
+    ArrowSdB = 27,
+    ArrowSdG = 28,
+    ArrowSdY = 29,
+    ArrowSdP = 30,
+    ArrowSdC = 31,
+    CursorR = 32,
+    CursorB = 33,
+    CursorG = 34,
+    CursorY = 35,
+    CursorP = 36,
+    CursorC = 37,
+    MarkerR = 38,
+    MarkerB = 39,
+    MarkerG = 40,
+    MarkerY = 41,
+    MarkerP = 42,
+    MarkerC = 43,
+    CMarker = 44,
+    MineOn = 45,
+    Arrow = 46,
+    MineOff = 47,
+    Missile = 48,
+    Bullet = 49,
+    Grenade = 50,
+    Banana = 51,
+    Mortar = 52,
+    Cluster = 53,
+    Clustlet = 54,
+    PetrolBm = 55,
+    HGrenade = 56,
+    Tamborin = 57,
+    HMissil1 = 58,
+    HMissil2 = 59,
+    AirMisl = 60,
+    SheepFal = 61,
+    Carpet1 = 62,
+    Carpet2 = 63,
+    SheepBrn = 64,
+    SheepLau = 65,
+    Meteor = 66,
+    Drill = 67,
+    RopeTip = 68,
+    RopeCuff = 69,
+    Phone = 70,
+    MbBomb = 71,
+    Letter1 = 72,
+    Letter2 = 73,
+    Vase = 74,
+    VaseBit1 = 75,
+    VaseBit2 = 76,
+    VaseBit3 = 77,
+    Dynamite = 78,
+    FireHit = 79,
+    KamiSmk = 80,
+    BaseHit = 81,
+    Donkey = 82,
+    Fireball = 83,
+    Flame1 = 84,
+    Flame2 = 85,
+    AirJetB = 86,
+    AirJetG = 87,
+    AirJetO = 88,
+    PostBox = 89,
+    ShpTruck = 90,
+    CptTruck = 91,
+    Targets = 92,
+    TargetsV = 93,
+    TargetW = 94,
+    TargetWV = 95,
+    WCrate1 = 96,
+    MCrate1 = 97,
+    UCrate1 = 98,
+    WCrate2 = 99,
+    MCrate2 = 100,
+    UCrate2 = 101,
+    Donor = 102,
+    WCrateV = 103,
+    MCrateV = 104,
+    UCrateV = 105,
+    Fallout = 106,
+    WCrate0 = 107,
+    MCrate0 = 108,
+    UCrate0 = 109,
+    OilDrum1 = 110,
+    OilDrum2 = 111,
+    OilDrum3 = 112,
+    OilDrum4 = 113,
+    UziHit = 114,
+    UziCase = 115,
+    ShotHit = 116,
+    ShotCase = 117,
+    WormHit1 = 118,
+    WormHit2 = 119,
+    Petrol1_ = 120,
+    Petrol2_ = 121,
+    Petrol3_ = 122,
+    Petrol4_ = 123,
+    Petrol1 = 124,
+    Petrol2 = 125,
+    Petrol3 = 126,
+    Petrol4 = 127,
+    Petrol5 = 128,
+    Petrol6 = 129,
+    Exhaust = 130,
+    HExhaust = 131,
+    WExhaust = 132,
+    QExhaust = 133,
+    Feather = 134,
+    MExhaust = 135,
+    TCloud = 136,
+    WWalk = 137,
+    WWalkU = 138,
+    WWalkD = 139,
+    WBlowW = 140,
+    WBlowWU = 141,
+    WBlowWD = 142,
+    WBlowA = 143,
+    WBlowAU = 144,
+    WBlowAD = 145,
+    WBungee = 146,
+    WBatRope = 147,
+    WRoll = 148,
+    WFly1 = 149,
+    WFly2 = 150,
+    WFly3 = 151,
+    LShpWlk = 152,
+    SheepWlk = 153,
+    SpSheep1 = 154,
+    SpSheep2 = 155,
+    AquaShp1 = 156,
+    AquaShp2 = 157,
+    MoleDive = 158,
+    MoleDig1 = 159,
+    MoleDig2 = 160,
+    MoleDig3 = 161,
+    Woman = 162,
+    Sally = 163,
+    CowWalk = 164,
+    CowJump = 165,
+    MoleWalk = 166,
+    WJetFly1 = 167,
+    WJetFly2 = 168,
+    WJetFly3 = 169,
+    WJetFly4 = 170,
+    WJetFlmB = 171,
+    WJetFlmD = 172,
+    Skunk1 = 173,
+    Skunk2 = 174,
+    PigeonR0 = 175,
+    PigeonR1 = 176,
+    PigeonR2 = 177,
+    PigeonR3 = 178,
+    WpBrth = 179,
+    WpBrthU = 180,
+    WpBrthD = 181,
+    WCough = 182,
+    WCoughU = 183,
+    WCoughD = 184,
+    WBrth1 = 185,
+    WBrth1U = 186,
+    WBrth1D = 187,
+    WBrth2 = 188,
+    WBrth2U = 189,
+    WBrth2D = 190,
+    WBlink1 = 191,
+    WBlink1U = 192,
+    WBlink1D = 193,
+    WBlink2 = 194,
+    WBlink2U = 195,
+    WBlink2D = 196,
+    WGlnce1 = 197,
+    WGlnce1U = 198,
+    WGlnce1D = 199,
+    WGlnce2 = 200,
+    WGlnce2U = 201,
+    WGlnce2D = 202,
+    WBgHead = 203,
+    WBgHeadU = 204,
+    WBgHeadD = 205,
+    WFist = 206,
+    WFistU = 207,
+    WFistD = 208,
+    WPeek = 209,
+    WPeekU = 210,
+    WPeekD = 211,
+    WULook = 212,
+    WULookU = 213,
+    WULookD = 214,
+    WOLook = 215,
+    WOLookU = 216,
+    WOLookD = 217,
+    WScarey = 218,
+    WScareyU = 219,
+    WScareyD = 220,
+    WKami1 = 221,
+    WKami2 = 222,
+    WKami3 = 223,
+    WKami4 = 224,
+    WKami5 = 225,
+    WScrtch = 226,
+    WScrtchU = 227,
+    WScrtchD = 228,
+    WAccuse = 229,
+    WAccuseU = 230,
+    WAccuseD = 231,
+    WTache = 232,
+    WTacheU = 233,
+    WTacheD = 234,
+    WMunch = 235,
+    WMunchU = 236,
+    WMunchD = 237,
+    WLazy = 238,
+    WLazyU = 239,
+    WLazyD = 240,
+    WWinner = 241,
+    WSurndr = 242,
+    WSurndrU = 243,
+    WSurndrD = 244,
+    WSvR = 245,
+    WSvRU = 246,
+    WSvRD = 247,
+    WSvB = 248,
+    WSvBU = 249,
+    WSvBD = 250,
+    WSvG = 251,
+    WSvGU = 252,
+    WSvGD = 253,
+    WSvY = 254,
+    WSvYU = 255,
+    WSvYD = 256,
+    WSvP = 257,
+    WSvPU = 258,
+    WSvPD = 259,
+    WSvC = 260,
+    WSvCU = 261,
+    WSvCD = 262,
+    WSkipGo = 263,
+    WSkipGoU = 264,
+    WSkipGoD = 265,
+    WSelect = 266,
+    WSelectU = 267,
+    WSelectD = 268,
+    WJump = 269,
+    WJumpU = 270,
+    WJumpD = 271,
+    WLand1 = 272,
+    WLand1U = 273,
+    WLand1D = 274,
+    WLand2 = 275,
+    WLand2U = 276,
+    WLand2D = 277,
+    WFlyLnk = 278,
+    WBackFlp = 279,
+    WPncLnk = 280,
+    WPncLnkU = 281,
+    WPncLnkD = 282,
+    WPncTop = 283,
+    WPncBak = 284,
+    WPncBakU = 285,
+    WPncBakD = 286,
+    WParaLnk = 287,
+    WParaCht = 288,
+    WParBak = 289,
+    WParBakU = 290,
+    WParBakD = 291,
+    WTwang = 292,
+    WTwangU = 293,
+    WTwangD = 294,
+    WSldLk1 = 295,
+    WSldLk1U = 296,
+    WSldLk1D = 297,
+    WSldLk2 = 298,
+    WSldLk2U = 299,
+    WSldLk2D = 300,
+    WpBrtLk = 301,
+    WpBrtLkU = 302,
+    WpBrtLkD = 303,
+    WBlowLk = 304,
+    WBlowLkU = 305,
+    WBlowLkD = 306,
+    WHatLnk = 307,
+    WHatLnkU = 308,
+    WHatLnkD = 309,
+    WNukeLk = 310,
+    WNukeLkU = 311,
+    WNukeLkD = 312,
+    WGrnLnk = 313,
+    WGrnLnkU = 314,
+    WGrnLnkD = 315,
+    WClsLnk = 316,
+    WClsLnkU = 317,
+    WClsLnkD = 318,
+    WBanLnk = 319,
+    WBanLnkU = 320,
+    WBanLnkD = 321,
+    WPbmLnk = 322,
+    WPbmLnkU = 323,
+    WPbmLnkD = 324,
+    WHgrLnk = 325,
+    WHgrLnkU = 326,
+    WHgrLnkD = 327,
+    WUtlLnk = 328,
+    WUtlLnkU = 329,
+    WUtlLnkD = 330,
+    WJetLnk = 331,
+    WJetLnkU = 332,
+    WJetLnkD = 333,
+    WDynLnk = 334,
+    WDynLnkU = 335,
+    WDynLnkD = 336,
+    WVasLnk = 337,
+    WVasLnkU = 338,
+    WVasLnkD = 339,
+    WCowLnk = 340,
+    WCowLnkU = 341,
+    WCowLnkD = 342,
+    WShpLnk = 343,
+    WShpLnkU = 344,
+    WShpLnkD = 345,
+    WWmnLnk = 346,
+    WWmnLnkU = 347,
+    WWmnLnkD = 348,
+    WSknLnk = 349,
+    WSknLnkU = 350,
+    WSknLnkD = 351,
+    WMolLnk = 352,
+    WMolLnkU = 353,
+    WMolLnkD = 354,
+    WWmn2Lk = 355,
+    WWmn2LkU = 356,
+    WWmn2LkD = 357,
+    WDrlLnk = 358,
+    WDrlLnkU = 359,
+    WDrlLnkD = 360,
+    WDrill = 361,
+    WPrdLnk = 362,
+    WPrdLnkU = 363,
+    WPrdLnkD = 364,
+    WProd = 365,
+    WProdU = 366,
+    WProdD = 367,
+    WPrdBk2 = 368,
+    WPrdBk2U = 369,
+    WPrdBk2D = 370,
+    WKamLnk = 371,
+    WKamLnkU = 372,
+    WKamLnkD = 373,
+    WKamJmp = 374,
+    WKamBmr = 375,
+    WKamBmrU = 376,
+    WKamBmrD = 377,
+    WFirBl1 = 378,
+    WFirBl1U = 379,
+    WFirBl1D = 380,
+    WFirBl2 = 381,
+    WFirBl2U = 382,
+    WFirBl2D = 383,
+    WFirAir = 384,
+    WJapBak = 385,
+    WJapBakU = 386,
+    WJapBakD = 387,
+    WMinLnk = 388,
+    WMinLnkU = 389,
+    WMinLnkD = 390,
+    WSkpLnk = 391,
+    WSkpLnkU = 392,
+    WSkpLnkD = 393,
+    WSelLnk = 394,
+    WSelLnkU = 395,
+    WSelLnkD = 396,
+    WAxeLnk = 397,
+    WAxeLnkU = 398,
+    WAxeLnkD = 399,
+    WAxeLk2 = 400,
+    WAxeLk2U = 401,
+    WAxeLk2D = 402,
+    WAxeSwn = 403,
+    WAxeSwnU = 404,
+    WAxeSwnD = 405,
+    WAxeBak = 406,
+    WAxeBakU = 407,
+    WAxeBakD = 408,
+    WBndLnk = 409,
+    WBndLnkU = 410,
+    WBndLnkD = 411,
+    WAirLnk = 412,
+    WAirLnkU = 413,
+    WAirLnkD = 414,
+    WAirTlk = 415,
+    WAirTlkU = 416,
+    WAirTlkD = 417,
+    WTelLnk = 418,
+    WTelLnkU = 419,
+    WTelLnkD = 420,
+    WTelTlk = 421,
+    WTelTlkU = 422,
+    WTelTlkD = 423,
+    WTelDsv = 424,
+    WTelDsvU = 425,
+    WTelDsvD = 426,
+    WThrBak = 427,
+    WThrBakU = 428,
+    WThrBakD = 429,
+    WBsbLnk = 430,
+    WBsbLnkU = 431,
+    WBsbLnkD = 432,
+    WBsbBk2 = 433,
+    WBsbBk2U = 434,
+    WBsbBk2D = 435,
+    WBazLnk = 436,
+    WBazLnkU = 437,
+    WBazLnkD = 438,
+    WFlmLnk = 439,
+    WFlmLnkU = 440,
+    WFlmLnkD = 441,
+    WBz2Lnk = 442,
+    WBz2LnkU = 443,
+    WBz2LnkD = 444,
+    WBz3Lnk = 445,
+    WBz3LnkU = 446,
+    WBz3LnkD = 447,
+    WSurLnk = 448,
+    WSurLnkU = 449,
+    WSurLnkD = 450,
+    WSvrLnk = 451,
+    WSvrLnkU = 452,
+    WSvrLnkD = 453,
+    WSvbLnk = 454,
+    WSvbLnkU = 455,
+    WSvbLnkD = 456,
+    WSvgLnk = 457,
+    WSvgLnkU = 458,
+    WSvgLnkD = 459,
+    WSvyLnk = 460,
+    WSvyLnkU = 461,
+    WSvyLnkD = 462,
+    WSvpLnk = 463,
+    WSvpLnkU = 464,
+    WSvpLnkD = 465,
+    WSvcLnk = 466,
+    WSvcLnkU = 467,
+    WSvcLnkD = 468,
+    WIceLnk = 469,
+    WIceLnkU = 470,
+    WIceLnkD = 471,
+    WIceLk2 = 472,
+    WIceLk2U = 473,
+    WIceLk2D = 474,
+    WIceLk3 = 475,
+    WIceLk3U = 476,
+    WIceLk3D = 477,
+    WIceLook = 478,
+    WIceBlnk = 479,
+    WIceGlnt = 480,
+    WIceStnd = 481,
+    WBatLnk = 482,
+    WBatLnkU = 483,
+    WBatLnkD = 484,
+    WBatBk2 = 485,
+    WBatBk2U = 486,
+    WBatBk2D = 487,
+    WUziLnk = 488,
+    WUziLnkU = 489,
+    WUziLnkD = 490,
+    WShgLnk = 491,
+    WShgLnkU = 492,
+    WShgLnkD = 493,
+    WBowLnk = 494,
+    WBowLnkU = 495,
+    WBowLnkD = 496,
+    WBowBk2 = 497,
+    WBowBk2U = 498,
+    WBowBk2D = 499,
+    WHgnLnk = 500,
+    WHgnLnkU = 501,
+    WHgnLnkD = 502,
+    WMgnLnk = 503,
+    WMgnLnkU = 504,
+    WMgnLnkD = 505,
+    WDie = 506,
+    SkdSmoke = 507,
+    WFlyUp = 508,
+    WFlyDn = 509,
+    WFall = 510,
+    WFallDn = 511,
+    WPncUp = 512,
+    WSlide = 513,
+    WSlideU = 514,
+    WSlideD = 515,
+    WBow = 516,
+    WBowU = 517,
+    WBowD = 518,
+    WBsbAim = 519,
+    WBsbAimU = 520,
+    WBsbAimD = 521,
+    WBsbSwn = 522,
+    WBsbSwnU = 523,
+    WBsbSwnD = 524,
+    WBaz = 525,
+    WBazU = 526,
+    WBazD = 527,
+    WFlm = 528,
+    WFlmU = 529,
+    WFlmD = 530,
+    WBaz2 = 531,
+    WBaz2U = 532,
+    WBaz2D = 533,
+    WBaz3 = 534,
+    WBaz3U = 535,
+    WBaz3D = 536,
+    WBatAim = 537,
+    WBatAimU = 538,
+    WBatAimD = 539,
+    WBatFrd = 540,
+    WBatFrdU = 541,
+    WBatFrdD = 542,
+    WShotG = 543,
+    WShotGU = 544,
+    WShotGD = 545,
+    WShotP = 546,
+    WShotPU = 547,
+    WShotPD = 548,
+    WShotF = 549,
+    WShotFU = 550,
+    WShotFD = 551,
+    WBowP = 552,
+    WBowPU = 553,
+    WBowPD = 554,
+    WBowF = 555,
+    WBowFU = 556,
+    WBowFD = 557,
+    WHandG = 558,
+    WHandGU = 559,
+    WHandGD = 560,
+    WHandF = 561,
+    WHandFU = 562,
+    WHandFD = 563,
+    WUzi = 564,
+    WUziU = 565,
+    WUziD = 566,
+    WUziF = 567,
+    WUziFU = 568,
+    WUziFD = 569,
+    WMini = 570,
+    WMiniU = 571,
+    WMiniD = 572,
+    WMiniF = 573,
+    WMiniFU = 574,
+    WMiniFD = 575,
+    WThrGrn = 576,
+    WThrGrnU = 577,
+    WThrGrnD = 578,
+    WThrCls = 579,
+    WThrClsU = 580,
+    WThrClsD = 581,
+    WThrBan = 582,
+    WThrBanU = 583,
+    WThrBanD = 584,
+    WThrPbm = 585,
+    WThrPbmU = 586,
+    WThrPbmD = 587,
+    WThrHgr = 588,
+    WThrHgrU = 589,
+    WThrHgrD = 590,
+    WThrow = 591,
+    WThrowU = 592,
+    WThrowD = 593,
+    Replay = 594,
+    NetBreak = 595,
+    ExFoom = 596,
+    ExBiff = 597,
+    ExPoot = 598,
+    ExPow = 599,
+    Circle25 = 600,
+    Circle50 = 601,
+    Circle75 = 602,
+    Circl100 = 603,
+    Elipse25 = 604,
+    Elipse50 = 605,
+    Elipse75 = 606,
+    Elips100 = 607,
+    GassGrn = 608,
+    SmkLt25 = 609,
+    SmkLt50 = 610,
+    SmkLt75 = 611,
+    SmkLt100 = 612,
+    SmkDrk20 = 613,
+    SmkDrk30 = 614,
+    SmkDrk40 = 615,
+    Clouds = 616,
+    CloudM = 617,
+    CloudL = 618,
+    Blob = 619,
+    // gap: 620-621 unused
+    Debris = 622,
+    Bubble1 = 623,
+    Bubble2 = 624,
+    Bubble3 = 625,
+    Bubble4 = 626,
+    WfDrown = 627,
+    Grave1V2 = 628,
+    Grave2V2 = 629,
+    Grave3V2 = 630,
+    Grave4V2 = 631,
+    Grave5V2 = 632,
+    Grave6V2 = 633,
+    TargetsV2 = 634,
+    TargetWV2 = 635,
+    WCrate1V2 = 636,
+    MCrate1V2 = 637,
+    UCrate1V2 = 638,
+    DonorV2 = 639,
+    WDrown = 640,
+    OilDrum = 641,
+    MeteorV2 = 642,
+    MineOnV2 = 643,
+    MineOffV2 = 644,
+    MissileV2 = 645,
+    AirMislV2 = 646,
+    GrenadeV2 = 647,
+    MortarV2 = 648,
+    ClusterV2 = 649,
+    ClustletV2 = 650,
+    BulletV2 = 651,
+    ArrowV2 = 652,
+    Sheep = 653,
+    Carpet1V2 = 654,
+    Carpet2V2 = 655,
+    SheepFalV2 = 656,
+    SheepBrnV2 = 657,
+    MbBombV2 = 658,
+    DrillV2 = 659,
+    WomanV2 = 660,
+    SallyV2 = 661,
+    SkunkV2 = 662,
+    Mole = 663,
+    CowWalkV2 = 664,
+    PigeonR0V2 = 665,
+    PigeonR1V2 = 666,
+    PigeonR2V2 = 667,
+    PigeonR3V2 = 668,
+    BananaV2 = 669,
+    PetrolBmV2 = 670,
+    TamborinV2 = 671,
+    HGrenadeV2 = 672,
+    HMissil1V2 = 673,
+    HMissil2V2 = 674,
+    AquaShp1V2 = 675,
+    AquaShp2V2 = 676,
+    VaseV2 = 677,
+    VaseBit1V2 = 678,
+    VaseBit2V2 = 679,
+    VaseBit3V2 = 680,
+    DynamiteV2 = 681,
+    Letter1V2 = 682,
+    Letter2V2 = 683,
+    DonkeyV2 = 684,
+    WBaz4 = 685,
+    WBaz4U = 686,
+    WBaz4D = 687,
+    WBaz5 = 688,
+    WBaz5U = 689,
+    WBaz5D = 690,
+    WBz4Lnk = 691,
+    WBz4LnkU = 692,
+    WBz4LnkD = 693,
+    WBz5Lnk = 694,
+    WBz5LnkU = 695,
+    WBz5LnkD = 696,
+}
+
+impl TryFrom<u32> for SpriteId {
+    type Error = u32;
+
+    fn try_from(value: u32) -> Result<Self, Self::Error> {
+        match value {
+            1..=619 | 622..=696 => {
+                // SAFETY: all matched values correspond to valid variants
+                Ok(unsafe { core::mem::transmute(value) })
+            }
+            _ => Err(value),
+        }
+    }
+}

crates/openwa-types/src/task.rs

@@ -0,0 +1,74 @@
+use crate::class_type::ClassType;
+use crate::fixed::Fixed;
+
+/// A 32-bit pointer as it appears in WA's memory (the game is 32-bit x86).
+pub type Ptr32 = u32;
+
+/// Base task class in WA's entity hierarchy.
+///
+/// All game objects inherit from CTask. Tasks form a tree via parent/children
+/// pointers and communicate through the TaskMessage system.
+///
+/// PARTIAL: Many fields between known offsets are unknown.
+///
+/// Source: wkJellyWorm CTask.h
+///
+/// Vtable at 0x669F8C (8 methods):
+///   0x00: 0x562710 vtable0 (init?)
+///   0x04: 0x562620 Free
+///   0x08: 0x562F30 HandleMessage
+///   0x0C: 0x5613D0 unknown
+///   0x10: 0x5613D0 unknown (same as 0x0C)
+///   0x14: 0x562FA0 unknown
+///   0x18: 0x563000 unknown
+///   0x1C: 0x563210 ProcessFrame
+#[repr(C)]
+pub struct CTask {
+    /// 0x00: Pointer to virtual method table
+    pub vtable: Ptr32,
+    /// 0x04: Parent task in the hierarchy
+    pub parent: Ptr32,
+    /// 0x08: Unknown (set to 0x10 in constructor — possibly capacity/flags)
+    pub _unknown_08: u32,
+    /// 0x0C-0x1F: Children task list (CList<CTask*>)
+    /// Internal structure: max_size(4), unk4(4), size(4), data_ptr(4), hash_list(4)
+    pub _children_raw: [u8; 20],
+    /// 0x20: Task classification type
+    pub class_type: ClassType,
+    /// 0x24-0x2F: Unknown padding to 0x30
+    pub _unknown_24: [u8; 12],
+}
+
+const _: () = assert!(core::mem::size_of::<CTask>() == 0x30);
+
+/// Game task - extends CTask with physics and gameplay data.
+///
+/// PARTIAL: Most fields between 0x30-0x83 and 0x98-0xEC are unknown.
+/// Only position and velocity fields have been verified.
+///
+/// Source: wkJellyWorm CGameTask.h
+///
+/// Additional vtable (12 methods at offsets 0x1C-0x48 in vtable)
+#[repr(C)]
+pub struct CGameTask {
+    /// 0x00-0x2F: Base CTask fields
+    pub base: CTask,
+    /// 0x30-0x83: Unknown gameplay fields (84 bytes)
+    pub _unknown_30: [u8; 0x54],
+    /// 0x84: X position in fixed-point
+    pub pos_x: Fixed,
+    /// 0x88: Y position in fixed-point
+    pub pos_y: Fixed,
+    /// 0x8C-0x8F: Unknown (4 bytes between pos and speed)
+    pub _unknown_8c: [u8; 4],
+    /// 0x90: X velocity in fixed-point
+    pub speed_x: Fixed,
+    /// 0x94: Y velocity in fixed-point
+    pub speed_y: Fixed,
+    /// 0x98-0xE7: Unknown gameplay fields
+    pub _unknown_98: [u8; 0x50],
+    /// 0xE8: Secondary vtable pointer (-> 0x669CF8 for CGameTask)
+    pub vtable2: Ptr32,
+}
+
+const _: () = assert!(core::mem::size_of::<CGameTask>() == 0xEC);

crates/openwa-types/src/weapon.rs

@@ -0,0 +1,94 @@
+/// Weapon types. Contiguous range 0-70.
+///
+/// Source: wkJellyWorm Constants.h
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(u32)]
+pub enum Weapon {
+    None = 0,
+    Bazooka = 1,
+    HomingMissile = 2,
+    Mortar = 3,
+    HomingPigeon = 4,
+    SheepLauncher = 5,
+    Grenade = 6,
+    ClusterBomb = 7,
+    BananaBomb = 8,
+    BattleAxe = 9,
+    Earthquake = 10,
+    Shotgun = 11,
+    Handgun = 12,
+    Uzi = 13,
+    Minigun = 14,
+    Longbow = 15,
+    FirePunch = 16,
+    DragonBall = 17,
+    Kamikaze = 18,
+    SuicideBomber = 19,
+    Prod = 20,
+    Dynamite = 21,
+    Mine = 22,
+    Sheep = 23,
+    SuperSheep = 24,
+    AquaSheep = 25,
+    MoleBomb = 26,
+    AirStrike = 27,
+    NapalmStrike = 28,
+    MailStrike = 29,
+    MineStrike = 30,
+    MoleSquadron = 31,
+    BlowTorch = 32,
+    PneumaticDrill = 33,
+    Girder = 34,
+    BaseballBat = 35,
+    GirderPack = 36,
+    NinjaRope = 37,
+    Bungee = 38,
+    Parachute = 39,
+    Teleport = 40,
+    ScalesOfJustice = 41,
+    SuperBanana = 42,
+    HolyGrenade = 43,
+    FlameThrower = 44,
+    SalvationArmy = 45,
+    MbBomb = 46,
+    PetrolBomb = 47,
+    Skunk = 48,
+    MingVase = 49,
+    SheepStrike = 50,
+    CarpetBomb = 51,
+    MadCow = 52,
+    OldWoman = 53,
+    Donkey = 54,
+    NuclearTest = 55,
+    Armageddon = 56,
+    SkipGo = 57,
+    Surrender = 58,
+    SelectWorm = 59,
+    Freeze = 60,
+    MagicBullet = 61,
+    JetPack = 62,
+    LowGravity = 63,
+    FastWalk = 64,
+    LaserSight = 65,
+    Invisibility = 66,
+    DamageX2 = 67,
+    CrateSpy = 68,
+    DoubleTurnTime = 69,
+    CrateShower = 70,
+}
+
+impl Weapon {
+    pub const COUNT: u32 = 71;
+}
+
+impl TryFrom<u32> for Weapon {
+    type Error = u32;
+
+    fn try_from(value: u32) -> Result<Self, Self::Error> {
+        if value < Self::COUNT {
+            Ok(unsafe { core::mem::transmute(value) })
+        } else {
+            Err(value)
+        }
+    }
+}

docs/plans/2026-03-05-openwa-foundation-design.md

@@ -0,0 +1,37 @@
+# OpenWA Foundation Design
+
+## Goal
+
+Build the type foundation for an incremental Rust reimplementation of Worms Armageddon 3.8.1 (Steam). Start with Ghidra-assisted reverse engineering and Rust type definitions, later expand to a WormKit module that replaces subsystems.
+
+## Strategy: Hybrid Bootstrap
+
+- **Constants/enums**: Translate immediately from wkJellyWorm's well-documented Constants.h (weapons, messages, sprites, sounds, class types)
+- **Struct layouts**: Explore in Ghidra first, write Rust types only for verified fields, pad unknowns
+
+## Architecture
+
+```
+OpenWA/                     (Cargo workspace)
+  crates/
+    openwa-types/           (no_std-compatible type definitions)
+      - Enums: ClassType, TaskMessage, Weapon, SoundId, SpriteId
+      - Structs: CTask, CGameTask (partial, Ghidra-verified)
+      - Primitives: FixedPoint (16.16 fixed-point math)
+      - Addresses: Known function/global addresses
+    openwa-wormkit/          (future: WormKit DLL module)
+    openwa-render/           (future: modern rendering backend)
+```
+
+## Key Decisions
+
+- `#[repr(C)]` and `#[repr(u32)]` for FFI compatibility from day one
+- Unknown struct fields as `_unknown_XX: [u8; N]` padding — honest about what we don't know
+- Fixed-point newtype rather than raw i32 — prevents unit confusion
+- No external dependencies in openwa-types (pure Rust, no_std compatible)
+
+## Sources
+
+- wkJellyWorm: Task hierarchy, enums, vtable layouts, offset documentation
+- WormKit: Game state pointers, network protocol, fixed-point conventions
+- Ghidra: WA.exe analysis (6,859 functions, image base 0x400000)

docs/re-notes/memory-map.md

@@ -0,0 +1,39 @@
+# Memory Map - WA.exe 3.8.1
+
+## Segments
+
+| Segment | Start      | End        | Size     | Description          |
+|---------|------------|------------|----------|----------------------|
+| Headers | 0x00400000 | 0x00400FFF | 4 KB     | PE headers           |
+| .text   | 0x00401000 | 0x00619FFF | ~2.1 MB  | Code                 |
+| .rdata  | 0x0061A000 | 0x00693FFF | ~484 KB  | Read-only data, vtables |
+| .data   | 0x00694000 | 0x008C4157 | ~2.2 MB  | Read-write globals   |
+| .rsrc   | 0x008C5000 | 0x00954FFF | ~576 KB  | Resources            |
+| .reloc  | 0x00955000 | 0x00983FFF | ~188 KB  | Relocations          |
+
+## Key Statistics
+
+- Total functions identified: 6,859
+- Image base: 0x00400000
+- 32-bit x86 PE, compiled with MSVC
+- Entry point: 0x005D8B6C (CRT startup)
+- Export: SetHostingProxyAddressAndPort @ 0x0058E380
+
+## DDGame structure access
+
+The main game state is accessed through the DDGame pointer:
+- DDGame obtained via `ConstructDDGameWrapper` (0x56DEF0) parameter
+- DDGame+0x08  → TurnGame object
+- DDGame+0x488 → Game global state
+- DDGame+0x4CC → PC_Landscape
+- DDGame+0x510 → Weapon table
+- DDGame+0x548 → Weapon panel
+
+## Fixed-point convention
+
+All coordinates, velocities, and physics values use 16.16 fixed-point:
+- `0x10000` = 1.0
+- `0x20000` = 2.0
+- `0xCCCC` ≈ 0.8
+- Positions stored as Fixed at CGameTask offsets 0x84 (X) and 0x88 (Y)
+- Velocities stored as Fixed at CGameTask offsets 0x90 (X) and 0x94 (Y)

docs/re-notes/task-hierarchy.md

@@ -0,0 +1,155 @@
+# Task Hierarchy - Worms Armageddon 3.8.1
+
+## Overview
+
+WA uses a hierarchical task/entity system. All game objects inherit from `CTask`,
+which forms a tree via parent/children pointers. Tasks communicate through a
+message passing system (see `TaskMessage` enum).
+
+## Class Hierarchy
+
+```
+CTask (base)                    vtable: 0x669F8C    ctor: 0x5625A0
+├── CGameTask                   vtable: 0x6641F8    ctor: 0x4FED50
+│   ├── CTaskWorm                                    ctor: 0x50BFB0
+│   ├── CTaskOldWorm                                 ctor: 0x51FEB0
+│   ├── CTaskMissile                                 ctor: 0x507D10
+│   ├── CTaskArrow                                   ctor: 0x4FE130
+│   ├── CTaskMine                                    ctor: 0x506660
+│   ├── CTaskCanister                                ctor: 0x501A80
+│   ├── CTaskCrate                                   ctor: 0x502490
+│   ├── CTaskOilDrum                                 ctor: 0x504AF0
+│   ├── CTaskCross                                   ctor: 0x5045C0
+│   └── CTaskLand                                    ctor: 0x505440
+├── CTaskFilter                                      ctor: 0x54F3D0
+├── CTaskTeam                                        ctor: 0x555BB0
+├── CTaskTurnGame                                    ctor: 0x55B280
+├── CTaskAirStrike                                   ctor: 0x5553C0
+├── CTaskDirt                                        ctor: 0x54EDC0
+├── CTaskFlame                                       ctor: 0x54F0F0
+├── CTaskFire                                        ctor: 0x54F4C0
+├── CTaskFireBall                                    ctor: 0x550890
+├── CTaskGas                                         ctor: 0x554750
+├── CTaskSmoke                                       ctor: 0x5551D0
+├── CTaskCloud                                       ctor: 0x5482E0
+├── CTaskSeaBubble                                   ctor: 0x554FE0
+├── CTaskScoreBubble                                 ctor: 0x554CA0
+├── CTaskCPU                                         ctor: 0x5485D0
+└── CTaskSpriteAnimation                             ctor: 0x5466C0
+```
+
+Note: Not all tasks are confirmed to inherit from CGameTask. The hierarchy
+above needs further verification via Ghidra analysis of each constructor.
+
+## CTask vtable (0x669F8C)
+
+| Index | Offset | Address    | Name (from wkJellyWorm) |
+|-------|--------|------------|-------------------------|
+| 0     | 0x00   | 0x562710   | vtable0 (init?)         |
+| 1     | 0x04   | 0x562620   | Free                    |
+| 2     | 0x08   | 0x562F30   | HandleMessage           |
+| 3     | 0x0C   | 0x5613D0   | unknown                 |
+| 4     | 0x10   | 0x5613D0   | unknown (=vt3)          |
+| 5     | 0x14   | 0x562FA0   | unknown                 |
+| 6     | 0x18   | 0x563000   | unknown                 |
+| 7     | 0x1C   | 0x563210   | ProcessFrame            |
+
+Note: wkJellyWorm says 7 methods but we see 8 entries. The 8th may be
+the start of CGameTask's extended vtable region, or the count was off by one.
+
+## CGameTask vtable (0x6641F8)
+
+First 3 entries override CTask:
+
+| Index | Offset | Address    | Name                    |
+|-------|--------|------------|-------------------------|
+| 0     | 0x00   | 0x4FF1C0   | vtable0 override        |
+| 1     | 0x04   | 0x4FEF10   | Free override           |
+| 2     | 0x08   | 0x4FF280   | HandleMessage override  |
+| 3     | 0x0C   | 0x5613D0   | (inherited from CTask)  |
+| 4     | 0x10   | 0x5613D0   | (inherited from CTask)  |
+| 5     | 0x14   | 0x562FA0   | (inherited from CTask)  |
+| 6     | 0x18   | 0x563000   | (inherited from CTask)  |
+| 7     | 0x1C   | 0x4FF720   | CGameTask-specific      |
+| 8     | 0x20   | 0x4FFED0   | CGameTask-specific      |
+| 9     | 0x24   | 0x500070   | CGameTask-specific      |
+| 10    | 0x28   | 0x500080   | CGameTask-specific      |
+| 11    | 0x2C   | 0x5000E0   | CGameTask-specific      |
+| 12    | 0x30   | 0x500380   | CGameTask-specific      |
+| 13    | 0x34   | 0x500360   | CGameTask-specific      |
+| 14    | 0x38   | 0x4FE060   | CGameTask-specific      |
+| 15    | 0x3C   | 0x500CC0   | CGameTask-specific      |
+| 16    | 0x40   | 0x592A50   | CGameTask-specific      |
+| 17    | 0x44   | 0x500090   | CGameTask-specific      |
+| 18    | 0x48   | 0x545780   | CGameTask-specific      |
+| 19    | 0x4C   | 0x4AA060   | CGameTask-specific      |
+
+CGameTask also has a secondary vtable at object offset 0xE8, pointing to 0x669CF8.
+
+## CTask memory layout (0x30 bytes)
+
+```
+Offset  Size  Field
+0x00    4     vtable pointer
+0x04    4     parent (CTask*)
+0x08    4     unknown (set to 0x10 in ctor)
+0x0C    4     children.max_size (init 0)
+0x10    4     children.unk4 (init 0)
+0x14    4     children.size
+0x18    4     children.data_ptr (allocated 0x60 bytes, zeroed 0x40)
+0x1C    4     children.hash_list
+0x20    4     class_type (ClassType enum)
+0x24    12    unknown padding
+```
+
+## CGameTask memory layout (0xEC bytes)
+
+Extends CTask at offset 0x00. Key fields discovered from constructor:
+
+```
+Offset  Size  Field
+0x00    0x30  CTask base
+0x20    4     class_type (set to 3 = GameCollisionTask in ctor)
+0x2C    4     param_3 from ctor
+0x30    4     param_3 (weapon id?)
+0x38    4     param_4
+0x3C    4     unknown
+...
+0x4C    4     = 0x10000 (Fixed 1.0)
+0x50    4     = 0x100000 (Fixed 16.0)
+0x54    4     = 0xCCCC (Fixed ~0.8)
+0x58    4     = 0x10000 (Fixed 1.0)
+0x5C    4     = 0
+0x60    4     = 0x10000 (Fixed 1.0)
+0x64    4     = 0x20000 (Fixed 2.0)
+0x68    4     = 0xF333 (Fixed ~0.95)
+...
+0x84    4     pos_x (Fixed)
+0x88    4     pos_y (Fixed)
+0x8C    4     = 0x10000 (Fixed 1.0, scale?)
+0x90    4     speed_x (Fixed)
+0x94    4     speed_y (Fixed)
+...
+0xCC    4     = 0x10000 (Fixed 1.0)
+0xD8    1     byte flag (init 0)
+0xD9    1     byte flag (init 0)
+0xE0    4     unknown (init 0)
+0xE4    4     unknown (init 0)
+0xDC    4     unknown (init 0)
+0xE8    4     secondary vtable pointer -> 0x669CF8
+```
+
+## Physics defaults from CGameTask constructor
+
+Several fixed-point constants are set in the constructor, likely physics defaults:
+- `0x10000` = 1.0 (appears at many offsets — scale factors, gravity?)
+- `0x100000` = 16.0 (mass? terminal velocity?)
+- `0xCCCC` ≈ 0.8 (friction? damping?)
+- `0x20000` = 2.0
+- `0xF333` ≈ 0.95 (air resistance?)
+- `0x3333` ≈ 0.2
+- `0x4CCC` ≈ 0.3
+- `0xFEB8` ≈ 0.995
+- `0x9999` ≈ 0.6
+- `0x3AE1` ≈ 0.23
+- `0xFC000000` = -67108864 (large negative, possibly a boundary?)