Ceeeb/Sandbox\ArmA: Scripting - Getting Started – User

From Bohemia Interactive Community
Jump to navigation Jump to search
(minor lexical corrections and a few additions)
(clean slate)
Line 1: Line 1:
==Introduction==
==Introduction==
Scripts are a essential part of mission making. They allow you to create amazing cutscenes, create effects and customize almost every aspect of your mission. Some diverse examples of what could be scripted are: a simulation of artillery fire, a poisonous gas cloud, or a money system for purchasing equipment.       
===Algorithm===
Your first task in writing scripts is to decide what sequence of steps is needed to solve a particular problem. This sequence is what would be called an ''algorithm''.
For example, if you wanted to transport weapons from Petrovice to Lipany, you would (as commander) give these orders:
*'''Commander:''' Private Honka, private Kouba, come here!
*'''Commander:''' Private Kouba, get in Ural as driver!
*'''Commander:''' Private Honka, get in Ural!
*'''Commander:''' Private Kouba, drive to Petrovice and load Ural!
*'''Private Kouba''': I don't know where Petrovice is, sir.
Now we have a problem. Kouba only knows how to get to Lipany and Honka only knows how to get to Petrovice. Our soldiers are new recruits and are really quite stupid. They can only take simple orders, one order at a time.  They can get in and out of vehicles, drive, and load and unload weapons and ammo. The commander must plan this sequence of orders and make provisions for obstacles that may arise.
# Destination is Petrovice
# Get in vehicle
# If driver does not know the way to Destination, swap driver and passenger
# Drive to the destination
# Get out of vehicle
# Load vehicle
# Destination is Lipany
# Get in vehicle
# If driver does not know the way to Destination, swap driver and passenger
# Drive to Destination
# Get out of vehicle
# Unload vehicle
===Interpreter===
If you have an algorithm, you need something that can execute it. We have a computer game, Armed Assault, which is able to do this; commanders have soldiers.
===Programming language===
It's way how to write our algorithm for Armed Assault. ArmA scripts are a sequence of 'orders' describing how to do it.
===Source code===
Source code is algorithm written in any programming language.
===Syntax===
'''Syntax''' is made up of commands and parameters, sometimes just the command is required as in [[exit]], other times the '''syntax''' is made up of one or more parameters. Each command has it's own reference in the [[Scripting]] section of the wiki. In each case the command + its parameters are listed with examples on how that particular command works.
'''[[if]]'''(PrivateHonka == TheMostCleverSolderInTheWorld) [[then]] {
    IAmChineeseGodOfHumour = true;
};
Be aware though that Armed Assault features two similar scripting grammars: [[SQF]] and [[SQS]].
===Interpreting works===
The '''Armed Assault''' engine reads your code from script files and translates those instructions for you to achieve your desired outcome/effect in the game.
===Let's start===
Every script consist of commands (see [[:Category:Scripting Commands|category Scripting Commands]]) and [[Control Structures|program flow]] statements (they are implemented as commands in Armed Assault, but it isn't relevant for now). The most useful command in your first script is [[titleText]]. It can write any text you want to the player's screen.
[[titleText]]["Good morning, captain", "PLAIN DOWN"];
It's a typical way to run commands. Behind the name of the command the parameters follow (but it depends on the command (see [[:Category:Scripting Commands]]). Every command can only have one parameter before it's name and/or one after (more arguments can be given with arrays which count as one parameter). Parameters can be of various [[:Category:Types|Data types]]. In this case it's an [[Array]] - a list of other data types. It can contain 0 - 4096? values. The first value is a [[String]] representing the text to be displayed and the second, in this case, says in what position on the screen the text will be displayed. There can be a third value: a [[Number]] which says how long the text needs to fade in. If this value is not entered, its default value (1) is used.
[[titleText]]["Good morning, captain", "PLAIN DOWN", 5];
Scripts which are called [[function]]s) are stored in .SQF files the mission folder, or in .SQSs files and then called only scripts.
If you want to try our 'script', create a mission in the mission editor, save it as ''testingmission'', open a text editor (eg. Notepad), write "[[titleText]]["Good morning, captain", "PLAIN DOWN"];" (without the outer "") and save it as hello.sqf to gamefolder/user/yourname/missions/testingmission. Then add solder in mission editor and to his initialization field type "execVM "hello.sqf"" (without the outer quotes). When you run this mission, you should see output of your first script. Well done, soldier! (If you are confused from this quantum of informations, don't panic, more continuously explanation follows.)
== Variables ==
See [[Variables]]
==Statements and operators==
See [[Operators]]
[[Category: Scripting Topics|Getting Started]]

Revision as of 09:29, 12 May 2007

Introduction

Retrieved from "https://community.bistudio.com/wiki?title=User:Ceeeb/Sandbox%5CArmA:_Scripting_-_Getting_Started&oldid=34024"