HEX..END

Sanny Builder
Search…
Sanny Builder
In English
HEX..END
Sanny Builder supports writing a raw content in an output file. All values within this construct are written in an output file without any checks.
Use this feature only if you know what you're doing. Any mistakes will corrupt the script file making it unreadable by the game or a script editor.
Syntax
hex
<any hexadecimal numbers>
end
1
hex
2
    04 00 02 0800 04 01
3
end
Copied!
This sequence of bytes is the compiled version of the opcode 0004: $2 = 1, so the game will correctly read it and set the value of the variable $2 to 1.
You must specify each byte you're going to write with two digits. All spaces are ignored. The compiler treats any two digits with a space between them as a single byte value. A single digit (0..F) is prefixed with 0. So, for example, a sequence of three lettersA B C will be compiled as the number 0xAB0C.
The HEX..END construct also accepts string literals, labels, global variables, model names. They are compiled without a preceding data type byte.
1
:get_offset
2
hex
3
    04 00 02 $PLAYER_CHAR 01 @get_offset
4
end
Copied!
This is the exact copy of the opcode 0004: $PLAYER_CHAR = @get_offset
A string literal enclosed in double quotes is compiled as a sequence of characters.
1
hex
2
    "This is a string"
3
end
Copied!
Escape Sequences
The following escape sequences are supported within a string literal:
Name
Escape Sequence
Byte Form
Null 
\0
00
Backspace
\b
08
Tab
\t
09
Line Feed
\n
0A
Carriage Return
\r
0D
Numeric escape sequence
\xnn
nn
Escape char
\char
char
1
hex
2
    "\0\b\t\n\r\xDD"
3
end
Copied!
It produces the following sequence of bytes: 00 08 09 0A 0D DD.
Currently multiple spaces in a string literal are converted into a single one. Thus a line "This    is  a     string" is converted into "This is a string". Use the backward slash character \ to add multiple spaces in a string literal: "This \ \ \ is \ a \ \ \ \ string".
Using aDMA Numbers
Also you can use the aDMA data type to write a numeric constant in an output file. The number after the & sign can be both positive or negative, decimal or hexadecimal.
1
hex
2
    &1000 &-0xA33500 
3
end
Copied!
This example produces the following sequence of bytes: E8 03 00 CB 5C FF.
Last modified 2yr ago
Copy link
Contents
Syntax
Escape Sequences
Using aDMA Numbers