Sanny Builder provides the end-user the following features:
Sanny Builder Library is a community-driven portal aiming to document all known scripting commands used in GTA III, Vice City and San Andreas. You can find it here: https://library.sannybuilder.com/
Starting with v3.8.0 Sanny Builder uses library's files to provide brief descriptions to all opcodes directly in the IDE complimentary to the Show opcode info feature. Those files are controlled with the new
<library> parameter in the edit mode configuration.
Double-clicking the opcode description in the status bar opens the library's page with this opcode's full description in the browser.
If the current edit mode uses the library documentation there is a text in the status bar telling the version of the documentation, e.g.
SBL v0.119. The version may vary from mode to mode.
Clicking the library version text in the status bar brings up a popup menu from which you can check if there are newer versions and download them. If you enable
Automatic updates option Sanny Builder will check the updates and download them on startup.
Sanny Builder's look and feel can be customized with themes. They define colors and style of the interface and code elements for easier reading. The active color theme can be changed in the options.
Also Sanny Builder has a built-in theme editor for quick customization of the existing themes.
You can bookmark a line by pressing
Ctrl+Shift+0..9 and then get back to it by pressing
Ctrl+0..9. To delete all bookmarks, use the menu option
Edit->Clear All Bookmarks.
Alternatively you can go to a particular line using the
Go To Line feature. Press
Ctrl+G, enter the line number and the editor will move the cursor to it.
The IDE allows to quickly navigate to some points of interest in the code without using the
Find dialog box.
To go to the line marked with a label (e.g,
:MyLabel), put the cursor on the label reference (
@MyLabel) and press
Alt+Right. If the label exists, the cursor position will change.
Similarly, to navigate to the start of a function or mission, use
Alt+Right on the function or mission name.
To return back to the previous position, press
Alt+Left. Keep pressing if you had more than one navigation.
These shortcuts can be redefined in the options.
When the option
Show opcode info is enabled the bottom bar displays:
a number of parameters for the current opcode;
a constant value when the cursor is on the constant name and the language service is enabled.
a brief description what this command does (from Sanny Builder Library)
Use the built-in Opcode Search tool to find an opcode you need.
Ctrl+Alt+1 when GTA San Andreas is running and the Coords Manager window will appear. You can read the player's coordinates from the game memory and modify them there.
In the top edit line you can enter the XYZ coordinates, delimited by the space character or the comma character
,. Additionally, you can insert the player's coordinates in the script source by pressing
Ctrl+Shift+C. To insert the player's z-angle, press
You can record a key pressing sequence (macro) and playback it later. Consider the following code:
$Actor = Actor.Create(CivMale, #MALE01, 100.0, 100.0, 10.0)$ActorWithGun = Actor.Create(CivMale, #MALE01, 110.0, 100.0, 20.0)$Gang01 = Actor.Create(CivMale, #MALE01, 120.0, 100.0, 30.0)$Gang02 = Actor.Create(CivMale, #MALE01, 130.0, 100.0, 40.0)$Killer = Actor.Create(CivMale, #MALE01, 140.0, 100.0, 50.0)$ActorWithoutGun = Actor.Create(CivMale, #MALE01, 150.0, 100.0, 60.0)
Say, you need to exchange the actor's handles in each pair (i.e have
$ActorWithGun instead of
$Actor, and vice versa).
Place the cursor in the first line before
$Actor and press
Ctrl+M. The editor immediately begins recording all keys - so be careful!
Press and hold
Ctrl and press the
Right Arrow button once
Down Arrow button. The cursor must be on the second line with the global variable in the clipboard
Ctrl+Right Arrow and
Up Arrow button
Ctrl+Shift+Right Arrow and
Now the first two lines should look like these:
$ActorWithGun = Actor.Create(CivMale, 100.0, 100.0, 10.0)$Actor = Actor.Create(CivMale, 110.0, 100.0, 20.0)
with the cursor being in the beginning of the first line. Now press
Ctrl+M to stop recording.
You can playback the recorded sequence by pressing
Ctrl+P. Place the cursor in the beginning of the third line, press
Ctrl+P and the actor handles will be swapped.
During recording, you can pause/unpause it by pressing
Sanny Builder allows using a mission name in the opcode
start_mission. The mission name is the label defined with a
DEFINE MISSION command. Say, you have:
DEFINE MISSION 10 AT @MYMISSION
start_mission 10 you can write
There is also the Replace Mission Numbers option. When it's enabled, the decompiler automatically replaces all mission numbers with their names.
To call the mission names list, press
Ctrl+Space. The cursor has to be directly after the
Additionally, you can use navigate to the mission code when the cursor is under the mission name.
Since v3.2.0 Sanny supports custom mission titles for each available edit mode. They are stored in the
missions.txt file. This file is used by the disassembler to add the title as a comment on line with mission define (
DEFINE MISSION) or start (
SCM file contains custom-made missions you may edit the
missions.txt to have the correct titles after disassembling.
Sanny Builder has fully multilingual interface translated into 15 languages. You can switch the languages in the options (
F10). Refer to sannybuilder/translations for more information on how to create or update a translation.
You can configure up to
9 apps to run when you need them. Each app has its own hotkey for your convenience. You may also pass the parameters to your app if needed. To pass the name of the currently opened file use the special word
Since v3.7.0 it's also possible to pass the variables
@game: that represent Sanny Builder directory and current game directory respectively into the command-line parameters of the external app:
Sanny Builder is able to check if a new version is available. To use this feature go to menu
Help->Check for update.... The editor will connect to a remote server and if a newer version is available it prompts the download and install.
The editor can also check for an update during startup if you enable this option in the updater window.