Version History
integration with Sanny Builder Library: a new portal documenting all known opcodes
16 new color themes
disassembler now outputs the content of a
hex..endblock as a string if it's a sequence of ASCII characters ending with 00 #33new debug option to let disassembler ignore custom information attached to the compiled script
new CLI parameter to launch the editor with custom options
custom user templates are now stored in a separate file and kept between updates
hotkeys using Numpad buttons have been changed (Zoom text: Ctrl + +/- and Navigate to label and back: Alt + Right/Left)
updated CLEO+ plugin to v1.0.8
updated translations to Hungarian, Spanish, Ukrainian and Chinese languages
👏 Kudos to contributors to this release: forms55, MatiDragon, Vital, wmysterio, XMDS
the autocomplete list displays declared constants (#40)
new VC Mobile mode with CLEO Android opcodes (sannybuilder/data#11)
added spaceeinstein's Opcode Restoration project opcodes in VC PC mode
error messages now have a link to localized documentation if possible (#101)
user tools configuration supports @sb: and @game: variables (#72)
CLEO+ plugin updated to v1.0.7
Read more on constants highlighting there: Language service.
👏 Kudos to XMDS for contributions to this release.
fixed a bug with labels missing in disassembled CLEO scripts #99
updated translation to Ukrainian language
updated CLEO+ plugin to v1.0.4
updated opcode definitions and keywords for CLEO opcodes #95
minor fixes and improvements (see the complete list)
👏 Kudos to wmysterio and XMDS for their contributions.
support for enumerated types in classes
initial support for language extensions
better integration with CLEO library:
updated third-party tools in the
toolsdirectory:CLEO v4.4
SCRLog v2020.2
added CLEO+ plugin for GTA SA with 250+ new opcodes
recognize Cleo for Android scripts (
*.csa,*.csi) as compiled scriptscompiler uses CLEO opcodes
0A9E,0A9F,0A90,0A91in certain expressions when no opcode is suppliedunified description and keywords for CLEO opcodes across different edit modes
added keywords for all opcodes in GTA SA SCR mode
word thread has been replaced with script in opcode definitions and keywords (see why)
👏 Kudos to MatiDragon and Wesser for updated translations.
fixed a bug with LCS and VCS compilation (#56)
arrays in LCS and VCS now get custom names from
CustomVariables.iniandCustomArrays.ini(#53)
👏 Kudos to darkdraggy for reporting the first bug and helping to test the fix.
updated command line interface
Unix-style syntax with hyphens (#42)
improved edit modes
games.xmlrenamed tomodes.xml, inner structure updatedmodes can now inherit properties of other modes (useful for different versions of one game)
a new mode for SA v2.0 (using
CustomLabels_v2.ini)separate modes for VCS PSP and VCS PS2 (#41)
support for custom IDE/DAT files
"hot" reloading of modes configuration (#15)
increased available space for the mode name section (#8)
updated opcode definitions for LCS/VCS*
removed SAMB to SB converter (#27)
fixed file association (#43)
fixed an issue with Opcode Search Tool window not available after minimize (#35)
New opcode definitions for GTA LCS and GTA VCS are incompatible with the previous definitions. You must disassemble the main.scm prior to making any scripts for those games.
👏 Kudos to marcelo_20xx and fastman92 for their awesome contribution to this release.
fixed incorrect number of parameters in opcode
04E3inVCSSCM.INIfixed the issue with the disassembler ignoring
Write opcodesoption and producing a callable label when a regular label is expected
added compiler support for the
SCMformat of GTA: Vice City Stories (#2)added a simpler form of calling subroutines using labels: a label name followed by a pair of parentheses
()substitutes agosubcommandadded more customization points for edit modes:
path to a GXT file used by the disassembler (#7)
path to
opcodes.txt(#5)exclusive code templates
added a new tutorial on higher level constructions in the Sanny Builder language, see
help\examplesdirectoryIDE updates:
Run San Andreasmenu action now checks forgta-sa.exe(Steam)a new menu item to quickly bootstrap a CLEO script file (see the bottom note in Code Templates)
links to the new documentation portal in the main menu and error messages
minor updates:
updated opcode descriptions (player money += in SA, award_achievement in SA Mobile,
0479in VCS)renamed variables
script_controlled_playerandflag_player_on_missiontoPLAYER_ACTORandONMISSIONrespectively in GTA III'sCustomVariables.ini(#3)reverted files in the
help\GXT Stringsdirectory to the older version (#25)renamed
macroes.txttotemplates.txt
👏 Kudos to OrionSR, ZAZ, XMDS, and Wesser for their awesome contribution to this release.
fixed a bug causing incorrect external scripts compilation
fixed the opcode
059Cin the Vice City mode
fixed the bug #0048
included
constants.txtmissing in theGTA SAmode
added compiler support for the Liberty City Stories
SCMformatadded aliases for the timer variables:
TIMERAandTIMERBchanged the Ranges check option to apply to the global variables
fixed a regression defect when a CHM help file can not be open
updated opcode definitions for GTA 3 and Vice City
added IDE support for CLEO 2.0 for III and VC
improved support for the version of GTA San Andreas for WinStore, Xbox 360, and PS3
fixed an issue with opcodes
09A4and0A18not being properly decompiled in the SA_Mobile mode
added translation into Korean language (thanks to MINE)
improved HEX..END construct processing
fixed the bug #0000028
added translation into Indonesian language (thanks to IMasterFX)
CLEO for GTA III and CLEO for Vice City updated (thanks to Silent)
adding custom edit modes by editing the
games.xmlfile is now possiblenew edit mode -
GTA SA SCRvariables can be quickly declared using a type name prefix
CLEO updated to the version 4.3.16
added the InstaSearch feature (formerly 'jump to label' function)
mission names can be changed by editing appropriate
missions.txtfilesimproved association of the script file extensions with Sanny Builder
Sanny Builder only checks if the game directory path is not empty, no checks for specific files (such as an
.exe)minor improvements in the SB updating feature
changed the Sanny Builder icon and the menu icons
fixed the bug #0000024
CLEO updated to the version 4.3.14
fixed minor interface glitches for hi-res displays
updated German, Polish, Chinese, Ukrainian translations
added support for iOS and Android versions of GTA San Andreas
a code scan value is now used when making a list of constants
updated Chinese and German translations
added Czech translation
added options to associate file extensions
.csand.cmwith Sanny Builder
added a new directive $OPCODE to register a new opcode in the script
corrected behavior of the directive $INCLUDE while scanning directories for the file
VCSCM.iniis updated to include opcodes for the GTA VC mobile version and unsupported opcodeswhen the option Add extra info to SCM is enabled, Sanny Builder remembers the game a script is compiled for, to use the proper edit mode when decompiling
added a new directive $NOSOURCE to prohibit including a source code into a compiled script
some hotkeys are now customizable in the options
added a feature to check automatically if an update exists at the program startup
directives
$VERSIONand$VERSION_RESTOREare deprecatedupdated Spanish and Chinese translations
Coords manager is now able to change the player's angle in GTA VC
The Sanny Builder installation now includes the SCRLog CLEO plugin by LINK/2012 (can be found in the
toolsfolder)
Sanny Builder is licensed under the Sanny Builder Freeware/Donationware License Agreement
added a feature to report found bugs via the official bug tracker
added a feature to check if an update is available
Coords manager is upgraded to work with all known versions of GTA3, VC and SA (thanks to Silent)
added an updated Chinese translation
minor design changes
added Silent's ASI Loader v1.1 as a default ASI loader for CLEO 3 and CLEO 4
added Chinese translation
added classes
FileandAudiostreamfor backward compatibility with CLEO 4 by Alien
File.Open, Audiostream.Load, Audiostream.Load3D were methods in CLEO 4. Now they are properties. It means, if you get an error when compiling old sources with these commands, change their syntax to:
var = File.Open(file_name, mode)
var = Audiostream.Load(file_name)
var = Audiostream.Load3D(file_name)
the compiler now accepts a string literal as a parameter in a class property
There is a limit on using space characters in such parameter.
the compiler now throws an error for a malformed string literal like
text1"text2"ortext1'text2'(without a leading quotation mark)the compiler is able to compile comment markers (curly braces) within a string (
"{text1}text2")the semicolon (
;) can not be used to comment out a line of the codechanged the syntax of the \debug parameter
added flag icons for the available languages in the options
fixed some issues with disassembling of the VCS SCM format
added new operators
++and--added support for block comments
/* */SASCM.INIgot an update from the GTAG Databasereplaced properties
Actor.ArmourandActor.Carwith their correct versionsActor.AddArmourandActor.MissionCaradded a new property
Actor.CurrentCarfor the opcode03C0in the SA and VC classes.added new hotkeys
Ctrl+Num+andCtrl+Num-to quickly change the text sizeSanny Builder now remembers a number of closed files for the option Load all closed files
fixed a bug when the compiler failed to compile a source with multiple HEX..END constructs
fixed a bug of version 3.05 when the program hung on startup trying to open a file
added new translations for the following languages: Finnish, Polish, Hungarian, Turkish, Ukrainian
the CLEO library updated to version 4.1.1.30f (CLEO 4 by Alien)
added a possibility to install CLEO for GTA III and Vice City (made by Alien)
opcode files (**SCM.ini, opcodes.txt) replaced with the ones from the CLEO 4 library installation
new command line parameter
\nosplash
the editor is able to to convert hexadecimal numbers to decimal ones and vice versa (
Ctrl+H), and convert the model names to their IDs (Ctrl+Alt+H)removed a warning message about
script.imgbeing used by the game when compiling a CLEO scriptthe post-compilation report shows the size of a CLEO script (as
Largest script)fixed a bug when compiling an array with constant numeric indexes
the installer no longer requires the system administrator rights
the previous version of CLEO had a bug
minor changes (the toolbar position wasn't saved)
new version of the CLEO library
main toolbar is movable
the Compile+Copy feature (
F7) does not create a copy of the output file if the source has$Eor$CLEOdirectivesduring a compilation run after pressing
F6, the output file for a source file with the$CLEOdirectiveis created in the same directory; after
F7the output file is created in the CLEO directory (similarly toSCMfiles)new translations: Italian, Portuguese
bug-fixes update
the CLEO 3 library is integrated into Sanny Builder
disassembler supports the
SCMformat of Vice City Storiesconstants support
new directives
$INCLUDE,$EXTERNAL,$CLEOwriting of the additional info to the end of a script file
custom arrays support
a possibility to decompile SCM files having no header
an ability to create an external script named
AAAa new command line parameter
\compilea possibility to use a floating-point value as the counter value in a FOR..END loop
dropped support for the commands
WriteMemandReadMema possibility to use regular expressions when searching
a possibility to save a source file in the
RTForHTMLformatsan ability to skip the splashes at SA startup
a new key combo
Ctrl+Enterupdated
SASCM.INI
fixed a bug when parts of the code within the HEX..END construct disappeared in debug mode
a HEX..END construct now accepts the aDMA type and string literals
a FOR loop accepts model identifiers as the counter values
Memory Hacker became a separate tool.
fixed a decompiler bug
added the Memory Hacker plug-in
disassembler supports the
SCMformat of Liberty City Storiessupport for constant numbers as indexes of global arrays
a global variable gets disassembled with the type aDMA (
&) if its address is not divisible by 4the compiler uses default values during compilation of a
main.scmwith the missing header segments (DEFINE XXX)a possibility to Drag&Drop a file into the editor to open it
new preprocessor directives:
{$VERSION},{$VERSION_RESTORE}
If you get a compiler error message like Unknown directive xxxx when compiling the sources from v2.99, replace the line {$VERSION xxxx} to any place after the header, for instance before the comment //-------------MAIN---------------
added new commands
WriteMemandReadMemsupport for hexadecimal numbers
HEX..ENDstatement accepts labels and global variablesfull support for the ADMA datatype
an opportunity to give custom names to labels
an opportunity to choose a different case for custom names and strings
added console to switch debug options
decompiler supports
GXTfiles of GTA III & GTA VCadded escape sequences in long string literals
information about INI file (version, author, date)
classes support the original order of the parameters (like in
SASCM.INIby PLPynton). The script should have a line {$VERSION x.0.xxxx} to support such order, see comments in theINIabout thisadded option to confirm an exit from the program
a dropdown menu to switch edit modes
converting of the selected piece of code
an opportunity to pass the current file name to an external tool
corrected some mistakes in the configuration files
removed auto-casting of an integer number to the float one when a variable is declared as
Float. Now the compiler chooses an opcode depending on the number type only (in math expressions without opcodes)reading/writing of the player's z_angle in Coord Manager; quick insertion of the z_angle value in the script by pressing
Ctrl+Shift+E(for SA)
The following opcodes were changed in SASCM.INI: 0181, 00c3, 00c4 in order to support the commands WriteMem and ReadMem. The original scripts did not use these opcodes and the unmodified games do not implement them so it should not break existing scripts.
The class member Car.SetSpeedInstantly was named incorrectly (with a wrong opcode) in the classes.db for SA. If you get an error message about this method during compilation, rename it toActor.DrivingPlane. We apologize.
Sanny Builder became multilingual
added menu for external applications
a special version of Opcode Search Tool has been built into SB. The details can be found in the file
OST Readme.txtvalidating math expressions during disassembling when Write opcodes is disabled (to ensure that opcodes are used properly)
an opportunity to choose a
script.imgfile manually if the folder with themain.scmfile does not have onean opportunity to add a new code template directly from the editor; added template descriptions
the list of models can be sorted alphabetically/by value (
Alt+Swhen the list is active)minor corrections and changes
new data type:
&for direct byte address (ADMA).minor updates
improved the jump to label option
added an opportunity to show the list of templates
added an option to replace mission numbers with their names
fixed some bugs
the
DEFINE OBJECTlist is now optional (the compiler can make it out of model names used in the script)support for block comments
{}keypress recording
minor changes
added additional commands
new operator
INadded IF..THEN..ELSE..END
added support for
WHILEandREPEATloopsadded support for nested loops
added a new function Alloc, allowing to assign a specific memory address to a global variable
new comment style:
//the editor now remembers the position of markers and the cursor in closed files
full support of
SCMformats of Vice City and GTA 3an opportunity to declare variables and arrays as class instances
added a feature to display the list of variables and labels
added loops (
FOR..END)minor changes:
missions can be referenced by their name (
start_mission MYMISSIONwhereMYMISSIONis the label defined in lineDEFINE MISSION XX at @MYMISSION)Ctrl+Spacedisplays the list of imported models (DEFINE OBJECT)new operator
<>if the disassembler can't find a
script.imgfile, it uses the one from the game folderadded
handletype for arraysan opportunity to switch off a warning that the
script.imgfile is being used by the game
added properties support
added code templates support
added construction VAR...END for variables declaration
all math commands can be used without opcodes (
0004..008B)new operators
<and<=added a capability that the compiler itself set necessary value for the IF command
added extended parameters support
added models list showing
minor changes and fixes
added classes support
added keywords support
some math commands can be written without opcodes (e.g.
0004,0005,0006,0007,0038,0039,0042,0043)for the opcode
00D6the default parameter is0(if=if 0)added the option to customize labels output
added keywords
TrueandFalsewhich correspond to1and0added construction HEX...END for writing hexadecimal values directly in a binary output
added coords manager
some bugs fixed
new format of labels
added converter from the BW's SA Mission Builder syntax
disassembler adds the model names and the text from
american.gxtin a source fileadded new options
fixed some bugs
added an ability to associate
SCMfiles with Sanny Builderdisassembler adds an additional index to the file name if a file with the same name already exists (e.g, if
main.scm.txtalready exists, a new file will bemain.scm[0].txt)more informative error messages
added a check for duplicated labels
fixed some bugs
added new options for text editing
added an ability to work with multiple files simultaneously
added a function to auto-complete an opcode with the
F1button (beta)
disassembling support for GTA SA
SCMformatcompilation of text sources into
main.scmandscript.imgbasic features for text editing
