====== Falcon4 .TE file ======

[[https://www.pmctactical.org/forum/viewforum.php?f=47|Falcon 4.0 Forum]], [[:falcon4|Falcon 4 Home]], [[falcon4:campaign|Falcon 4 Campaign]], [[falcon4:cockpits|Falcon 4 Cockpits]], [[falcon4:database|Falcon 4 Database]], [[falcon4:file_formats|Falcon 4 File Formats]], [[falcon4:srtm|Falcon 4 SRTM Terrain]], [[falcon4:terrain|Falcon 4 Terrain]], [[falcon4:textures|Falcon 4 Textures]], [[falcon4:tools|Falcon 4 Tools]]

The .TE file is one of the files embedded within a .TRN/.TAC file.  The .TE file holds holds information about the victory conditions and other details about tactical engagements. Unlike some other embedded files, it is not compressed.

===== .TE file format =====
The .TE file is a plain ASCII file. It is structured the following way:


**:fieldname**\\
//fieldvalues//\\

where :fieldname is a new line starting with a colon and immediately followed by a name indicating which field is being referenced by the very next line.  The next line will specify the values for that field.  Some fields take multiple lines to specify all of their values.

==== Fields ====

If there are victory conditions, this field will appear in the file (at the top), as such:

**:Victory**

followed by one line per team, each line listing seven signed-integer fields, separated by spaces, as such :

**xxx xxx xxx xxx xxx xxx xxx**

Where the meaning of the xxx's are as such:\\
Field 1: Team #\\
Field 2: Type\\
Field 3: VU_ID.num\\
Field 4: VU_ID.creator (value)\\
Field 5: tolerance\\
Field 6: points\\

Note that the use of **xxx** in the example does not imply that these integer strings have to be 3 characters long.  They can be of any length provided the data they refer to is valid data.
----

After any victory conditions are specified, then, if points are required, there will be another line of text will read as such:

**:Required**

which will be followed by another line specifying the number of points required.
----

Then there will be a field called ":Teams" which specifies the number of teams.  First there will be a line of text that reads as such:

**:Teams**

followed by a line of text which specifies the number of teams.


Then, for each team, there will then be a field called ":Team", where there first is a line that reads as such:

**:Team**

followed by a line with 3 signed-integer values, separated by spaces, as such:

**xxx xxx xxx**

where the meaning of the xxx's are as such:\\
Field 1: Team #\\   
Field 2: Number of aircraft\\
Field 3: Number of F-16s\\

This will be followed by a line that reads as such:

**:TeamName**

followed by another line which specifies the team name for this team.

There will then be another line that reads as such:

**:TeamFlag**

followed by another line containing an integer which specifies the flag to use for that team.

The last 3 fields described (:Team, :TeamName, and :TeamFlag) will repeat until all teams have been specified.

----

Lastly, there may be a line in the file which specifies the file name (minus the extension) of the outer .TRN/.TAC file.