<onlyinclude>
<code>PTCL</code>(a.k.a <code>EFTB</code>/<code>VFXB</code>) files define certain graphical effects of objects such as emissions, particles, and shaders. They use the <code>.esetlist</code> extension. The format changes what structures it uses for different types of data between platforms, aside for <code>ESTA</code> and <code>PRMA</code>.
</onlyinclude>

== PTCL File Layout ==
PTCL files are made up of a header and four structures that are aligned to 16 bytes.
* Emitter Set Array
* Texture Array / Cafe Resource
* PRM{{check}} Array
* Shader Array / Binary Shader

Each array serves as a root node in a tree structure.

== PTCL Header ==
The <code>EFTB</code> and <code>VFXB</code> headers both contain different data, and as such have different size (0x30 and 0x40 respectively).

=== EFTB Header Structure ===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
| 0x00
| 4
| String
| file signature (magic) (<code>45 46 54 42</code> or "EFTB" in ASCII)
|-
| 0x04
| 4
| Unsigned Int
| VFX API Version ()
|-
| 0x08
| 4
| String
| Unknown (<code>47 61 6d 65</code> or "Game")
|-
| colspan="4" | ...
|}

=== VFXB Header Structure ===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
| 0x00
| 4
| String
| File signature (magic) (<code>56 46 58 42</code> or "VFXB" in ASCII)
|-
| 0x04
| 4
| Unsigned Int
| Unknown (<code>20 20 20 20</code>)
|-
| 0x08
| 2
| Unsigned Short
| Graphics API version ()
|-
| 0x0A
| 2
| Unsigned Short
| VFX API version
|-
| 0x0C
| 2
| Unsigned Short
| Byte-Order Mark
|-
| 0x0E
| 1
| Byte
| Alignment
|-
| 0x0F
| 1
| Byte
| Target offset
|-
| 0x10
| 4
| Unsigned Int
| Header size
|-
| 0x14
| 2
| Unsigned Short
| Flag
|-
| 0x16
| 2
| Unsigned Short
| First node offset
|-
| 0x18
| 4
| Padding
|
|-
| 0x1C
| 4
| Unsigned Int
| File size
|-
| 0x20
| 4
| String
| Game
|-
| 0x24
| 28
| Byte[28]
| Unknown
|-
| colspan="4" | ...
|}

== Nodes ==
Each node in an array's tree structure is made up of a header and three optional sections.
* Binary data
* Attribute nodes{{check}}
* Child nodes

=== Node Header Structure ===
Node headers typically have the same 32-byte structure, though some are longer and some calculate certain values differently.

{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
| 0x00
| 4
| Unsigned Int
| Signature (magic)
|-
| 0x04
| 4
| Unsigned Int
| Node size. Different node types calculate this differently.
|-
| 0x08
| 4
| Unsigned Int
| Offset to the first child node, or <code>FF FF FF FF</code> if there are no children
|-
| 0x0c
| 4
| Unsigned Int
| Offset to the next sibling node, or <code>FF FF FF FF</code> if there are no more siblings
|-
| 0x10
| 4
| Unsigned Int
| Offset to the first attribute{{check}}, or <code>FF FF FF FF</code> if there are no attributes
|-
| 0x14
| 4
| Unsigned Int
| Offset to the binary data, or the size of the header
|-
| 0x18
| 4
|
| Padding
|-
| 0x1c
| 2
| Unsigned Short
| Number of child nodes. Shaders' use of this value is unknown.
|-
| 0x1e
| 2
| Unsigned Short
| Unknown (<code>00 01</code>)
|}

=== Emitter Sets (ESTA) ===
The Emitter Set Array (ESTA) contains any number of Emitter Sets (ESET) as child nodes.

==== Emitter Set (ESET) ====
Emitter sets (ESET) contain 0x60 bytes of data after the header:

{| class="wikitable"
!Offset (h)
!Size (h)
!Data Type
!Description
|-
| 0x10 || 0x40 || String || 0-terminated string representing the name of the emitter set
|-
| 0x50 || 0x04 || Unsigned Int || Total number of emitters in the set, including all descendant nodes
|-
| 0x5a || 0x02 || Unsigned Short || Unknown
|-
| 0x5f || 0x01 || Byte || Unknown. Can be <code>0x00</code> or <code>0xff</code>
|}

The rest of the data block is padding.

Emitter sets also contain any number of Emitters (EMTR) as child nodes.

==== Emitter (EMTR) ====
An Emitter's (EMTR) data section is aligned to 0x20 bytes and contains the following data after the header:

{| class="wikitable"
! Offset (h)
! Size (h)
! Data Type
! Description
|-
| 0x00 || 0x60 || Name block, like in ESET
|-
| 0x60 || 0x18 || Six Unsigned Ints specifying the sizes of the color arrays
* Color 0
* Alpha 0
* Color 1
* Alpha 1
* Scale{{check}}
* Unknown
|-
| 0x78 | 0x38 || Byte[56]|| Padding
|-
| 0xB0 || 0x30 || UInt32[12] || Unknown
|-
| 0xE0 || 0x4 || Float || Blink Intensity 1
|-
| 0xE4 || 0x4 || Float || Blink Intensity 2
|-
| 0xE8 || 0x4 || Float || Blink Duration 1
|-
| 0xEC || 0x4 || Float || Blink Duration 2
|-
| 0xF0 || 0x2C0 || Float[176]{{check}} || Unknown
|-
| 0x3B0 || 0x4 || Float || Radius
|-
| 0x3B4 || 0x4 || Float || Unknown
|-
| 0x3B8 || 0x8 || Byte[8] || Padding
|-
| 0x3C0 || 0x80 || Float[4] * 8 || Color 0 array (eight sets of four 32-bit floats describing Red, Green, Blue, and Time)
|-
| 0x440 || 0x80 || Float[4] * 8 || Alpha 0 array (eight sets of four 32-bit floats describing Red, Green, Blue, and Time)
|-
| 0x4C0 || 0x80 || Float[4] * 8 || Color 1 array (eight sets of four 32-bit floats describing Red, Green, Blue, and Time)
|-
| 0x540 || 0x80 || Float[4] * 8 || Alpha 1 array (eight sets of four 32-bit floats describing Red, Green, Blue, and Time)
|-
| 0x5C0 || 0x40 || Float[16]{{check}} || Unknown array
|-
| 0x600 || 0x80 || Float[4] * 8 || Scale{{check}} array (eight sets of four 32-bit floats)
|-
| 0x680 || 0xD0 || Float[52]{{check}} || Unknown
|-
| 0x750 || 0x10 || Byte[16] || Unknown
|-
| 0x760 || 0x90 || Float[36]{{check}} || Unknown
|-
| 0x7F0 || 0x8 || Byte[8] || Unknown
|-
| 0x7F8 || 0x40 || Float[16]{{check}} || Unknown
|-
| 0x838 || 0x8 || Byte[8] || Unknown
|-
| 0x840 || 0x58 || Float[22]{{check}} || Unknown
|-
| 0x898 || 0x8 || Byte[8] || Unknown
|-
| 0x8A0 || 0x8 || Float[2]{{check}} || Unknown
|-
| 0x8A8 || 0x10 || Byte[16] || Unknown
|-
| 0x8B8 || 0x18 || Float[6]{{check}} || Unknown
|-
| 0x8D0 || 0x10 || Byte[16] || Unknown
|-
| 0x8E0 || 0x18 || Float[6]{{check}} || Unknown
|-
| 0x8F8 || 0x18 || Byte[24] || Unknown
|-
| 0x910 || 0x8 || Float[2]{{check}} || Unknown
|-
| 0x918 || 0x4 || Byte[4] || Padding?{{check}} Sometimes <code>FF FF FF FF</code>
|-
| 0x91C || 0x8 || UInt64{{check}} || Unknown. Sometimes <code>FF FF FF FF</code>
|-
| 0x924 || 0x4 || Byte[4] || Padding?{{check}} Sometimes <code>FF FF FF FF</code>
|-
| 0x928 || 0x8 || Float[2]{{check}} || Unknown
|-
| 0x930 || 0x8 || UInt64{{check}} || Unknown
|-
| 0x938 || 0x10 || Float[4]{{check}} || Unknown
|-
| 0x948 || 0xA || String || Usually is <code>ATEST_ONLY</code> when used. Can be null.
|-
| 0x952 || 0x2 || Byte[2] || Padding
|-
| 0x954 || 0x48 || UInt32[48]{{check}} || Unknown
|-
| 0x99C || 0xC || Byte[12] || Unknown
|-
| 0x9A8 || 0x10 || Float[4] || Constant Color 0 if Color 0 array is empty
|-
| 0x9B8 || 0x10 || Float[4] || Constant Color 1 if Color 1 array is empty
|-
| 0x9C8 || 0x30 || UInt32[12]{{check}} || Unknown
|-
| 0x9F8 || 0x60 || Three Sample Info blocks, consisting of the following structure:
* 0x00 - UInt32 - Enabled flag - Set if 0, unset if -1
* 0x04 - UInt32 - Texture ID
* 0x08 - Byte - 1st flag - Can be 0, 1 or 2
* 0x09 - Byte - 2nd flag - Can be 0, 1 or 2
* 0x0A - Byte - Padding
* 0x0B - Byte - 3rd flag - Can be either 0 or 1
* 0x0C - Float - Unknown - Can be 2.0. 6.0 or 15.99
* 0x10 - Byte[4] - Padding
* 0x14 - Byte - 4th flag - Can be either 0 or 1
* 0x15 - Byte - 5th flag - Can be either 0 or 1
* 0x16 - Byte - 6th flag - Can be either 0 or 1
* 0x17 - Byte - 7th flag - Can be either 0 or 1
* 0x18 - Byte - 8th flag - Can be either 0 or 1
* 0x19 - Byte[7] - Padding
|-
| 0xA58 || 0x30 || Byte[48] || Unknown
|}

Emitters can also have any number of attribute nodes (e.g. CADP, CSDP, FCSF), the purpose of which is currently unknown, as well as child emitter nodes.

===== Attributes =====

'''CADP''' causes an emitter to cast light on surrounding surfaces. It contains the following data:

{| class="wikitable"
! Offset (h)
! Size
! Data Type
! Description
|-
| 0x00 || 0x04 || Bitmask || Flag determining the light's shape
|-
| 0x04 || (variable) || Float || A variable number of floats whose purpose is unknown
|}

Shape flag:

{| class="wikitable"
! Flag
! Description
|-
| 0x00 || Sphere
|-
| 0x01 || Rod (e.g. swords)
|-
| 0x02 || Changes the orientation of Rod
|-
| 0x04 || Adds a dead zone to the center of Rod
|-
| 0x08 || Wide cone
|-
| 0x10 || Square
|-
| 0x20 || Point
|-
| 0x40 || Widens the Point
|}

=== Textures (TEXA) ===
The Texture Array (TEXA) contains any number of Textures (TEXR), with each texture containing a single GX2 Texture Block (GX2B). The TEXA tree is flattened such that all TEXR nodes appear first, followed by all of their child GX2B nodes.

=== (PRMA) ===
The PRMA{{check}} contains any number of PRIM{{check}} nodes.

=== Shaders (SHDA) ===
The Shader Array (SHDA) contains a single{{check}} GX2 Shader Block (SHDB).

<references />

[[Category:File formats]]

Help:Porting mods

2022-01-05T22:12:22Z

Nitram: /* Animations */

Help:Porting mods

2022-01-05T22:11:19Z

Nitram: Created page with "Due to the development of BotW starting on WiiU and then being ported to Switch, many of the game's files are not inter-compatible, meaning some WiiU files will not work on Sw..."

Due to the development of BotW starting on WiiU and then being ported to Switch, many of the game's files are not inter-compatible, meaning some WiiU files will not work on Switch and viceversa. This article covers all tools and ways of using those tools to port mods between platforms.

Note that if you want to port a WiiU mod to Switch, you can use [https://gamebanana.com/tools/7836 this tool] for a more automated process. If it errors out, you can come back to this guide and follow the steps for your desired files.

== Camera, Model and UI ==
All these files fall under the <code>FRES</code> format, which can be edited using [https://github.com/KillzXGaming/Switch-Toolbox Switch Toolbox](referred to as STB from now on). Preferably, you will be modifying the same file that was used to make your original mod, but creating a new file from scratch can sometimes work when applicable.

=== Importing your files ===
Once you open STB, you'll be greeted with an empty workspace, along with drop-down menus labeled '''File''', '''Edit'''(greyed out), '''Tools''', '''Experimental''', '''Windows''', '''Settings''', '''Console''' and '''Help'''.
[[File:Screenshot from 2022-01-05 09-44-18.png|thumb|An empty workspace, shown when opening STB]]
From the '''File''' drop-down menu, use either ''Open'' for opening a single file, or ''Open (folder)'' if you want to open all files within a folder. The following process differs from file to file, so make sure to follow the corresponding section.
====Animations====
Animations have 9 different types:
- Skeletal Animation
- Shader Parameter Animation
- Color Animation
- Texture SRT Animation
- Texture Pattern Animation
- Bone Visibility Animation
- Material Visibility Animation
- Shape Animation
- Scene Animation
Out of all these, Breath of the Wild does not use Shape Animations, so they will be ignored for the purpose of this tutorial. As of the time of writing, only Skeletal, Color, Texture SRT and Texture Pattern animations can be exported from a modded file and reimported into your target platform using STB. All others need to be recreated when needed.
==Effects==
==Physics==
==Sound==
==Others==
All file types not covered in this guide can be converted using [https://github.com/NiceneNerd/BCML BCML's] converter without issue.

File:Screenshot from 2022-01-05 09-44-18.png

2022-01-05T12:48:28Z

Nitram:

A mainly empty workspace, shown when opening Switch Toolbox