Loot (.ITS) File Format - Revision history

Heinermann: /* container_state */ possible state

2025-08-01T00:44:27Z

container_state: possible state

← Older revision		Revision as of 00:44, 1 August 2025
Line 79:		Line 79:
	\|-		\|-
	\| 07 \|\| Tidal (Sunken Ship chests that are on land at night and underwater during day.)		\| 07 \|\| Tidal (Sunken Ship chests that are on land at night and underwater during day.)
			\|-
			\| 09 \|\| Physics?
	\|-		\|-
	\| 13 \|\| On Land (Pots only, but some are 00 or 03, so what's the difference?)		\| 13 \|\| On Land (Pots only, but some are 00 or 03, so what's the difference?)

Heinermann: /* container_type */ add container type IDs

2025-07-31T23:29:14Z

container_type: add container type IDs

← Older revision		Revision as of 23:29, 31 July 2025
Line 85:		Line 85:
	===container_type===		===container_type===
	{\| class="wikitable dataStructure"		{\| class="wikitable dataStructure"
	! Value !! Meaning		! Value !! Meaning !! Object ID created
	\|-		\|-
	\| 00 \|\| Free-standing		\| 00 \|\| Free-standing \|\| N/A
	\|-		\|-
	\| 01 \|\| Sasa Chest		\| 01 \|\| Sasa Chest \|\| {{ObjID\|B1E}}
	\|-		\|-
	\| 02 \|\| Pot		\| 02 \|\| Pot \|\| {{ObjID\|B39}}
	\|-		\|-
	\| 03 \|\| Wooden Horse		\| 03 \|\| Wooden Horse \|\| {{ObjID\|B38}}
	\|-		\|-
	\| 04 \|\| Chest		\| 04 \|\| Chest \|\| {{ObjID\|B4B}}
	\|-		\|-
	\| 05 \|\| Gale Shrine Chest		\| 05 \|\| Gale Shrine Chest \|\| {{ObjID\|B4C}}
	\|-		\|-
	\| 06 \|\| Clover		\| 06 \|\| Clover \|\| {{ObjID\|B44}}
	\|-		\|-
	\| 07 \|\| Grass		\| 07 \|\| Grass \|\| {{ObjID\|B3E}}
	\|-		\|-
	\| 08 \|\| Watermelon		\| 08 \|\| Watermelon \|\| {{ObjID\|B41}}
	\|-		\|-
	\| 09 \|\| Locked Box		\| 09 \|\| Locked Box \|\| {{ObjID\|840}}
	\|-		\|-
	\| 0a \|\| Bloom Pod		\| 0a \|\| Bloom Pod \|\| {{ObjID\|B4F}}
	\|-		\|-
	\| 0b \|\| Guardian Fruit		\| 0b \|\| Guardian Fruit \|\| {{ObjID\|373}}
	\|-		\|-
	\| 0c \|\| Electric Chest		\| 0c \|\| Electric Chest \|\| {{ObjID\|B50}}
	\|-		\|-
	\| 0d \|\| Clam Shell		\| 0d \|\| Clam Shell \|\| {{ObjID\|B51}}
	\|-		\|-
	\| 0e \|\| Flower		\| 0e \|\| Flower \|\| {{ObjID\|B29}}
	\|-		\|-
	\| 0f \|\| Flaming Chest		\| 0f \|\| Flaming Chest \|\| {{ObjID\|890}}
	\|-		\|-
	\| 10 \|\| One-eyed Doll		\| 10 \|\| One-eyed Doll \|\| {{ObjID\|9FB}}
	\|-		\|-
	\| 11 \|\| Frozen Chest		\| 11 \|\| Frozen Chest \|\| {{ObjID\|B53}}
	\|-		\|-
	\| 12 \|\| Crystal PS3 Rock		\| 12 \|\| Crystal PS3 Rock \|\| {{ObjID\|B70}}
	\|-		\|-
	\| 13 \|\| Iron PS2 Rock		\| 13 \|\| Iron PS2 Rock \|\| {{ObjID\|B71}}
	\|}		\|}

Heinermann: /* ITSEntry */ item param is 4 bytes

2025-07-31T23:00:19Z

ITSEntry: item param is 4 bytes

← Older revision		Revision as of 23:00, 31 July 2025
Line 53:		Line 53:
	\| 23 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 23 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
	\|-		\|-
	\| 24 \|\| 1 \|\| ~~uint8~~ \|\| \|\| Item parameter. Depends on the item.		\| 24 \|\| 4 \|\| uint32 \|\| \|\| Item parameter. Depends on the item.
	* '''Stray Bead''': bitfield index for the [[Save_File_(OKAMI)_File_Format#Collection_Data\|Collection Data]] struct.		* '''Stray Bead''': bitfield index for the [[Save_File_(OKAMI)_File_Format#Collection_Data\|Collection Data]] struct.
	* '''Praise (Clover)''': amount of praise granted.		* '''Praise (Clover)''': amount of praise granted.
	\|-		\|-
	\| 25 \|\| 15 \|\| uint8 array \|\| padding \|\| All 00.		\| 28 \|\| 12 \|\| uint8 array \|\| padding \|\| All 00.
	\|}		\|}

Heinermann: /* ITSEntry */ coordinates is signed

2025-07-31T22:52:21Z

ITSEntry: coordinates is signed

← Older revision		Revision as of 22:52, 31 July 2025
Line 35:		Line 35:
	\| 7 \|\| 3 \|\| PackedTuple<uint8> \|\| rotation \|\| Rotation around axis (x, y, z).		\| 7 \|\| 3 \|\| PackedTuple<uint8> \|\| rotation \|\| Rotation around axis (x, y, z).
	\|-		\|-
	\| 10 \|\| 6 \|\| PackedTuple<~~uint16~~> \|\| coordinates \|\| Location of container (x, y, z)		\| 10 \|\| 6 \|\| PackedTuple<int16> \|\| coordinates \|\| Location of container (x, y, z)
	\|-		\|-
	\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.		\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.

Heinermann: /* ITSEntry */ fix typo

2025-07-31T01:55:22Z

ITSEntry: fix typo

← Older revision		Revision as of 01:55, 31 July 2025
Line 47:		Line 47:
	\| 20 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 20 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
	\|-		\|-
	\| 21 \|\| 1 \|\| uint8 \|\| \|\| No respawn. ~~Forced~~ include this entry in the [[Save_File_(OKAMI)_File_Format#Map_Data\|Map Data collection bitfield]].		\| 21 \|\| 1 \|\| uint8 \|\| \|\| No respawn. Force include this entry in the [[Save_File_(OKAMI)_File_Format#Map_Data\|Map Data collection bitfield]].
	\|-		\|-
	\| 22 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 22 \|\| 1 \|\| uint8 \|\| \|\| Unknown.

Heinermann: areas restored and item param

2025-07-31T01:49:30Z

areas restored and item param

← Older revision		Revision as of 01:49, 31 July 2025
Line 39:		Line 39:
	\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.		\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.
	\|-		\|-
	\| 17 \|\| 1 \|\| uint8 \|\| \|\| ~~Unknown~~.		\| 17 \|\| 1 \|\| uint8 \|\| \|\| Area restored spawn requirement. Subtract 1 (since 0 means none) and add 16 to match the index for [[Save_File_(OKAMI)_File_Format#Map_Data\|areas restored map data]].
	\|-		\|-
	\| 18 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 18 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
Line 53:		Line 53:
	\| 23 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 23 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
	\|-		\|-
	\| 24 \|\| 1 \|\| uint8 \|\| \|\| Stray ~~bead~~ bitfield index for the [[Save_File_(OKAMI)_File_Format#Collection_Data\|Collection Data]] struct.		\| 24 \|\| 1 \|\| uint8 \|\| \|\| Item parameter. Depends on the item.
			* '''Stray Bead''': bitfield index for the [[Save_File_(OKAMI)_File_Format#Collection_Data\|Collection Data]] struct.
			* '''Praise (Clover)''': amount of praise granted.
	\|-		\|-
	\| 25 \|\| 15 \|\| uint8 array \|\| padding \|\| All 00.		\| 25 \|\| 15 \|\| uint8 array \|\| padding \|\| All 00.

Heinermann: /* ITSEntry */ collection info

2025-07-31T01:30:15Z

ITSEntry: collection info

← Older revision		Revision as of 01:30, 31 July 2025
Line 18:		Line 18:

	===ITSEntry===		===ITSEntry===
	Describes a single piece of loot.		Describes a single piece of loot. Chests and clovers are automatically included in the [[Save_File_(OKAMI)_File_Format#Map_Data\|Map Data collection bitfield]], the index is in the order they appear in this file, and incremented only when a collectable is encountered.

	{\| class="wikitable dataStructure"		{\| class="wikitable dataStructure"
Line 47:		Line 47:
	\| 20 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 20 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
	\|-		\|-
	\| 21 \|\| 1 \|\| uint8 \|\| \|\| ~~Unknown~~.		\| 21 \|\| 1 \|\| uint8 \|\| \|\| No respawn. Forced include this entry in the [[Save_File_(OKAMI)_File_Format#Map_Data\|Map Data collection bitfield]].
	\|-		\|-
	\| 22 \|\| 1 \|\| uint8 \|\| \|\| Unknown.		\| 22 \|\| 1 \|\| uint8 \|\| \|\| Unknown.

Heinermann: /* ITSEntry */ stray bead value

2025-07-31T01:20:15Z

ITSEntry: stray bead value

← Older revision		Revision as of 01:20, 31 July 2025
Line 39:		Line 39:
	\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.		\| 16 \|\| 1 \|\| uint8 \|\| container_type \|\| See below for values.
	\|-		\|-
	\| 17 \|\| 8 \|\| uint8 ~~array~~ \|\| ~~unknowns~~ \|\| Unknown.		\| 17 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 18 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 19 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 20 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 21 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 22 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 23 \|\| 1 \|\| uint8 \|\| \|\| Unknown.
			\|-
			\| 24 \|\| 1 \|\| uint8 \|\| \|\| Stray bead bitfield index for the [[Save_File_(OKAMI)_File_Format#Collection_Data\|Collection Data]] struct.
	\|-		\|-
	\| 25 \|\| 15 \|\| uint8 array \|\| padding \|\| All 00.		\| 25 \|\| 15 \|\| uint8 array \|\| padding \|\| All 00.

Heinermann: file format category

2025-06-23T17:15:39Z

file format category

← Older revision		Revision as of 17:15, 23 June 2025
Line 1:		Line 1:
	{{RE}}		{{File Format}}

	==Explanation==		==Explanation==

Whataboutclyde: Loot file format (ITS)

2022-11-22T03:45:58Z

Loot file format (ITS)

New page

{{RE}}

==Explanation==

This file defines all guaranteed loot locations on a single map.

==File Format==
===Overall===
{| class="wikitable dataStructure"
! Start (Byte) !! Width (Bytes) !! Type !! Field Name !! Note
|-
| 0 || 4 || uint32 || Number of Entries || Count of loot definitions
|-
| 4 || || ITSEntry array || entries || Loot definitions
|-
| || || padding || 00 || Pad zeroes for 4 byte alignment
|}

===ITSEntry===
Describes a single piece of loot.

{| class="wikitable dataStructure"
! Start (Byte) !! Width (Bytes) !! Type !! Field Name !! Note
|-
| 0 || 1 || uint8 || contents_id || See [[Item Table]].
|-
| 1 || 1 || uint8 || cat_id || Category ID: 0a is items.
|-
| 2 || 1 || uint8 || unknown2 || Always 01.
|-
| 3 || 1 || uint8 || container_state || See below for values.
|-
| 4 || 3 || PackedTuple<uint8> || size || Size of container (width, height, depth).
|-
| 7 || 3 || PackedTuple<uint8> || rotation || Rotation around axis (x, y, z).
|-
| 10 || 6 || PackedTuple<uint16> || coordinates || Location of container (x, y, z)
|-
| 16 || 1 || uint8 || container_type || See below for values.
|-
| 17 || 8 || uint8 array || unknowns || Unknown.
|-
| 25 || 15 || uint8 array || padding || All 00.
|}

===container_state===
{| class="wikitable dataStructure"
! Value !! Meaning
|-
| 00 || On Land
|-
| 01 || Underwater
|-
| 02 || Buried
|-
| 03 || On Land (unsure the difference from 00)
|-
| 04 || Required Pickup (Only astral pouch and devout beads chests.)
|-
| 05 || Powerslash Only (Kusa Village Gourds.)
|-
| 06 || In Canal (Sei'an Commoner's Quarter chests that are initially on land and later underwater.)
|-
| 07 || Tidal (Sunken Ship chests that are on land at night and underwater during day.)
|-
| 13 || On Land (Pots only, but some are 00 or 03, so what's the difference?)
|}

===container_type===
{| class="wikitable dataStructure"
! Value !! Meaning
|-
| 00 || Free-standing
|-
| 01 || Sasa Chest
|-
| 02 || Pot
|-
| 03 || Wooden Horse
|-
| 04 || Chest
|-
| 05 || Gale Shrine Chest
|-
| 06 || Clover
|-
| 07 || Grass
|-
| 08 || Watermelon
|-
| 09 || Locked Box
|-
| 0a || Bloom Pod
|-
| 0b || Guardian Fruit
|-
| 0c || Electric Chest
|-
| 0d || Clam Shell
|-
| 0e || Flower
|-
| 0f || Flaming Chest
|-
| 10 || One-eyed Doll
|-
| 11 || Frozen Chest
|-
| 12 || Crystal PS3 Rock
|-
| 13 || Iron PS2 Rock
|}