Saving And Loading - astruyk/Ares GitHub Wiki

Saving And Loading

Using the 'Generate Mission SQF' module

This module will, when dropped into the world, generate SQF code that can be used to re-build the mission later.

The basic usage is:

  1. Setup your mission by placing objects using the normal Zeus tools.
  2. Drop the 'Generate Mission SQF' module into the world in the mission area.
  3. Choose the options for which objects to save (see below for details) and choose 'OK'.
  4. Copy the text from the resulting dialog box into your clipboard (selecting the text and using CTRL-C).
  5. (optional) Save the copied SQF to a text file on your computer to ensure it's kept safe.

Typically you will want to re-generate the mission at a later time:

  1. Place down the 'Util -> Execute Code (Server)' module
  2. Paste the SQF you copied into the code window.
  3. Choose 'OK' to execute the code.

Options

  • Radius - The size of the mission area to capture centered around the position the module was placed. Only objects within this area will actually be saved.
  • Include AI - Determines whether or not AI units (soldiers and crewed vehicles) will be included.
  • Include Empty Vehicles - Determines whether or not vehicles and static weapons that are not crewed should be included.
  • Include Objects - Determines whether objects that do not fall into the 'AI' or 'Empty Vehicles' categories should be captured. Typically this includes things like fortifications and buildings.
  • Include Markers - Determines whether or not map markers placed in the area should be included.

Other Applications

The generated code does not rely on Ares being present at all, so it is safe to use in missions that aren't running it. If you want to, you can use the code into an .SQF file that is executed by the mission (make sure to run it only on the server if it's an MP mission!).

For example, you might want to generate a bunch of 'side missions' that are randomly spawned during your main mission on-the-fly - you can use this module to generate the code to spawn enemies and/or bases that you setup in zeus ahead of time without having to hand-code everything!