Tutorial of X-Script

• Preface
  

• Chapter 1 - First Steps
  

• Chapter 2 - Hello World
  

• Chapter 3 - UFOs
  
  

• 3.1 The basic mission framework

Introducing Missiontypes. Furthermore, it is shown how to configure events leading to defeat and victory.

• 3.2 The script core - the procedure StartMission
  

It is shown how to create UFOs. Furthermore, some new language elements are introduced, including variables, the function random(n) in order to create random numbers, arithmetic operations, and the for...to-loop.

• 3.3 Victory or defeat
  

Shows how to control victory or defeat in connection with register_ufo_* and event_register(...). With these, UFOs can be defined as victory conditions and procedures can be called after a certain tim.

• 3.4 Self-made UFOs
  

Will be completed, as soon as X-script will contain the appropriate functions (propably version 0.850 (?!?)).

• 3.5 The Type TUFO
  

The most important attributes and methods which are available for TUFO are explained. Furthermore the type boolean is introduced and the correct usage of the conditional instruction if...then is explained. In addition, hints in order to avoid problems with globally defined variables are given.

• 3.6 The complete mission and debugging
  

The complete script for chapter 3 is given. In addition, trouble shooting assistance provided by the script editor itself is presented.

• Chapter 4 - Message windows for advanced users
  

• 4.1 The basic framework for our quiz
  

ASCII symbols in strings; Tags for coloured text; mzUser; Declarations with forward

• 4.2 The 1. quiz
  

The 1. quiz is constructed. For that purpose, TStringList and the corresponding methods Create, Add, CommaText and Free are introduced. In addition, informations concerning the handling of object variables are provided. game_api_ChooseItemBox is introduced, as well as the loop while ... do and the commands Inc and StrToInt.

• 4.3 The 2. quiz
  

The 2. quiz is constructed. The method TStringList.Count, the operator not, the function game_api_QueryText and the procedure (Ansi)UpperCase are introduced.

• 4.4 The 3. quiz
  

The 3. quiz is constructed. Placeholder in strings, the appropriate function 'Format and StrtoIntdef are introduced.

• 4.5 Analysis of all quiz games
  

savegame_api_FreeCredits; savegame_api_GetCredits, savegame_api_NeedCredits, game_api_GameOver, IntToStr

• 4.6 The complete script
  

• 4.7 Messages with savegame_api_Message and further string commands
  

savegame_api_Message and a bunch of other commands used to manipulate strings.

• Chapter 5 - Multilingual scripts
  

• Chapter 6 - The creation of a ground combat mission
  

• 6.1 - A simple ground combat mission
  

TEinsatz (including the methods AddAlien and Start); TAlien; einsatz_api_generateeinsatz; alien_api_GetRandomAlien

• 6.2 - How to change ground combat missions
  

country_api_count; country_api_getCountry; country_api_GetRandomLandPosition; TCountry.Name; TEinsatz.Position; TEinsatz.Name; TEinsatz.Description; TEinsatz.Objectives; TEinsatz.RemainTime; TEinsatz.MapName; break; array of; SetLength; high; einsatz_api_getMapFiles; TAlien.Ges

• 6.3 - Events for ground combat missions
  

EVENT_ONEINSATZTIMEUP; EVENT_ONEINSATZWIN

• 6.4 - Alien management
  

TEinsatz.PopulateFromUFO; LongWord; function; alien_api_GetCount; alien_api_GetAlienByIndex; TAlien.Name; string_utils_split; "Conversion" of TObject-variables; var; record; type; set of; include; Arithmetic and logical operators

• Chapter 7 - Depot, transports and related stuff
  

Appendix A - Tasks

• Tasks
  

• Solutions
  

Appendix B - a short syntax-introduction for X-Script

• Syntax
• Script structure
• Variables and constants
• Complex datatypes
• Branches
• Loops
• Conditions
• Procedures and functions

Appendix C - Independant chapters

• Ingame timeline
  

This chapter describes, in which sequence special functions and events are called within a script.

• Function calls and event signals
  

This chapter discusses the different possibilities, to control and call multiple used functions.

• Finding and correcting errors
• Nameconventions in programming

This chapter describes what should be considered while naming functions and variables.

Miscellaneous

• Terms
  

• Types in X-Script
  

• Description of errors