# Script File Format Documentation
This is information for the `stageXX.bin` files that are found in `DATA.BIN` of the game's ISO. There are 12 script files.

## The Format

|Address|Section|
|---|---|
|$0-$2000|Pointer Table|
|$2001-EOF|Script|

## Pointer Table
The pointer table has a repeating pattern of a **Script Index** and **Pointer**.  
**Script Index** is 4 bytes long and is stored in little-endian.  
**Pointer** is 4 bytes long and is stored in little-endian.  
To get the true offset of the pointer add $2000 to the value.  
For example, a pointer value of `00 E1 0C 00` ($CE100) means the true offset is at `$D0100`.  
The table is always $2000 bytes long allowing for a maximum of 1024 entries.  
If there is less than 1024 entries the table section is padded with `$00`'s.  

## Script
One pointer can have as many lines of text and has no length limitations.  
  
### Font Info
All text is Shift-JIS encoded with fullwidth characters being 2 bytes long and 20 pixels wide while halfwidth characters are 1 byte long and 10 pixels wide.  
In `SLPM_663.60` the font graphics are located at $1A3E99 as 4BPP graphics, its palette is stored at $25E4C0, and the fontmap is at $1A31F0.  
`font.py` extracts the fontmap from `SLPM_663.60` to create a `font.tbl` table file.  
Use `kefin.tbl` for corrected values and control codes.  

### Control Codes
Control codes and related info can be found at the function located at `$4CE00` in `SLPM_663.60` (Loaded into `$0014CD80`)

|Hex Values|Meaning|Table file|
|---|---|---|
|`$0A`|Newline|`[LINE]`|
|`$1D $XXXX`|Move NPC? If `$XXXX` is not `$3000` then the NPC will not face Adol|`[MOVE]`|
|`$1D $XXXX $YYYY`|Move NPC? `$YYYY` is the direction the NPC will face|`[MOVE]`|
|`$23 $XXXX`|Normally `#`, change colour of text based on ASCII values of $XXXX (See Colour Section)|`[HASH]`|
|`$2F $XXXX`|Normally `/`, unknown, $XXXX is stored in little-endian|`/<$XX><$XX>`|
|`$3B $XX`|Show character name in dialoague box (see Character section)|`[CHAR]`|
|`$44 $XXXXXXXX`|Normally `D`, jump to new text with given Script Text (see above)|`[INDEX]`|
|`$52 $XXXX`|Normally `R`, set textbox? If `$XXXX` is not `$3000` then it will not point to the speaker|[BOX]|
|`$XX $80`|Print $XX number of bytes|`[LEN]`|
|`$FF`|End text?|`[END]`|
|`$81A5`|Normally `▼`, wait for player input|`[WAIT]`|
|`$FFFD $XX`|Pause printing text for $XX frames(?)|`[PAUSE]`|

`string.py` can be used to calculate a new [LEN] value.

#### Colours
The value of the `$23` Colour control code translates to the ASCII values of the two bytes after the code.  
White is the default colour for text.

|Hex values|ASCII|Meaning|Colour code|
|---|---|---|---|
|`$77 $68`|`wh`|White|   |
|`$67 $72`|`gr`|Green|   |
|`$62 $6C`|`bl`|Blue|   |
|`$70 $69`|`pi`|Pink|   |
|`$79 $6C`|`yl`|Yellow|   |
|`$72 $65`|`re`|Red|   |
|`$62 $6B`|`bk`|Black|   |
|`$67 $6C`|`gl`|Gray|   |
|`$63 $79`|`cy`|Cyan|   | 


#### Characters
The value of the `$3B` Character control code comes from the index value from a list of pointers.  
These pointers are found at $2298E0 in `SLPM_663.60` and `pointer.py` can be used to extract this list.

| Value | Original Text | Translation |
|---|---|---|
| $0 | アドル | Adol |
| $1 | ドギ | Dogi |
| $2 | ニーナ | Niena |
| $3 | テラ | Terra |
| $4 | マーシャ | Massea |
| $5 | スタン | Stein |
| $6 | ドーマン | Doman |
| $7 | リジェ | Rizze |
| $8 | ジャビル | Jabir |
| $9 | エフィ | Effey |
| $A | ケフィン王 | King Kefin |
| $B | アルガ | Alga |
| $C | ディオス | Dios |
| $D | ノティス | Nottis |
| $E | チェイス | Chase |
| $F | アイシャ | Aisha |
| $10 | ウイリー | Willy |
| $11 | ムバーハ | Mubaja |
| $12 | バルク | Baruq |
| $13 | アビス | Abyss |
| $14 | カリオン | Karion |
| $15 | 鍛冶屋 | Blacksmith |
| $16 | 水夫 | Sailor |
| $17 | 執事 | Butler |
| $18 | メイド | Maid |
| $19 | 下級兵士 | Foot Soldier |
| $1A | 兵士 | Soldier |
| $1B | 冒険家Ａ | Adventurer A |
| $1C | 冒険家Ｂ | Adventurer B |
| $1D | 商人Ａ | Merchant A |
| $1E | 商人Ｂ | Merchant B |
| $1F | コボルト | Kobold |
| $20 | 砂漠おばあさん | Desert Old Woman |
| $21 | 砂漠おじいさん | Desert Old Man |
| $22 | 砂漠女 | Desert Woman |
| $23 | 砂漠男Ａ | Desert Man A |
| $24 | 砂漠男Ｂ | Desert Man B |
| $25 | 砂漠女の子 | Desert Girl |
| $26 | 砂漠男の子 | Desert Boy |
| $27 | ケフィン男Ａ | Kefin Man A |
| $28 | ケフィン男Ｂ | Kefin Man B |
| $29 | ケフィン女Ａ | Kefin Woman A |
| $2A | ケフィン女Ｂ | Kefin Woman B |
| $2B | レジスタンスＡ | Rebel A |
| $2C | レジスタンスＢ | Rebel B |
| $2D | おじさんＡ | Man A |
| $2E | おじさんＢ | Man B |
| $2F | おばさん | Woman |
| $30 | 街男Ａ | Villager Man A |
| $31 | 街男Ｂ | Villager Man B |
| $32 | 街娘Ａ | Villager Girl A |
| $33 | 街娘Ｂ | Villager Girl B |
| $34 | おばあさん | Old Woman |
| $35 | おじいさん | Old Man |
| $36 | 男の子Ａ | Boy A |
| $37 | 男の子Ｂ | Boy B |
| $38 | 女の子Ａ | Girl A |
| $39 | 犬 | Dog |
| $3A | 女の子Ｂ | Girl B |
| $3B | 誘拐スタン | Kidnapped Stein |
| $3C | ノティス＆ディオス | Noties & Deios |
| $40 | 綺麗な女性 | Beautiful Woman |
| $41 | 女の子 | Girl |
| $42 | 乱暴者Ａ | Thug A |
| $43 | 乱暴者Ｂ | Thug B |
| $44 | 謎の声 | Mysterious Voice |
| $45 | 謎の男 | Mysterious Man |
| $46 | 大男 | Big Man |
| $47 | おばさん | Woman |