Editing Scenarios

==CREATING SCENARIOS==

Scenarios in [[Orbiter]] contain a series of data that may change depending on many things.
But we are covering the basics to build a scenario. We are going to build a scenario using the standard orbiter install.

Open Notepad and paste the following text...
<pre>
BEGIN_DESC
Ready to take off.
END_DESC

BEGIN_ENVIRONMENT
System Sol
Date MJD 51981.6009797824
END_ENVIRONMENT

BEGIN_FOCUS
Ship GL-01
END_FOCUS

BEGIN_CAMERA
TARGET GL-01
MODE Cockpit
FOV 60.00
END_CAMERA

BEGIN_MFD Left
TYPE Surface
SPDMODE 1
END_MFD

BEGIN_MFD Right
TYPE Orbit
PROJ Ship
FRAME Ecliptic
REF Earth
END_MFD

BEGIN_PANEL
END_PANEL

BEGIN_SHIPS
GL-01: DeltaGlider
STATUS Landed Earth
BASE Cape Canaveral:1
POS -80.6758964 28.5227640
HEADING 150.00
PRPLEVEL 0:1.000 1:1.000
NAVFREQ 402 94 0 0
XPDR 0
GEAR 1 1.0000
END
END_SHIPS
</pre>
...and now let's learn about what we just pasted.

===DESCRIPTION SECTION===

The following text makes scenario to display a description in the Orbiter Launchpad window, before you load a scenario. In this case it will display "Ready to take off" in the launch pad window. It can be left blank if you don't want to include anything in the description.
<pre>
BEGIN_DESC
Ready to take off.
END_DESC
</pre>

===ENVIRONMENT SECTION===

The environment section specifies the [[Solar System|solar system]]. It refers to a CFG file (Sol.cfg) that contains data on [[planet|planets]] and other space bodies. It also sets the time when the scenario will start.
It's not the standard DD/MM/YYY HH:MM format - It uses [[Julian Day|MJD]] format. If you browse your "\Orbiter\Utils" directory, you will find a program named "Date.exe" which allows you to convert to and from MJD format.

How to set a date is something that we might leave for future lessons. Let's see how environment section looks...
<pre>
BEGIN_ENVIRONMENT
System Sol
Date MJD 51981.6009797824
END_ENVIRONMENT
</pre>

===FOCUS SECTION===

Now, let's see where YOU will be when the mission starts.
The focus section describes the ship you will pilot or the object you will control when you start your mission.

In the following case you have a ship named "GL-01". It's a custom name. We will need to define the properties of this ship later.
<pre>
BEGIN_FOCUS
Ship GL-01
END_FOCUS
</pre>
===CAMERA SECTION===

The camera section indicates if you are looking at your ship from the inside or the outside. We won't cover the camera parameter variations yet. In this case you start right inside the cockpit. Also notice you  can change the default Field of View (FOV) value for the scenario if you want to start out with a wider or more narrow view.
<pre>
BEGIN_CAMERA
TARGET GL-01
MODE Cockpit
FOV 60.00
END_CAMERA
</pre>

===MFD SECTION===

In your cockpit you have 2 screens called MFDs which will display some info. Each MFD is configured differently. We won't cover yet how to configure MFDs.
<pre>
BEGIN_MFD Left
TYPE Surface
SPDMODE 1
END_MFD

BEGIN_MFD Right
TYPE Orbit
PROJ Ship
FRAME Ecliptic
REF Earth
END_MFD
</pre>
===PANEL SECTION===

The next section is the panel section. We won't cover it here. So let's leave it like this...

 BEGIN_PANEL
 END_PANEL

===SHIPS SECTION===

Now it comes the time when we define the properties of your ship in the ships section.
In this case we have only one ship in our entire universe. It is GL-01. Remember?
GL-01 is a DeltaGlider class ship. You will have a limited set of classes unless you install other spacecratf/aircraft addons that add more classes.

The status indicates if you are landed or if you are moving (Orbit).

POS indicates your longitude and latitude.

HEADING indicates the direction of the nose of your ship. If you put a ship in a runway you might like it to aim at the end of the runway.

PRPLEVEL indicates your level of propellant in the different tanks each ship has. Configuration of this parameter may change from a ship class to another.

The rest of the parameters depend on what ship you are piloting. Let's see how the ships section would look. This will add a ship that will be located at a landing pad at [[Cape Canaveral]].
<pre>
BEGIN_SHIPS
GL-01: DeltaGlider
STATUS Landed Earth
BASE Cape Canaveral:1
POS -80.6758964 28.5227640
HEADING 150.00
PRPLEVEL 0:1.000 1:1.000
NAVFREQ 402 94 0 0
XPDR 0
GEAR 1 1.0000
END
END_SHIPS
</pre>

===ADDING MORE SHIPS TO YOUR SCENARIO===

We want to add another [[Delta-glider]] ship called "GL-02" which should be parked at the end of a runway. Where is the end of the runway?

You need to load your scenario, press F1 for external view and then zoom out and rotate your view until you have the camera right at the beginning of the runway. Now press CTRL-F1.

Do you remember how we got the latitude and longitude for our base in our previous lesson? Let's do the same trick.

We can copy and paste the GL-01 properties and then add the latitude and longitude, and change the ship name. But don't forget about the heading...

That way, we are going to add this code, which will place your ship at Cape Ca&#241;averal runway...
<pre>
GL-02: DeltaGlider
STATUS Landed Earth
POS -80.560213 +28.455060
HEADING 308.00
PRPLEVEL 0:1.000 1:1.000
NAVFREQ 402 94 0 0
XPDR 0
GEAR 1 1.0000
END
</pre>
As we add the code, your ship section should look like this...
<pre>
BEGIN_SHIPS
GL-01: DeltaGlider
STATUS Landed Earth
BASE Cape Canaveral:1
POS -80.6758964 28.5227640
HEADING 150.00
PRPLEVEL 0:1.000 1:1.000
NAVFREQ 402 94 0 0
XPDR 0
GEAR 1 1.0000
END
GL-02: DeltaGlider
STATUS Landed Earth
POS -80.560213 +28.455060
HEADING 308.00
PRPLEVEL 0:1.000 1:1.000
NAVFREQ 402 94 0 0
XPDR 0
GEAR 1 1.0000
END
END_SHIPS
</pre>
Now we have 2 ships in your scenario. You may use F3 to display a window that allows you to switch from one ship to another.

Congratulations, you have created your first scenario!!

===OTHER IMPORTANT ISSUES===

Now edit other scenarios using Notepad and learn how they are built.
Just remember... if a ship class is not present, either your ships would look invisible, or it may crash orbiter to desktop.

If the FOCUS section has a ship that is not defined in the SHIPS section, you may have problems too. If you refer to a non existent MFD or if you have any syntax error when defining the parameters for each property, you may have problems.

If a scenario is crashing, try to add a standard [[Delta-glider]] ship only. If it crashes, the problem is elsewhere, a syntax error probably. If not, then you don't have the required files to have a certain ship flying.

You also may try to see the camera section for each scenario and what results are obtained. if you read the Orbiter manual, you may find more information about the contents of each scenario.

===External Links===
*[http://orbit.m6.net/v2/read.asp?id=25089 Orbiter Forum Discussion]

----
created by "Pablo Luna from Costa Rica", posted with his permission

[[Category:Tutorials]][[Category:Add-on tutorials]]