Difference between revisions of "Filesystem/Race/Common.szs/ItemSlot.bin"

From Custom Mario Kart
Jump to navigation Jump to search
m (→‎Columns: →Balloon Battle & Coin Runners →“with most” to “with the most”)
Line 203: Line 203:
 
== Tools ==
 
== Tools ==
 
The following tools can handle ItemSlot.bin:
 
The following tools can handle ItemSlot.bin:
* (none)
+
* [[Item Slot Editor]], by [[MrDark35000vr]]
  
 
[[Category:Filesystem|I]]
 
[[Category:Filesystem|I]]
 
[[Category:File Format/MKW|I]]
 
[[Category:File Format/MKW|I]]

Revision as of 06:18, 28 November 2018

ItemSlot.bin is a sub file of /Race/Common.szs. It contains a set of tables used for Item Box Settings that control the item roulette probabilities in race. In competitions, Nintendo also used a variant that can be used individually in specific courses, named ItemSlotTable.slt.

File Format

Bot ItemSlot.bin and ItemSlotTable.bin share the same table-based format, and the difference between them is that the latter lacks of Battle mode tables originally. However, the file would still work if replaced with a full ItemSlot.bin set of tables.

Header

Header
Offset Type Description
0x00 Byte Number of tables. 12 for ItemSlot.bin, 6 for ItemSlotTable.slt.
0x01 End of header, start of first table.

Table Format

Header
Offset Type Description
0x00 Byte Number of columns C.
0x01 Byte Number of rows R.
C + N Byte Item chance cell corresponding to the R row from the C column. In original files, this value is a range between 0 to 200, being each unit a 0.5% of chance, and all rows in a single column add to 200, but neither of those is required for the slot table to work.

Table list

Table list
Index Description
1 Item probabilities for the player in Grand Prix mode.
2 Item probabilities for the CPU in Grand Prix mode.
3 Item probabilities for the player in VS mode.
4 Item probabilities for the CPU in VS mode.
5 Item probabilities for the player in online VS mode.
6 Special Item Boxes' probabilities.
7 Item probabilities for the player in Balloon Battle mode (not used in ItemSlotTable.slt).
8 Item probabilities for the CPU in Balloon Battle mode (not used in ItemSlotTable.slt).
9 Item probabilities for the player in Coin Runners mode (not used in ItemSlotTable.slt).
10 Item probabilities for the CPU in Coin Runners mode (not used in ItemSlotTable.slt).
11 Item probabilities for the player in online Balloon Battle mode (not used in ItemSlotTable.slt).
12 Item probabilities for the player in online Coin Runners mode (not used in ItemSlotTable.slt).

Columns

In Grand Prix and VS modes, the columns represent 1-12th positions; in Battle modes they represent how many points/coins you are behind the player in first; and for Special Item Boxes they represent the Special Item Box ID used in the KMP itembox object. In online and multiplayer modes, the values are recalculated for <12 player rooms.

Columns used in Grand Prix and VS modes
Index Description
1 1st position.
2 2nd position.
3 3rd position.
4 4th position.
5 5th position.
6 6th position.
7 7th position.
8 8th position.
9 9th position.
10 10th position.
11 11th position.
12 12th position.
Columns used in Balloon Battle
Index Description
1 Between 0 to 3 points behind the player with the most points.
2 Between 3 to 5 points behind the player with the most points.
3 More than 5 points behind the player with the most points.
Columns used in Coin Runners
Index Description
1 Between 0 to 4 coins behind the player with the most coins.
2 Between 4 to 7 coins behind the player with the most coins.
3 More than 7 coins behind the player with the most coins.
Columns used in Special Item Boxes
Index Description
1 First set (0x01).
2 Second set (0x02).
3 Third set (0x03).
4 Fourth set (0x04).
5 Fifth set (0x05).
6 Sixth set (0x06).
7 Seventh set (0x07).
8 Eighth set (0x08).
9 Nineth set (0x09).
10 Tenth set (0x0A).
11 Eleventh set (0x0B).
12 Twelveth set (0x0C).
13 Thirteenth set (0x0D) (unused).
14 Fourteenth set (0x0E) (unused).
15 Fifteenth set (0x0F) (unused).
16 Sixteenth set (0x10) (unused).

Rows

The rows represent the item values, common for all tables (19 total items).

Item rows
Index Description
1 Green Shell.
2 Red Shell.
3 Banana.
4 Fake Item Box.
5 Mushroom.
6 Triple Mushroom.
7 Bob-omb.
8 Blue Shell.
9 Lightning.
10 Star.
11 Golden Mushroom.
12 Mega Mushroom.
13 Blooper.
14 POW Block.
15 Thundercloud.
16 Bullet Bill.
17 Triple Green Shells.
18 Triple Red Shells.
19 Triple Bananas.

Tools

The following tools can handle ItemSlot.bin: