# 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
├── CTaskGirder (was 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?)