Create a Script - Revision history

Spaceeinstein at 02:03, 16 July 2018

2018-07-16T02:03:45Z

← Older revision		Revision as of 02:03, 16 July 2018
Line 15:		Line 15:

	That is where the MAIN section ends and the first mission begins. Insert your script between it. The simplest scripts have this format:		That is where the MAIN section ends and the first mission begins. Insert your script between it. The simplest scripts have this format:
	~~<pre>~~		{{Pre\|
	:simple_script		:simple_script
	// Insert your code here		// Insert your code here
	004E: end_thread		004E: end_thread
	~~</pre>~~		}}

	Your script can include a series of opcodes like adding cash to you or setting your wanted level:		Your script can include a series of opcodes like adding cash to you or setting your wanted level:
	~~<pre>~~		{{Pre\|1=
	:simple_script		:simple_script
	0109: player $PLAYER_CHAR money += 1000		0109: player $PLAYER_CHAR money += 1000
	010D: set_player $PLAYER_CHAR wanted_level_to 6		010D: set_player $PLAYER_CHAR wanted_level_to 6
	004E: end_thread		004E: end_thread
	~~</pre>~~		}}

	More complex code can be placed there instead, including spawning a ped, creating a clothes pickup, or creating a moving gate.		More complex code can be placed there instead, including spawning a ped, creating a clothes pickup, or creating a moving gate.

	Your script can have an optional name with which the game can identify by using opcode 03A4. A maximum of 7 characters are allowed for the name. If needed, through different scripts you can end your script with opcode 0459.		Your script can have an optional name with which the game can identify by using opcode 03A4. A maximum of 7 characters are allowed for the name. If needed, through different scripts you can end your script with opcode 0459.
	~~<pre>~~		{{Pre\|
	:simple_script		:simple_script
	03A4: name_thread 'SCRIPTA'		03A4: name_thread 'SCRIPTA'
Line 39:		Line 39:
	// Insert your code here		// Insert your code here
	004E: end_thread		004E: end_thread
	~~</pre>~~		}}

	== Loops ==		== Loops ==
	The example above shows you a script that ends immediately. If you want your script to run continuously, you have insert a loop. For most cases, looping requires opcode 0001 (or ''wait'' command) to be placed somewhere within the loop or else the game will crash. There are exceptions but it is safer to have it. The simplest loop has this format:		The example above shows you a script that ends immediately. If you want your script to run continuously, you have insert a loop. For most cases, looping requires opcode 0001 (or ''wait'' command) to be placed somewhere within the loop or else the game will crash. There are exceptions but it is safer to have it. The simplest loop has this format:
	~~<pre>~~		{{Pre\|
	:simple_script		:simple_script
	while true		while true
Line 49:		Line 49:
	// Insert your code here		// Insert your code here
	end		end
	~~</pre>~~		}}

	This script will repeat itself indefinitely so be careful what you put in it. In older or decompiled scripts, you may see this format:		This script will repeat itself indefinitely so be careful what you put in it. In older or decompiled scripts, you may see this format:
	~~<pre>~~		{{Pre\|
	:simple_script		:simple_script
	0001: wait 0 ms		0001: wait 0 ms
	// Insert your code here		// Insert your code here
	0002: jump @simple_script		0002: jump @simple_script
	~~</pre>~~		}}

	This style is lower level and behaves equivalently to the prior example script.		This style is lower level and behaves equivalently to the prior example script.
Line 63:		Line 63:
	== Conditions ==		== Conditions ==
	Conditional opcodes are used to check whether the action is performed rather than to perform the action. If the condition is satisfied, it returns true, otherwise it returns false. In Sanny Builder, conditional opcodes are noted by spaces between the opcode and the description of the opcode. Conditions start with IF statements that checks if an action is performed.		Conditional opcodes are used to check whether the action is performed rather than to perform the action. If the condition is satisfied, it returns true, otherwise it returns false. In Sanny Builder, conditional opcodes are noted by spaces between the opcode and the description of the opcode. Conditions start with IF statements that checks if an action is performed.
	~~<pre>~~		{{Pre\|1=
	:simple_script		:simple_script
	while true		while true
Line 78:		Line 78:
	end		end
	end		end
	~~</pre>~~		}}

	In older or decompiled scripts, you may see this format:		In older or decompiled scripts, you may see this format:
	~~<pre>~~		{{Pre\|1=
	:simple_script		:simple_script
	0001: wait 100 ms		0001: wait 100 ms
Line 98:		Line 98:
	:simple_script_end		:simple_script_end
	0002: jump @simple_script		0002: jump @simple_script
	~~</pre>~~		}}

	Again, this style is lower level and behaves equivalently to the prior example script. Both of the examples above show if '''one''' condition is met (the CAMERA key is pressed), the condition is true and the first command will be performed (add $2000). Otherwise, the condition would be false and reaches the alternate command (subtract $10). For IF statements with more than one conditions, you need to either add ''and'' or ''or'' after ''if''.		Again, this style is lower level and behaves equivalently to the prior example script. Both of the examples above show if '''one''' condition is met (the CAMERA key is pressed), the condition is true and the first command will be performed (add $2000). Otherwise, the condition would be false and reaches the alternate command (subtract $10). For IF statements with more than one conditions, you need to either add ''and'' or ''or'' after ''if''.

	'''if and''' means if all of the conditions are met, then perform the command.		'''if and''' means if all of the conditions are met, then perform the command.
	~~<pre>~~		{{Pre\|
	// ...		// ...
	if and		if and
Line 112:		Line 112:
	end		end
	// ...		// ...
	~~</pre>~~		}}

	This shows that if '''all''' conditions (if both keys 4 and 19 are pressed in this example) are met, the command will be performed. Otherwise, the code will skip the command and continue onwards.		This shows that if '''all''' conditions (if both keys 4 and 19 are pressed in this example) are met, the command will be performed. Otherwise, the code will skip the command and continue onwards.

	'''if or''' means if any one of these conditions are met, then perform the command.		'''if or''' means if any one of these conditions are met, then perform the command.
	~~<pre>~~		{{Pre\|
	// ...		// ...
	if or		if or
Line 126:		Line 126:
	end		end
	// ...		// ...
	~~</pre>~~		}}

	This shows that if '''either''' condition (if either key 4 or key 19 is pressed in this example) is met, the command will be performed. Otherwise, the code will skip the command and continue onwards.		This shows that if '''either''' condition (if either key 4 or key 19 is pressed in this example) is met, the command will be performed. Otherwise, the code will skip the command and continue onwards.

	Opcodes normally starts with the number ''0'', but conditional opcodes can start with the number ''8''. This checks if the condition is '''not''' performed.		Opcodes normally starts with the number ''0'', but conditional opcodes can start with the number ''8''. This checks if the condition is '''not''' performed.
	~~<pre>~~		{{Pre\|
	00E1: player 0 pressed_key 4 // IS pressed		00E1: player 0 pressed_key 4 // IS pressed
	80E1: not player 0 pressed_key 4 // is NOT pressed		80E1: not player 0 pressed_key 4 // is NOT pressed
	~~</pre>~~		}}

	== Save your changes ==		== Save your changes ==
Line 141:		Line 141:
	== See also ==		== See also ==
	* [[Mission Scripting (Overview)]]		* [[Mission Scripting (Overview)]]
	* [[~~Wikipedia:Thread (computer science)~~\|~~Multithreading theory (Wikipedia)~~]]		* [[CLEO/Tutorial\|CLEO tutorial]]

	{{~~fdl~~}}		{{3-navi}}
	~~[[Category:Modifications]]~~		{{VC-navi}}

Spaceeinstein: Spaceeinstein moved page Create a thread to Create a Script

2018-06-30T02:13:23Z

Spaceeinstein moved page Create a thread to Create a Script

← Older revision	Revision as of 02:13, 30 June 2018
(No difference)

Spaceeinstein: contributions from myself

2018-06-30T02:13:05Z

contributions from myself

What changes will this make?

Gta-mysteries at 19:39, 17 July 2010

2010-07-17T19:39:38Z

← Older revision		Revision as of 19:39, 17 July 2010
Line 84:		Line 84:
	* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]		* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]

	~~[[Category:Mission Scripting]]~~		{{fdl}}
	~~[[Category:GTA III Modifications]]~~
	~~[[Category:GTA Vice City]]~~

	~~{{gtasa}}~~{{fdl}}
	[[Category:Modifications]]		[[Category:Modifications]]

	~~{{modding}}~~

A-Dust at 00:42, 7 March 2010

2010-03-07T00:42:17Z

← Older revision		Revision as of 00:42, 7 March 2010
Line 1:		Line 1:
	'''Creating a simple thread''' is one of the first steps in understanding how to code. This article will show you the basic steps on how to create the simplest thread using [[Sanny Builder]]. It should work for [[~~GTA 3~~]], [[Vice City]], and [[San Andreas]].		'''Creating a simple thread''' is one of the first steps in understanding how to code. This article will show you the basic steps on how to create the simplest thread using [[Sanny Builder]]. It should work for [[Grand Theft Auto III]], [[Grand Theft Auto: Vice City]], and [[Grand Theft Auto: San Andreas]].

	== Create your thread ==		== Create your thread ==
Line 84:		Line 84:
	* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]		* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]

	[[Category:Mission Scripting]][[Category:GTA III Modifications]][[Category:GTA Vice City]]		[[Category:Mission Scripting]]
			[[Category:GTA III Modifications]]
			[[Category:GTA Vice City]]

	{{gtasa}}{{fdl}}		{{gtasa}}{{fdl}}

Gtabot: /* See also */clean up,

2010-01-24T01:44:51Z

Gtabot: /* See also */clean up, replaced: {{SA-navi}} → {{gtasa}}

2010-01-23T20:28:07Z

See also: clean up, replaced: {{SA-navi}} → {{gtasa}}

← Older revision		Revision as of 20:28, 23 January 2010
Line 84:		Line 84:
	* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]		* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]

	[[Category:Mission Scripting]][[Category:GTA III Modifications]][[Category:GTA VC]]		[[Category:Mission Scripting]][[Category:GTA III Modifications]][[Category:GTA Vice City]]

	{{~~SA-navi~~}}{{fdl}}		{{gtasa}}{{fdl}}

Gtabot: /* See also */renaming category,

2010-01-12T00:14:45Z

Gtabot: /* See Also */Completing import,

2010-01-12T00:11:56Z

Gboyers: 1 revision: Imported from gtamodding.com - under GNU FDL

2010-01-11T23:50:54Z

1 revision: Imported from gtamodding.com - under GNU FDL

← Older revision	Revision as of 23:50, 11 January 2010
(No difference)

← Older revision		Revision as of 00:14, 12 January 2010
Line 84:		Line 84:
	* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]		* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]

	[[Category:Mission Scripting]][[Category:GTA 3 Modifications]][[Category:GTA VC]]		[[Category:Mission Scripting]][[Category:GTA III Modifications]][[Category:GTA VC]]

	{{SA-navi}}{{fdl}}		{{SA-navi}}{{fdl}}

← Older revision		Revision as of 00:11, 12 January 2010
Line 80:		Line 80:
	Using this format requires you to start a new game. If you do not understand what is being said here, try looking into the [http://www.gtaforums.com/?showforum=109 Tutorial Forum] for more in-depth tutorials or the [http://www.gtaforums.com/index.php?showforum=49 Mission Coding Forum] on how to understand this.		Using this format requires you to start a new game. If you do not understand what is being said here, try looking into the [http://www.gtaforums.com/?showforum=109 Tutorial Forum] for more in-depth tutorials or the [http://www.gtaforums.com/index.php?showforum=49 Mission Coding Forum] on how to understand this.

	== See ~~Also~~ ==		== See also ==
	* [[Mission Scripting (Overview)]]		* [[Mission Scripting (Overview)]]
	* [[Wikipedia:~~Thread_~~(~~computer_science~~)\|Multithreading theory (Wikipedia)]]		* [[Wikipedia:Thread (computer science)\|Multithreading theory (Wikipedia)]]

	[[Category:Mission Scripting]][[Category:GTA 3]][[Category:GTA VC]]		[[Category:Mission Scripting]][[Category:GTA 3 Modifications]][[Category:GTA VC]]

	{{SA-navi}}{{fdl}}		{{SA-navi}}{{fdl}}

← Older revision		Revision as of 01:44, 24 January 2010
Line 87:		Line 87:

	{{gtasa}}{{fdl}}		{{gtasa}}{{fdl}}
			[[Category:Modifications]]

			{{modding}}