An extension is a set of new instructions added to the vanilla game. The CLEO library and its plugins is the most known way of adding those.
To make Sanny Builder aware of the custom instructions and explicitly signal their intentional usage, a script must have {$USE} directive. The {$USE} directive enables one or multiple sets of instructions (see below the list of extensions).
{$USE CLEO, ini, CLEO+}
Each opcode included in Sanny Builder's INI files has been categorized to belong to some extension. Currently it is done via the file extensions.txt.
{% hint style="info" %}
New edit modes shipped with Sanny Builder 4 use command definitions managed through Sanny Builder Library (SBL). They don't use INI files and extensions.txt. Information about each extension can be found in the JSON file located in the mode directory, or on the Sanny Builder Library website.
{% endhint %}
Standard game opcodes have been included in the default extension that is implicitly available in any script. {$USE default} is possible but redundant.
Using {$CLEO} directive also implies {$USE CLEO} so standard CLEO opcodes are available to the compiler already.
Sanny Builder ships some common and recognized extensions for different edit modes.
{% hint style="info" %} This list does not apply to the new SBL edit modes. Find a list of extensions for each game in Sanny Builder Library. {% endhint %}
| Extension Name | Source | Edit Modes Where Available |
|---|---|---|
CLEO
|
CLEO for GTA III CLEO 4.4 CLEO Android |
GTA III Vice City GTA SA v1.0, v2.0, (v1.0 - SCR) SA Mobile VC Mobile |
ini
|
IniFiles.cleo plugin |
GTA III GTA SA v1.0, v2.0, (v1.0 - SCR) |
file
|
FileSystemOperations plugin |
GTA III GTA SA v1.0, v2.0, (v1.0 - SCR) |
bitwise
|
IntOperations plugin |
GTA III GTA SA v1.0, v2.0, (v1.0 - SCR) |
clipboard
|
ClipboardControl plugin | GTA III GTA SA v1.0, v2.0, (v1.0 - SCR) |
memory
|
MemoryModule plugin | GTA III |
CLEO+
|
CLEO+ plugin | GTA SA v1.0, v2.0, (v1.0 - SCR) |
newOpcodes
|
newOpcodes plugin | GTA SA v1.0, v2.0 |
Restoration
|
Opcode Restoration Project | Vice City |
Using opcodes provided by the third-party libraries not listed above is still possible, the compiler will not require the {$USE} directive for them.