Difference between revisions of "Sanny Builder"

From GTAMods Wiki
Jump to navigation Jump to search
m (Examples of scripts made with Sanny Builder)
m (latest version upd)
 
(48 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{ToolBox
 
{{ToolBox
 
| name    = Sanny Builder
 
| name    = Sanny Builder
| version = 3.04
+
| version = 3.9.1
| author  = [[User:Seemann|Seemann]]
+
| date    = September 18, 2023
| genre  = [[Mission Scripting]]
+
| author  = {{Ui|Seemann}}
| site    = http://sannybuilder.com
+
| game    = [[GTA 3]], [[GTA VC]], [[GTA SA]] <br> [[GTA LCS]], [[GTA VCS]]
 +
| genre  = [[mission scripting|script editor]]
 +
| site    = https://sannybuilder.com
 
| image  = [[Image:Sb3_004.gif|250px|Sanny Builder 3]]
 
| image  = [[Image:Sb3_004.gif|250px|Sanny Builder 3]]
 +
| patrol  = yes
 
}}
 
}}
 +
'''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}}.
  
==Description==
+
Sanny Builder won "the Best Tool" award on GTANet Annual Awards 2013{{ref|1}}.
Sanny Builder is a fast and powerful tool designed for the GTA 3D game series (GTA3, VC, SA; partially LCS and VCS).
 
It includes a decompiler, permitting the end-user to quickly decompile the MAIN.SCM file which contains game scripts. The compiler feature offers a convenient editor with a large number of useful functions such as; syntax highlighting, error checking, advanced search tools, player coordinates reading, fast movement through code and much more.  
 
  
Sanny offers an advanced code syntax which is similar to existing programming languages. This syntax includes changeable classes, keywords and high-level statements. We recommend you continue reading and fully explore the help section to learn more about SB and its capabilities. We provide a wealth of information that will help you get started in mission coding. Now that you have discovered some of the possibilities.  
+
== 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.
  
Sanny Builder is made and produced by [[User:Seemann|Seemann]].
+
== Syntax features ==
 +
* high-level statements (loops, conditions)
 +
* basic class system
 +
* directives
 +
* constants
 +
* direct hex input
  
[http://sannybuilder.com Official website]
+
== 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
  
[http://www.gtaforums.com/index.php?showtopic=211077 GTAForums topic]
+
== 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 [https://docs.sannybuilder.com/version-history here]  
  
==Features==
+
The latest version is v3.9.1, released on September 18, 2023.
* Support for all GTA 3D game series
 
* Fast compiler
 
* Convenient IDE with syntax highlighting
 
* Detailed help including description and solutions for all run-time error messages
 
  
==Version changes==
+
==See also==
Current version:
+
* [[Mission Scripting Tools]]
v3.04, released on 17 August 2008
+
* {{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]]
  
===v3.04===
+
== External links ==
* the editor got abilities to convert hexadimal numbers to decimal ones and vice versa (Ctrl+H), and convert the model names to their IDs (Ctrl+Alt+H)
+
* [http://sannybuilder.com Official website]
* removed the complaining message about the script.img being used by the game when compiling a [[CLEO]] script
+
* [https://docs.sannybuilder.com Documentation Portal]
* the compiling report displays size of the CLEO script (as Largest script)
+
* [http://public.sannybuilder.com/archive Old versions archive]
* fixed bug when compiling an array with constant numeric indexes
+
* {{GTAF|211077}}
* the installer no longer requires the system administrator rights
+
* [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!}}
  
===v3.03===
+
{{N|VCS|LCS|sa|vc|3}}
* the previous version of CLEO had a bug
+
[[Category:GTA LCS]][[Category:GTA VCS]][[Category:Mission Scripting]]
* 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===
 
bug-fixes update
 
 
 
===v3.00===
 
* the CLEO 3 library 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
 
 
 
== Examples of scripts made with Sanny Builder ==
 
 
 
[http://www.gtamodding.com/index.php?title=Car_Spawn Car Spawns]
 
 
 
[http://ryosuke.my-sv.net/mapmod/portal/index.html Portal Gun]
 
 
 
[http://ryosuke.my-sv.net/mapmod/ggun/index.html Gravity Gun]
 
 
 
Petrol Meters
 
 
 
[http://www.freewebtown.com/devann/leatherface/download.html Leatherface Mod]
 
 
 
[http://www.freewebtown.com/devann/leatherface/download.html Bigfoot Script]
 
 
 
 
 
[[Category:GTA SA]] [[Category:Mission Scripting]] [[Category:Tools]]
 
{{tool-stub}}
 

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