Difference between revisions of "FreeSpace 2 Mission File Format"

From FreeSpace Wiki
Jump to: navigation, search
($Formula:)
(#Mission Info: Added Flags and details)
Line 14: Line 14:
  
 
===#Mission Info===
 
===#Mission Info===
*Defines that the file is a Mission file.
+
Fields:
 +
 
 +
$Version: STRING
 +
*contains the version number for this mission
 +
$Name: XSTR
 +
*contains the name of this mission. Uses tstrings.tbl for translation.
 +
$Author: STRING
 +
*The author's name
 +
$Created: STRING
 +
*The time and date that this mission was created on. Format is "MM/DD/YY at HH:MI:SS", where MM = Month, DD = Day, YY = Year, HH = Hours (24 hour format), MI = minutes and SS = seconds.
 +
$Notes: STRING
 +
*Contains any notes the mission designer wishes to add.
 +
$End Notes: ??
 +
 
 +
$Mission Desc: XSTR
 +
*Contains a short description of this mission. Uses tstrings.tbl for translation.
 +
$end_multi_text
 +
 
 +
+Game Type Flags: INT
 +
 
 +
+Flags: INT
 +
+NebAwacs: FLOAT
 +
 
 +
+Storm: STRING
 +
+Red Alert: INT
 +
+Scramble: INT
 +
 
 +
+Disallow Support: 0 or 1
 +
*Whether or not support ships are available on this mission
 +
 
 +
+Hull Repair Ceiling: FLOAT
 +
 
 +
+Subsystem Repair Ceiling: FLOAT
 +
 
 +
+Player Entry Delay: FLOAT
 +
 
 +
+Viewer pos: FLOAT, FLOAT, FLOAT
 +
*FRED camera position
 +
 
 +
+Viewer orient:
 +
        FLOAT, FLOAT, FLOAT,
 +
        FLOAT, FLOAT, FLOAT,
 +
        FLOAT, FLOAT, FLOAT
 +
*Orientation Matrix for FRED camera
 +
 
 +
+SquadReassignName: STRING
 +
+SquadReassignLogo: STRING
 +
*Squadron the player is reassigned to
 +
 
 +
$Skybox Model: STRING
 +
*Which skybox model to use
 +
 
 +
$AI Profile: STRING
 +
*Which AI profile is used
 +
 
 +
#Sexp_variables
 +
 
 +
$Variables: ??
  
 
===#Command Briefing===
 
===#Command Briefing===

Revision as of 20:39, 24 September 2009

FS2 files are simple text files defining how FS2 will 'execute' a given mission. It refers to external files for the actual assets used in the mission, including Model files and Tables.

General Format

File section headers start with the "#" character. Each file section should be separated by a blank line.

Statements start with either the "$" or "+" characters, and may last for multiple lines. Comments are indicated by ";!", and continue to the end of the line.

Data finishes at "#End"

Sections

#Mission Info

Fields:

$Version: STRING

  • contains the version number for this mission

$Name: XSTR

  • contains the name of this mission. Uses tstrings.tbl for translation.

$Author: STRING

  • The author's name

$Created: STRING

  • The time and date that this mission was created on. Format is "MM/DD/YY at HH:MI:SS", where MM = Month, DD = Day, YY = Year, HH = Hours (24 hour format), MI = minutes and SS = seconds.

$Notes: STRING

  • Contains any notes the mission designer wishes to add.

$End Notes: ??

$Mission Desc: XSTR

  • Contains a short description of this mission. Uses tstrings.tbl for translation.

$end_multi_text

+Game Type Flags: INT

+Flags: INT +NebAwacs: FLOAT

+Storm: STRING +Red Alert: INT +Scramble: INT

+Disallow Support: 0 or 1

  • Whether or not support ships are available on this mission

+Hull Repair Ceiling: FLOAT

+Subsystem Repair Ceiling: FLOAT

+Player Entry Delay: FLOAT

+Viewer pos: FLOAT, FLOAT, FLOAT

  • FRED camera position

+Viewer orient:

       FLOAT, FLOAT, FLOAT, 
       FLOAT, FLOAT, FLOAT, 
       FLOAT, FLOAT, FLOAT
  • Orientation Matrix for FRED camera

+SquadReassignName: STRING +SquadReassignLogo: STRING

  • Squadron the player is reassigned to

$Skybox Model: STRING

  • Which skybox model to use

$AI Profile: STRING

  • Which AI profile is used
  1. Sexp_variables

$Variables: ??

#Command Briefing

  • Defines the Command Briefing section of the briefing. If no command briefing is required, leave this blank.

#Briefing

  • Defines the Mission Briefing. Leaving this blank will cause 'no briefing' to be shown instead of a mission briefing.

#Players

  • Defines the players for the mission. At least one player must be defined.

#Objects

  • Defines all the objects in the mission and their initial state.
  • This includes all ships (including the player ships), installations and other objects.
  • Does not include asteroid (debris) fields.

#Wings

  • Defines all wings in the mission, friendly and hostile

#Events

  • The SEXPs that make up the Events List.

$Formula:

$Formula: ( SEXP_TEXT 
   FIRST_OPERAND
   SECOND_OPERAND
)
+Name: Event name
+Repeat Count: 1
+Interval: 1
+Chained: 30 ;! Indicates that Event is chained to the previous Event and the chain time in seconds.
+Team: 0

#Goals

  • The mission directives

#Waypoints


#Messages


#Reinforcements


#Background bitmaps


#Asteroid Fields


#Music


#End

  • The end of the file.