2016-02-22T19:27:43Z

Nethraz: Added list of flags (+4 and +8)

The game uses objects to store runtime information about sprites and scripts,
e.g. size and position of a sprite, or the current script address.
Each object has a handle in range 0x1000...0x1F80, in steps of 0x40, allowing for a maximum of 63 objects.
Object data is stored in chunks of 0x1000 bytes at various places in RAM.
Objects are created by declaration in the [[Map Object Header]] or by script command.

== Object Data ==

Offsets must be added to the object handle to get the memory address.

{| class="wikitable"
|+ Table at 7E1000
|-
! Offset !! Size !! Description
|-
| 7E0000 || 2 || X Position (signed)
|-
| 7E0002 || 2 || Y Position (signed)
|-
| 7E0004 || 2 || Interaction Flags

{| class="wikitable"
|-
! Value !! Description
|-
| 8000 || Invisible
|-
| 0400 || Player
|-
| 0200 || Enemy
|-
| 0010 || not attacking (0 while attacking)
|-
| 0008 || Shielding
|-
| 0004 || Interacts with map
|-
| 0002 || Projectile
|-
| 0001 || Blockable by shield
|}

|-
| 7E0006 || 2 || Handler Invocation Mask
|-
| 7E0008 || 2 || Sprite Flags

{| class="wikitable"
|-
! Value !! Description
|-
| 8000 || V-Flip
|-
| 4000 || H-Flip
|}

|-
| 7E000A || 3 || Script Pointer, also used for reentry
|-
| 7E000E || 2 || Reentry Delay in frames
|-
| 7E0012 || 1 || Bank for bounds data (used with ptr at 7F000A)
|-
| 7E0016 || 2 || Elevation level (sprites on different levels can't hit each other)
|-
| 7E002C || 2 || Previous Object in List
|-
| 7E002E || 2 || Next Object in List
|}

{| class="wikitable"
|+ Table at 7F1000
|-
! Offset !! Size !! Description
|-
| 7F000A || 2 || Pointer to Bounding Rect Table [ROM], used with bank at 7E0012

{| class="wikitable"
|+ Bounding Rect Table
|-
! Offset !! Size !! Description
|-
| 0 || 4 || Map Collision Rect
|-
| 4 || 4 || Attack Collision Rect
|-
| 8 || 4 || Defense Collision Rect
|}

{| class="wikitable"
|+ Rect
|-
! Offset
| 0 || 1 || 2 || 3
|-
! Value
| Left || Width || Top || Height
|}

Values are signed 8 bit pixel coordinates, relative to the object's X and Y position.

|-
| 7F0018 || 2 || Movement dx
|-
| 7F001A || 2 || Movement dy
|}

{| class="wikitable"
|+ Table at 7F2000
|-
! Offset !! Size !! Description
|-
| 7F1022 || 2 || Fighting Data Ptr [ROM], Bank: 8D
|-
| 7F102A || 2 || Current HP
|}

== Double Linked List ==

Objects are organized in a double linked list.
The list defines, among other things, the order in which scripts run.

{| class="wikitable"
|+ Double Linked List
|-
! Offset !! Description
|-
| 0DFA || First entry
|-
| 0DFC || Last entry
|-
| object[2C] || Predecessor
|-
| object[2E] || Successor
|}

ROM

2016-02-22T18:29:20Z

Nethraz: added link to Map Object Header

All these offsets are for the "Terranigma (G) (V1.0) [!]" version of Terranigma!

[[Additional Information]] Unused content, debug stuff, ...

[[Chest Information]]

[[Compression]]

[[Enemy Information]]

[[Event Flags]]

[[Graphics]]

[[Items]]

[[Maps]] ([[Map Script Format]], [[Map Exit Format]], [[Map Flags]], [[Map Object Header]])

[[Messages]] ([[Message Format]])

[[Music]]

[[RAM]]

[[ROM Layout]]

[[Objects]]

[[Scripts]] ([[Script Format]])

[[Sprite Layout Information]]

[[Store Information]]

[[Tiles]]

[[XP Table]]

[[Autohealing]]

Map Object Header

2016-02-22T18:28:14Z

Nethraz: Introduction + Table of commands

The '''Map Object Header''' declares the objects (and sprites) that are initially present on a map.
It also contains the [[Map Flags]] as first two bytes.

The address of the header can be found either at [28000 + 2*map_id] or at [38000 + 2*map_id], only one of these is allowed to be not null. The header is stored in the same 0x8000 bank as the pointer, either 0x82 or 0x83.

After the 2 byte [[Map Flags]], the header consists of a sequence of commands, which is terminated by 0xFF and the map's title.

== Commands ==

If a command declares an [[Objects|Object]], it gets assigned a handle in sequential order (starting from 0x1000) and is appended to the end of the object list.

The first object usually is the Ark Sprite, created by command '''FD''' and has the handle 0x1000.

{| class="wikitable"
|-
! Command !! Size !! Description
|-
| FF || 1 || End of header, followed by map title, which is terminated by 0xD4 (see [[Message Format]])
|-
| FE || 5 || Declare Object with Script
|-
| FD || 7 || Declare Object with Position and Script
|-
| FC || ?? || ??
|-
| FB || 5 || ??
|-
| FA || 3+2*x || Conditional Jump
|-
| F0 || 7 || ??
|-
| other || 10 or 16 || Declare Sprite with Flags3, Position, Script and optional Death Handler.

If '''(Extension Flags & 0xC0) == 0xC0''', then the command length is 16 and the death handler is specified,
else the length is 10.

{| class="wikitable"
|-
! Offset || 0 || 1 || 2 || 3 || 4 || 7 || 10 || 13
|-
! Value
| Flags3 = (value & 0xC1) << 8 || X Position || Y Position || Extension Flag || Script || ?? || Death Handler || ??
|}

Objects

2016-02-22T16:58:03Z

Nethraz: Added information about double linked list

The game uses objects to store runtime information about sprites and scripts,
e.g. size and position of a sprite, or the current script address.
Each object has a handle in range 0x1000...0x1F80, in steps of 0x40, allowing for a maximum of 63 objects.
Object data is stored in chunks of 0x1000 bytes at various places in RAM.
Objects are created by declaration in the [[Map Object Header]] or by script command.

== Object Data ==

Offsets must be added to the object handle to get the memory address.

{| class="wikitable"
|+ Table at 7E1000
|-
! Offset !! Size !! Description
|-
| 7E0000 || 2 || X Position (signed)
|-
| 7E0002 || 2 || Y Position (signed)
|-
| 7E0004 || 2 || Flags
|-
| 7E0006 || 2 || Flags2
|-
| 7E0008 || 2 || Flags3
|-
| 7E000A || 3 || Script Pointer, also used for reentry
|-
| 7E000E || 2 || Reentry Delay in frames
|-
| 7E0012 || 1 || Bank for bounds data (used with ptr at 7F000A)
|-
| 7E0016 || 2 || Elevation level (sprites on different levels can't hit each other)
|-
| 7E002C || 2 || Previous Object in List
|-
| 7E002E || 2 || Next Object in List
|}

{| class="wikitable"
|+ Table at 7F1000
|-
! Offset !! Size !! Description
|-
| 7F000A || 2 || Pointer to Bounding Rect Table [ROM], used with bank at 7E0012

{| class="wikitable"
|+ Bounding Rect Table
|-
! Offset !! Size !! Description
|-
| 0 || 4 || Map Collision Rect
|-
| 4 || 4 || Attack Collision Rect
|-
| 8 || 4 || Defense Collision Rect
|}

{| class="wikitable"
|+ Rect
|-
! Offset
| 0 || 1 || 2 || 3
|-
! Value
| Left || Width || Top || Height
|}

Values are signed 8 bit pixel coordinates, relative to the object's X and Y position.

|-
| 7F0018 || 2 || Movement dx
|-
| 7F001A || 2 || Movement dy
|}

{| class="wikitable"
|+ Table at 7F2000
|-
! Offset !! Size !! Description
|-
| 7F1022 || 2 || Fighting Data Ptr [ROM], Bank: 8D
|-
| 7F102A || 2 || Current HP
|}

== Double Linked List ==

Objects are organized in a double linked list.
The list defines, among other things, the order in which scripts run.

{| class="wikitable"
|+ Double Linked List
|-
! Offset !! Description
|-
| 0DFA || First entry
|-
| 0DFC || Last entry
|-
| object[2C] || Predecessor
|-
| object[2E] || Successor
|}

ROM

2016-02-22T16:28:30Z

Nethraz: Added link to new objects page

All these offsets are for the "Terranigma (G) (V1.0) [!]" version of Terranigma!

[[Additional Information]] Unused content, debug stuff, ...

[[Chest Information]]

[[Compression]]

[[Enemy Information]]

[[Event Flags]]

[[Graphics]]

[[Items]]

[[Maps]] ([[Map Script Format]], [[Map Exit Format]], [[Map Flags]])

[[Messages]] ([[Message Format]])

[[Music]]

[[RAM]]

[[ROM Layout]]

[[Objects]]

[[Scripts]] ([[Script Format]])

[[Sprite Layout Information]]

[[Store Information]]

[[Tiles]]

[[XP Table]]

[[Autohealing]]

Objects

2016-02-22T16:26:31Z

Nethraz: Objects introduction + Offset tables

Compression

2016-02-18T22:35:12Z

Nethraz: described compression in detail

User:Nethraz/Script Commands

2016-02-18T20:32:57Z

Nethraz: test some new command table layout

Scripts are basically written in ASM.
The '''02''' (COP) ASM instruction is used to execute custom script commands,
with the actual command and parameters following the 02 opcode.

For example the command 07 (Modify Flag) is written as:

02 07 flag_value

where flag_value is the 2 byte flag and value encoded in little endian format,
so the whole command takes up 4 bytes.

The length of every known command is shown in the following table.

{| class="wikitable collapsible" style="font-family:Lucida Console; text-align:right"
|+ Command Length Table
|-
!
! 00 !! 01 !! 02 !! 03 !! 04 !! 05 !! 06 !! 07 !! 08 !! 09 !! 0A !! 0B !! 0C !! 0D !! 0E !! 0F
|-
! 00
| 5 || 2 || 4 || 2 || 2 || 4 || 5 || 4 || 6 || 8 || 6 || 6 || 9 || 9 || 13 || 7
|-
! 10
| 7 || 10 || 10 || 5 || 10 || 2 || 9 || 7 || 8 || 16 || 5 || 4 || 5 || 4 || 5 || 2
|-
! 20
| 2 || 4 || 6 || 4 || 5 || 2 || 6 || || || 4 || 4 || 6 || 6 || 9 || 6 || 6
|-
! 30
| 3 || 3 || 3 || 2 || || 12 || 3 || 3 || 4 || 5 || 5 || 2 || 2 || 5 || 5 || 5
|-
! 40
| 5 || || 8 || 6 || 6 || 2 || 9 || 6 || 4 || 4 || 7 || 5 || || || 6 || 6
|-
! 50
| || || || || 5 || 3 || 5 || 5 || 5 || 3 || 7 || 7 || || 7 || 8 || 10
|-
! 60
| 6 || 8 || 3 || 4 || 7 || 7 || 2 || 3 || || 2 || 4 || 4 || 5 || 2 || 2 || 2
|-
! 70
| 8 || 8 || 5 || || || 6 || 4 || || 3 || || || || || || ||
|-
! 80
| 3 || 3 || 4 || 4 || 5 || 4 || 4 || 5 || 5 || 3 || 3 || || 3 || || 2 || 2
|-
! 90
| || 2 || || 2 || || 2 || || 10 || 12 || 7 || 5 || 7 || 9 || 11 || 9 || 11
|-
! A0
| 7 || 5 || 7 || 9 || 11 || 9 || 11 || 2 || 3 || || 5 || 7 || 6 || 8 || 3 || 3
|-
! B0
| 3 || 4 || 4 || 6 || 2 || 2 || 2 || 2 || 2 || 2 || 3 || 3 || 2 || 2 || 7 || 5
|-
! C0
| 5 || 4 || 4 || 4 || 4 || 4 || 2 || 4 || 4 || 4 || 4 || 6 || 7 || 2 || 11 || 2
|-
! D0
| 18 || 2 || 7 || 10 || 10 || 4 || 5 || 6 || 5 || 3 || 11 || 9 || 7 || 9 || 3 || 5
|-
! E0
| || || || || 2 || 13 || 5 || 7 || 11 || 11 || 5 || 2 || 10 || 7 || 3 ||
|}

[[#00 - Call]]
[[#01 - Return if Called With 00]]
[[#02 - Loop Begin]]
[[#03 - Loop Next (yield)]]
[[#04 - Loop Next (no yield)]]
[[#05 - Wait On Flag]]
[[#06 - Goto New Script Origin]]
[[#07 - Modify Flag]]
[[#08 - Check Flag]]
[[#09 - Check Multiple Flags]]
[[#0A - Check Map Id]]
[[#0B - Check 0600]]

== 00 - Call ==

== 01 - Return if Called With 00 ==

== Experimental Table Layouts ==

{| class="wikitable collapsible" style="font-family:Lucida Console; text-align:left"
|-
! Command (Length)
! Name
! Description
|-
! 0C (7)
| TriggerOnAreaAbsolute
|
{| class="wikitable collapsible" style="font-family:Lucida Console; text-align:center"
|-
! Direction !! Left !! Top !! Right !! Bottom !! JumpAddress
|-
| 1 || 1 || 1 || 1 || 1 || 2
|}

|}

Script Format

2016-02-18T18:11:21Z

Nethraz: commands: D2, DA, 65, 66, 5F, DF

Script Format

2016-02-18T17:21:01Z

Nethraz: command 58

Script Format

2016-02-13T01:00:21Z

Nethraz: fixed lengths for cmds: 6E, 73, 78, B2, DC (also checked all the other lengths)

Talk:Script Format

2016-02-12T23:50:32Z

2016-02-11T22:46:41Z

Nethraz: Added introduction and command length table

Scripts are basically written in ASM.
The '''02''' (COP) ASM instruction is used to execute custom script commands,
with the actual command and parameters following the 02 opcode.

For example the command 07 (Modify Flag) is written as:

02 07 flag_value

where flag_value is the 2 byte flag and value encoded in little endian format,
so the whole command takes up 4 bytes.

The length of every known command is shown in the following table.

{| class="wikitable collapsible" style="font-family:Lucida Console; text-align:right"
|+ Command Length Table
|-
! 00 !! 01 !! 02 !! 03 !! 04 !! 05 !! 06 !! 07 !! 08 !! 09 !! 0A !! 0B !! 0C !! 0D !! 0E !! 0F
|-
! 00
| 5 || 2 || 4 || 2 || 2 || 4 || 5 || 4 || 6 || 8 || 6 || 6 || 9 || 9 || 13 || 7
|-
! 10
| 7 || 10 || 10 || 5 || 10 || 2 || 9 || 7 || 8 || 16 || 5 || 4 || 5 || 4 || 5 || 2
|-
! 20
| 2 || 4 || 6 || 4 || 5 || 2 || 6 || || || 4 || 4 || 6 || 6 || 9 || 6 || 6
|-
! 30
| 3 || 3 || 3 || 2 || || 12 || 3 || 3 || 4 || 5 || 5 || 2 || 2 || 5 || 5 || 5
|-
! 40
| 5 || || 8 || 6 || 6 || 2 || 9 || 6 || 4 || 4 || 7 || 5 || || || 6 || 6
|-
! 50
| || || || || 5 || 3 || 5 || 5 || 5 || 3 || 7 || 7 || || 7 || 8 || 10
|-
! 60
| 6 || 8 || 3 || 4 || 7 || 7 || 2 || 3 || || 2 || 4 || 4 || 5 || 2 || 2 || 2
|-
! 70
| 8 || 8 || 5 || || || 6 || 4 || || 3 || || || || || || ||
|-
! 80
| 3 || 3 || 4 || 4 || 5 || 4 || 4 || 5 || 5 || 3 || 3 || || 3 || || 2 || 2
|-
! 90
| || 2 || || 2 || || 2 || || 10 || 12 || 7 || 5 || 7 || 9 || 11 || 9 || 11
|-
! A0
| 7 || 5 || 7 || 9 || 11 || 9 || 11 || 2 || 3 || || 5 || 7 || 6 || 8 || 3 || 3
|-
! B0
| 3 || 4 || 4 || 6 || 2 || 2 || 2 || 2 || 2 || 2 || 3 || 3 || 2 || 2 || 7 || 5
|-
! C0
| 5 || 4 || 4 || 4 || 4 || 4 || 2 || 4 || 4 || 4 || 4 || 6 || 7 || 2 || 11 || 2
|-
! D0
| 18 || 2 || 7 || 10 || 10 || 4 || 5 || 6 || 5 || 3 || 11 || 9 || 7 || 9 || 3 || 5
|-
! E0
| || || || || 2 || 13 || 5 || 7 || 11 || 11 || 5 || 2 || 10 || 7 || 3 ||
|}

[[#00 - Call]]
[[#01 - Return if Called With 00]]
[[#02 - Loop Begin]]
[[#03 - Loop Next (yield)]]
[[#04 - Loop Next (no yield)]]
[[#05 - Wait On Flag]]
[[#06 - Goto New Script Origin]]
[[#07 - Modify Flag]]
[[#08 - Check Flag]]
[[#09 - Check Multiple Flags]]
[[#0A - Check Map Id]]
[[#0B - Check 0600]]

== 00 - Call ==

== 01 - Return if Called With 00 ==

User:Nethraz

2016-02-11T20:14:35Z

Nethraz: Created page with "== WIP Pages == Script Commands"

== WIP Pages ==

[[User:Nethraz/Script Commands|Script Commands]]

Autohealing

2016-02-11T19:57:41Z

Nethraz: Explain autoheal

Autoheal is enabled if [07EF] == 0001 and Weapon [064A] == 0081 or 009C (Crystal Spear or Hero Pike).

Hero Pike has 4 times faster healing.

Autoheal gets disabled by setting [07EF] = 0 in the script of map 0129 (Chapter 2 intro screen).

ROM

2016-02-11T19:53:42Z

Nethraz: new link for "Autohealing"

All these offsets are for the "Terranigma (G) (V1.0) [!]" version of Terranigma!

[[Additional Information]] Unused content, debug stuff, ...

[[Chest Information]]

[[Compression]]

[[Enemy Information]]

[[Event Flags]]

[[Graphics]]

[[Items]]

[[Maps]] ([[Map Script Format]], [[Map Exit Format]])

[[Messages]] ([[Message Format]])

[[Music]]

[[RAM]]

[[ROM Layout]]

[[Scripts]] ([[Script Format]])

[[Sprite Layout Information]]

[[Store Information]]

[[Tiles]]

[[XP Table]]

[[Autohealing]]