Difference between revisions of "Thing"

From DoomWiki.org

[unchecked revision][checked revision]
m (Doom 64 flags: fix bit number)
(33 intermediate revisions by 15 users not shown)
Line 1: Line 1:
'''Things''' represent [[player]]s, [[monster]]s, [[pick-up]]s, and [[projectile]]s. Inside the game, these are known as actors.  
+
'''Things''' represent [[player]]s, [[monster]]s, [[pick-up]]s, and [[projectile]]s. Inside the game, these are known as actors, or [[mobj]]s. They also represent obstacles, certain decorations, player start positions and [[teleporter|teleport]] landing sites.  
  
DoomEd numbers are the numbers used in the editor to represent an actor. When the map is loaded, an actor that corresponds to that number will be spawned at the location of that map thing. Although many actors have DoomEd numbers, not all of them do. For instance, a blue key card has a DoomEd number, but a rocket flying through the air does not.
+
While some mobjs, such as projectiles and special effects, can only be created during play, most things can be placed in a map from a map editor through an associated editor number. When the map is loaded, an actor that corresponds to that number will be spawned at the location of that map thing. See [[thing types]] for a listing of all things that have an associated editor number.
  
 
==THINGS lump==
 
==THINGS lump==
 
+
{{Doom level format}}
Level thing data is stored in the <tt>THINGS</tt> lump.
+
Level thing data is stored in the {{c|THINGS}} [[lump]]. Each entry is 10 bytes long. This format is used by both [[Doom]] and [[Heretic]].
{| {{prettytable}}
+
{| {{prettytable|style=text-align: center;}}
!Offset
+
! Offset
!Size (bytes)
+
! Size (bytes)
!Description
+
! C99 type
 +
! Description
 
|-
 
|-
|0||2||X position
+
| 0 || 2 || int16_t
 +
| style="text-align: left;" | ''x'' position
 
|-
 
|-
|2||2||Y position
+
| 2 || 2 || int16_t
 +
| style="text-align: left;" | ''y'' position
 
|-
 
|-
|4||2||Angle facing
+
| 4 || 2 || int16_t
 +
| style="text-align: left;" | [[Angle]] facing
 
|-
 
|-
|6||2||DoomEd thing type
+
| 6 || 2 || int16_t
|-
+
| style="text-align: left;" | DoomEd [[thing type]]
|8||2||Flags
 
 
|-
 
|-
 +
| 8 || 2 || int16_t
 +
| style="text-align: left;" | Flags
 
|}
 
|}
 +
 
===Flags===
 
===Flags===
  
Line 27: Line 33:
 
!bit||hex||description
 
!bit||hex||description
 
|-
 
|-
|0||0x0001||Thing is on skill levels 1 &amp; 2
+
|0||0x0001||Thing is on [[Skill level#Doom and Doom II skill levels|skill levels]] 1 &amp; 2
 
|-
 
|-
 
|1||0x0002||Thing is on skill level 3
 
|1||0x0002||Thing is on skill level 3
Line 33: Line 39:
 
|2||0x0004||Thing is on skill levels 4 &amp; 5
 
|2||0x0004||Thing is on skill levels 4 &amp; 5
 
|-
 
|-
|3||0x0008||Thing is deaf
+
|3||0x0008||Thing is waiting in ambush. Commonly known as "deaf" flag.<br>In fact, it [[Monster_behavior#Initial_state_and_alertness|does not render monsters deaf]] per se. 
 
|-
 
|-
 
|4||0x0010||Thing is not in single player
 
|4||0x0010||Thing is not in single player
|-
 
 
|}
 
|}
  
Line 49: Line 54:
 
|-
 
|-
 
|6||0x0040||Thing is not in coop
 
|6||0x0040||Thing is not in coop
 +
|}
 +
 +
===MBF flag===
 +
 +
[[MBF]] adds the flag:
 +
 +
{| {{prettytable}}
 +
!bit||hex||description
 
|-
 
|-
 
|7||0x0080||Friendly monster
 
|7||0x0080||Friendly monster
 
|}
 
|}
  
==ZDoom editing==
+
==Hexen Format==
 +
[[Hexen]] extended upon the things lump.  Hexen things may contain an action special which is executed upon death or pickup of the thing (for monsters and items, respectively).  Hexen format also introduced true [[z-clipping]], allowing placement of monsters on the z-axis.  Finally, Hexen monsters are also able to have a tag similar to sectors.  This is called the thing ID or TID.
  
[[Spawn number]]s are the numbers used by specials such as [[Thing Spawn]] to spawn actors in the game once the user has started playing the map. Although DoomEd numbers and spawn numbers both describe actors, they are not interchangeable&mdash;you must not use a spawn number on a map thing, and you must not use a DoomEd number for instance as a Thing_Spawn parameter.
+
{| {{prettytable|style=text-align: center;}}
 +
! Offset
 +
! Size (bytes)
 +
! C99 type
 +
! Description
 +
|-
 +
| 0 || 2 || int16_t
 +
| style="text-align: left;" | Thing id (tid)
 +
|-
 +
| 2 || 2 || int16_t
 +
| style="text-align: left;" | X position
 +
|-
 +
| 4 || 2 || int16_t
 +
| style="text-align: left;" | Y position
 +
|-
 +
| 6 || 2 || int16_t
 +
| style="text-align: left;" | Starting height
 +
|-
 +
| 8 || 2 || int16_t
 +
| style="text-align: left;" | Angle facing
 +
|-
 +
| 10 || 2 || int16_t
 +
| style="text-align: left;" | DoomEd thing type
 +
|-
 +
| 12 || 2 || int16_t
 +
| style="text-align: left;" | Flags
 +
|-
 +
| 14 || 1 || uint8_t
 +
| style="text-align: left;" | [[Hexen action special]]
 +
|-
 +
| 15 || 1 || uint8_t
 +
| style="text-align: left;" | Argument 1
 +
|-
 +
| 16 || 1 || uint8_t
 +
| style="text-align: left;" | Argument 2
 +
|-
 +
| 17 || 1 || uint8_t
 +
| style="text-align: left;" | Argument 3
 +
|-
 +
| 18 || 1 || uint8_t
 +
| style="text-align: left;" | Argument 4
 +
|-
 +
| 19 || 1 || uint8_t
 +
| style="text-align: left;" | Argument 5
 +
|}
 +
 
 +
Note that Hexen things are 20 bytes in size; 10 bytes larger than things in Doom.
  
[[classes|Actor Names]] are the actual names each actor has internally (to test these you may want to try out the [[summon]] console command).  These are used with the functions [[SpawnSpot]] and [[Spawn]] which allow you to spawn any actor available with [[Thing_Spawn]] and also all other actors (though some actors aren't meant to be spawned) such as cameras, scenery or whatever you might require.
+
===Hexen flags===
  
If you create a new actor with the [[DECORATE]] lump, you can specify both the spawn number (SpawnNum), and the DoomEd number (DoomEdNum).  The name you give the new [[DECORATE]] item is also its actor name, so you can also spawn it using that.
+
{| {{prettytable}}
 +
!bit||hex||description
 +
|-
 +
|0||0x0001||Thing is on [[Skill level#Hexen skill levels|skill levels]] 1 &amp; 2
 +
|-
 +
|1||0x0002||Thing is on skill level 3
 +
|-
 +
|2||0x0004||Thing is on skill levels 4 &amp; 5
 +
|-
 +
|3||0x0008||Thing is waiting in ambush
 +
|-
 +
|4||0x0010||Thing is dormant - it will not wake up until it is activated using Thing_Activate
 +
|-
 +
|5||0x0020||Thing appears to the [[Fighter]] class
 +
|-
 +
|6||0x0040||Thing appears to the [[Cleric]] class
 +
|-
 +
|7||0x0080||Thing appears to the [[Mage]] class
 +
|-
 +
|8||0x0100||Thing appears in single-player games
 +
|-
 +
|9||0x0200||Thing appears in cooperative games
 +
|-
 +
|10||0x0400||Thing appears in deathmatch games
 +
|}
  
===THINGS structure===
+
==Strife Format==
 +
[[Strife]] did not alter the thing structure like Hexen did, however it did make use of the unused flag bits.
  
 +
===Strife flags===
 
{| {{prettytable}}
 
{| {{prettytable}}
!Offset
+
!bit||hex||description
!Size (bytes)
+
|-
!Description
+
|0||0x0001||Thing is on [[Skill level#Strife skill levels|skill levels]] 1 &amp; 2
 
|-
 
|-
|0||2||Thing id (tid)
+
|1||0x0002||Thing is on skill level 3
 
|-
 
|-
|2||2||X position
+
|2||0x0004||Thing is on skill levels 4 &amp; 5
 
|-
 
|-
|4||2||Y position
+
|3||0x0008||Thing stands still (only useful for specific enemies)
 
|-
 
|-
|6||2||Starting height
+
|4||0x0010||Thing will not appear in single player
 
|-
 
|-
|8||2||Angle facing
+
|5||0x0020||Thing is waiting in ambush
 
|-
 
|-
|10||2||DoomEd thing type
+
|6||0x0040||Thing is a friendly monster
 
|-
 
|-
|12||2||Flags (see below)
+
|7||0x0080||Unused
 
|-
 
|-
|14||1||Hexen/ZDoom special type
+
|8||0x0100||Thing is 25% translucent
 
|-
 
|-
|15||1||Argument 1
+
|9||0x0200||Thing is either invisible, or 75% translucent if combined with bit 8.
 +
|}
 +
 
 +
==Doom 64 format==
 +
The [[Doom 64]] THING format is similar to the Doom format except for the inclusion of a ''z'' position and an ID. Each entry is 14 bytes long.
 +
{| {{prettytable|style=text-align: center;}}
 +
! Offset
 +
! Size (bytes)
 +
! C99 type
 +
! Description
 
|-
 
|-
|16||1||Argument 2
+
| 0 || 2 || int16_t
 +
| style="text-align: left;" | ''x'' position
 
|-
 
|-
|17||1||Argument 3
+
| 2 || 2 || int16_t
 +
| style="text-align: left;" | ''y'' position
 
|-
 
|-
|18||1||Argument 4
+
| 4 || 2 || int16_t
 +
| style="text-align: left;" | ''z'' position
 
|-
 
|-
|19||1||Argument 5
+
| 6 || 2 || int16_t
 +
| style="text-align: left;" | [[Angle]] facing
 +
|-
 +
| 8 || 2 || int16_t
 +
| style="text-align: left;" | DoomEd [[thing type]]
 +
|-
 +
| 10 || 2 || int16_t
 +
| style="text-align: left;" | Flags
 +
|-
 +
| 12 || 2 || int16_t
 +
| style="text-align: left;" | ID
 
|}
 
|}
  
Doom Format things are 10 bytes in size, while Hexen/ZDoom format things are 20 bytes in size.
+
===Doom 64 flags===
 +
Additional flags are defined in comparison to the Doom format, however flags 10 through 12 are not used in any Doom 64 maps.
  
===Flags===
+
{| {{prettytable}}
 +
!bit||hex||description
 +
|-
 +
|0||0x0001||Thing is on [[Skill level#Doom 64 skill levels|skill levels]] 1 &amp; 2
 +
|-
 +
|1||0x0002||Thing is on skill level 3
 +
|-
 +
|2||0x0004||Thing is on skill level 4
 +
|-
 +
|3||0x0008||Thing is waiting in ambush
 +
|-
 +
|4||0x0010||Thing is not in single player
 +
|-
 +
|5||0x0020||Thing doesn't spawn until triggered in level
 +
|-
 +
|6||0x0040||Thing triggers something when picked up
 +
|-
 +
|7||0x0080||Thing triggers something when killed
 +
|-
 +
|8||0x0100||Thing counts as secret in [[intermission]] screen
 +
|-
 +
|9||0x0200||Thing ignores other attackers (no [[infighting]])
 +
|-
 +
|10||0x0400||Thing doesn't spawn in deathmatch games
 +
|-
 +
|11||0x0800||Thing doesn't in standard netgame mode
 +
|-
 +
|12||0x1000||Thing appears in nightmare mode ([[KEX Engine]])
 +
|}
  
<table border cellpadding=2>
+
==Sources==
<tr align=center>
+
* [[Unofficial Doom Specs]]
<td>bit</td> <td>hex</td> <td>description</td>
+
* [[Boom]] source code: <tt>boomref.txt</tt>
</tr>
+
* {{idgames|file=docs/editing/d64techbible|title=Doom 64 Tech Bible}}
<tr align=left>
 
<td>0</td><td>0x0001</td><td>Thing is on Skill levels 1 &amp; 2</td>
 
</tr>
 
<tr align=left>
 
<td>1</td><td>0x0002</td><td>Thing is on Skill level 3</td>
 
</tr>
 
<tr align=left>
 
<td>2</td><td>0x0004</td><td>Thing is on Skill levels 4 &amp; 5</td>
 
</tr>
 
<tr align=left>
 
<td>3</td><td>0x0008</td><td>Thing is Deaf</td>
 
</tr>
 
<tr align=left>
 
<td>4</td><td>0x0010</td><td>Thing is dormant until activated</td>
 
</tr>
 
<tr align=left>
 
<td>8</td><td>0x0100</td><td>Thing is in Single Player</td>
 
</tr>
 
<tr align=left>
 
<td>9</td><td>0x0200</td><td>Thing is in Co-Op</td>
 
</tr>
 
<tr align=left>
 
<td>10</td><td>0x0400</td><td>Thing is in Deathmatch</td>
 
</tr>
 
<tr align=left>
 
<td>11</td><td>0x0800</td><td>Thing is 25% translucent</td>
 
</tr>
 
<tr align=left>
 
<td>12</td><td>0x1000</td><td>Makes the thing invisible</td>
 
</tr>
 
<tr align=left>
 
<td>13</td><td>0x2000</td><td>Friendly monster</td>
 
</tr>
 
<tr align=left>
 
<td>14</td><td>0x4000</td><td>Thing stands still (only useful for specific Strife monsters or friendlies)</td>
 
</tr>
 
</table>
 
  
Strife
 
<table border cellpadding=2>
 
<tr align=center>
 
<td>bit</td> <td>hex</td> <td>description</td>
 
</tr>
 
<tr align=left>
 
<td>0</td><td>0x0001</td><td>Thing is on Skill levels 1 &amp; 2</td>
 
</tr>
 
<tr align=left>
 
<td>1</td><td>0x0002</td><td>Thing is on Skill level 3</td>
 
</tr>
 
<tr align=left>
 
<td>2</td><td>0x0004</td><td>Thing is on Skill levels 4 &amp; 5</td>
 
</tr>
 
<tr align=left>
 
<td>3</td><td>0x0008</td><td>Thing stands still (only useful for specific Strife monsters)</td>
 
</tr>
 
<tr align=left>
 
<td>4</td><td>0x0010</td><td>Thing is not in Single player</td>
 
</tr>
 
<tr align=left>
 
<td>5</td><td>0x0020</td><td>Thing is Deaf</td>
 
</tr>
 
<tr align=left>
 
<td>6</td><td>0x0040</td><td>Friendly monster</td>
 
</tr>
 
<tr align=left>
 
<td>8</td><td>0x0100</td><td>Thing is 25% translucent</td>
 
</tr>
 
<tr align=left>
 
<td>9</td><td>0x0200</td><td>Makes the thing invisible</td>
 
</tr>
 
</table></td>
 
 
[[Category:Doom engine]]
 
[[Category:Doom engine]]
 +
[[Category:WAD lumps]]
 +
[[Category:Lists]]

Revision as of 08:46, 25 July 2020

Things represent players, monsters, pick-ups, and projectiles. Inside the game, these are known as actors, or mobjs. They also represent obstacles, certain decorations, player start positions and teleport landing sites.

While some mobjs, such as projectiles and special effects, can only be created during play, most things can be placed in a map from a map editor through an associated editor number. When the map is loaded, an actor that corresponds to that number will be spawned at the location of that map thing. See thing types for a listing of all things that have an associated editor number.

THINGS lump

Doom level format

Level thing data is stored in the THINGS lump. Each entry is 10 bytes long. This format is used by both Doom and Heretic.

Offset Size (bytes) C99 type Description
0 2 int16_t x position
2 2 int16_t y position
4 2 int16_t Angle facing
6 2 int16_t DoomEd thing type
8 2 int16_t Flags

Flags

bit hex description
0 0x0001 Thing is on skill levels 1 & 2
1 0x0002 Thing is on skill level 3
2 0x0004 Thing is on skill levels 4 & 5
3 0x0008 Thing is waiting in ambush. Commonly known as "deaf" flag.
In fact, it does not render monsters deaf per se.
4 0x0010 Thing is not in single player

Boom flags

Boom adds the flags:

bit hex description
5 0x0020 Thing is not in deathmatch
6 0x0040 Thing is not in coop

MBF flag

MBF adds the flag:

bit hex description
7 0x0080 Friendly monster

Hexen Format

Hexen extended upon the things lump. Hexen things may contain an action special which is executed upon death or pickup of the thing (for monsters and items, respectively). Hexen format also introduced true z-clipping, allowing placement of monsters on the z-axis. Finally, Hexen monsters are also able to have a tag similar to sectors. This is called the thing ID or TID.

Offset Size (bytes) C99 type Description
0 2 int16_t Thing id (tid)
2 2 int16_t X position
4 2 int16_t Y position
6 2 int16_t Starting height
8 2 int16_t Angle facing
10 2 int16_t DoomEd thing type
12 2 int16_t Flags
14 1 uint8_t Hexen action special
15 1 uint8_t Argument 1
16 1 uint8_t Argument 2
17 1 uint8_t Argument 3
18 1 uint8_t Argument 4
19 1 uint8_t Argument 5

Note that Hexen things are 20 bytes in size; 10 bytes larger than things in Doom.

Hexen flags

bit hex description
0 0x0001 Thing is on skill levels 1 & 2
1 0x0002 Thing is on skill level 3
2 0x0004 Thing is on skill levels 4 & 5
3 0x0008 Thing is waiting in ambush
4 0x0010 Thing is dormant - it will not wake up until it is activated using Thing_Activate
5 0x0020 Thing appears to the Fighter class
6 0x0040 Thing appears to the Cleric class
7 0x0080 Thing appears to the Mage class
8 0x0100 Thing appears in single-player games
9 0x0200 Thing appears in cooperative games
10 0x0400 Thing appears in deathmatch games

Strife Format

Strife did not alter the thing structure like Hexen did, however it did make use of the unused flag bits.

Strife flags

bit hex description
0 0x0001 Thing is on skill levels 1 & 2
1 0x0002 Thing is on skill level 3
2 0x0004 Thing is on skill levels 4 & 5
3 0x0008 Thing stands still (only useful for specific enemies)
4 0x0010 Thing will not appear in single player
5 0x0020 Thing is waiting in ambush
6 0x0040 Thing is a friendly monster
7 0x0080 Unused
8 0x0100 Thing is 25% translucent
9 0x0200 Thing is either invisible, or 75% translucent if combined with bit 8.

Doom 64 format

The Doom 64 THING format is similar to the Doom format except for the inclusion of a z position and an ID. Each entry is 14 bytes long.

Offset Size (bytes) C99 type Description
0 2 int16_t x position
2 2 int16_t y position
4 2 int16_t z position
6 2 int16_t Angle facing
8 2 int16_t DoomEd thing type
10 2 int16_t Flags
12 2 int16_t ID

Doom 64 flags

Additional flags are defined in comparison to the Doom format, however flags 10 through 12 are not used in any Doom 64 maps.

bit hex description
0 0x0001 Thing is on skill levels 1 & 2
1 0x0002 Thing is on skill level 3
2 0x0004 Thing is on skill level 4
3 0x0008 Thing is waiting in ambush
4 0x0010 Thing is not in single player
5 0x0020 Thing doesn't spawn until triggered in level
6 0x0040 Thing triggers something when picked up
7 0x0080 Thing triggers something when killed
8 0x0100 Thing counts as secret in intermission screen
9 0x0200 Thing ignores other attackers (no infighting)
10 0x0400 Thing doesn't spawn in deathmatch games
11 0x0800 Thing doesn't in standard netgame mode
12 0x1000 Thing appears in nightmare mode (KEX Engine)

Sources