OBPOS.DAT

This file is used by the tactical game engine to record the location of items. Each record is made up of 16 single byte values. UFO has 170 records (for a total 2,720 bytes), and TFTD has 200 (for a total of 3,200 bytes). It comes in three flavours:

• OBPOSREF.DAT
  

Initially created by the GeoScape engine and stored in the MISSDAT folder. Contains info required for Battlescape Map Generation. Unlike the other two versions, this only contains the bare minimum number of records required to store the items it details.

• OBPOS.DAT
  

Created along with a battlescape save, contains the mid-mission state of the object table.

• OBPOS2.DAT
  

Appears in the MISSDAT folder at the end of combat. Used to determine what equipment is to be returned back to the base stores (though base/UFO components are listed in MISSION2.DAT. See Equipment Recovery for more info).

Values are presented according to the byte offset within each record (0 to 15) followed by the equivalent hex offset (00 to 0F) in bold. Let us know what else you can find!!

Structure

0/00: Object type (Object is the item ID# in geodata\obdata.dat). Value of 255/-1 = item in this slot is meant to be unused or destroyed. See OBDATA.DAT for a list of possibilities.

1/01: Y coordinate when on the ground.

2/02: X coordinate when on the ground.

3/03: Z coordinate when on the ground.

The three above values are meant to tell the game where the items physically are. They determine where an unconcious unit will wake up. They tell the game where to centre an explosion for area effect items.

Oddly enough, these values ARE NOT UPDATED when in inventory. All items that start in your inventory default to the equipment pile. All items that start in the alien inventories are at location (0,0,0).

4/04: Owner of item. References the units in unitpos. First unit unit index is 0, naturally. Just tells the game who's holding the current item. If 255 = object will be on the ground.

5/05: Inventory slot (from left to right):

Slot(s)	Area
0	Right Hand
1	Left Hand
2-3	Right Leg
4-5	Left Leg
6-7	Right Shoulder
8-9	Left Shoulder
10-18	Back Pack
19-24	Belt

WARNING: If adding an item to the hand slots, remember to update the hand slot images in UNITREF for the soldier involved.

Note that if an alien doesn't need an object in the hand(s), it'll move it to slot 2 (regardless of the size or if the slot is vacant). It's unknown as to whether aliens use TUs to move items.

6/06: Object the current item is loaded into. -1/255 by default for no item. (Uses obpos item index - first object in obpos is 0).

7/07: -1/255 by default, otherwise 0 if the item is loaded into something.

8/08: Item Quantity 1:

For Ammo: Ammo quantity.

For Medikits: Painkillers remaining.

For Unconscious 'corpses': Index to UNITPOS.DAT, Also see offset 12

For Grenade: 'Turn to detonate on' trigger (0 = grenade object has not been primed).

Non zero positive value = What turn to explode on. Grenade will explode if current 'turn' is equal or greater than this number. See WGLOB.DAT for No. of turns.

When priming grenades this is set to the current turn number +1 for every additional turn added onto the timer. Refer to wglob for current number of turns. (Uses actual turns, not turns/2)

9/09: Item Quantity 2:

For Medikits: Stimulants remaining.

For Grenades: Ownership flag (unitpos reference). For remembering who last threw the live grenade. For morale loss calculations and for determining the soldier's combat experience. Refers to unit 0 by default. Refers to unit in unitpos.

10/0A: Item Quantity 3:

Medikit's Heal uses remaining.

11/0B: This is a direct copy of offset[48] from the MCD record (see TERRAIN) of the tile the unit is standing on. A signed byte.

12/0C: Some kind of bitfield, seems to change with the inventory view --Pi Masta 15:48, 14 February 2007 (PST)

Bit 0 On - object has been on the ground this turn, Off - object has not touched the ground this turn
Bit 1 On - seems to only flag with bit 0 and after you have selected another soldier or have thrown it
Bit 2 On - was seen in last inventory view , off - wasn't seen in last inventory view
Bit 3 Flags on for unconscious units (corpse), offset 8 will point to UNITPOS.DAT index of unit
Bit 4 ??                                          --Pi Masta
Bit 5 ??
Bit 6 ??
Bit 7 ??

Usually 224 (-32?) or 227 (-35?), though other values have been observed.

Some of these may have something to do with whether an item should appear on the ground view of the inventory display. If you hit the arrow thingy to display extra items on the ground, those which have already been displayed aren't rendered again until the full set has been shown, or until you re-enter the inventory display, check another soldier, etc... - Bomb Bloke 23:32, 9 June 2007 (PDT)

11100000 - 224
11100011 - 227

13/0D: Presumed unused.

14/0E: Presumed unused.

15/0F: Presumed unused.

See Also

• Saved Game Files
• Battlescape Map Generation