Scenario Scripting

TODO: Update

First, go through the screens under "Mission Scripting" on the project website. If you prefer a video guide, try these: Scenario writing guides on YouTube.

After that, here are some suggested steps to making scripts:

1. Simple experiment

• Open the "Empty Space" scenario and create some terrain (asteroids, mines, black holes, etc.)
• Click the "Copy Scenario" button
• Open your favorite text editor and paste and you'll see the objects you clicked to create in code

2. See how an existing scenario works

• Open an existing scenario script. I suggest Waves or Birth of Atlantis
• Look at how these scripts do the things you observed when you played the scenario

3. Read the reference

• On Windows, find script_reference.html in the same directory as EmptyEpsilon.exe

• On Mac, assuming you built from source following the instructions in this wiki, find script_reference.html in the _build directory along side the EmptyEpsilon.app file

• on Mac, assuming you're running under Wine, find script_reference.html after you view package contents and navigate to the folder with EmptyEpsilon.exe. This is typically under drive_c/Program Files/EmptyEpsilon.

• On Linux, assuming you built from source following the instructions in this wiki, find script_reference.html in the _build directory along side the EmptyEpsilon executable file

• The reference file lists almost all the scripting features available. Just reading through some of the things you can do can be inspirational.

• If you build from source, the reference can also be generated with the script_docs/main.py Python 3 script, which scans the source code and produces the HTML reference. Run it from the repository root:

  python3 script_docs/main.py

4. Talk to your fellow gamers about what they'd like to see and then try to put it into a scenario.