Mission Editor

From Zero-K
Revision as of 18:51, 4 September 2020 by GoogleFrog (talk | contribs)
Jump to navigation Jump to search

The Mission Editor allows players to create interactive missions similar to single-player scenarios of commercial games and to easily publish them to all players.

Missions can also be designed for multiplayer and can be played cooperatively or competitively.

Missions can become part of campaigns. (Campaigns not implemented yet)

Mission editor intro 1.jpg Mission editor intro 2.png

Download

Feature Requests and Bug Reports

Running the Mission Editor

The mission editor loads its files using an older version of Spring. To get the required version:

  1. Open a Custom host and set a password.
  2. Do !engine 104.0.1-287-gf7b0fcc. You should see the response Nightwatch Engine changed to 104.0.1-287-gf7b0fcc.
  3. Start the battle. The engine should start downloading silently in the background.
  4. Wait a few minutes and check whether steamapps/common/Zero-K/win64/104.0.1-287-gf7b0fcc exists. If it doesn't then try win32. If you're on Linux then check the appropriate directory.
  5. Copy the entirety of 104.0.1-287-gf7b0fcc folder to a new folder somewhere isolated called missionDev.
  6. Copy steamapps/common/Zero-K/maps and steamapps/common/Zero-K/games to missionDev such that you have the paths missionDev/spring.exe, missionDev/maps and missionDev/games. Optionally, you may just make empty games and maps folders and copy whatever you need in as you need it.
  7. Run the mission editor and point it to missionDev/spring.exe when it asks you to supply an engine path.

You now have a mission editor setup capable of making and editing missions that use the maps and games you have copied into the relevant folders. To edit existing missions you may require two additional steps:

  • Some missions run off the development version of Zero-K as this makes them easier to test and debug. When the mission is exported for use the version is changed to zk:stable. To get the development version of Zero-K follow the instructions here with paths modified to end up with missionDev/games/zk.sdd.
  • To take a look at or edit the current missions, clone this repository similarly to how you would clone the main game in the above dot point.
  • Some old missions may be made with a version of Zero-K that no longer loads on the mission editor. When in doubt, use the development version of Zero-K (Zero-K $VERSION as it is the most likely to be up to date. The version of a mission can be changed directly by editing its xml.

Tutorials

General Tutorial

Factory Orders Tutorial

Cutscenes Tutorial

Publishing a mission

You can make your mission available online by publishing it. It will be available for others to play once enabled by an administrator.

To do this, open the Mission menu and click Publish. Fill in the form displayed.

A mission must have a description and image to be published.

Uploading the mission will take a few seconds. If you want to update or delete it, select the Manage Missions item in the Mission menu.

Errors

If you have the error message "Value cannot be null. Parameter name: paths"

  • Make sure your engine folder exists in the correct format in your Spring data directory: engine/<platform>/<version>.
  • For instance: engine\win32\103.0.1-746-g82259fc