Luma's Workshop - User contributions [en]

AST (File Format)

2026-03-17T03:33:55Z

AwesomeTMC: Loop enabled is the unknown at 0xE

[[category:File formats]]
'''AST''' files are audio streams found in several JAudio2 games, including ''Super Mario Galaxy'' and ''Super Mario Galaxy 2''. Both games store their '''AST''' files in the <code>AudioRes/Stream</code> directory. 
For a comprehensive list linking '''AST''' files to the Galaxy they're used in, check the [[List of Music]] page.

== Header ==
AST file header, 0x40 bytes in length.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || File magic. '''STRM''' in ASCII.
|-
| 0x04 || UInt32 || Size of all sound blocks. ''File Size - Header Length''
|-
| 0x08 || UInt16 || Audio format. 0 = ADPCM, 1 = PCM16
|-
| 0x0A || UInt16 || Bit depth.
|-
| 0x0C || UInt16 || Number of channels.
|-
| 0x0E || UInt16 || Loop enabled? 0xFFFF = true. 0 = false.
|-
| 0x10 || UInt32 || Sample rate.
|-
| 0x14 || UInt32 || Total sample count.
|-
| 0x18 || UInt32 || Loop start in samples.
|-
| 0x1C || UInt32 || Loop end in samples.
|-
| 0x20 || UInt32 || Unknown. Seems to be the size of the first block.
|-
| 0x24 || UInt32 || Unknown. Always 0.
|-
| 0x28 || UInt32 || Unknown. Always 0x7F000000.
|-
| 0x2C || Byte || Always 0. Likely padding.
|-
| 0x40 || || End of Header.
|-
|}
== BLCK ==
AST file contain multiple BLCK sections, each containing sound data.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || Block magic. '''BLCK''' in ASCII.
|-
| 0x04 || UInt32 || Block size.
|-
| 0x08 || Byte || Unknown. Likely padding for alignment.
|-
| 0x20 || Byte || Sound data.
|-
|}

= Tools =
[https://www.lumasworkshop.com/tools/#audio-tools Luma's Workshop - Audio Tools]

= Tutorials =
[https://www.lumasworkshop.com/guides/?d=Changing%20Background%20Music Luma's Workshop - Changing Background Music] 
[https://www.lumasworkshop.com/guides/?d=Importing%20New%20Music%20Tracks Luma's Workshop - Importing New Music Tracks]

BTI (File Format)

2026-03-07T04:04:58Z

AwesomeTMC: BTIs have a bool "is palette enabled" in them

[[Category:File formats]]
BTI is an image file format similar to TEX0, TPL and BREFT file formats. The only difference is the file header.

__TOC__

== File Format ==
The file format is very simple and starts with a file header followed by the image data. All data is written in [[big endian]].

=== File Header ===
The following table shows the file header. It is 0x20 bytes long. There is no magic to identify BTI files,
so tools may do some plausibility checks to identify them.

{| class="textbox grid alt center" style="border:1px; solid:#aaaaaa; max-width:743px" rules=all
|- style=background:lightgray
! colspan=3 | File Header (''Table inspired off of [http://wiki.tockdom.com/wiki/BTI_(File_Format)#File_Header this]''')
|- style=background:#f2f2f2
! Offset !! Type !! Description
|-
| 0x00 || Byte || '''Image format'''
|-
| 0x01 || Byte || '''Enable alpha''' (0x00 means alpha is disabled, anything higher means alpha is enabled)
|-
| 0x02 || UInt16 || '''Width''' of the image in pixels
|-
| 0x04 || UInt16 || '''Height''' of the image in pixels
|-
| 0x06 || Byte || '''Wrap S'''[http://www.amnoid.de/gc/bti.txt] (0x01 for posteffect.bti, 0x00 for others). Probably repeat, clamp or mirror wraps for U projection maps
|-
| 0x07 || Byte || '''Wrap T'''[http://www.amnoid.de/gc/bti.txt] (0x01 for posteffect.bti, 0x00 for others). Probably repeat, clamp or mirror wraps for V projection maps
|-
| 0x08 || Boolean || '''Is palette enabled?'''
|-
| 0x09 || Byte || '''Palette format'''
|-
| 0x0A || UInt16 || '''Number of palette entries'''
|-
| 0x0C || UInt32 || '''Offset to palette data''', relative to the start of the file header
|-
| 0x10 || Boolean || '''Mipmap Enable''' Whether the texture will use mipmaps or not
|-
| 0x11 || Boolean || '''EnableEdgeLOD'''
|-
| 0x12 || Boolean || '''Clamp LOD Bias'''
|-
| 0x13 || Boolean || '''Max Anisotropy'''
|-
| 0x14 || Byte || '''Minification filter type'''
|-
| 0x15 || Byte || '''Magnification filter type'''
|-
| 0x16 || Byte || '''Min LOD''' The minimum LOD clamp, scaled by 8. Usually 0 so the 0th Mipmap level is used.
|-
| 0x17 || Byte || '''Max LOD''' The maximum LOD clamp, scaled by 8. This should practically have the same value as MipmapCount.
|-
| 0x18 || Byte || '''Total number of images''', thus number of mipmaps + 1. Apparently unread by the engine itself, it only uses the MipmapEnable flag and the max LOD field.
|-
| 0x19 || Byte || style=background:lightgray | '''Unknown''' Probably Padding
|-
| 0x1A || UInt16 || '''LOD Bias''' The LOD bias of the texture, scaled by 100.
|-
| 0x1C || UInt32 || '''Offset to image data''', relative to the start of the file header
|-
| 0x20 || colspan=2 style="background:lightgray; text-align:center;" | End of file header
|}

== Palette Data ==
{| class="textbox grid alt center" style="border:1px; solid:#0000a0; max-width:743px;" rules=all
|-
! colspan=7 style="background:#000080; color:white;" | Image Formats (''Table inspired off of [http://wiki.tockdom.com/wiki/Template:Image_Formats this])
|- style="background:#b0b0f0"
! ID !! Name !! Bits per pixel !! Block width !! Block height !! Block size !! Type
|- style="background:#d0d0f0"
| 0x00 || I4 || 4 || 8 || 8 || 32 bytes || Gray
|- style="background:#f0f0ff"
| 0x01 || I8 || 8 || 8 || 4 || 32 bytes || Gray
|- style="background:#d0d0f0"
| 0x02 || IA4 || 8 || 8 || 4 || 32 bytes || Gray + Alpha
|- style="background:#f0f0ff"
| 0x03 || IA8 || 16 || 4 || 4 || 32 bytes || Gray + Alpha
|- style="background:#d0d0f0"
| 0x04 || RGB565|| 16 || 4 || 4 || 32 bytes || Color
|- style="background:#f0f0ff"
| 0x05 || RGB5A3 || 16 || 4 || 4 || 32 bytes || Color + Alpha
|- style="background:#d0d0f0"
| 0x06 || RGBA32|| 32 || 4 || 4 || 64 bytes || Color + Alpha
|- style="background:#f0f0ff"
| 0x08 || C4 || 4 || 8 || 8 || 32 bytes || Palette (IA8, RGB565, RGB5A3)
|- style="background:#d0d0f0"
| 0x09 || C8|| 8 || 8 || 4 || 32 bytes || Palette (IA8, RGB565, RGB5A3)
|- style="background:#f0f0ff"
| 0x0A || C14X2 || 16 || 4 || 4 || 32 bytes || Palette (IA8, RGB565, RGB5A3)
|- style="background:#d0d0f0"
| 0x0E || CMPR || 4 || 8 || 8 || 32 bytes || Color + 1 bit Alpha (compressed)
|}

= Tools =
[http://avsys.xyz/upload/files/Wexos%27s%20Toolbox%20v1.0.2.0.zip Wexos's Toolbox] can convert PNG files into BTI images. (Only supports certain pallets.) 
[https://szs.wiimm.de/ Wiimms SZS Tools] can convert BTI and PNG images in any direction. It may also convert the image and palette formats and add or remove mipmaps on the fly. 
[https://github.com/KillzXGaming/Switch-Toolbox Switch Toolbox] can open BTI images and convert them into PNG files.
 
[https://github.com/Lord-Giganticus/BTIConv BTIConv] is a cross platform solution to convert BTI and PNG images in any direction. Built in NET 6.0
== Libraries ==
[https://github.com/SuperHackio/Hack.io/tree/master/Hack.io.BTI Hack.io.BTI] Windows only C# library to help manipulating BTI images

BAS (File Format)

2025-01-31T08:01:21Z

AwesomeTMC: Initial BAS page (still very WIP)

[[Category:File formats]]
{{WIP}}

'''BAS''' stands for (presumably) '''B'''inary '''A'''udio '''S'''equence. It is used in several JSystem games, including Super Mario Galaxy and Super Mario Galaxy 2.

== Header ==
Every BAS starts with this header. It is 0x8 in size.
{|class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || UInt16 || Entry Count
|-
| 0x02 || UInt16 || Unused
|-
| 0x04 || UInt32 *|| Pointer (in memory) to a class that implements virtual methods for:
* void doNothing(); // you can put anything here, just make sure one virtual function comes first.
* u32 *getSound(JAUSoundAnimation *);
* u32 getNumSounds(JAUSoundAnimation *);
in that order. Put 0 for default behavior. Always 0 in SMG/SMG2.
|-
|}
It is then followed by an array of sound entries:
{|class="wikitable"
! Offset !! Type !! Description
|-
| 0x08 || SoundEntry[Entry Count] || Array of sound entries.
|}

== Sound Entry ==
0x20 in size, including padding.
{|class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || UInt32 || Sound ID
|-
| 0x04 || Single || Start Frame
|-
| 0x08 || Single || End Frame
|-
| 0x0C || Single || Pitch
|-
| 0x10 || UInt32|| Flags:
bool useEndFrame(?) = (flags >> 6) & 0x01 
(Still unknown/unused but set: 32, 16, 4)
|-
| 0x14 || UInt8 || Volume
|-
| 0x15 || UInt8 || Pitch Factor
|-
| 0x16 || UInt8 || Loop Count
|-
| 0x17 || UInt8 || Panning
|-
| 0x18 || UInt8 || Volume Factor
|-
| 0x19 || UInt8[7] || Padding
|-
|}

(References: [https://github.com/SuperHackio/Hack.io/blob/master/Hack.io.BAS/BAS.cs Hack.io.BAS], [https://github.com/XAYRGA/bastool/blob/master/bastool/BinaryAudioSequence.cs bastool], [https://github.com/SunakazeKun/pyjaubas/blob/main/pyjaubas/bas.py pyjaubas])

JPA (File Format)

2025-01-29T17:12:42Z

AwesomeTMC: More formatting...

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image/Texture Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags:
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X)

bool IsGlobalColorAnimation = (flags >> 0xC) & 0x01

bool IsGlobalTextureAnimation = (flags >> 0xE) & 0x01 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01

bool IsEnableProjection = (flags >> 0x14) & 0x01

bool IsDrawForwardAhead = (flags >> 0x15) & 0x01

bool IsDrawPrintAhead = (flags >> 0x16) & 0x01

bool IsEnableTexScrollAnim = (flags >> 0x18) & 0x01 
TlingS = if ((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if ((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0

bool IsNoDrawParent = (flags >> 0x1B) & 0x01

bool IsNoDrawChild = (flags >> 0x1C) & 0x01 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 1
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 1
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags:
BlendMode = (blendFlags & 0x03). See [[JPA (File Format)#Blend Mode|Blend Mode]] 
SourceFactor = (blendFlags >> 2) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]] 
DestinationFactor = (blendFlags >> 6) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]] 
|-
| 0x1A || UInt8 || Alpha Compare Flags:
AlphaCompareType0 = (alphaFlags & 0x07). See [[JPA (File Format)#Compare Type|Compare Type]] 
AlphaOperator = (alphaFlags >> 3) & 0x03. See [[JPA (File Format)#Alpha Operator|Alpha Operator]] 
AlphaCompareType1 = (alphaFlags >> 5) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]] 
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 1
|-
| 0x1D || UInt8 || Z Mode Flags:
bool DepthTest = (zModeFlags & 0x01) 
DepthCompareType = (zModeFlags >> 1) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]] 
bool DepthWrite = (zModeFlags >> 4) & 0x01
|-
| 0x1E || UInt8 || Texture Flags: bool IsEnableTextureAnimation = (TextureFlags & 0x01)
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: bool IsPrimaryColorAnimEnabled = (ColorFlags >> 1) & 0x01 
bool IsEnvironmentColorAnimEnabled = (ColorFlags >> 3) & 0x01 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 1
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 1
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 1
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 1
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = (flags & 0x01) 
bool IsDifferentXY = (flags >> 1) & 0x1 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = (flags >> 0x10) & 0x01 
bool IsEnableSinWave = (flags >> 0x11) & 0x01 
bool IsEnableRotate = (flags >> 0x18) & 0x01
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags:
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = (flags >> 0x10) & 0x01 
bool IsInheritedAlpha = (flags >> 0x11) & 0x01 
bool IsInheritedRGB = (flags >> 0x12) & 0x01 
bool IsEnableField = (flags >> 0x15) & 0x01 
bool IsEnableScaleOut = (flags >> 0x16) & 0x01 
bool IsEnableAlphaOut = (flags >> 0x17) & 0x01 
bool IsEnableRotate = (flags >> 0x18) & 0x01
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf (Influence?) Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags:
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]].

Note that due to masking, SUBTRACT isn't used.

bool UseSecondTextureIndex = (flags >> 8) & 0x01
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding/Unused?, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)

bool NoInheritRotate = (flags >> 0x11) & 0x01

bool AirDrag = (flags >> 0x12) & 0x01

bool FadeUseEnterTime = (flags >> 0x13) & 0x01

bool FadeUseDistanceTime = (flags >> 0x14) & 0x01

bool FadeUseFadeIn (flag >> 0x15) & 0x01

bool FadeUseFadeOut (flag >> 0x16) & 0x01)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIFETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCITYDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

=== Blend Mode ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NONE
|-
| 0x01 || BLEND
|-
| 0x02 || LOGIC
|-
|}

=== Blend Factor ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || ZERO
|-
| 0x01 || ONE
|-
| 0x02 || SOURCE_COLOR
|-
| 0x03 || INVERSE_SOURCE_COLOR
|-
| 0x04 || SOURCE_COLOR (Duplicate?)
|-
| 0x05 || INVERSE_SOURCE_COLOR (Duplicate?)
|-
| 0x06 || SOURCE_ALPHA
|-
| 0x07 || INVERSE_SOURCE_ALPHA
|-
| 0x08 || DESTINATION_ALPHA
|-
| 0x09 || INVERSE_DESTINATION_ALPHA
|-
|}

=== Compare Type ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NEVER
|-
| 0x01 || LESS_THAN
|-
| 0x02 || LESS_THAN_EQUAL
|-
| 0x03 || EQUAL
|-
| 0x04 || NOT_EQUAL
|-
| 0x05 || GREATER_THAN_EQUAL
|-
| 0x06 || GREATER_THAN
|-
| 0x07 || ALWAYS
|-
|}

=== Alpha Operator ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || AND
|-
| 0x01 || OR
|-
| 0x02 || XOR
|-
| 0x03 || XNOR
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2025-01-28T19:28:07Z

AwesomeTMC: Finish off documenting what I currently know

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image/Texture Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags:
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X)

bool IsGlobalColorAnimation = (flags >> 0xC) & 0x01

bool IsGlobalTextureAnimation = (flags >> 0xE) & 0x01 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01

bool IsEnableProjection = (flags >> 0x14) & 0x01

bool IsDrawForwardAhead = (flags >> 0x15) & 0x01

bool IsDrawPrintAhead = (flags >> 0x16) & 0x01

bool IsEnableTexScrollAnim = (flags >> 0x18) & 0x01 
TlingS = if ((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if ((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0

bool IsNoDrawParent = (flags >> 0x1B) & 0x01

bool IsNoDrawChild = (flags >> 0x1C) & 0x01 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags:
BlendMode = (blendFlags & 0x03). See [[JPA (File Format)#Blend Mode|Blend Mode]]
SourceFactor = (blendFlags >> 2) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]]
DestinationFactor = (blendFlags >> 6) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]]
|-
| 0x1A || UInt8 || Alpha Compare Flags:
AlphaCompareType0 = (alphaFlags & 0x07). See [[JPA (File Format)#Compare Type|Compare Type]]
AlphaOperator = (alphaFlags >> 3) & 0x03. See [[JPA (File Format)#Alpha Operator|Alpha Operator]]
AlphaCompareType1 = (alphaFlags >> 5) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]]
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 1
|-
| 0x1D || UInt8 || Z Mode Flags:
bool DepthTest = (zModeFlags & 0x01)
DepthCompareType = (zModeFlags >> 1) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]]
bool DepthWrite = (zModeFlags >> 4) & 0x01
|-
| 0x1E || UInt8 || Texture Flags: bool IsEnableTextureAnimation = (TextureFlags & 0x01)
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: bool IsPrimaryColorAnimEnabled = (ColorFlags >> 1) & 0x01
bool IsEnvironmentColorAnimEnabled = (ColorFlags >> 3) & 0x01
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = (flags & 0x01) 
bool IsDifferentXY = (flags >> 1) & 0x1 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = (flags >> 0x10) & 0x01 
bool IsEnableSinWave = (flags >> 0x11) & 0x01 
bool IsEnableRotate = (flags >> 0x18) & 0x01
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags:
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = (flags >> 0x10) & 0x01 
bool IsInheritedAlpha = (flags >> 0x11) & 0x01 
bool IsInheritedRGB = (flags >> 0x12) & 0x01 
bool IsEnableField = (flags >> 0x15) & 0x01 
bool IsEnableScaleOut = (flags >> 0x16) & 0x01 
bool IsEnableAlphaOut = (flags >> 0x17) & 0x01 
bool IsEnableRotate = (flags >> 0x18) & 0x01
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf (Influence?) Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags:
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]].

Note that due to masking, SUBTRACT isn't used.

bool UseSecondTextureIndex = (flags >> 8) & 0x01
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding/Unused?, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)

bool NoInheritRotate = (flags >> 0x11) & 0x01

bool AirDrag = (flags >> 0x12) & 0x01

bool FadeUseEnterTime = (flags >> 0x13) & 0x01

bool FadeUseDistanceTime = (flags >> 0x14) & 0x01

bool FadeUseFadeIn (flag >> 0x15) & 0x01

bool FadeUseFadeOut (flag >> 0x16) & 0x01)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIFETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCITYDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

=== Blend Mode ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NONE
|-
| 0x01 || BLEND
|-
| 0x02 || LOGIC
|-
|}

=== Blend Factor ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || ZERO
|-
| 0x01 || ONE
|-
| 0x02 || SOURCE_COLOR
|-
| 0x03 || INVERSE_SOURCE_COLOR
|-
| 0x04 || SOURCE_COLOR (Duplicate?)
|-
| 0x05 || INVERSE_SOURCE_COLOR (Duplicate?)
|-
| 0x06 || SOURCE_ALPHA
|-
| 0x07 || INVERSE_SOURCE_ALPHA
|-
| 0x08 || DESTINATION_ALPHA
|-
| 0x09 || INVERSE_DESTINATION_ALPHA
|-
|}

=== Compare Type ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NEVER
|-
| 0x01 || LESS_THAN
|-
| 0x02 || LESS_THAN_EQUAL
|-
| 0x03 || EQUAL
|-
| 0x04 || NOT_EQUAL
|-
| 0x05 || GREATER_THAN_EQUAL
|-
| 0x06 || GREATER_THAN
|-
| 0x07 || ALWAYS
|-
|}

=== Alpha Operator ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || AND
|-
| 0x01 || OR
|-
| 0x02 || XOR
|-
| 0x03 || XNOR
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2025-01-28T18:28:59Z

AwesomeTMC:

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image/Texture Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags:
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X)

bool IsGlobalColorAnimation = (flags >> 0xC) & 0x01

bool IsGlobalTextureAnimation = (flags >> 0xE) & 0x01 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01

bool IsEnableProjection = (flags >> 0x14) & 0x01

bool IsDrawForwardAhead = (flags >> 0x15) & 0x01

bool IsDrawPrintAhead = (flags >> 0x16) & 0x01

bool IsEnableTexScrollAnim = (flags >> 0x18) & 0x01 
TlingS = if ((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if ((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0

bool IsNoDrawParent = (flags >> 0x1B) & 0x01

bool IsNoDrawChild = (flags >> 0x1C) & 0x01 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags:
BlendMode = (blendFlags & 0x03). See [[JPA (File Format)#Blend Mode|Blend Mode]]
SourceFactor = (blendFlags >> 2) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]]
DestinationFactor = (blendFlags >> 6) & 0x0F. See [[JPA (File Format)#Blend Factor|Blend Factor]]
|-
| 0x1A || UInt8 || Alpha Compare Flags:
AlphaCompareType0 = (alphaFlags & 0x07). See [[JPA (File Format)#Compare Type|Compare Type]]
AlphaOperator = (alphaFlags >> 3) & 0x03. See [[JPA (File Format)#Alpha Operator|Alpha Operator]]
AlphaCompareType1 = (alphaFlags >> 5) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]]
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 1
|-
| 0x1D || UInt8 || Z Mode Flags:
bool DepthTest = (zModeFlags & 0x01)
DepthCompareType = (zModeFlags >> 1) & 0x07. See [[JPA (File Format)#Compare Type|Compare Type]]
bool DepthWrite = (zModeFlags >> 4) & 0x01
|-
| 0x1E || UInt8 || Texture Flags: bool IsEnableTextureAnimation = (TextureFlags & 0x01)
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: bool IsPrimaryColorAnimEnabled = (ColorFlags >> 1) & 0x01
bool IsEnvironmentColorAnimEnabled = (ColorFlags >> 3) & 0x01
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]]
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIFETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCITYDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

=== Blend Mode ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NONE
|-
| 0x01 || BLEND
|-
| 0x02 || LOGIC
|-
|}

=== Blend Factor ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || ZERO
|-
| 0x01 || ONE
|-
| 0x02 || SOURCE_COLOR
|-
| 0x03 || INVERSE_SOURCE_COLOR
|-
| 0x04 || SOURCE_COLOR (Duplicate?)
|-
| 0x05 || INVERSE_SOURCE_COLOR (Duplicate?)
|-
| 0x06 || SOURCE_ALPHA
|-
| 0x07 || INVERSE_SOURCE_ALPHA
|-
| 0x08 || DESTINATION_ALPHA
|-
| 0x09 || INVERSE_DESTINATION_ALPHA
|-
|}

=== Compare Type ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NEVER
|-
| 0x01 || LESS_THAN
|-
| 0x02 || LESS_THAN_EQUAL
|-
| 0x03 || EQUAL
|-
| 0x04 || NOT_EQUAL
|-
| 0x05 || GREATER_THAN_EQUAL
|-
| 0x06 || GREATER_THAN
|-
| 0x07 || ALWAYS
|-
|}

=== Alpha Operator ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || AND
|-
| 0x01 || OR
|-
| 0x02 || XOR
|-
| 0x03 || XNOR
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

List of Music

2025-01-09T22:44:49Z

AwesomeTMC: Small fixes

[[Category:Lists]]

This page lists all music that can be found in both ''Galaxy'' games along with their respective BGM, STM, MBGM labels and their associated files:
* '''BGM Label''': The name of the sequenced track.
* '''Stream Label''': The name of the streamed track.
* '''Multi Label''': The Multi BGM name that combines the sequenced and streamed tracks.
* '''Sequence File''': The file name of the BMS data in ''AudioRes/Seqs/JaiSeq.arc''.
* '''Chord File''': The file name of the chord data in ''AudioRes/Info/JaiChord.arc''.
* '''Stream File''': The stream's file name in ''AudioRes/Stream''.

These entries can be found and edited in [[SMR.szs]] as well as in [[File_system#Audio_&_Video|various lists]] that vary per game.

==Super Mario Galaxy==
{| class="wikitable"
|-
! Description
! BGM Label
! Stream Label
! Multi Label
! Sequence File (.szs/.bms)
! Chord File (.cit)
! Stream File (.ast)
|-
! colspan="7" | General Galaxy Music
|-
| Gateway Galaxy
| BGM_GALAXY_24
| STM_GALAXY_24
| MBGM_GALAXY_24
| smg_galaxy24_midi_cnv
| smg_galaxy24_midi
| SMG_galaxy24_multi
|-
| Gateway Galaxy 2
| BGM_GALAXY_25
| STM_GALAXY_25
| MBGM_GALAXY_25
| smg_galaxy25_midi_cnv
| smg_galaxy25_midi
| SMG_galaxy25_strm
|-
| Gateway Galaxy 3
| BGM_GALAXY_26
| STM_GALAXY_26
| MBGM_GALAXY_26
| smg_galaxy26_midi_cnv
| smg_galaxy26_midi
| SMG_galaxy26_strm
|-
| Good Egg Galaxy
| BGM_GALAXY_01
| STM_GALAXY_01
| MBGM_GALAXY_01
| smg_galaxy01_midi_cnv
| smg_galaxy01_midi
| SMG_galaxy01_strm
|-
| Honeyhive Galaxy
| BGM_GALAXY_10
| STM_GALAXY_10
| MBGM_GALAXY_10
| smg_galaxy10_midi_cnv
| smg_galaxy10_midi
| SMG_galaxy10_strm
|-
| Big Bad Bugaboom
| BGM_GALAXY_10_HURRY
| STM_GALAXY_10_HURRY
| MBGM_GALAXY_10_HURRY
| smg_galaxy10_hurry_midi_cnv
| smg_galaxy10_hurry_midi
| SMG_galaxy10_hurry_strm
|-
| Space Junk Galaxy
| BGM_GALAXY_08
| STM_GALAXY_08
| MBGM_GALAXY_08
| smg_galaxy08_midi_cnv
| smg_galaxy08_midi
| SMG_galaxy08_strm
|-
| Battlerock Galaxy
| BGM_GALAXY_11
| STM_GALAXY_11
| MBGM_GALAXY_11
| smg_galaxy11_midi_cnv
| smg_galaxy11_midi
| SMG_galaxy11_multi
|-
| Bowser's Star Reactor
| BGM_GALAXY_15
| STM_GALAXY_15
| MBGM_GALAXY_15
| smg_galaxy15_midi_cnv
| smg_galaxy15_midi
| SMG_galaxy15_strm
|-
| Bowser's Big Staircase
| BGM_GALAXY_15_HURRY
| STM_GALAXY_15_HURRY
| MBGM_GALAXY_15_HURRY
| smg_galaxy15_hurry_midi_cnv
| smg_galaxy15_hurry_midi
| SMG_galaxy15_hurry_strm
|-
| Beach Bowl Galaxy
| BGM_GALAXY_03
| STM_GALAXY_03
| MBGM_GALAXY_03
| smg_galaxy03_midi_cnv
| smg_galaxy03_midi
| SMG_galaxy03_multi
|-
| Ghostly Galaxy
| BGM_GALAXY_06
| STM_GALAXY_06
| MBGM_GALAXY_06
| smg_galaxy06_midi_cnv
| smg_galaxy06_midi
| SMG_galaxy06_strm
|-
| Buoy Base Galaxy
| BGM_GALAXY_04
| STM_GALAXY_04
| MBGM_GALAXY_04
| smg_galaxy04_midi_cnv
| smg_galaxy04_midi
| SMG_galaxy04_multi
|-
| Bowser Jr.'s Airship Armada
| BGM_GALAXY_09
| STM_GALAXY_09
| MBGM_GALAXY_09
| smg_galaxy09_midi_cnv
| smg_galaxy09_midi
| SMG_galaxy09_strm
|-
| Drip Drop Galaxy
| BGM_GALAXY_23
| STM_GALAXY_23
| MBGM_GALAXY_23
| smg_galaxy23_midi_cnv
| smg_galaxy23_midi
| SMG_galaxy23_strm
|-
| Gusty Garden Galaxy
| BGM_GALAXY_14
| STM_GALAXY_14
| MBGM_GALAXY_14
| smg_galaxy14_midi_cnv
| smg_galaxy14_midi
| SMG_galaxy14_strm
|-
| Freezeflame Galaxy
| BGM_GALAXY_16
| STM_GALAXY_16
| MBGM_GALAXY_16
| smg_galaxy16_midi_cnv
| smg_galaxy16_midi
| SMG_galaxy16_multi
|-
| Dusty Dune Galaxy
| BGM_GALAXY_19
| STM_GALAXY_19
| MBGM_GALAXY_19
| smg_galaxy19_midi_cnv
| smg_galaxy19_midi
| SMG_galaxy19_strm
|-
| Toy Time Galaxy
| BGM_GALAXY_22
| STM_GALAXY_22
| MBGM_GALAXY_22
| smg_galaxy22_midi_cnv
| smg_galaxy22_midi
| SMG_galaxy22_strm
|-
| Deep Dark Galaxy
| BGM_GALAXY_05
| STM_GALAXY_05
| MBGM_GALAXY_05
| smg_galaxy05_midi_cnv
| smg_galaxy05_midi
| SMG_galaxy05_strm
|-
| Melty Molten Galaxy
| BGM_GALAXY_02
| STM_GALAXY_02
| MBGM_GALAXY_02
| smg_galaxy02_midi_cnv
| smg_galaxy02_midi
| SMG_galaxy02_strm
|-
| Snow Cap Galaxy
| BGM_GALAXY_27
| STM_GALAXY_27
| MBGM_GALAXY_27
| smg_galaxy27_midi_cnv
| smg_galaxy27_midi
| SMG_galaxy27_strm
|-
| Bowser's Galaxy Reactor
| BGM_GALAXY_28
| STM_GALAXY_28
| MBGM_GALAXY_28
| smg_galaxy28_midi_cnv
| smg_galaxy28_midi
| SMG_galaxy28_strm
|-
! colspan="7" | Miscellaneous Stage Music
|-
| Interlude
| BGM_GALAXY_INTER
| STM_GALAXY_INTER
| MBGM_GALAXY_INTER
| smg_galaxy_inter_midi_cnv
| smg_galaxy_inter_midi
| SMG_galaxy_inter_strm
|-
| A Tense Moment
| BGM_GALAXY_01_TOMB
| STM_GALAXY_01_TOMB
| MBGM_GALAXY_01_TOMB
| smg_galaxy01_tomb_midi_cnv
| smg_galaxy01_tomb_midi
| SMG_galaxy01_tomb_strm
|-
| Space Fantasy
| BGM_GALAXY_12
| STM_GALAXY_12
| MBGM_GALAXY_12
| smg_galaxy12_midi_cnv
| smg_galaxy12_midi
| SMG_galaxy12_strm
|-
| Space Athletic
| BGM_GALAXY_13
| STM_GALAXY_13
| MBGM_GALAXY_13
| smg_galaxy13_midi_cnv
| smg_galaxy13_midi
| SMG_galaxy13_strm
|-
| Blue Sky Athletic
| BGM_GALAXY_17
| STM_GALAXY_17
| MBGM_GALAXY_17
| smg_galaxy17_midi_cnv
| smg_galaxy17_midi
| SMG_galaxy17_strm
|-
| Speedy Comet
| BGM_GALAXY_02_HURRY
| STM_GALAXY_02_HURRY
| MBGM_GALAXY_02_HURRY
| smg_galaxy02_hurry_midi_cnv
| smg_galaxy02_hurry_midi
| SMG_galaxy02_hurry_strm
|-
| Cosmic Comet
| BGM_GALAXY_20
| STM_GALAXY_20
| MBGM_GALAXY_20
| smg_galaxy20_midi_cnv
| smg_galaxy20_midi
| SMG_galaxy20_strm
|-
| Purple Comet
| BGM_GALAXY_21
| STM_GALAXY_21
| MBGM_GALAXY_21
| smg_galaxy21_midi_cnv
| smg_galaxy21_midi
| SMG_galaxy21_strm
|-
| Pipe Interior
| BGM_GALAXY_18
| STM_GALAXY_18
| MBGM_GALAXY_18
| smg_galaxy18_midi_cnv
| smg_galaxy18_midi
| SMG_galaxy18_strm
|-
| Captain Toad's Theme
| BGM_KINOPIO_TANKEN
| STM_KINOPIO_TANKEN
| MBGM_KINOPIO_TANKEN
| smg_ev_kinotan_midi_cnv
| smg_ev_kinotan_midi
| SMG_ev_kinotan_strm
|-
| Captain Toad's Theme (Duplicate)
| BGM_KINOPIO_TANKEN_B
| STM_KINOPIO_TANKEN_B
| MBGM_KINOPIO_TANKEN_B
| smg_ev_kinotan_midi_cnv
| smg_ev_kinotan_midi
| SMG_ev_kinotan_strm
|-
| Surfing Race
| BGM_RACE_01
| STM_RACE_01
| MBGM_RACE_01
| smg_ev_race_midi_cnv
| smg_ev_race_midi
| SMG_ev_race_strm
|-
| Spooky Race
| BGM_RACE_02
| STM_RACE_02
| MBGM_RACE_02
| smg_ev_race02_midi_cnv
| smg_ev_race02_midi
| SMG_ev_race02_multi
|-
| Star Ball (Rolling Greens)
| BGM_TAMAKORO
|
|
| smg_ev_tamakoro
|
|
|-
| Star Ball (Melty Molten)
| BGM_TAMAKORO_2
|
|
| smg_ev_tamakoro02
|
|
|-
| Star Bunny Theme
| BGM_GALAXY_02_CHASE
| STM_GALAXY_02_CHASE
| MBGM_GALAXY_02_CHASE
| smg_ev_rabbit_midi_cnv
| smg_ev_rabbit_midi
| SMG_ev_rabbit_strm
|-
| Bowser Appears
|
| STM_MEET_KOOPA
|
|
|
| SMG_ev_kuppabt01_strm
|-
| A Chance to Grab a Star! 1
| BGM_STAR_EXIST
| STM_STAR_EXIST
| MBGM_STAR_EXIST
| smg_ev_starchance_midi_cnv
| smg_ev_starchance_midi
| SMG_ev_starchance_strm
|-
| A Chance to Grab a Star! 2
| BGM_STAR_EXIST_2
| STM_STAR_EXIST_2
| MBGM_STAR_EXIST_2
| smg_ev_starchance02_midi_cnv
| smg_ev_starchance02_midi
| SMG_ev_starchance02_strm
|-
! colspan="7" | Boss Music
|-
| Dino Piranha
| BGM_BOSS_03_A
| STM_BOSS_03_A
| MBGM_BOSS_03_A
| smg_boss03a_midi_cnv
| smg_boss03a_midi
| SMG_boss03a_strm
|-
| Dino Piranha (Fast)
| BGM_BOSS_03_B
| STM_BOSS_03_B
| MBGM_BOSS_03_B
| smg_boss03b_midi_cnv
| smg_boss03b_midi
| SMG_boss03b_strm
|-
| King Kaliente
| BGM_BOSS_01_A
| STM_BOSS_01_A
| MBGM_BOSS_01_A
| smg_boss01a_midi_cnv
| smg_boss01a_midi
| SMG_boss01a_strm
|-
| King Kaliente (Fast)
| BGM_BOSS_01_B
| STM_BOSS_01_B
| MBGM_BOSS_01_B
| smg_boss01b_midi_cnv
| smg_boss01b_midi
| SMG_boss01b_strm
|-
| Megaleg
| BGM_BOSS_02_A
| STM_BOSS_02_A
| MBGM_BOSS_02_A
| smg_boss02a_midi_cnv
| smg_boss02a_midi
| SMG_boss02a_strm
|-
| Megaleg (Fast)
| BGM_BOSS_02_B
| STM_BOSS_02_B
| MBGM_BOSS_02_B
| smg_boss02b_midi_cnv
| smg_boss02b_midi
| SMG_boss02b_strm
|-
| Kamella
| BGM_BOSS_04
| STM_BOSS_04
| MBGM_BOSS_04
| smg_boss04_midi_cnv
| smg_boss04_midi
| SMG_boss04_strm
|-
| Bowser
| BGM_BOSS_KOOPA
| STM_BOSS_KOOPA
| MBGM_BOSS_KOOPA
| smg_boss07_midi_cnv
| smg_boss07_midi
| SMG_boss07_multi
|-
| Bouldergeist
| BGM_BOSS_09_A
| STM_BOSS_09_A
| MBGM_BOSS_09_A
| smg_boss09a_midi_cnv
| smg_boss09a_midi
| SMG_boss09a_multi
|-
| Bouldergeist (Fast)
| BGM_BOSS_09_B
| STM_BOSS_09_B
| MBGM_BOSS_09_B
| smg_boss09b_midi_cnv
| smg_boss09b_midi
| SMG_boss09b_multi
|-
| Bowser Jr.
| BGM_BOSS_06_A
| STM_BOSS_06_A
| MBGM_BOSS_06_A
| smg_boss06a_midi_cnv
| smg_boss06a_midi
| SMG_boss06a_strm
|-
| Bowser Jr. (Fast)
| BGM_BOSS_06_B
| STM_BOSS_06_B
| MBGM_BOSS_06_B
| smg_boss06b_midi_cnv
| smg_boss06b_midi
| SMG_boss06b_strm
|-
| Major Burrows Chases Star Bunny
| BGM_PINCH_3
|
|
| smg_ev_pinch03_cnv
| smg_ev_pinch03
|
|-
| Major Burrows
| BGM_BOSS_05_A
| STM_BOSS_05_A
| MBGM_BOSS_05_A
| smg_boss05a_midi_cnv
| smg_boss05a_midi
| SMG_boss05a_strm
|-
| Major Burrows (Fast)
| BGM_BOSS_05_B
| STM_BOSS_05_B
| MBGM_BOSS_05_B
| smg_boss05b_midi_cnv
| smg_boss05b_midi
| SMG_boss05b_strm
|-
| Mecha-Bowser
| BGM_BOSS_MECHA_KOOPA
| STM_BOSS_MECHA_KOOPA
| MBGM_BOSS_MECHA_KOOPA
| smg_boss08_midi_cnv
| smg_boss08_midi
| SMG_boss08_strm
|-
| Baron Brr/Undergrund Gunner
| BGM_PINCH_1
|
|
| smg_ev_pinch01_cnv
| smg_ev_pinch01
|
|-
| Baron Brr/Undergrunt Gunner (no intro)
| BGM_PINCH_2
|
|
| smg_ev_pinch02_cnv
| smg_ev_pinch02
|
|-
| Final Bowser
| BGM_BOSS_KOOPA_FINAL
| STM_BOSS_KOOPA_FINAL
| MBGM_BOSS_KOOPA_FINAL
| smg_boss10_midi_cnv
| smg_boss10_midi
| SMG_boss10_strm
|-
! colspan="7" | Comet Observatory
|-
| Comet Observatory 1
|
| STM_ASTRO_OUT
|
|
|
| SMG_astroout01_strm
|-
| Comet Observatory 2
|
| STM_ASTRO_OUT_2
|
|
|
| SMG_astroout02_strm
|-
| Comet Observatory 3
|
| STM_ASTRO_OUT_3
|
|
|
| SMG_astroout03_strm
|-
| Dome
| BGM_ASTRO_DOME
| STM_ASTRO_DOME
| MBGM_ASTRO_DOME
| smg_astrodome_midi_cnv
| smg_astrodome_midi
| SMG_astrodome_multi
|-
| Dome (Bowser)
| BGM_ASTRO_DOME_2
| STM_ASTRO_DOME_2
| MBGM_ASTRO_DOME_2
| smg_astrodome02_midi_cnv
| smg_astrodome02_midi
| SMG_astrodome02_strm
|-
| Dome (Garden)
| BGM_ASTRO_DOME_LOFT
| STM_ASTRO_DOME_LOFT
| MBGM_ASTRO_DOME_LOFT
| smg_astrodome04_midi_cnv
| smg_astrodome04_midi
| SMG_astrodome04_multi
|-
| Library
| BGM_LIBRARY
| STM_LIBRARY
| MBGM_LIBRARY
| smg_astrodome03_midi_cnv
| smg_astrodome03_midi
| SMG_astrodome03_strm
|-
! colspan="7" | Power-Up Music
|-
| Rainbow Power-Up
| BGM_MUTEKI_A
|
|
| smg_ev_mutekistar_a_cnv
| smg_ev_mutekistar_a
|
|-
| Rainbow Power-Up (first time)
| BGM_MUTEKI_B
|
|
| smg_ev_mutekistar_b_cnv
| smg_ev_mutekistar_b
|
|-
| Fire Power-Up
| BGM_FIRE_A
|
|
| smg_ev_fire_a_cnv
| smg_ev_fire_a
|
|-
| Fire Power-Up (first time)
| BGM_FIRE_B
|
|
| smg_ev_fire_b_cnv
| smg_ev_fire_b
|
|-
| Ice Power-Up
| BGM_ICE_A
|
|
| smg_ev_ice_a_cnv
| smg_ev_ice_a
|
|-
| Ice Power-Up (first time)
| BGM_ICE_B
|
|
| smg_ev_ice_b_cnv
| smg_ev_ice_b
|
|-
| Flying Power-Up
| BGM_FLYING_A
|
|
| smg_ev_fly_a_cnv
| smg_ev_fly_a
|
|-
| Flying Power-Up (first time)
| BGM_FLYING_B
|
|
| smg_ev_fly_b_cnv
| smg_ev_fly_b
|
|-
| Power-Up Discovered (loop)
| BGM_FIRST_MORPH_A
|
|
| smg_jingle12a
|
|
|-
| Power-Up Discovered (fade-out)
| BGM_FIRST_MORPH_B
|
|
| smg_jingle12b
|
|
|-
! colspan="7" | Other Music
|-
| Title Music
|
| STM_TITLE
|
|
|
| SMG_title_strm
|-
| File Select
| BGM_FILE_SELECT
| STM_FILE_SELECT
| MBGM_FILE_SELECT
| smg_fileselect_midi_cnv
| smg_fileselect_midi
| SMG_fileselect_strm
|-
| Credits
|
| STM_STAFF_ROLL
|
|
|
| SMG_staffroll_strm
|-
| Picture Book
|
| STM_PROLOGUE_01
|
|
|
| SMG_ev_prolo01_strm
|-
| Picture Book (Sad)
|
| STM_PROLOGUE_01_B
|
|
|
| SMG_ev_prolo01_b_strm
|-
| Mushroom Kingdom
| BGM_PROLOGUE_02
| STM_PROLOGUE_02
| MBGM_PROLOGUE_02
| smg_ev_prolo02_midi_cnv
| smg_ev_prolo02_midi
| SMG_ev_prolo02_strm
|-
| Mushroom Kingdom (After Attack)
|
| STM_PROLOGUE_05
|
|
|
| SMG_ev_prolo05_strm
|-
| Star Child
|
| STM_EPILOGUE_B
|
|
|
| SMG_ev_epilogue_b_strm
|-
| Mission Select (entered from Dome)
| BGM_SENARIO_SEL
|
|
| smg_courseselect
|
|
|-
| Mission Select (entered otherwise)
| BGM_SENARIO_SEL_2
|
|
| smg_courseselect02
|
|
|-
| Preparing for Center of the Universe
| BGM_SENARIO_SEL_3
|
|
| smg_courseselect03
|
|
|-
| Galaxy Intro
| BGM_START_DEMO
|
|
| smg_jingle07
|
|
|-
| Gateway Intro
| BGM_MEET_TICO_ZOOM_OUT
|
|
| smg_jingle16
|
|
|-
| Bowser Jr. Intro
| BGM_KOOPA_JR_APPEAR
|
|
| smg_ev_kuppajr
|
|
|-
| Final Bowser Intro
| BGM_KOOPA_VS3_SUN
|
|
| smg_jingle24
|
|
|-
| First Grand Star Collected
|
| STM_FIRST_ASTRO
|
|
|
| SMG_first_astro_strm
|-
| Another Grand Star Collected
|
| STM_SECOND_ASTRO
|
|
|
| SMG_second_astro_strm
|-
! colspan="7" | Jingles
|-
| Death
| BGM_MISS
|
|
| smg_jingle01
|
|
|-
| Game Over
| BGM_GAMEOVER
|
|
| smg_jingle02
|
|
|-
| Luma joins Mario
| BGM_STAR_POW_GET
|
|
| smg_jingle08
|
|
|-
| Got Power Star
| BGM_CLEAR
|
|
| smg_jingle03
|
|
|-
| Grand Star appears
| BGM_KOOPA_GRAND_STAR_1
|
|
| smg_jingle20
|
|
|-
| Got Grand Star
| BGM_GRAND_STAR_GET
|
|
| smg_jingle11
|
|
|-
| Final Grand Star appears
| BGM_KOOPA_GRAND_STAR_3
|
|
| smg_jingle21
|
|
|-
| Got Final Grand Star
| BGM_GRAND_STAR_GET_2
|
|
| smg_jingle22
|
|
|-
| Countdown
| BGM_MINIGAME_START
|
|
| smg_jingle04
|
|
|-
| Won Race
| BGM_RACE_WIN
|
|
| smg_jingle05
|
|
|-
| Lost Race
| BGM_RACE_LOSE
|
|
| smg_jingle06
|
|
|-
| New Galaxy
| BGM_NEW_GALAXY
|
|
| smg_jingle10
|
|
|-
| Planet Appeared
| BGM_APPEAR_PLANET
|
|
| smg_jingle17
|
|
|-
| Pedestal Appeared in Gateway
| BGM_APPEAR_HD_TOWER
|
|
| smg_jingle18
|
|
|-
| New High Score
| BGM_HIGH_SCORE
|
|
| smg_jingle19
|
|
|-
| Galaxy Results
| BGM_ASTRO_RETURN
|
|
| smg_jingle09
|
|
|-
| Galaxy Completed
| BGM_GALAXY_COMPLETE
|
|
| smg_jingle25
|
|
|-
| Enemy Base uncovered
| BGM_KOOPA_APPEAR
|
|
| smg_jingle13
|
|
|-
! colspan="7" | Unused Music
|-
| [[List of Music#Attack of the Airships (MBGM_PROLOGUE_03)|Attack of the Airships]]
| BGM_PROLOGUE_03
| STM_PROLOGUE_03
| MBGM_PROLOGUE_03
| smg_ev_prolo03_midi_cnv
| smg_ev_prolo03_midi
| SMG_ev_prolo03_strm
|-
| [[List of Music#Catastrophe (STM_PROLOGUE_04)|Catastrophe]]
|
| STM_PROLOGUE_04
|
|
|
| SMG_ev_prolo04_strm
|-
| [[List of Music#E3 2006 Bubble (BGM_IN_BUBBLE)|E3 2006 Bubble]]
| BGM_IN_BUBBLE
|
|
| smg_ev_inbubble
|
|
|-
| [[List of Music#Unused jingle (BGM_JINGLE_LIGHT_1)|Unused jingle]]
| BGM_JINGLE_LIGHT_1
|
|
| smg_jingle23
|
|
|-
| [[List of Music#Unused jingle (BGM_RED_COMET_APPEAR)|Unused jingle]]
| BGM_RED_COMET_APPEAR
|
|
| smg_jingle14
|
|
|}

=== Attack of the Airships (MBGM_PROLOGUE_03) ===
{| class="wikitable"
|-
! Description
! ???
! Theme
! Theme + ???
|-
| Label
| BGM_PROLOGUE_03
| STM_PROLOGUE_03
| MBGM_PROLOGUE_03
|-
| File
| smg_ev_prolo03_midi_cnv.szs
| SMG_ev_prolo03_strm.ast
|
|-
| Audio
| BMS data contains no music
| [[File:STM_PROLOGUE_03.ogg]]
| Same as STM
|}

=== Catastrophe (STM_PROLOGUE_04) ===
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| STM_PROLOGUE_04
|-
| File
| SMG_ev_prolo04_strm.ast
|-
| Audio
| [[File:STM_PROLOGUE_04.ogg]]
|}

=== E3 2006 Bubble (BGM_IN_BUBBLE) ===
A short melody used in the intro of the 2006 E3 demo, where the player is instructed to point at Mario and press B to pop his bubble.
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| BGM_IN_BUBBLE
|-
| File
| smg_ev_inbubble.szs
|-
| Audio
| [[File:BGM_IN_BUBBLE.ogg]]
|}

=== Unused jingle (BGM_JINGLE_LIGHT_1) ===
This jingle was used in the 2007 E3 demo when collecting a Power-Up for the first time. In the final release, it was replaced with BGM_FIRST_MORPH_A.
{| class="wikitable"
|-
! Description
! Jingle
|-
| Label
| BGM_JINGLE_LIGHT_1
|-
| File
| smg_jingle23.szs
|-
| Audio
| [[File:BGM_JINGLE_LIGHT_1.ogg]]
|}

=== Unused jingle (BGM_RED_COMET_APPEAR) ===
{| class="wikitable"
|-
! Description
! Jingle
|-
| Label
| BGM_RED_COMET_APPEAR
|-
| File
| smg_jingle14.szs
|-
| Audio
| [[File:BGM_RED_COMET_APPEAR.ogg]]
|}

==Super Mario Galaxy 2==
{| class="wikitable"
|-
! Description
! BGM Label
! Stream Label
! Multi Label
! Sequence File (.szs/.bms)
! Chord File (.cit)
! Stream File (.ast)
|-
| No music
| {{#inline-tooltip: BGM_CLEAR | This BGM references the same Star Get jingle as in SMG1, but its volume is set to 0 in BgmParam.bcsv and thus muted ingame}}
|
|
| smg_jingle03
|
|
|-
! colspan="7" | General Galaxy Music
|-
| Sky Station Galaxy
| BGM_SMG2_GALAXY_06
| STM_SMG2_GALAXY_06
| MBGM_SMG2_GALAXY_06
| smg2_galaxy06_midi_cnv
| smg2_galaxy06_midi
| SMG2_galaxy06_strm
|-
| Sky Station Galaxy 2
| BGM_SMG2_GALAXY_05
| STM_SMG2_GALAXY_05
| MBGM_SMG2_GALAXY_05
| smg2_galaxy05_midi_cnv
| smg2_galaxy05_midi
| SMG2_galaxy05_strm
|-
| Yoshi Star Galaxy
| BGM_SMG2_GALAXY_32
| STM_SMG2_GALAXY_32
| MBGM_SMG2_GALAXY_32
| smg2_galaxy32_midi_cnv
| smg2_galaxy32_midi
| SMG2_galaxy32_strm
|-
| Spin-Dig Galaxy
| BGM_SMG2_GALAXY_09
| STM_SMG2_GALAXY_09
| MBGM_SMG2_GALAXY_09
| smg2_galaxy09_midi_cnv
| smg2_galaxy09_midi
| SMG2_galaxy09_strm
|-
| Fluffy Bluff Galaxy
| BGM_SMG2_GALAXY_07
| STM_SMG2_GALAXY_07
| MBGM_SMG2_GALAXY_07
| smg2_galaxy07_midi_cnv
| smg2_galaxy07_midi
| SMG2_galaxy07_strm
|-
| Rightside Down Galaxy
| BGM_SMG2_GALAXY_03
| STM_SMG2_GALAXY_03
| MBGM_SMG2_GALAXY_03
| smg2_galaxy03_midi_cnv
| smg2_galaxy03_midi
| SMG2_galaxy03_multi
|-
| Flip-Swap Galaxy
| BGM_SMG2_GALAXY_04
| STM_SMG2_GALAXY_04
| MBGM_SMG2_GALAXY_04
| smg2_galaxy04_midi_cnv
| smg2_galaxy04_midi
| SMG2_galaxy04_strm
|-
| Bowser Jr.'s Fiery Flotilla
| BGM_SMG2_GALAXY31
| STM_SMG2_GALAXY31
| MBGM_SMG2_GALAXY31
| smg2_galaxy31_midi_cnv
| smg2_galaxy31_midi
| SMG2_galaxy31_strm
|-
| Puzzle Plank Galaxy
| BGM_SMG2_GALAXY_29
| STM_SMG2_GALAXY_29
| MBGM_SMG2_GALAXY_29
| smg2_galaxy29_midi_cnv
| smg2_galaxy29_midi
| SMG2_galaxy29_strm
|-
| Hightail Falls Galaxy
| BGM_DASH_YOSHI
|
|
| smg2_ev_dashyoshi_cnv
| smg2_ev_dashyoshi
|
|-
| Cosmic Cove Galaxy
| BGM_SMG2_GALAXY_02
| STM_SMG2_GALAXY_02
| MBGM_SMG2_GALAXY_02
| smg2_galaxy02_midi_cnv
| smg2_galaxy02_midi
| SMG2_galaxy02_strm
|-
| Wild Glide Galaxy
| BGM_GLIDER
| STM_GLIDER
| MBGM_GLIDER
| smg2_ev_glider_midi_cnv
| smg2_ev_glider_midi
| SMG2_ev_glider_strm
|-
| Honeybloom Galaxy
| BGM_SMG2_GALAXY_13
| STM_SMG2_GALAXY_13
| MBGM_SMG2_GALAXY_13
| smg2_galaxy13_midi_cnv
| smg2_galaxy13_midi
| SMG2_galaxy13_strm
|-
| Bowser's Lava Lair
| BGM_SMG2_GALAXY_15
| STM_SMG2_GALAXY_15
| MBGM_SMG2_GALAXY_15
| smg2_galaxy15_midi_cnv
| smg2_galaxy15_midi
| SMG2_galaxy15_strm
|-
| Tall Trunk Galaxy Slide
| BGM_SLIDER
|
|
| smg2_ev_slider
|
|
|-
| Haunty Halls Galaxy
| BGM_SMG2_GALAXY_11
| STM_SMG2_GALAXY_11
| MBGM_SMG2_GALAXY_11
| smg2_galaxy11_midi_cnv
| smg2_galaxy11_midi
| SMG2_galaxy11_strm
|-
| Freezy Flake Galaxy
| BGM_SMG2_GALAXY_19
| STM_SMG2_GALAXY_19
| MBGM_SMG2_GALAXY_19
| smg2_galaxy19_midi_cnv
| smg2_galaxy19_midi
| SMG2_galaxy19_strm
|-
| Beat Block Galaxy
| BGM_REPEAT_TIMER
|
|
| smg2_ev_rptimer_cnv
| smg2_ev_rptimer
|
|-
| Supermassive Galaxy
| BGM_SMG2_GALAXY_23
| STM_SMG2_GALAXY_23
| MBGM_SMG2_GALAXY_23
| smg2_galaxy23_midi_cnv
| smg2_galaxy23_midi
| SMG2_galaxy23_strm
|-
| Flipsville Galaxy
| BGM_SMG2_GALAXY_14
| STM_SMG2_GALAXY_14
| MBGM_SMG2_GALAXY_14
| smg2_galaxy14_midi_cnv
| smg2_galaxy14_midi
| SMG2_galaxy14_strm
|-
| Starshine Beach Galaxy
| BGM_SMG2_GALAXY_27
| STM_SMG2_GALAXY_27
| MBGM_SMG2_GALAXY_27
| smg2_galaxy27_midi_cnv
| smg2_galaxy27_midi
| SMG2_galaxy27_multi
|-
| Sweet Mystery Galaxy
| BGM_SMG2_GALAXY_10
| STM_SMG2_GALAXY_10
| MBGM_SMG2_GALAXY_10
| smg2_galaxy10_midi_cnv
| smg2_galaxy10_midi
| SMG2_galaxy10_strm
|-
| Space Storm Galaxy
| BGM_SMG2_GALAXY_12
| STM_SMG2_GALAXY_12
| MBGM_SMG2_GALAXY_12
| smg2_galaxy12_midi_cnv
| smg2_galaxy12_midi
| SMG2_galaxy12_strm
|-
| Space Storm Galaxy 2
| BGM_SMG2_GALAXY_17
| STM_SMG2_GALAXY_17
| MBGM_SMG2_GALAXY_17
| smg2_galaxy17_midi_cnv
| smg2_galaxy17_midi
| SMG_galaxy17_multi
|-
| Slipsand/Clockwork Ruins Galaxy
| BGM_SMG2_GALAXY_01
| STM_SMG2_GALAXY_01
| MBGM_SMG2_GALAXY_01
| smg2_galaxy01_midi_cnv
| smg2_galaxy01_midi
| SMG2_galaxy01_multi
|-
| Shiverburn Galaxy
| BGM_SMG2_GALAXY_16
| STM_SMG2_GALAXY_16
| MBGM_SMG2_GALAXY_16
| smg2_galaxy16_midi_cnv
| smg2_galaxy16_midi
| SMG2_galaxy16_multi
|-
| Fleet Glide Galaxy
| BGM_SMG2_GALAXY_28
| STM_SMG2_GALAXY_28
| MBGM_SMG2_GALAXY_28
| smg2_galaxy28_midi_cnv
| smg2_galaxy28_midi
| SMG2_galaxy28_strm
|-
| Melty Monster Galaxy
| BGM_SMG2_GALAXY_30
| STM_SMG2_GALAXY_30
| MBGM_SMG2_GALAXY_30
| smg2_galaxy30_midi_cnv
| smg2_galaxy30_midi
| SMG2_galaxy30_strm
|-
| Throwback Galaxy
| BGM_SMG2_GALAXY_21
| STM_SMG2_GALAXY_21
| MBGM_SMG2_GALAXY_21
| smg2_galaxy21_midi_cnv
| smg2_galaxy21_midi
| SMG2_galaxy21_strm
|-
| Slimy Spring Galaxy
| BGM_SMG2_GALAXY_24
| STM_SMG2_GALAXY_24
| MBGM_SMG2_GALAXY_24
| smg2_galaxy24_midi_cnv
| smg2_galaxy24_midi
| SMG2_galaxy24_strm
|-
| Slimy Spring Galaxy (Ambience)
| BGM_SMG2_GALAXY_24B
| STM_SMG2_GALAXY_24B
| MBGM_SMG2_GALAXY_24B
| smg2_galaxy24b_midi_cnv
| smg2_galaxy24b_midi
| SMG2_galaxy24b_strm
|-
| Bowser's Galaxy Generator
| BGM_SMG2_GALAXY_20
| STM_SMG2_GALAXY_20
| MBGM_SMG2_GALAXY_20
| smg2_galaxy20_midi_cnv
| smg2_galaxy20_midi
| SMG2_galaxy20_strm
|-
| Stone Cyclone Galaxy
| BGM_SMG2_GALAXY_22
| STM_SMG2_GALAXY_22
| MBGM_SMG2_GALAXY_22
| smg2_galaxy22_midi_cnv
| smg2_galaxy22_midi
| SMG2_galaxy22_multi
|-
| {{#inline-tooltip: Boss Blitz Galaxy | Only plays at the start of the level}}
| BGM_EV_BOSSRUSH
|
|
| smg2_ev_bossrush_cnv
| smg2_ev_bossrush
|
|-
| {{#inline-tooltip: Boss Blitz Galaxy (with fade-in) | Plays after every boss except Fiery Dino Piranha}}
| BGM_EV_BOSSRUSH02
|
|
| smg2_ev_bossrush02_cnv
| smg2_ev_bossrush02
|
|-
| Good Egg Galaxy
| BGM_SMG_GALAXY_01
| STM_SMG_GALAXY_01
| MBGM_SMG_GALAXY_01
| smg_galaxy01_midi_cnv
| smg_galaxy01_midi
| SMG_galaxy01_strm
|-
| Gusty Garden Galaxy
| BGM_SMG_GALAXY_14
| STM_SMG_GALAXY_14
| MBGM_SMG_GALAXY_14
| smg_galaxy14_midi_cnv
| smg_galaxy14_midi
| SMG_galaxy14_strm
|-
| Bowser's Galaxy Reactor
| BGM_SMG_GALAXY_28
| STM_SMG_GALAXY_28
| MBGM_SMG_GALAXY_28
| smg_galaxy28_midi_cnv
| smg_galaxy28_midi
| SMG_galaxy28_strm
|-
! colspan="7" | Miscellaneous Stage Music
|-
| Unknown Star
| BGM_SMG2_GALAXY_INTER
| STM_SMG2_GALAXY_INTER
| MBGM_SMG2_GALAXY_INTER
| smg2_galaxy_inter_midi_cnv
| smg2_galaxy_inter_midi
| SMG2_galaxy_inter_strm
|-
| Speedy Comet
| BGM_SMG2_GALAXY_HURRY
| STM_SMG2_GALAXY_HURRY
| MBGM_SMG2_GALAXY_HURRY
| smg2_galaxy_hurry_midi_cnv
| smg2_galaxy_hurry_midi
| SMG2_galaxy_hurry_strm
|-
| Daredevil Comet
| BGM_SMG2_GALAXY_DANGER
| STM_SMG2_GALAXY_DANGER
| MBGM_SMG2_GALAXY_DANGER
| smg2_galaxy_danger_midi_cnv
| smg2_galaxy_danger_midi
| SMG2_galaxy_danger_strm
|-
| Purple Comet
| BGM_SMG2_GALAXY_26
| STM_SMG2_GALAXY_26
| MBGM_SMG2_GALAXY_26
| smg2_galaxy26_midi_cnv
| smg2_galaxy26_midi
| SMG2_galaxy26_strm
|-
| Pipe Interior
| BGM_SMG2_GALAXY_18
| STM_SMG2_GALAXY_18
| MBGM_SMG2_GALAXY_18
| smg2_galaxy18_midi_cnv
| smg2_galaxy18_midi
| SMG2_galaxy18_strm
|-
| Bonus Room
| BGM_GAMBLE
|
|
| smg2_ev_gamble
|
|
|-
| Teleporter
| BGM_SMG2_EV_PORTER
|
|
| smg2_ev_porter
|
|
|-
| Minigame
| BGM_MINI_GAME
| STM_MINI_GAME
| MBGM_MINI_GAME
| smg2_ev_minigame_midi_cnv
| smg2_ev_minigame_midi
| SMG2_ev_minigame_strm
|-
| Star Ball (Rolling Masterpiece)
| BGM_TAMAKORO
|
|
| smg2_ev_tamakoro
|
|
|-
| Star Ball (Rolling Coaster)
| BGM_TAMAKORO_2
|
|
| smg2_ev_tamakoro02
|
|
|-
| Tip Network
| BGM_DREAM01
|
|
| smg2_ev_dream01
|
|
|-
| Captain Toad's Theme
| BGM_EV_KINOTAN
| STM_EV_KINOTAN
| MBGM_EV_KINOTAN
| smg2_ev_kinotan_midi_cnv
| smg2_ev_kinotan_midi
| SMG2_ev_kinotan_strm
|-
| Star Bunny Theme
| BGM_EV_RABBIT
| STM_EV_RABBIT
| MBGM_EV_RABBIT
| smg2_ev_rabbit_midi_cnv
| smg2_ev_rabbit_midi
| SMG2_ev_rabbit_strm
|-
| Whittle Theme
| BGM_SMG2_EV_MOKKU
| STM_SMG2_EV_MOKKU
| MBGM_SMG2_EV_MOKKU
| smg2_ev_mokku_midi_cnv
| smg2_ev_mokku_midi
| SMG2_ev_mokku_strm
|-
| Bowser Appears
|
| STM_SMG2_EV_KUPPABT01
|
|
|
| SMG2_ev_kuppabt01_strm
|-
| A Chance to Grab a Star! 1
| BGM_STAR_CHANCE
| STM_STAR_CHANCE
| MBGM_STAR_CHANCE
| smg2_ev_starchance_midi_cnv
| smg2_ev_starchance_midi
| SMG2_ev_starchance_strm
|-
| {{#inline-tooltip: A Chance to Grab a Star! 2 | Only used in Slipsand Galaxy 3}}
| BGM_STAR_CHANCE_2
| STM_STAR_CHANCE_2
| MBGM_STAR_CHANCE_2
| smg2_ev_starchance02_midi_cnv
| smg2_ev_starchance02_midi
| SMG2_ev_starchance02_strm
|-
| A Chance to Grab a Star! 3
|
| STM_STAR_CHANCE_3
|
|
|
| SMG2_ev_starchance03_strm
|-
! colspan="7" | Boss Music
|-
| Peewee Piranha
| BGM_SMG2_BOSS_05A
| STM_SMG2_BOSS_05A
| MBGM_SMG2_BOSS_05A
| smg2_boss05a_midi_cnv
| smg2_boss05a_midi
| SMG2_boss05a_strm
|-
| Peewee Piranha (Fast)
|
| STM_SMG2_BOSS_05B
|
|
|
| SMG2_boss05b_strm
|-
| Giga-Lakitu
| BGM_PINCH_01
|
|
| smg2_ev_pinch01_cnv
| smg2_ev_pinch01
|
|-
| Giga-Lakitu (no intro)
| BGM_PINCH_02
|
|
| smg2_ev_pinch02_cnv
| smg2_ev_pinch02
|
|-
| Digga-Leg/Whomp King
| BGM_SMG2_BOSS_08A
| STM_SMG2_BOSS_08A
| MBGM_SMG2_BOSS_08A
| smg2_boss08a_midi_cnv
| smg2_boss08a_midi
| SMG2_boss08a_strm
|-
| Gobblegut
| BGM_SMG2_BOSS_01A
| STM_SMG2_BOSS_01A
| MBGM_SMG2_BOSS_01A
| smg2_boss01a_midi_cnv
| smg2_boss01a_midi
| SMG2_boss01a_strm
|-
| Bowser
| BGM_SMG2_BOSS_07
| STM_SMG2_BOSS_07
| MBGM_SMG2_BOSS_07
| smg2_boss07_midi_cnv
| smg2_boss07_midi
| SMG2_boss07_multi
|-
| Bowser (Fast)
| BGM_SMG2_BOSS_07B
| STM_SMG2_BOSS_07B
| MBGM_SMG2_BOSS_07B
| smg2_boss07b_midi
|
| SMG2_boss07b_multi
|-
| Megahammer
| BGM_SMG2_BOSS_03A
| STM_SMG2_BOSS_03A
| MBGM_SMG2_BOSS_03A
| smg2_boss03a_midi_cnv
| smg2_boss03a_midi
| SMG2_boss03a_multi
|-
| Glamdozer
| BGM_SMG2_BOSS_02A
| STM_SMG2_BOSS_02A
| MBGM_SMG2_BOSS_02A
| smg2_boss02a_midi_cnv
| smg2_boss02a_midi
| SMG2_boss02a_strm
|-
| Squizzard
| BGM_SMG2_BOSS_04A
|
|
| smg2_boss04a_midi_cnv
| smg2_boss04a_midi
|
|-
| Boomsday Machine
| BGM_SMG2_BOSS_06A
| STM_SMG2_BOSS_06A
| MBGM_SMG2_BOSS_06A
| smg2_boss06a_midi_cnv
| smg2_boss06a_midi
| SMG2_boss06a_strm
|-
| Boomsday Machine (Fast)
| BGM_SMG2_BOSS_06B
| STM_SMG2_BOSS_06B
| MBGM_SMG2_BOSS_06B
| smg2_boss06b_midi_cnv
| smg2_boss06b_midi
| SMG2_boss06b_strm
|-
| Final Bowser
| BGM_SMG2_BOSS_10
| STM_SMG2_BOSS_10
| MBGM_SMG2_BOSS_10
| smg2_boss10_midi
|
| SMG2_boss10_multi
|-
| Dino Piranha
| BGM_SMG_BOSS_03A
| STM_SMG_BOSS_03A
| MBGM_SMG_BOSS_03A
| smg_boss03a_midi_cnv
| smg_boss03a_midi
| SMG_boss03a_strm
|-
| Dino Piranha (Fast)
| BGM_SMG_BOSS_03B
| STM_SMG_BOSS_03B
| MBGM_SMG_BOSS_03B
| smg_boss03b_midi_cnv
| smg_boss03b_midi
| SMG_boss03b_strm
|-
| King Kaliente
| BGM_SMG_BOSS_01A
| STM_SMG_BOSS_01A
| MBGM_SMG_BOSS_01A
| smg_boss01a_midi_cnv
| smg_boss01a_midi
| SMG_boss01a_strm
|-
| King Kaliente (Fast)
| BGM_SMG_BOSS_01B
| STM_SMG_BOSS_01B
| MBGM_SMG_BOSS_01B
| smg_boss01b_midi_cnv
| smg_boss01b_midi
| SMG_boss01b_strm
|-
| Major Burrows
| BGM_SMG_BOSS_05A
| STM_SMG_BOSS_05A
| MBGM_SMG_BOSS_05A
| smg_boss05a_midi_cnv
| smg_boss05a_midi
| SMG_boss05a_strm
|-
| Major Burrows (Fast)
| BGM_SMG_BOSS_05B
| STM_SMG_BOSS_05B
| MBGM_SMG_BOSS_05B
| smg_boss05b_midi_cnv
| smg_boss05b_midi
| SMG_boss05b_strm
|-
| Bouldergeist
| BGM_SMG_BOSS_09A
| STM_SMG_BOSS_09A
| MBGM_SMG_BOSS_09A
| smg_boss09a_midi_cnv
| smg_boss09a_midi
| SMG_boss09a_multi
|-
| Bouldergeist (Fast)
| BGM_SMG_BOSS_09B
| STM_SMG_BOSS_09B
| MBGM_SMG_BOSS_09B
| smg_boss09b_midi_cnv
| smg_boss09b_midi
| SMG_boss09b_multi
|-
! colspan="7" | HUB & World Map Music
|-
| World 1 & 2
| BGM_SMG2_WORLDMAP_06
| STM_SMG2_WORLDMAP_06
| MBGM_SMG2_WORLDMAP_06
| smg2_worldmap06_midi
|
| SMG2_worldmap06_multi
|-
| World 3
| BGM_SMG2_WORLDMAP_00
| STM_SMG2_WORLDMAP_00
| MBGM_SMG2_WORLDMAP_00
| smg2_worldmap00_midi
|
| SMG2_worldmap00_multi
|-
| World 4
| BGM_SMG2_WORLDMAP_04
| STM_SMG2_WORLDMAP_04
| MBGM_SMG2_WORLDMAP_04
| smg2_worldmap04_midi
|
| SMG2_worldmap04_multi
|-
| World 5
| BGM_SMG2_WORLDMAP_08
| STM_SMG2_WORLDMAP_08
| MBGM_SMG2_WORLDMAP_08
| smg2_worldmap08_midi
|
| SMG2_worldmap08_multi
|-
| World 6
| BGM_SMG2_WORLDMAP_07
| STM_SMG2_WORLDMAP_07
| MBGM_SMG2_WORLDMAP_07
| smg2_worldmap07_midi
|
| SMG2_worldmap07_multi
|-
| World S
| BGM_SMG2_WORLDMAP_03
| STM_SMG2_WORLDMAP_03
| MBGM_SMG2_WORLDMAP_03
| smg2_worldmap03_midi
|
| SMG2_worldmap03_multi
|-
| Green Star World
| BGM_SMG2_WORLDMAP_05
| STM_SMG2_WORLDMAP_05
| MBGM_SMG2_WORLDMAP_05
| smg2_worldmap05_midi
|
| SMG2_worldmap05_multi
|-
| Starship Mario 1
| BGM_SMG2_MARIO_SHIP01
| STM_SMG2_MARIO_SHIP01
| MBGM_SMG2_MARIO_SHIP01
| smg2_mario_ship01_midi_cnv
| smg2_mario_ship01_midi
| SMG2_mario_ship01_strm
|-
| Starship Mario 2
| BGM_SMG2_MARIO_SHIP02
| STM_SMG2_MARIO_SHIP02
| MBGM_SMG2_MARIO_SHIP02
| smg2_mario_ship02_midi_cnv
| smg2_mario_ship02_midi
| SMG2_mario_ship02_strm
|-
| Starship Mario 3
| BGM_SMG2_MARIO_SHIP03
| STM_SMG2_MARIO_SHIP03
| MBGM_SMG2_MARIO_SHIP03
| smg2_mario_ship03_midi_cnv
| smg2_mario_ship03_midi
| SMG2_mario_ship03_strm
|-
| Comet Observatory
|
| STM_SMG_ASTROOUT03
|
|
|
| SMG_astroout03_strm
|-
! colspan="7" | Power-Up Music
|-
| Rainbow Power-Up
| BGM_MUTEKI_A
|
|
| smg_ev_mutekistar_a_cnv
| smg_ev_mutekistar_a
|
|-
| Rainbow Power-Up (first time)
| BGM_MUTEKI_B
|
|
| smg_ev_mutekistar_b_cnv
| smg_ev_mutekistar_b
|
|-
| Fire Power-Up
| BGM_FIRE_A
|
|
| smg_ev_fire_a_cnv
| smg_ev_fire_a
|
|-
| Fire Power-Up (first time)
| BGM_FIRE_B
|
|
| smg_ev_fire_b_cnv
| smg_ev_fire_b
|
|-
| Ice Power-Up
| BGM_ICE_A
|
|
| smg_ev_ice_a_cnv
| smg_ev_ice_a
|
|-
| Ice Power-Up (first time)
| BGM_ICE_B
|
|
| smg_ev_ice_b_cnv
| smg_ev_ice_b
|
|-
| Flying Power-Up
| BGM_FLYING_A
|
|
| smg_ev_fly_a_cnv
| smg_ev_fly_a
|
|-
| Flying Power-Up (first time)
| BGM_FLYING_B
|
|
| smg_ev_fly_b_cnv
| smg_ev_fly_b
|
|-
| Power-Up Discovered (loop)
| BGM_FIRST_MORPH_A
|
|
| smg_jingle12a
|
|
|-
| Power-Up Discovered (fade-out)
| BGM_FIRST_MORPH_B
|
|
| smg_jingle12b
|
|
|-
! colspan="7" | Other Music
|-
| Mushroom Kingdom
|
| STM_SMG2_EV_PROLOGUE_02
|
|
|
| SMG2_ev_prolo02_strm
|-
| Mario meets Luma
| BGM_SMG2_EV_PROLO_03
|
|
| smg2_ev_prolo03
|
|
|-
| Bowser Attacks
|
| STM_SMG2_EV_PROLOGUE_05
|
|
|
| SMG2_ev_prolo05_strm
|-
| First Star Select
| BGM_SMG2_EV_DEPART01
|
|
| smg2_ev_depart01
|
|
|-
| Star Select
| BGM_SMG2_COURSESELECT02
|
|
| smg2_courseselect02
|
|
|-
| Galaxy Intro
| BGM_JG_START_CAMERA_DEMO
|
|
| smg2_jg_stcamera_cnv
| smg2_jg_stcamera
|
|-
| Bowser Jr. appears
| BGM_KOOPA_JR_APPEAR
|
|
| smg2_ev_kuppajr
|
|
|-
| {{#inline-tooltip: Return with Grand Star | World 1}}
|
| STM_SMG2_FIRST_ASTRO
|
|
|
| SMG2_first_astro_strm
|-
| Traveling to next World
|
| STM_SMG2_FIRST_ASTRO2
|
|
|
| SMG2_first_astro2_strm
|-
| {{#inline-tooltip: Return with Grand Star | Worlds 2 through 5}}
|
| STM_SMG2_SECOND_ASTRO
|
|
|
| SMG2_second_astro_strm
|-
| Peach returns with Grand Star
|
| STM_SMG2_EV_EPILOGUE_01
|
|
|
| SMG2_ev_epilogue01_strm
|-
| Rosalina with Lumas
|
| STM_SMG2_EV_ENDING01
|
|
|
| SMG2_ev_ending01_strm
|-
| Credits
| BGM_SMG2_STAFFROLL
| STM_SMG2_STAFFROLL
| MBGM_SMG2_STAFFROLL
| smg2_staffroll_midi_cnv
| smg2_staffroll_midi
| SMG2_staffroll_strm
|-
! colspan="7" | Jingles
|-
| Start File
| BGM_SMG2_JG_DECIDE
|
|
| smg2_jg_decide
|
|
|-
| Luma joins Mario
| BGM_SMG2_JG_MEETCHIKO
|
|
| smg2_jg_meetchiko
|
|
|-
| Death
| BGM_MISS
|
|
| smg_jingle01
|
|
|-
| Game Over
| BGM_GAMEOVER
|
|
| smg_jingle02
|
|
|-
| Galaxy Results
| BGM_JG_RETURN_HOME
|
|
| smg2_jg_return
|
|
|-
| Starship Mario created
| BGM_SMG2_JG_M_PLANET01
|
|
| smg2_jg_m_planet01
|
|
|-
| New Galaxy unlocked
| BGM_JG_NEW_GALAXY
|
|
| smg2_jg_discov
|
|
|-
| New Planet/Galaxy born
| BGM_JG_APPEAR_PLANET
|
|
| smg2_jg_appear
|
|
|-
| Yoshi rescued
| BGM_SMG2_JG_MEETYOSHI
|
|
| smg2_jg_meetyoshi
|
|
|-
| Countdown
| BGM_MINIGAME_START
|
|
| smg_jingle04
|
|
|-
| Won Race
| BGM_RACE_WIN
|
|
| smg_jingle05
|
|
|-
| Lost Race
| BGM_RACE_LOSE
|
|
| smg_jingle06
|
|
|-
| New High Score
| BGM_JG_HIGH_SCORE
|
|
| smg2_jg_hiscore
|
|
|-
| New Best Time
| BGM_SMG2_JG_TIME
|
|
| smg2_jg_time
|
|
|-
| Galaxy Complete
| BGM_JG_GALAXY_COMPLETE
|
|
| smg2_jg_complete
|
|
|-
| Gearmo receives Goomba/Topman
| BGM_SMG2_JG_PAMATA
|
|
| smg2_jg_pamata
|
|
|-
| Grand Star appears
| BGM_SMG2_JG_GSTAR1
|
|
| smg2_jg_gstar1
|
|
|-
| Fake Grand Star appears
| BGM_SMG2_JG_GSTAR2
|
|
| smg2_jg_gstar2
|
|
|-
| Prankster Comet roaming
|
| STM_SMG2_JG_COMETSE
|
|
|
| SMG2_jg_cometse_strm
|-
| Prankster Comet appeared
| BGM_SMG2_JG_COMET
|
|
| smg2_jg_comet
|
|
|-
| [[List of Music#Green Stars unlocked (BGM_SMG2_JG_GREENSTAR1)|Green Stars unlocked]]
| BGM_SMG2_JG_GREENSTAR1
|
|
| smg2_jg_greenstar1
|
|
|-
! colspan="7" | Unused Music
|-
| [[List of Music#Title Theme Duplicate (MBGM_TITLE)|{{#inline-tooltip: Title Theme (Duplicate) | The actual Title Theme uses SE_SY_LV_TITLE_BGM and SE_SY_LV_TITLE_BGM_RHYTHM}}]]
| BGM_TITLE
| STM_TITLE
| MBGM_TITLE
| smg2_title_midi_cnv
| smg2_title_midi
| SMG2_title_strm
|-
| [[List of Music#Unused Galaxy Theme (MBGM_SMG2_GALAXY_08)|Unused Galaxy Theme]]
| BGM_SMG2_GALAXY_08
| STM_SMG2_GALAXY_08
| MBGM_SMG2_GALAXY_08
| smg2_galaxy08_midi_cnv
| smg2_galaxy08_midi
| SMG2_galaxy08_strm
|-
| {{#inline-tooltip: Gateway Galaxy | The AST file is identical to SMG_galaxy25_strm.ast from SMG}}
| BGM_SMG2_GALAXY_25
| STM_SMG2_GALAXY_25
| MBGM_SMG2_GALAXY_25
| smg2_galaxy25_midi_cnv
| smg2_galaxy25_midi
| SMG2_galaxy25_strm
|-
| [[List of Music#Digga-Leg/Whomp King Fast (STM_SMG2_BOSS08B)|Digga-Leg/Whomp King (Fast)]]
|
| STM_SMG2_BOSS08B
|
|
|
| SMG2_boss08b_strm
|-
| [[List of Music#Gobblegut Fast (STM_SMG2_BOSS_01B)|Gobblegut (Fast)]]
|
| STM_SMG2_BOSS_01B
|
|
|
| SMG2_boss01b_strm
|-
| [[List of Music#Megahammer Fast (STM_SMG2_BOSS_03B)|Megahammer (Fast)]]
|
| STM_SMG2_BOSS_03B
|
|
|
| SMG2_boss03b_strm
|-
| [[List of Music#Glamdozer Fast (STM_SMG2_BOSS_02B)|Glamdozer (Fast)]]
|
| STM_SMG2_BOSS_02B
|
|
|
| SMG2_boss02b_strm
|-
| [[List of Music#Final Bowser without Ambience (STM_SMG2_BOSS10)|Final Bowser (Without Ambience)]]
|
| STM_SMG2_BOSS10
|
|
|
| SMG2_boss10_strm
|-
| {{#inline-tooltip: Comet Observatory 2 | The AST file is identical to the one from SMG}}
|
| STM_SMG_ASTROOUT02
|
|
|
| SMG_astroout02_strm
|-
| {{#inline-tooltip: SMG1 Got Grand Star | Leftover BMS data from SMG1. SMG2 uses SE_SY_GRAND_STAR_GET_JINGLE for the Grand Star jingle}}
| BGM_JG_GRAND_STAR_GET
|
|
| smg2_jg_starget2
|
|
|-
| [[List of Music#E3 2006 Bubble (BGM_IN_BUBBLE)|E3 2006 Bubble]]
| BGM_IN_BUBBLE
|
|
| smg_ev_inbubble
|
|
|-
! colspan="7" | {{#inline-tooltip: Unreferenced Music | Unreferenced files are unused and furthermore not usable without modifications to SMR.szs}}
|-
| {{#inline-tooltip: SMG1 Baron Brr/Undergrund Gunner | Both files are identical copies from SMG1}}
|
|
|
| smg_ev_pinch01_cnv
| smg_ev_pinch01
|
|-
| [[List of Music#Unused Whittle Theme|Unused Whittle Theme]]
|
|
|
| smg2_ev_mokku_cnv
| smg2_ev_mokku
|
|-
| [[List of Music#Unused World Map 1|Unused World Map 1]]
|
|
|
|
|
| SMG2_worldmap01_strm
|-
| [[List of Music#Unused World Map 2|Unused World Map 2]]
|
|
|
|
|
| SMG2_worldmap02_strm
|-
| {{#inline-tooltip: Unused World Map 4 | The BMS contains no actual music data. The CIT contains data but needs to be investigated}}
|
|
|
| smg2_worldmap04_midi_cnv
| smg2_worldmap04_midi
|
|-
| [[List of Music#Unused Far Map|Unused Far Map]]
|
|
|
| smg2_worldmap_far
|
|
|}

=== Green Stars unlocked (BGM_SMG2_JG_GREENSTAR1) ===
This jingle only plays once for a text box when unlocking the Green Star Prankster Comets. This rare occurrence caused some people to believe it's unused, thus we decided to post it here.
{| class="wikitable"
|-
! Description
! Jingle
|-
| Label
| BGM_SMG2_JG_GREENSTAR1
|-
| File
| smg2_jg_greenstar1.szs
|-
| Audio
| [[File:BGM_SMG2_JG_GREENSTAR1.ogg]]
|}

=== Title Theme Duplicate (MBGM_TITLE) ===
A duplicate of the title theme. There is no audible difference to the actual title theme. A leftover in [[CBgmSettingInfo|cBgmSettingInfo]] for triggering the drums can still be found. The actual Title Theme uses SE_SY_LV_TITLE_BGM and SE_SY_LV_TITLE_BGM_RHYTHM. 
{| class="wikitable"
|-
! Description
! Extra Drums
! Theme
! Theme + Extra Drums
|-
| Label
| BGM_TITLE
| STM_TITLE
| MBGM_TITLE
|-
| File
| smg2_title_midi_cnv.szs
| SMG2_title_strm.ast
|
|-
| Audio
| [[File:BGM_TITLE.ogg]]
| [[File:STM_TITLE.ogg]]
| [[File:MBGM_TITLE.ogg]]
|}

=== Unused Galaxy Theme (MBGM_SMG2_GALAXY_08) ===
An unused level theme that's neither heard ingame nor in pre-release footage. It is believed to be used in the E3 2009 version of Yoshi Star Galaxy.
{| class="wikitable"
|-
! Description
! Yoshi Drums
! Theme
! Theme + Yoshi Drums
|-
| Label
| BGM_SMG2_GALAXY_08
| STM_SMG2_GALAXY_08
| MBGM_SMG2_GALAXY_08
|-
| File
| smg2_galaxy08_midi_cnv.szs
| SMG2_galaxy08_strm.ast
|
|-
| Audio
| [[File:BGM_SMG2_GALAXY_08.ogg|start=0:04]]
| [[File:STM_SMG2_GALAXY_08.ogg]]
| [[File:MBGM_SMG2_GALAXY_08.ogg]]
|}

=== Digga-Leg/Whomp King Fast (STM_SMG2_BOSS08B) ===
A fast or final-phase version of the Digga-Leg/Whomp King battle theme.
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| STM_SMG2_BOSS08B
|-
| File
| SMG2_boss08b_strm.ast
|-
| Audio
| [[File:STM_SMG2_BOSS08B.ogg]]
|}

=== Gobblegut Fast (STM_SMG2_BOSS_01B) ===
A fast or final-phase version of the Gobblegut battle theme.
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| STM_SMG2_BOSS_01B
|-
| File
| SMG2_boss01b_strm.ast
|-
| Audio
| [[File:STM_SMG2_BOSS_01B.ogg]]
|}

=== Megahammer Fast (STM_SMG2_BOSS_03B) ===
A fast or final-phase version of the Megahammer battle theme.
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| STM_SMG2_BOSS_03B
|-
| File
| SMG2_boss03b_strm.ast
|-
| Audio
| [[File:STM_SMG2_BOSS_03B.ogg]]
|}

=== Glamdozer Fast (STM_SMG2_BOSS_02B) ===
A fast or final-phase version of the Glamdozer battle theme.
{| class="wikitable"
|-
! Description
! Theme
|-
| Label
| STM_SMG2_BOSS_02B
|-
| File
| SMG2_boss02b_strm.ast
|-
| Audio
| [[File:STM_SMG2_BOSS_02B.ogg]]
|}

=== Final Bowser without Ambience (STM_SMG2_BOSS10) ===
An identical duplicate of the Final Bowser theme without the additional track that contains the ambience sound effect.

=== Unused Whittle Theme ===
An unused sequenced version of the Whittle theme using different instruments than the final version. As it doesn't have a BGM Label, it cannot be used without modifications to [[SMR.szs]].
{| class="wikitable"
|-
! Description
! Theme
|-
| File
| smg2_ev_mokku_cnv.szs
|-
| Audio
| [[File:Smg2_ev_mokku_cnv.ogg]]
|}

=== Unused World Map 1 ===
An unused World Map theme. Unlike all used themes, this one does not have a Grand Map view track. As it doesn't have a STM Label, it cannot be used without modifications to [[SMR.szs]].
{| class="wikitable"
|-
! Description
! Theme
|-
| File
| SMG2_worldmap01_strm.ast
|-
| Audio
| [[File:STM_SMG2_WORLDMAP_01.ogg]]
|}

=== Unused World Map 2 ===
An unused World Map theme. Unlike all used themes, this one does not have a Grand Map view track. As it doesn't have a STM Label, it cannot be used without modifications to [[SMR.szs]].
{| class="wikitable"
|-
! Description
! Theme
|-
| File
| SMG2_worldmap02_strm.ast
|-
| Audio
| [[File:STM_SMG2_WORLDMAP_02.ogg]]
|}

=== Unused Far Map ===
An unused Grand Map ambience sound. As it doesn't have a BGM Label, it cannot be used without modifications to [[SMR.szs]].
{| class="wikitable"
|-
! Description
! Theme
|-
| File
| smg2_worldmap_far.bms
|-
| Audio
| [[File:Smg2_worldmap_far.ogg]]
|}

BRS (File Format)

2024-12-28T08:11:01Z

AwesomeTMC: Add more documentation

[[category:File formats]]
{{WIP}}'''BRS''' ('''B'''inary '''R'''emix '''S'''equence) files contain sequence data for the NoteFairy (Rainbow Notes) object. ''Super Mario Galaxy'' and ''Super Mario Galaxy 2'' each contain only one '''BRS''' file, located in <code>AudioRes/Info/JaiRemixSeq.arc/brs/defaultremixseq.brs</code>.

== Header ==
The '''BRS''' format contains no header magic like most files do. Instead, it consists of a Sequence Count and Offsets. The size of the header is <code>0x4 + (Sequence Count x 0x4)</code>:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Sequence Count
|}

=== Offsets ===
Each offset holds the offset of a Sequence relative to the beginning of the file and is formatted like this:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Offset
|}

== Sequence Header ==
Each sequence's header consists of a Track and Note Count:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Track Count
|-
| 0x04
| UInt32 (0x4)
| Note Count
|}

== Unused/Unknown Section ==
The header is followed by a section that doesn't seem to do anything. This section's size is <code>Note Count x 0x4</code>.
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Unused/Unknown
|}

== Track ==
Each Track starts by defining its instrument (0x4), followed by the individual Key-presses for a Note (0x10 each). There is no padding between Tracks.

Only 16 keys can be played at once.
=== Instrument ===
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt16 (0x2)
| Not used
|-
| 0x02
| UInt8 (0x1)
| Bank Number
|-
| 0x03
| UInt8 (0x1)
| Program Number
|}

=== Key ===
Duration's intended range is 0-1440 after being scaled. Any value above 1440 is clamped to 1440. However, due to the first 3 bytes being discarded at one point, a scaled duration above 255 can cause unexpected behavior.

For instance, if a scaled duration is 0x1234, it is clamped to 0x05A0 (1440) and the 0x05 is discarded later on, making 0xA0 (160) how long it actually plays for.

The tempo at any given time is calculated using: (player_magnitude * 3600.0) / (note_fairy_path_length / note_count)

The scaled duration is calculated using: (120.0 * duration / tempo)
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Key (0x00 = C-1, 0x60 = C4 (middle C), 0x7F = G9, FFFFFFFF = None)
|-
| 0x04
| UInt32 (0x4)
| Velocity. Valid range: 0-127.
|-
| 0x08
| UInt32 (0x4)
| Duration (in ticks?). Scaled to the tempo the song is being played at.
Valid range: 0-255 after being scaled.
|-
| 0x0C
| UInt32 (0x4)
| Delay (in ticks?)
|}

== Sequences in SMG & SMG2 ==
A sequence can be defined in Obj_arg4 for the NoteFairy object. Obj_arg4 directly corresponds to the sequence index in defaultremixseq.brs. The following sequences are available in both games:
{| class="wikitable"
|-
! Obj_arg4
! Name
! Note Count
! Notes
|-
| 0
| Super Mario Bros. main theme (long)
| 13
| Unused
|-
| 1
| Super Mario Bros. main theme (short)
| 7
| Unused
|-
| 2
| Super Mario Bros. underground theme
| 43
|
|-
| 3
| Super Mario Bros. main theme (short)
| 7
| Unused
|-
| 4
| Super Mario Bros. underwater theme
| 46
|
|-
| 5
| Super Mario World bonus room theme
| 64
|
|}

BRS (File Format)

2024-12-11T21:47:54Z

AwesomeTMC:

'''BRS''' ('''B'''inary '''R'''emix '''S'''equence) files contain sequence data for the NoteFairy (Rainbow Notes) object. ''Super Mario Galaxy'' and ''Super Mario Galaxy 2'' each contain only one '''BRS''' file, located in <code>AudioRes/Info/JaiRemixSeq.arc/brs/defaultremixseq.brs</code>.

== Header ==
The '''BRS''' format contains no header magic like most files do. Instead, it consists of a Sequence Count and Pointers. The size of the header is <code>0x4 + (Sequence Count x 0x4)</code>:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Sequence Count
|}

=== Offsets ===
Each pointer holds the offset of a Sequence relative to the beginning of the file and is formatted like this:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Offset
|}

== Sequence Header ==
Each sequence's header consists of a Track and Note Count:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Track Count
|-
| 0x04
| UInt32 (0x4)
| Note Count
|}

== Note Duration (?) ==
The header is followed by a section that (presumably) defines the duration of each Note. This section's size is <code>Note Count x 0x4</code>.
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Note Duration (?)
|}

== Track ==
Each Track starts by defining its instrument (0x4), followed by the individual Key-presses for a Note (0x10 each). There is no padding between Tracks.
=== Instrument ===
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| ??? (0x2)
| Likely unused
|-
| 0x02
| UInt8 (0x1)
| Set Bank
|-
| 0x03
| UInt8 (0x1)
| Set Prog
|}

=== Key ===
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x00
| UInt32 (0x4)
| Key (0x00 = C-1, 0x60 = C4 (middle C), 0x7F = G9, FFFFFFFF = None)
|-
| 0x04
| UInt32 (0x4)
| Velocity
|-
| 0x08
| UInt32 (0x4)
| Duration
|-
| 0x0C
| UInt32 (0x4)
| Delay
|}

== Sequences in SMG & SMG2 ==
A sequence can be defined in Obj_arg4 for the NoteFairy object. The following sequences are available in both games:
{| class="wikitable"
|-
! Obj_arg4
! Name
! Note Count
! Notes
|-
| 0
| Super Mario Bros. main theme (long)
| 13
| Unused
|-
| 1
| Super Mario Bros. main theme (short)
| 7
| Unused
|-
| 2
| Super Mario Bros. underground theme
| 43
|
|-
| 3
| Super Mario Bros. main theme (short)
| 7
| Unused
|-
| 4
| Super Mario Bros. underwater theme
| 46
|
|-
| 5
| Super Mario World bonus room theme
| 64
|
|}

JPA (File Format)

2024-10-17T18:37:05Z

AwesomeTMC: Almost forgot this one too

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIFETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCITYDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2024-10-17T18:35:06Z

AwesomeTMC: /* JPA Key Types */ Livetime.

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIFETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2024-10-06T03:00:48Z

AwesomeTMC: /* Plane Types */ YZ -> XZ

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || XZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2024-10-01T02:26:55Z

AwesomeTMC: formatting.....

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]] 
bool FixedDensity = (flags >> 0) & 0x01 
bool FixedInterval = (flags >> 1) & 0x01 
bool InheritScale = (flags >> 2) & 0x01 
bool FollowEmitter = (flags >> 3) & 0x01 
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork] 
Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2024-10-01T02:23:32Z

AwesomeTMC: /* BEM1 */ More documentation

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object.

Also known as JPADynamicsBlock. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]]
bool FixedDensity = (flags >> 0) & 0x01
bool FixedInterval = (flags >> 1) & 0x01
bool InheritScale = (flags >> 2) & 0x01
bool FollowEmitter = (flags >> 3) & 0x01
bool FollowEmitterChild = (flags >> 4) & 0x01
|-
| 0x0C || UInt32 || [https://github.com/projectPiki/pikmin2/blob/cdea138d6289e5b3a762990e11a7a034fa66eefb/include/JSystem/JParticle/JPABlock.h#L49 ResUserWork]Unused in SMG2?
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code], [https://github.com/projectPiki/pikmin2/ Pikmin 2 decompilation])

JPA (File Format)

2024-09-11T04:57:14Z

AwesomeTMC: /* KFA1 */ Fix mistake

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]]
|-
| 0x0C || UInt32 || Unknown
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding, sometimes has 0x01 in it
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code])

JPA (File Format)

2024-09-11T00:09:31Z

AwesomeTMC: small clarifications and fixes

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]]
|-
| 0x0C || UInt32 || Unknown
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x31 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding. Always the same value as
Loop (false = 0, true = 1)
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code])

JPA (File Format)

2024-09-08T07:25:21Z

AwesomeTMC: colour -> color for consistency (and my sanity), change note at top to follow format, make padding size accurate for ETX1

[[Category:File formats]]
{{WIP}}

'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]]
|-
| 0x0C || UInt32 || Unknown
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColorInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColorAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Color Data Offset. ColorFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Color Data Offset. ColorFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Color Flags: 
Color Calculate Index Type = (ColorFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Color Animation Data Count. ColorFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Color Animation Data Count. ColorFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Color Animation Max Frame
|-
| 0x26 || Color RGBA UInt8[4] || Primary Color
|-
| 0x2A || Color RGBA UInt8[4] || Environment Color
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Color Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x34 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColorTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the color
|-
| 0x2 || Color RGBA UInt8[4] || The color at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Primary Color Animation Data Count'''] || A table of primary color keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColorFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColorTable['''Environment Color Animation Data Count'''] || A table of environment color keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Color RGBA UInt8[4] || Primary Color
|-
| 0x38 || Color RGBA UInt8[4] || Environment Color
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8 || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code])

JPA (File Format)

2024-09-03T05:07:11Z

AwesomeTMC: /* Extra BSP1 Data */ Further document extra BSP1 Data

[[Category:File formats]]
'''JPA''' stands for '''JPA'''rticle, and is part of Nintendo's JSystem. The version of JPA documented here is JPAC2-10.

This page is a work in progress.

== JPA Header ==
The file starts with this Header
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || JPAC2-10 in ASCII
|-
| 0x08 || UInt16 || Particle Count
|-
| 0x0A || UInt16 || Image Count
|-
| 0x0C || UInt32 || Offset to the TEX1 section
|-
| 0x10 || UInt32 || Unknown
|-
| 0x14 || UInt32 || Unknown
|-
|}

== BEM1 ==
This section is the Base Emitter, which contains settings for the emitter object. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BEM1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. VolumeType = (flags >> 8) & 0x07. See the [[#Volume_Types|Volume Type Table]]
|-
| 0x0C || UInt32 || Unknown
|-
| 0x10 || Single || Emitter Scale X
|-
| 0x14 || Single || Emitter Scale Y
|-
| 0x18 || Single || Emitter Scale Z
|-
| 0x1C || Single || Emitter Translation X
|-
| 0x20 || Single || Emitter Translation Y
|-
| 0x24 || Single || Emitter Translation Z
|-
| 0x28 || Single || Emitter Direction X
|-
| 0x2C || Single || Emitter Direction Y
|-
| 0x30 || Single || Emitter Direction Z
|-
| 0x34 || Single || Initial Velocity Omni-Directional (?)
|-
| 0x38 || Single || Initial Velocity Axis
|-
| 0x3C || Single || Initial Velocity Random
|-
| 0x40 || Single || Initial Velocity Direction
|-
| 0x44 || Single || Spread
|-
| 0x48 || Single || Initial Velocity Ratio
|-
| 0x4C || Single || Rate
|-
| 0x50 || Single || Rate Random
|-
| 0x54 || Single || Lifetime Random
|-
| 0x58 || Single || Volume Sweep
|-
| 0x5C || Single || Volume Minimum Radius
|-
| 0x60 || Single || Air Resistance
|-
| 0x64 || Single || Moment Random
|-
| 0x68 || Int16 || Emitter Rotation X in Degrees
|-
| 0x6A || Int16 || Emitter Rotation Y in Degrees
|-
| 0x6C || Int16 || Emitter Rotation Z in Degrees
|-
| 0x6E || Int16 || Max Frame
|-
| 0x70 || Int16 || Start Frame
|-
| 0x72 || Int16 || Lifetime
|-
| 0x74 || Int16 || Volume Size
|-
| 0x76 || Int16 || Division Number
|-
| 0x78 || UInt8 || Rate Step
|-
| 0x79 || UInt8[3] || Padding
|-
|}

== BSP1 ==
This section is the Basic Shape, which contains settings on how to draw the particle. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || BSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
ColourInSelect = (flags >> 0x0F) & 0x07 
AlphaInSelect = (flags >> 0x12) & 0x01 
TlingS = if !((flags >> 0x19) & 0x01), set to 2.0, otherwise, use 1.0 
TlingT = if !((flags >> 0x1A) & 0x01), set to 2.0, otherwise, use 1.0 
bool IsGlobalColourAnimation = !(flags & 0x00001000) 
bool IsGlobalTextureAnimation = !(flags & 0x00004000) 
bool IsEnableProjection = !(flags & 0x00100000) 
bool IsDrawForwardAhead = !(flags & 0x00200000) 
bool IsDrawPrintAhead = !(flags & 0x00400000) 
bool IsEnableTextureScrollAnimation = !(flags & 0x01000000) 
bool IsNoDrawParent = !(flags & 0x08000000) 
bool IsNoDrawChild = !(flags & 0x10000000) 
|-
| 0x0C || UInt16 || Primary Colour Data Offset. ColourFlags & 0x02 must equal 0
|-
| 0x0E || UInt16 || Environment Colour Data Offset. ColourFlags & 0x08 must equal 0
|-
| 0x10 || Single || BaseSizeX
|-
| 0x14 || Single || BaseSizeY
|-
| 0x18 || UInt16 || Blend Mode Flags
|-
| 0x1A || UInt8 || Alpha Compare Flags
|-
| 0x1B || UInt8 || Alpha Reference 0
|-
| 0x1C || UInt8 || Alpha Reference 0
|-
| 0x1D || UInt8 || Z Mode Flags
|-
| 0x1E || UInt8 || Texture Flags: 
Texture Calculate Index Type = (TextureFlags >> 2) & 0x07. See the [[#Calculate_Index_Types|Calculate Index Type Table]] 
bool IsEnableTextureAnimation = !(TextureFlags & 0x01)
|-
| 0x1F || UInt8 || Texture Index Animation Count '''TexIDAnimCount'''
|-
| 0x20 || UInt8 || TextureIndex
|-
| 0x21 || UInt8 || Colour Flags: 
Colour Calculate Index Type = (ColourFlags >> 0x04) & 0x07
|-
| 0x22 || UInt8 || Primary Colour Animation Data Count. ColourFlags & 0x02 must equal 0
|-
| 0x23 || UInt8 || Environment Colour Animation Data Count. ColourFlags & 0x08 must equal 0
|-
| 0x24 || UInt16 || Colour Animation Max Frame
|-
| 0x26 || Colour RGBA UInt8[4] || Primary Colour
|-
| 0x2A || Colour RGBA UInt8[4] || Environment Colour
|-
| 0x2E || UInt8 || Animation Random
|-
| 0x2F || UInt8 || Colour Loop Offset Mask
|-
| 0x30 || UInt8 || Texture Index Loop Offset Mask
|-
| 0x34 || UInt8[3] || Padding
|-
|}
=== Extra BSP1 Data ===
This extra data exists if IsEnableTextureScrollAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Texture Init Translation X
|-
| 0x04 || Single || Texture Init Translation Y
|-
| 0x08 || Single || Texture Init Scale X
|-
| 0x0C || Single || Texture Init Scale Y
|-
| 0x10 || Single || Texture Init Rotation
|-
| 0x14 || Single || Texture Increment Translation X
|-
| 0x18 || Single || Texture Increment Translation Y
|-
| 0x1C || Single || Texture Increment Scale X
|-
| 0x20 || Single || Texture Increment Scale Y
|-
| 0x24 || Single || Texture Increment Rotation
|-
|}
This extra data exists (after the above data if that exists) if isEnableTextureAnimation is TRUE
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt8['''TexIDAnimCount'''] || A list of bytes representing texture IDs
|-
|}
==== ColourTable ====

{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || UInt16 || The keyframe of the colour
|-
| 0x2 || Colour RGBA UInt8[4] || The colour at the keyframe
|-
|}

This extra data exists (after the above data if that exists) if ColourFlags & 0x02 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColourTable['''Primary Colour Animation Data Count'''] || A table of primary colour keyframes
|-
|}

This extra data exists (after the above data if that exists) if ColourFlags & 0x08 equals 0
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x0 || ColourTable['''Environment Colour Animation Data Count'''] || A table of environment colour keyframes
|-
|}

== ESP1 ==
Extra settings for how to draw the particle. This chunk is optional.
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ESP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags. 
bool IsEnableScale = !(flags & 0x01) 
bool IsDifferentXY = !(flags & 0x02) 
ScaleAnimTypeX = (flags >> 0x08) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
ScaleAnimTypeY = (flags >> 0x0A) & 0x03. See the [[#Calculate_Scale_Animation_Types|Calculate Scale Animation Type Table]] 
PivotX = (flags >> 0x0C) & 0x03 
PivotY = (flags >> 0x0E) & 0x04 
bool IsEnableAlpha = !(flags & 0x0010000) 
bool IsEnableSinWave = !(flags & 0x0020000) 
bool IsEnableRotate = !(flags & 01000000) 
|-
| 0x0C || Single || Scale In Timing
|-
| 0x10 || Single || Scale Out Timing
|-
| 0x14 || Single || Scale In Value X
|-
| 0x18 || Single || Scale Out Value X
|-
| 0x1C || Single || Scale In Value Y
|-
| 0x20 || Single || Scale Out Value Y
|-
| 0x24 || Single || Scale Out Random
|-
| 0x28 || UInt16 || Scale Animation X Max Frame
|-
| 0x2A || UInt16 || Scale Animation Y Max Frame
|-
| 0x2C || Single || Alpha In Timing
|-
| 0x30 || Single || Alpha Out Timing
|-
| 0x34 || Single || Alpha In Value
|-
| 0x38 || Single || Alpha Base Value
|-
| 0x3C || Single || Alpha Out Value
|-
| 0x40 || Single || Alpha Wave Frequency
|-
| 0x44 || Single || Alpha Wave Random
|-
| 0x48 || Single || Alpha Wave Amplitude
|-
| 0x4C || Single || Rotate Angle
|-
| 0x50 || Single || Rotate Angle Random
|-
| 0x54 || Single || Rotate Speed
|-
| 0x58 || Single || Rotate Speed Random
|-
| 0x5C || Single || Rotate Direction
|-
|}

== SSP1 ==
Settings for child particles that are spawned from the parent particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || SSP1 in ASCII
|-
| 0x04 || UInt32 || Section Length
|-
| 0x08 || UInt32 || Flags: 
ShapeType = flags & 0x0F. See the [[#Shape_Types|Shape Type Table]] 
DirectionType = (flags >> 0x04) & 0x07. See the [[#Direction_Types|Direction Type Table]] 
RotationType = (flags >> 0x07) & 0x07. See the [[#Rotation_Types|Rotation Type Table]] 
PlaneType = (flags >> 0x0A) & 0x01. See the [[#Plane_Types|Plane Type Table]]. (If the ShapeType is DIRECTIONCROSS or ROTATIONCROSS, the PlaneType is always X) 
bool IsInheritedScale = !(flags & 0x0001000) 
bool IsInheritedAlpha = !(flags & 0x0002000) 
bool IsInheritedRGB = !(flags & 0x0004000) 
bool IsEnableField = !(flags & 0x0020000) 
bool IsEnableScaleOut = !(flags & 0x0040000) 
bool IsEnableAlphaOut = !(flags & 0x0080000) 
bool IsEnableRotate = !(flags & 0x0100000) 
|-
| 0x0C || Single || Position Random
|-
| 0x10 || Single || Base Velocity
|-
| 0x14 || Single || Base Velocity Random
|-
| 0x18 || Single || Velocity Inf Rate
|-
| 0x1C || Single || Gravity
|-
| 0x20 || Single || Global Scale 2D X
|-
| 0x24 || Single || Global Scale 2D Y
|-
| 0x28 || Single || Inherit Scale
|-
| 0x2C || Single || Inherit Alpha
|-
| 0x30 || Single || Inherit RGB
|-
| 0x34 || Colour RGBA UInt8[4] || Primary Colour
|-
| 0x38 || Colour RGBA UInt8[4] || Environment Colour
|-
| 0x3C || Single || Timing
|-
| 0x40 || UInt16 || Life
|-
| 0x42 || UInt16 || Rate
|-
| 0x44 || UInt8 || Step
|-
| 0x45 || UInt8 || Texture Index
|-
| 0x46 || UInt16 || Rotate Speed
|-
|}

== ETX1 ==
Settings for configuring two or three textures on a particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || ETX1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
IndirectTextureMode = flags & 0x01. See the [[#Indirect_Texture_Mode|Indirect Texture Mode Table]]
|-
| 0x0C || Single || Indirect Texture Matrix. Item00
|-
| 0x10 || Single || Indirect Texture Matrix. Item01
|-
| 0x14 || Single || Indirect Texture Matrix. Item02
|-
| 0x18 || Single || Indirect Texture Matrix. Item10
|-
| 0x1C || Single || Indirect Texture Matrix. Item11
|-
| 0x20 || Single || Indirect Texture Matrix. Item12
|-
| 0x24 || Int8 || Matrix Scale
|-
| 0x25 || UInt8 || Indirect Texture Index
|-
| 0x26 || UInt8 || Second Texture Index. Set to -1 if (flags & 0x00000100) is true
|-
| 0x27 || UInt8[2] || Padding
|-
|}

== KFA1 ==
Contains curve animation tracks that can affect various properties of the emitter over time
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || KFA1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt8 || Key Type. See the [[#JPA_Key_Types|JPA Key Types Table]]
|-
| 0x09 || UInt8 || Key Count
|-
| 0x0A || UInt8 || Padding
|-
| 0x0B || bool || Loop
|-
| 0x0C || J3DKeyframe[] || Keyframes
|-
|}
=== J3D Keyframe ===
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || Single || Time
|-
| 0x04 || Single || Value
|-
| 0x08 || Single || Tangent In
|-
| 0x0C || Single || Tangent Out
|-
|}

== FLD1 ==
Defines different physics simulation fields that affect the particles
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || FLD1 in ASCII
|-
| 0x04 || UInt32 || Section length
|-
| 0x08 || UInt32 || Flags: 
Type = flags & 0x0F. See the [[#Field_Types|Field Type Table]] 
VelocityType = (flags >> 0x08) & 0x03. See the [[#Field_Add_Types|Field Add Type Table]] 
STTFlag = (flags >> 0x10)
|-
| 0x0C || Single || Position X
|-
| 0x10 || Single || Position Y
|-
| 0x14 || Single || Position Z
|-
| 0x18 || Single || Direction X
|-
| 0x1C || Single || Direction Y
|-
| 0x20 || Single || Direction Z
|-
| 0x24 || Single || Param 1
|-
| 0x28 || Single || Param 2
|-
| 0x2C || Single || Param 3
|-
| 0x30 || Single || Fade In
|-
| 0x34 || Single || Fade Out
|-
| 0x38 || Single || Enter Time (?)
|-
| 0x3C || Single || Distance Time
|-
| 0x40 || UInt8 || Cycle
|-
| 0x41 || UInt8[3] || Padding
|-
|}

== TDB1 ==
This "chunk" stores a mapping of particle texture indices to the JPAC texture indices. This chunk is required for every particle
{| class="wikitable"
! Offset !! Type !! Description
|-
| 0x00 || String || TDB1 in ASCII
|-
| 0x04 || UInt32 || Section length - 0x08
|-
| 0x08 || UInt16[] || JPAC Texture Indices
|-
|}

== Type Lists ==
=== Volume Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || CUBE
|-
| 0x01 || SPHERE
|-
| 0x02 || CYLINDER
|-
| 0x03 || TORUS
|-
| 0x04 || POINT
|-
| 0x05 || CIRCLE
|-
| 0x06 || LINE
|-
|}

=== Shape Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || POINT
|-
| 0x01 || LINE
|-
| 0x02 || BILLBOARD
|-
| 0x03 || DIRECTION
|-
| 0x04 || DIRECTIONCROSS
|-
| 0x05 || STRIPE
|-
| 0x06 || STRIPECROSS
|-
| 0x07 || ROTATION
|-
| 0x08 || ROTATIONCROSS
|-
| 0x09 || DIRBILLBOARD
|-
| 0x0A || YBILLBOARD
|-
|}

=== Direction Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || VELOCITY
|-
| 0x01 || POSITION
|-
| 0x02 || POSITIONINVERSE
|-
| 0x03 || EMITTERDIRECTION
|-
| 0x04 || PREVIOUSPARTICLE
|-
|}

=== Rotation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || X
|-
| 0x01 || Y
|-
| 0x02 || Z
|-
| 0x03 || XYZ
|-
| 0x04 || YJIGGLE
|-
|}

=== Plane Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || XY
|-
| 0x01 || YZ
|-
| 0x02 || X
|-
|}

=== Calculate Index Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
| 0x03 || MERGE
|-
| 0x04 || RANDOM
|-
|}

=== Calculate Scale Animation Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || NORMAL
|-
| 0x01 || REPEAT
|-
| 0x02 || REVERSE
|-
|}

=== Calculate Alpha Wave Types ===
{| class="wikitable"
! Value !! Type
|-
| 0xFF || NONE
|-
| 0x00 || NORMALSIN
|-
| 0x01 || ADDSIN
|-
| 0x02 || MULTIPLYSIN
|-
|}

=== Indirect Texture Mode ===
{| class="wikitable"
! Value !! Mode
|-
| 0x00 || OFF
|-
| 0x01 || NORMAL
|-
| 0x02 || SUBTRACT
|-
|}

=== Field Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || GRAVITY
|-
| 0x01 || AIR
|-
| 0x02 || MAGNET
|-
| 0x03 || NEWTON
|-
| 0x04 || VORTEX
|-
| 0x05 || RANDOM
|-
| 0x06 || DRAG
|-
| 0x07 || CONVECTION
|-
| 0x08 || SPIN
|-
|}

=== Field Add Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || FIELDACCELERATION
|-
| 0x01 || BASEVELOCITY
|-
| 0x02 || FIELDVELOCITY
|-
|}

=== JPA Key Types ===
{| class="wikitable"
! Value !! Type
|-
| 0x00 || RATE
|-
| 0x01 || VOLUMESIZE
|-
| 0x02 || VOLUMESWEEP
|-
| 0x03 || VOLUMEMINIMUMRADIUS
|-
| 0x04 || LIVETIME
|-
| 0x05 || MOMENT
|-
| 0x06 || INITIALVELOCITYOMNIDIRECTIONAL (?)
|-
| 0x07 || INITIALVELOCITYAXIS
|-
| 0x08 || INITIALVELOCIRTDIRECTION
|-
| 0x09 || SPREAD
|-
| 0x0A || SCALE
|-
|}

(Source: [https://github.com/magcius/noclip.website/blob/master/src/Common/JSYSTEM/JPA.ts noclip.website source code])

AreaObj Limitations

2024-07-20T23:08:25Z

AwesomeTMC: /* SMG2 */ Add BeeWallShortDistArea

{{Finished}}
In both ''Super Mario Galaxy'' games there is an internal table that sets up the AreaObj managers. For every manager, there is a limit of ''AreaObj'' instances that can be placed in a level. If the game exceeds this limit, the game will very likely crash.

=Lists=
Below are tables for every game that list the managers with their respective limits.

==SMG1==
{| class="wikitable"
|-
! Manager Name
! Limit
|-
| align=center | SwitchArea
|64
|-
| align=center | RaceJudgeCube
|64
|-
| align=center | NinForceWindCube
|64
|-
| align=center | NinAbyssCube
|64
|-
| align=center | CubeCamera
|160
|-
| align=center | BindEndCube
|64
|-
| align=center | EffectCylinder
|64
|-
| align=center | DeathArea
|64
|-
| align=center | WarpCube
|64
|-
| align=center | TripodBossStepStart
|64
|-
| align=center | Water
|64
|-
| align=center | PlaneModeCube
|16
|-
| align=center | PlaneCircularModeCube
|16
|-
| align=center | PipeModeCube
|4
|-
| align=center | TowerModeCylinder
|4
|-
| align=center | ShadeCube
|64
|-
| align=center | PullBackCube
|64
|-
| align=center | PullBackCylinder
|64
|-
| align=center | RestartCube
|64
|-
| align=center | ChangeBgmCube
|32
|-
| align=center | BgmProhibitArea
|4
|-
| align=center | SoundEmitterCube
|16
|-
| align=center | SoundEmitterSphere
|8
|-
| align=center | PlaneCollisionCube
|16
|-
| align=center | ForbidTriangleJumpCube
|16
|-
| align=center | ForbidWaterSearchCube
|16
|-
| align=center | QuakeEffectArea
|16
|-
| align=center | HazeCube
|16
|-
| align=center | AudioEffectArea
|16
|-
| align=center | BigBubbleGoalArea
|16
|-
| align=center | SunLightArea
|16
|-
| align=center | GlaringLightArea
|64
|-
| align=center | ViewGroupCtrlCube
|64
|-
| align=center | LensFlareArea
|64
|-
| align=center | CameraRepulsiveArea
|128
|-
| align=center | LightArea
|128
|-
| align=center | FallsCube
|32
|-
| align=center | MercatorCube
|1
|-
| align=center | AstroChangeStageCube
|16
|-
| align=center | ImageEffectArea
|32
|-
| align=center | BlueStarGuidanceCube
|16
|-
| align=center | TicoSeedGuidanceCube
|16
|-
| align=center | MessageArea
|16
|-
| align=center | SmokeEffectColorArea
|16
|-
| align=center | BeeWallShortDistArea
|16
|-
| align=center | ExtraWallCheckArea
|16
|-
| align=center | ExtraWallCheckCylinder
|16
|-
| align=center | SpinGuidanceCube
|16
|-
| align=center | HipDropGuidanceCube
|16
|-
| align=center | TamakoroMoveGuidanceCube
|16
|-
| align=center | TamakoroJumpGuidanceCube
|16
|-
| align=center | BigBubbleGuidanceCube
|16
|-
| align=center | HeavySteeringCube
|16
|-
| align=center | NonSleepCube
|16
|-
| align=center | AreaMoveSphere
|16
|-
| align=center | DodoryuClosedCylinder
|8
|-
| align=center | DashChargeCylinder
|8
|-
| align=center | PlayerSeArea
|8
|-
| align=center | RasterScrollCube
|8
|-
| align=center | OnimasuCube
|32
|-
| align=center | ForbidJumpCube
|8
|-
| align=center | CollisionArea
|64
|-
| align=center | AstroOverlookArea
|8
|-
| align=center | CelestrialSphere
|4
|-
| align=center | MirrorArea
|16
|-
| align=center | DarkMatterCube
|64
|-
| align=center | DarkMatterCylinder
|32
|-
|}

==SMG2==
{| class="wikitable"
|-
! Manager Name
! Limit
|-
| align=center | AreaMoveSphere
|16
|-
| align=center | AudioEffectArea
|16
|-
| align=center | BeeWallShortDistArea
|16
|-
| align=center | BgmChangeArea
|16
|-
| align=center | BgmVolumeFadeArea
|4
|-
| align=center | BindEnd
|64
|-
| align=center | BlueStarGuidance
|16
|-
| align=center | CameraRepulsiveArea
|128
|-
| align=center | CancelBeeMorphArea
|16
|-
| align=center | Celestrial
|4
|-
| align=center | ClipDrawArea
|64
|-
| align=center | CollisionArea
|64
|-
| align=center | CometFireDanceArea
|4
|-
| align=center | CometHopperArea
|4
|-
| align=center | CometNoSpinArea
|4
|-
| align=center | CometRainbowArea
|4
|-
| align=center | CubeCamera
|160
|-
| align=center | CumulativeTimerSwitchArea
|4
|-
| align=center | DarkMatterArea
|128
|-
| align=center | DashChargeArea
|8
|-
| align=center | DeathArea
|64
|-
| align=center | DemoPlayerForbidUpdateArea
|4
|-
| align=center | DodoryuClosedArea
|8
|-
| align=center | DreamerDeadCountArea
|1
|-
| align=center | DrillHoleHiddenArea
|16
|-
| align=center | Effect
|40
|-
| align=center | EnforceJumpArea
|4
|-
| align=center | ExtraWallCheckArea
|16
|-
| align=center | ExtraWallCheckCylinder
|16
|-
| align=center | Falls
|32
|-
| align=center | ForbidJump
|8
|-
| align=center | ForbidSupportTicoArea
|32
|-
| align=center | ForbidTriangleJump
|16
|-
| align=center | ForbidWaterSearch
|16
|-
| align=center | ForceDashCube
|16
|-
| align=center | GlaringLightArea
|64
|-
| align=center | HazeCube
|16
|-
| align=center | HeavySteering
|16
|-
| align=center | HipDropGuidance
|16
|-
| align=center | ImageEffectArea
|32
|-
| align=center | LensFlareArea
|64
|-
| align=center | LightArea
|128
|-
| align=center | MarioNoCapArea
|4
|-
| align=center | MercatorCube
|1
|-
| align=center | MessageArea
|16
|-
| align=center | MirrorArea
|16
|-
| align=center | MorphSwitchArea
|64
|-
| align=center | NoMessageArea
|1
|-
| align=center | NonSleep
|16
|-
| align=center | Onimasu
|32
|-
| align=center | PipeMode
|4
|-
| align=center | PlaneCircularMode
|16
|-
| align=center | PlaneCollision
|16
|-
| align=center | PlaneMode
|16
|-
| align=center | PlayerMorphLimitArea
|4
|-
| align=center | PlayerSeArea
|8
|-
| align=center | PlayerSideRetainOffArea
|8
|-
| align=center | PullBack
|128
|-
| align=center | QuakeEffectArea
|16
|-
| align=center | RaceJudge
|64
|-
| align=center | RasterScrollArea
|64
|-
| align=center | RecoveryFloorControlArea
|16
|-
| align=center | RepeatBlockShadowChangeArea
|8
|-
| align=center | RollingWaterBreakArea
|4
|-
| align=center | SceneChangeArea
|8
|-
| align=center | SceneExitArea
|8
|-
| align=center | ShadeCube
|64
|-
| align=center | ShadowColorArea
|32
|-
| align=center | ShadowFarClipCtrlArea
|16
|-
| align=center | SlopeRunningCancelArea
|4
|-
| align=center | SmokeEffectColorArea
|16
|-
| align=center | SoundEmitterCube
|8
|-
| align=center | SoundEmitterSphere
|8
|-
| align=center | SoundPlayArea
|16
|-
| align=center | SpinCloudFrontDefineArea
|32
|-
| align=center | SpinGuidance
|16
|-
| align=center | SpinSwitchArea
|64
|-
| align=center | StoryBookAreaText
|64
|-
| align=center | StoryBookAreaWarp
|8
|-
| align=center | SunLightArea
|64
|-
| align=center | SwitchArea
|64
|-
| align=center | TamakoroJumpGuidance
|16
|-
| align=center | TamakoroMoveGuidance
|16
|-
| align=center | TicoSeedGuidance
|16
|-
| align=center | TogepinAttackFoulArea
|16
|-
| align=center | TowerModeCylinder
|4
|-
| align=center | TripodBossStepStart
|64
|-
| align=center | ViewGroupCtrl
|64
|-
| align=center | WarpCube
|64
|-
| align=center | Water
|64
|-
| align=center | WorldMapAccessArea
|4
|-
| align=center | WorldMapSyncSoundEmitterCube
|8
|-
| align=center | YoshiCaptureGuidanceArea
|8
|-
| align=center | YoshiEatGuidanceArea
|8
|-
| align=center | YoshiSendOffArea
|4
|-
|}

=Table Locations=
The table that specifies the area managers, their limits and creation function can be found at the following addresses:

{| class="wikitable"
|-
! Region
! SMG1 Address
! SMG2 Address
|-
| align=center | NTSC-U
| align=center | 0x8052DF30
| align=center | 0x806452F0
|-
| align=center | PAL
| align=center | 0x8052DF30
| align=center | 0x806452F0
|-
| align=center | NTSC-J
| align=center | 0x8052DF30
| align=center | 0x806452F0
|-
| align=center | KOR
| align=center | 0x8052F4B0
| align=center | 0x80645870
|-
| align=center | TWN
| align=center | ----------
| align=center | 0x80645870
|-
|}

=Table Format=
Each table entry consists of three DWORDs:

{| class="wikitable"
|-
! Entry Offset
! Description
|-
| align=center | 0x00
| Pointer to the manager's name.
|-
| align=center | 0x04
| Number of AreaObj entries.
|-
| align=center | 0x08
| Pointer to the manager's creation function.
|-
|}