BREFF (File Format)

From Custom Mario Kart
Jump to navigation Jump to search


Read BREFF and BREFT (File Format) for an introduction.

File Format

The Sub File Item explained here points to this structure.

Offset Size Type Description
0x00 0x04 UInt32 Pointer to effect name (calculated at runtime)
0x04 0x04 UInt32 Size of emitter data.
0x08 Start of Emitter data


An emitter usually has size 0x14c.

Offset Size Type Description
0x00 0x04 Unknown flags
0x04 0x03 Emit flags
0x07 0x01 Byte Emitter shape
Value Description
0x0 Disc
0x1 Line
0x5 Cube
0x7 Cylinder
0x8 Sphere
0x9 Point
0xA Torus
0x08 0x02 UInt16 Emitter life
0x0a 0x02 UInt16 Particle life. Hardcoded for environment effects.
0x0c 0x01 Byte Particle life random
0x0d 0x01 Bool Inherit child particle translation
0x0e 0x01 Byte Emit interval random
0x0f 0x01 Byte Emit random
0x10 0x04 Float Emission rate. Hardcoded to 0.5 for most environment effects.
0x14 0x02 UInt16 Emit start
0x16 0x02 UInt16 Emit end
0x18 0x02 UInt16 Emit interval
0x1a 0x01 Bool Inherit particle translation
0x1b 0x01 Bool Inherit child emitter translation?
0x1c 0x18 Float[6] Emitter dimensions. The total size is the sum of the radius of the empty inner area and the size of the shape. A point emitter has no dimension settings.
Index Disc Line Cube Cylinder Sphere Torus
0 X-size Length X-size
1 Inner radius X-rotation Y-size Inner radius
2 Angle start Y-rotation Z-size Angle start
3 Angle end Z-rotation Inner radius Angle end
4 Z-size Y-size
5 Z-size
0x34 0x02 UInt16 Emit diversion?
0x36 0x01 Byte Velocity random
0x37 0x01 Byte Momentum random
0x38 0x04 Float Power radiation
0x3c 0x04 Float Power Y-axis value
0x40 0x04 Float Power random
0x44 0x04 Float Power normal
0x48 0x04 Float Diffison emitter normal
0x4c 0x04 Float Power spec
0x50 0x04 Float Diffusion spec
0x54 0x04 Float3 Emission angle
0x60 0x0C Float3 Scale
0x6C 0x0C Float3 Rotation
0x78 0x0C Float3 Translation
0x84 0x01 Byte LOD nearest distance
0x85 0x01 Byte LOD farthest distance
0x86 0x01 Byte LOD minimal emission
0x87 0x01 Byte LOD alpha
0x88 0x04 UInt32 Random seed
0x8C 0x08 Unknown
0x94 0x02 UInt16 Draw flags bitfield, see table below.
0x96 0x01 Byte Alpha comparison 0
0x97 0x01 Byte Alpha comparison 1
0x98 0x01 Byte Alpha compare operation
0x99 0x01 Byte Number of TEV stages
0x9A 0x01 Byte Unknown
0x9B 0x01 Byte Enabled indirect TEV stages (bit X corresponds to indirect stage X)
0x9C 0x04 Byte[4] Texture used by each TEV stage
0xA0 0x10 Byte[4][4] Four color input sources per TEV stage
0xB0 0x14 Byte[4][5] One of the struct below for each TEV stage. For possible values, see Wii Graphics Code.
Offset Size Type Description
0x0 1 Byte Operation
0x1 1 Byte Bias
0x2 1 Byte Scale
0x3 1 Byte Clamp
0x4 1 Byte Out register
0xC4 0x10 Byte[4][4] Four alpha input sources per TEV stage
0xD4 0x14 Byte[4][5] Repeat of 0xB0, but for the alpha TEV stages.
0xE8 0x04 Byte[4] Constant color selectors
0xEC 0x04 Byte[4] Constant alpha selectors
0xF0 0x01 Byte Blend mode type
0xF1 0x01 Byte Blend source factor
0xF2 0x01 Byte Blend destination factor
0xF3 0x01 Byte Blend operation
0xF4 0x08 ColorIn Assigns particle colors to TEV color registers
0xFC 0x08 ColorIn Assigns particle alpha to TEV alpha registers
0x104 0x01 Byte Z-compare function
0x105 0x01 Byte Alpha flick type
Value Description
0 None
1 Triangle
2 Sawtooth 1
3 Sawtooth 2
4 Square
5 Sine
0x106 0x02 Short Alpha flick cycle length
0x107 0x01 Byte Alpha flick max. cycle random deviation
0x108 0x01 Byte Alpha flick amplitude
0x109 0x01 Byte Lighting mode: 0 = off, 1 = simple, 2 = hardware
0x10A 0x01 Byte Lighting type: 0 = none, 1 = ambient, 2 = point
0x10C 0x04 Byte[4] Lighting ambient color
0x110 0x04 Byte[4] Lighting diffuse color
0x114 0x04 Float Lighting radius
0x118 0x0C Float[3] Lighting position
0x124 0x18 Float[2][3] Indirect texture matrix
0x13C 0x01 SByte Indirect texture matrix scale
0x13D 0x01 SByte Piviot X
0x13E 0x01 SByte Piviot Y
0x13F 0x01 Padding
0x140 0x01 Byte Particle type
Value Description
0 Point
1 Line
2 Free
3 Billboard
4 Directional
5 Stripe
6 Smooth stripe
0x141 0x01 Byte Particle type option, see below.
0x142 0x01 Byte Movement direction
Value Description
0 Velocity vector
1 Relative to emitter position
2 Emitter direction
3 Relative to the previous particle
4 Relative to both neighbours (billboard only)
6 Relative to both neighbours (other types)
0x143 0x01 Byte Rotation axis (0 = X, 1 = Y, 2 = Z, 3 = XYZ)
0x144 0x01 Byte

Directional: Y is derived from speed if 1
Smooth stripe: number of tube vertices (min. 3)

0x145 0x01 Byte

Directional: 0 = XY surface, 1 = XZ surface
Smooth stripe: number of interpolation divisions (min. 1)

0x146 0x01 Byte

Directional: convert to billboard if 1.
Stripe and smooth stripe: 1 = connect both ends, 2 = connect newest particle to emitter

0x147 0x01 Padding
0x148 0x04 Float Z-Offset

Draw flag bitfield values

Offset Byte Description
0 0x0001 Enable Z-compare
1 0x0002 Enable Z-update
2 0x0004 Compare alpha before texture
3 0x0008 Disable alpha clipping
4 0x0010 Enable texture 1
5 0x0020 Enable texture 2
6 0x0040 Enable indirect texture
7 0x0080 Project texture 1
8 0x0100 Project texture 2
9 0x0200 Project indirect texture
10 0x0400 Make invisible
11 0x0800 Reverse draw order
12 0x1000 Enable fog
13 0x2000 XYLinkSize
14 0x4000 XYLinkScale

Particle type options

Billboard type

Value Description
0 Normal
1 Y-axis billboard
2 Movement direction axis
3 Normal, no roll

Stripe type

Value Description
0 Normal
1 Cross
2 Always face the screen
3 Tube shaped

Other types

Value Description
0 Normal
1 Cross


Like the emitter, the particle structure has a UInt32 telling how large this section is.

Offset Size Type Description
0x00 0x04 UInt32 Size of particle data.
0x04 Start of Particle data

Afterwards comes the particle data.

Offset Size Type Description
0x00 0x04 Byte[4] Color1A.
0x04 0x04 Byte[4] Color1B.
0x08 0x04 Byte[4] Color2A.
0x0C 0x04 Byte[4] Color2B.
0x10 0x08 Float[2] Size.
0x18 0x08 Float[2] Scale.
0x20 0x0C Float[3] Rotation.
0x2C 0x08 Float[2] Texture Scale 1.
0x34 0x08 Float[2] Texture Scale 2.
0x3C 0x08 Float[2] Texture Scale 3.
0x44 0x0C Float[3] Texture Rotation.
0x50 0x08 Float[2] Texture Translate 1.
0x58 0x08 Float[2] Texture Translate 2.
0x60 0x08 Float[2] Texture Translate 3.
0x68 0x04 UInt32 mTexture1.
0x6C 0x04 UInt32 mTexture2.
0x70 0x04 UInt32 mTexture3.
0x74 0x02 UInt16 Texture Wrap.
0x76 0x01 Byte Texture Reverse.
0x77 0x01 Byte AlphaCompareRef0.
0x78 0x01 Byte AlphaCompareRef1.
0x79 0x01 Byte Rotate Offset Random 1.
0x7A 0x01 Byte Rotate Offset Random 2.
0x7B 0x01 Byte Rotate Offset Random 3.
0x7C 0x0C Float[3] Rotate Offset.
0x84 0x02 UInt16 L1 = Length of texture reference 1 including the terminating NULL byte.
0x86 L1 String Texture Reference 1 (including a NULL byte).
0x86 + L1 0x02 UInt16 L2 = Length of texture reference 2 including the terminating NULL byte.
0x8C + L1 L2 String Texture Reference 2 (including a NULL byte).
0x8C + L1 + L2 0x02 UInt16 L3 = Length of texture reference 3 including the terminating NULL byte.
0x8E + L1 + L2 L3 String Texture Reference 3 (including a NULL byte).
0x8E + L1 + L2 + L3 End of this structure

Between this and the next structure there might be some padding to make the next structure aligned.

Animation Table

Offset Size Type Description
0x00 0x02 UInt16 A = Particle animation Count.
0x02 0x02 UInt16 PtcllnitTrackCount.
0x04 A * 4 UInt32[A] Pointers to animations, filled in during runtime.
0x04 + A * 4 A * 4 UInt32[A] Animation Sizes.
0x04 + 2(A * 4) 0x02 UInt16 B = Emitter animation Count
0x06 + 2(A * 4) 0x02 UInt16 EmitlnitTrackCount.
0x08 + 2(A * 4) + B * 4 B * 4 UInt32[E] Pointers to animations, filled in during runtime.
0x08 + 2(A * 4) + 2(B * 4) B * 4 UInt32[E] Animation Sizes.
0x08 + 2(A * 4) + 2(B * 4) End of this structure


Offset Size Type Description
0x00 0x01 Byte Animation identifier. Always 0xAB or 0xAC.
0x01 0x01 Byte Kind Type.
0x02 0x01 Byte Curve Flag.
0x03 0x01 Byte Kind Enable.
Value Description
0 Disabled
1 X
2 Y
3 XY
4 Z
5 XZ
6 YZ
0x04 0x01 Byte Process Flag.
0x05 0x01 Byte Loop Count.
0x06 0x02 UInt16 Random Seed.
0x08 0x02 UInt16 Frame Count.
0x0A 0x02 UInt16 Padding.
0x0C 0x04 UInt32 KeyTable Size.
0x10 0x04 UInt32 RangeTable Size.
0x14 0x04 UInt32 RandomTable Size.
0x18 0x04 UInt32 NameTable Size.
0x1C 0x04 UInt32 InfoTable Size.
0x20 End of this structure

It seems like the tables contain the actual animation data. The tables comes directly after this section and they appear in the order KeyTable, RangeTable, RandomTable, NameTable and InfoTable.



Offset Size Type Description
0x00 0x02 UInt16 N = Number of entries.
0x02 0x02 UInt16 Padding?
0x04 End of this structure
Offset Size Type Description
0x00 0x04 Float Unknown.
0x04 0x04 Float Unknown.
0x08 0x04 Float Unknown.
0x0C 0x04 Float Unknown.
0x10 End of this structure


Offset Size Type Description
0x00 0x02 UInt16 N = Number of entries.
0x02 0x02 UInt16 Padding?
0x04 End of this structure
Offset Size Type Description
0x00 0x04 UInt32 Unknown.
0x04 End of this structure


This table seems to link to one or more sub file item.

Offset Size Type Description
0x00 0x02 UInt16 N = Number of entries.
0x02 0x02 UInt16 Padding?
0x04 N * 0x04 UInt32[N] Padding?
0x04 + N * 0x04 End of this structure

After comes the sub file item name references. All entries comes after each other and after the last, there might be some padding to align the next structure.

Offset Size Type Description
0x00 0x02 UInt16 L = Length of the sub file item name including a NULL byte.
0x02 L String Sub file item name reference (including a NULL byte).
0x02 + L End of this structure



The following tools can handle BREFF files: