Difference between revisions of "Sanny Builder"

From GTAMods Wiki
Jump to navigation Jump to search
m (latest version upd)
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{ToolBox
 
{{ToolBox
 
| name    = Sanny Builder
 
| name    = Sanny Builder
| version = 3.06
+
| version = 3.9.1
| date    = 17 June, 2013
+
| date    = September 18, 2023
| author  = [[User:Seemann|Seemann]]
+
| author  = {{Ui|Seemann}}
 
| game    = [[GTA 3]], [[GTA VC]], [[GTA SA]] <br> [[GTA LCS]], [[GTA VCS]]
 
| game    = [[GTA 3]], [[GTA VC]], [[GTA SA]] <br> [[GTA LCS]], [[GTA VCS]]
 
| genre  = [[mission scripting|script editor]]
 
| genre  = [[mission scripting|script editor]]
| site    = http://sannybuilder.com
+
| site    = https://sannybuilder.com
 
| image  = [[Image:Sb3_004.gif|250px|Sanny Builder 3]]
 
| image  = [[Image:Sb3_004.gif|250px|Sanny Builder 3]]
 
| patrol  = yes
 
| patrol  = yes
 
}}
 
}}
'''Sanny Builder''', or shortly '''SB''', is a fast and powerful [[script]] editor designed for the GTA 3D game series (GTA3, VC, SA; partially LCS and VCS). It includes a dissasembler, permitting the end-user to quickly disassemble the [[main.scm]] file which contains game scripts, and a fast compiler to translate user-made scripts back into a SCM or CLEO file readable by game. Sanny Builder is made and produced by {{U|Seemann}}.
+
'''Sanny Builder''', or shortly '''SB''', is a fast and powerful [[script]] editor designed for the GTA 3D game series. It includes a dissasembler, permitting the end-user to quickly disassemble the [[main.scm]] file which contains game scripts, and a fast compiler to translate user-made scripts back into a [[SCM]] or [[CLEO]] file readable by game. Sanny Builder is made and produced by {{U|Seemann}}.
 +
 
 +
Sanny Builder won "the Best Tool" award on GTANet Annual Awards 2013{{ref|1}}.
  
 
== Major features ==
 
== Major features ==
* Support for all GTA 3D game series till [[GTA 4]]. It could disassemble and assemble scripts of GTA3, GTA VC and GTA SA. The script format of GTA LCS and GTA VCS is supported partially: SB is able only to disassemble its scripts;
+
* Support for all GTA 3D era games prior to [[GTA 4]]. It could disassemble and assemble scripts of GTA3, GTA VC, GTA SA, GTA LCS, GTA VCS
 
* Sanny Builder has the fastest mission compiler comparing to all other existing tools;
 
* Sanny Builder has the fastest mission compiler comparing to all other existing tools;
 
* Convenient IDE with syntax highlighting;
 
* Convenient IDE with syntax highlighting;
Line 26: Line 28:
  
 
== Built-in-tools ==
 
== Built-in-tools ==
* Player coordinates manager (lets you to read and change player's coords and [[Angle|z-angle]] in game)
+
* Player coordinates manager (lets you to read and change player's coords and [[angle]] in game)
 
* Opcode search tool (Allows you to quicky find a needed opcode)
 
* Opcode search tool (Allows you to quicky find a needed opcode)
 
* Source converting tool (converts scripts written for the [[Mission Builder]] into the Sanny Builder syntax)
 
* Source converting tool (converts scripts written for the [[Mission Builder]] into the Sanny Builder syntax)
* Native support for the [[CLEO|CLEO library]]
+
* Native support for the CLEO library
 
+
* Web update feature
== Version changes ==
 
Development of the tool began on July 05, 2005. First public release (v0.6-beta) was made a month later on August 04, 2005.
 
 
 
Current version: v3.06, released on June 17, 2013.
 
 
 
=== v3.06 ===
 
* added new operators ++ and --
 
* added support for block comments /* */
 
* SASCM.INI is updated with help of the [http://gtag.gtagaming.com/opcode-database/ GTAG Database]
 
* properties Actor.Armour and Actor.Car are replaced with their correct versions Actor.AddArmour and Actor.MissionCar
 
* added new property Actor.CurrentCar for the opcode 03C0 in the SA and VC classes
 
* added new hotkeys Ctrl+Num+ and Ctrl+Num- to quickly change the text size
 
* Sanny Builder now remembers a number of closed files for the option Load all closed files
 
* fixed bug when the compiler failed to compile numerous hex..end constructs
 
* fixed bug of version 3.05 when the program hung on startup trying to open a file passed as a parameter
 
 
 
<br><div class="NavFrame collapsed"><div class="NavHead">'''''Previous versions''''' </div>
 
<div class="NavContent">
 
=== v3.05 ===
 
* 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 possibility to install CLEO for GTA III and Vice City (made by Alien)
 
* the opcode files (**SCM.ini, opcodes.txt) replaced with the ones from the CLEO 4 library installation
 
* new command line parameter \nosplash
 
 
 
=== v3.04 ===
 
* the editor got abilities to convert hexadimal numbers to decimal ones and vice versa (Ctrl+H), and convert model names to their IDs (Ctrl+Alt+H)
 
* removed the complaining message about the script.img being used by the game when compiling a [[CLEO]] script
 
* the compiling report displays size of the CLEO script (as Largest script)
 
* fixed bug when compiling an array with constant numeric indexes
 
* the installer no longer requires the system administrator rights
 
 
 
=== v3.03 ===
 
* the previous version of CLEO had a bug
 
* minor changes (the toolbar position wasn't saved)
 
 
 
=== v3.02 ===
 
* new version of the CLEO library
 
* main toolbar is movable
 
* F7 while compiling SCM with no header (with $E, $CLEO directives) does not make a copy of the output file
 
* while compiling a source file with directive $CLEO by pressing F6, the output file is created at the same directory; if by pressing F7 a copy of the output is created at the CLEO directory (like with common SCM files)
 
* new translation languages - italian, portuguese
 
  
=== v3.01 ===
+
== Version history ==
*bug-fixes update
+
Development of the tool began on July 5, 2005. First public release (v0.6-beta) was made a month later on August 4, 2005. Detailed changelog can be found [https://docs.sannybuilder.com/version-history here]
  
=== v3.00 ===
+
The latest version is v3.9.1, released on September 18, 2023.
* [[CLEO]] 3 is integrated into Sanny Builder
 
* VCS SCM format support (decompiling only)
 
* constants support
 
* new directives $INCLUDE,$EXTERNAL,$CLEO
 
* writing of the additional info to the end of the main.scm
 
* custom arrays support
 
* possibility to decompile the files having no header
 
* ability to create an external script named AAA
 
* new command line parameter \compile
 
* possibility to use the floating-point values as a counter value in FOR..END loop
 
* the commands WriteMem and ReadMem are not supported anymore
 
* possibility to use the regular expressions when searching
 
* possibility to save a source file in the RTF or HTML formats.
 
* ability to skip the splashes at SA startup
 
* new key combo Ctrl+Enter
 
* updated SASCM.INI
 
</div>
 
  
 
==See also==
 
==See also==
* [[Mission Scripting Tools|Mission scripting tools]]
+
* [[Mission Scripting Tools]]
 +
* {{Icon|3}} [[Sanny Builder/SCM.INI]]
 +
* {{Icon|VC}} [[Sanny Builder/VCSCM.INI]]
 +
* {{Icon|LCS}} [[Sanny Builder/LCSSCM.INI]]
 +
* {{Icon|VCS}} [[Sanny Builder/VCSSCM.INI]]
 +
* {{Icon|3}} {{Icon|VC}} [[Sanny Builder/stripped.txt]]
  
 
== External links ==
 
== External links ==
 
* [http://sannybuilder.com Official website]
 
* [http://sannybuilder.com Official website]
 +
* [https://docs.sannybuilder.com Documentation Portal]
 +
* [http://public.sannybuilder.com/archive Old versions archive]
 
* {{GTAF|211077}}
 
* {{GTAF|211077}}
 
* [http://gtag.gtagaming.com/opcode-database/generator/ Download latest INI file with opcodes] - provided by {{U|Deji}}
 
* [http://gtag.gtagaming.com/opcode-database/generator/ Download latest INI file with opcodes] - provided by {{U|Deji}}
 +
* {{note|1}} {{GTAF|684325|Annual Awards 2013 - Winners!}}
  
{{N|sa|vc|3}}
+
{{N|VCS|LCS|sa|vc|3}}
 
[[Category:GTA LCS]][[Category:GTA VCS]][[Category:Mission Scripting]]
 
[[Category:GTA LCS]][[Category:GTA VCS]][[Category:Mission Scripting]]

Latest revision as of 03:39, 23 October 2023

Sanny Builder
Sanny Builder 3
Current version:3.9.1 (!)
Developed by:User.pngSeemann
Supported games:GTA 3, GTA VC, GTA SA
GTA LCS, GTA VCS
Type:script editor
Website:https://sannybuilder.com

Sanny Builder, or shortly SB, is a fast and powerful script editor designed for the GTA 3D game series. It includes a dissasembler, permitting the end-user to quickly disassemble the main.scm file which contains game scripts, and a fast compiler to translate user-made scripts back into a SCM or CLEO file readable by game. Sanny Builder is made and produced by Seemann.

Sanny Builder won "the Best Tool" award on GTANet Annual Awards 2013[1].

Major features

  • Support for all GTA 3D era games prior to GTA 4. It could disassemble and assemble scripts of GTA3, GTA VC, GTA SA, GTA LCS, GTA VCS
  • Sanny Builder has the fastest mission compiler comparing to all other existing tools;
  • Convenient IDE with syntax highlighting;
  • Detailed help including description and solutions for all run-time error messages.

Syntax features

  • high-level statements (loops, conditions)
  • basic class system
  • directives
  • constants
  • direct hex input

Built-in-tools

  • Player coordinates manager (lets you to read and change player's coords and angle in game)
  • Opcode search tool (Allows you to quicky find a needed opcode)
  • Source converting tool (converts scripts written for the Mission Builder into the Sanny Builder syntax)
  • Native support for the CLEO library
  • Web update feature

Version history

Development of the tool began on July 5, 2005. First public release (v0.6-beta) was made a month later on August 4, 2005. Detailed changelog can be found here

The latest version is v3.9.1, released on September 18, 2023.

See also

External links