>Aruki at 12:03, 15 November 2016

2016-11-15T12:03:48Z

← Older revision		Revision as of 12:03, 15 November 2016
Line 56:		Line 56:
	\|-		\|-
	\| 0x0		\| 0x0
	\| ~~u32~~		\| {{FourCC}}
	\| 1		\| 1
	\| '''Magic'''		\| '''Magic'''
Line 141:		Line 141:
	! Notes		! Notes
	\|-		\|-
	\| ~~char~~		\| {{FourCC}}
	\| 4		\| 1
	\| '''Condition ID ~~FourCC~~'''		\| '''Condition ID'''
	\|		\|
	\|-		\|-
Line 170:		Line 170:
	! Notes		! Notes
	\|-		\|-
	\| ~~char~~		\| {{FourCC}}
	\| 4		\| 1
	\| '''Action ID ~~FourCC~~'''		\| '''Action ID'''
	\|		\|
	\|-		\|-

>Aruki: Created page with "{{todo|Description of the function of RULE files}} This file format was introduced in Metroid Prime 2 and has appeared in every Retro game since. The format is identical in P..."

2016-11-12T04:49:52Z

Created page with "{{todo|Description of the function of RULE files}} This file format was introduced in Metroid Prime 2 and has appeared in every Retro game since. The format is identical in P..."

New page

{{todo|Description of the function of RULE files}}

This file format was introduced in Metroid Prime 2 and has appeared in every Retro game since. The format is identical in Prime 2/3/DKCR, other than the shorter asset ID length in Prime 2. In Tropical Freeze, the extension was changed to RSTC and the header was changed, but otherwise the format is the same.

Possible version numbers:

{| class="wikitable"
! Version
! Game
|-
| 1
| Metroid Prime 2: Echoes, Metroid Prime 3: Corruption, Donkey Kong Country Returns
|-
| 2
| Donkey Kong Country: Tropical Freeze
|}

__TOC__

== Format ==

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| [[#Header|Header]]
| 1
| '''Header'''
|
|-
| u16
| 1
| '''Rule Count'''
| Count of rules in the file.
|-
| [[#Rule|Rule]]
| ''Rule Count''
| '''Rule Array'''
| Array of rules.
|}

=== Header ===

==== Version 1 ====

Header for RULE files in Metroid Prime 2, Metroid Prime 3, and Donkey Kong Country Returns:

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| u32
| 1
| '''Magic'''
| Always <code>RULE</code>
|-
| 0x4
| u8
| 1
| '''Version'''
| Always 1
|-
| 0x5
| Asset ID (RULE)
| 1
| '''Parent RULE'''
| Parent file which is checked after all conditions in this file have been checked. This allows overriding specific conditions.
|-
| {{none}}
| colspan=4 {{unknown|End of RULE Header}}
|}

==== Version 2 ====

Header for RSTC files in Donkey Kong Country: Tropical Freeze:

{| class="wikitable"
! Offset
! Type
! Count
! Name
! Notes
|-
| 0x0
| [[Form Descriptor (Tropical Freeze)|Form Descriptor]]
| 1
| '''RSTC Form Descriptor'''
| Data type is <code>RSTC</code>
|-
| 0x20
| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]
| 1
| '''RULE Chunk Descriptor'''
| Data type is <code>RULE</code>
|-
| 0x38
| colspan=4 {{unknown|End of RSTC Header}}
|}

=== Rule ===

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u16
| 1
| '''Condition Count'''
| Count of conditions in this rule
|-
| [[#Condition|Condition]]
| ''Condition Count''
| '''Condition Array'''
| Array of conditions
|-
| u16
| 1
| '''Action Count'''
| Count of actions in this rule
|-
| [[#Action|Action]]
| ''Action Count''
| '''Action Array'''
| Array of actions
|}

==== Condition ====

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| char
| 4
| '''Condition ID FourCC'''
|
|-
| u8
| 1
| '''[[#Comparison Operator Enum|Comparison Operator]]'''
| Operator used to compare with ''Value''.
|-
| u8
| 1
| '''[[#Value Type Enum|Value Type]]'''
| Type of ''Value''.
|-
| ''Value Type''
| 1
| '''Value'''
| All types are 32 bits.
|}

==== Action ====

{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| char
| 4
| '''Action ID FourCC'''
|
|-
| u8
| 1
| '''Property Count'''
|
|-
| ''[Varies]''
| ''Property Count''
| '''Property Array'''
| Properties used by this action. All property types are 32 bits. The number and type of properties varies depending on the ''Action ID FourCC''.
|}

==== Comparison Operator Enum ====

{| class="wikitable"
! ID
! Operator
|-
| 0
| Less than
|-
| 1
| Less than or equal to
|-
| 2
| Equal to
|-
| 3
| Greater than or equal to
|-
| 4
| Greater than
|}

==== Value Type Enum ====

Rule values are always 32 bits. These are the possible types:

{| class="wikitable"
! ID
! Type
|-
| 0
| bool
|-
| 1
| float
|-
| 2
| int32
|-
| 3
| {{unknown|Unknown; variable type? Used internally but may not actually be used in RULE files.}}
|}

[[Category:File Formats]]
[[Category:Metroid Prime 2 Demo]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3 Prototype]]
[[Category:Metroid Prime 3: Corruption]]
[[Category:Donkey Kong Country Returns]]
[[Category:Donkey Kong Country: Tropical Freeze]]

RULE (File Format) - Revision history

>Aruki at 12:03, 15 November 2016

>Aruki: Created page with "{{todo|Description of the function of RULE files}} This file format was introduced in Metroid Prime 2 and has appeared in every Retro game since. The format is identical in P..."