Difference between revisions of "Scripting Tutorial: Basic Scripting Knowledge"

no edit summary
imported>Sythe1525
imported>Darkness X
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Tools|req0=[[The Elder Scrolls Construction Set|Construction Set]]}}
A script is a small program that runs within the game, the Oblivion scripting language is rather simple, and experience in any other programming language brings you quite far.
A script is a small program that runs within the game, the Oblivion scripting language is rather simple, and experience in any other programming language brings you quite far.


Line 4: Line 5:


You can also comment your scripting code by using the ';' everything after the semicolon will be ignored.
You can also comment your scripting code by using the ';' everything after the semicolon will be ignored.


Scripting-Operations can be divided in two base categories, each with two sub-categories:
Scripting-Operations can be divided in two base categories, each with two sub-categories:


 
== [[:Category:Commands|Commands]] ==
== 1. [[:Category:Commands|Commands]] ==


A command is a script-operation that controls what happens within the script. Commands regulate how a script is executed, but don't affect the world directly.
A command is a script-operation that controls what happens within the script. Commands regulate how a script is executed, but don't affect the world directly.


There are two sub-categories: ''administrative commands'' and ''statements'':
There are two sub-categories: ''administrative commands'' and ''statements'':
Line 20: Line 18:
*''Statements'' are [[Set]], [[If]], [[Return]] and the [[Declaring_variables|variable declarations]] Statements aren't required for a script to work, but all but the most simple scripts require them to control '''how''' the script is executed.  
*''Statements'' are [[Set]], [[If]], [[Return]] and the [[Declaring_variables|variable declarations]] Statements aren't required for a script to work, but all but the most simple scripts require them to control '''how''' the script is executed.  


<br>
== [[:Category:Functions|Functions]] ==
 
== 2. [[:Category:Functions|Functions]] ==


Functions are script operations that interact with the game-world. This is by far the larger category of script operations. Every function returns a value which can be used as condition for [[If|"if"-Statements]] or to set variables with the [[Set|"set"-statement]].
Functions are script operations that interact with the game-world. This is by far the larger category of script operations. Every function returns a value which can be used as condition for [[If|"if"-Statements]] or to set variables with the [[Set|"set"-statement]].


There are two sub categories: ''passive'' and ''active'' functions:
There are two sub categories: ''passive'' and ''active'' functions:
Line 33: Line 28:
*''Active functions'' do changes to the game-world and usually return a boolean value ("1" or "0") to return if the action was successful or not. [[RemoveSpell]] for example removes a spell from the target and returns "1" if this was successful (i.e. the target had the spell in the first place). [[PlaceAtMe]] creates an object at the caller's location and returns the Reference to this object.
*''Active functions'' do changes to the game-world and usually return a boolean value ("1" or "0") to return if the action was successful or not. [[RemoveSpell]] for example removes a spell from the target and returns "1" if this was successful (i.e. the target had the spell in the first place). [[PlaceAtMe]] creates an object at the caller's location and returns the Reference to this object.


<br>
==[[Reference|References]] and [[:Category:Variables|Variables]] ==
== 3. [[:Category:References|References]] and [[:Category:Variables|Variables]] ==


Functions affect the "calling object" (That on which the script is running) by default, but you can redirect them to another object by using the object's [[:Category:References|reference]]. When you want a script to affect the player for example, use the player's reference ("Player") and a '.' to redirect the function-call to the player instead of the calling object.
Functions affect the "calling object" (That on which the script is running) by default, but you can redirect them to another object by using the object's [[Reference|reference]]. When you want a script to affect the player for example, use the player's reference ("Player") and a '.' to redirect the function-call to the player instead of the calling object.


  player.additem gold_001 100
  player.additem gold_001 100


To gain more flexibility, you can use [[:Category:Variables|variables]] instead of numeric values whenever a function requires such input.
To gain more flexibility, you can use [[:Category:Variables|variables]] instead of numeric values whenever a function requires such input.
Anonymous user