Difference between revisions of "How to create new scenario/mission"

From Nebuchadnezzar Modding Wiki
Jump to navigation Jump to search
Line 105: Line 105:
 
*1) Start the game again and in the mod manager activate newly created mod.
 
*1) Start the game again and in the mod manager activate newly created mod.
 
*2) Restart the game.
 
*2) Restart the game.
*3) In the editor
+
*3) In the editor [[#Missions_management_screen|missions management screen]] select newly created mission.
 +
*4) Set size of the new map and click to the "Create new map" button.

Revision as of 15:55, 25 October 2021

Warn.png This manual is intended for the new reworked map editor. Not release yet, but you can already try it in the Steam beta branch. Currently it's the recommended way how to create the new maps.

How to change Steam beta branches:

1) Right click to Nebuchadnezzar in the Steam library and then select "Properties".
< Branch1.png

2) Select "Betas" section and in the drop down list select required version. Chose "None" for the default version.
Branch3.png


Custom maps and mods

  • All new or changed data (including new missions) are distributed and managed through the mods.
    • Note: All scenarios are in fact missions without a campaign, so we will refer all new maps as a missions.
  • Although working with the map editor won't require you to work directly with the raw mod data, the user should know the basic of how the mods work.
  • See Quick Start & Modding Basics

Mission map vs Mission definition

Process of creating a new mission in Nebuchadnezzar has two main parts:

  • 1) Define the mission.
    • Create data structure for the mission.
    • Define all of the mission's properties like available buildings, surrounding cities, mission objectives etc.
  • 2) Create a map for the mission.
    • Create the map itself.
    • Place all terrains, buildings etc.

In-game editor's screens

In-game editor's screens description.

Mods management screen

This screen allows you to create new mods and to upload your mods to the Steam workshop.

  • 1) List of your developers mods
  • 2) Create new mod with the given name.
  • 3) Upload selected mod to the Steam workshop
  • 4) Go to the next screen with the mod's missions.

Editor1.png

Missions management screen

This screen allows you to create map for the defined missions and access them for the future editing and testing.

  • 1) List of your missions in the selected mod.
  • 2) Create new map for the selected mission.
  • 3) Open editor with the selected mission, either for empty map start or historical start.
  • 4) Run the selected mission, either in empty map start or historical start.
  • 5) Open missions definition tool. More below.

Editor2.png

Definitions files editor

Nebuchadnezzar definition files generator (NDFG) is an externa tool to help users to create and edit missions' definition files.

  • It can be launched from the game of separately in installation folder at installation folder/binary/[linux, win]_editor/editor.exe

Warning: Warn.png

  • All mission related definition files in the mod will be rewritten by the generated files.
  • This tool uses its own data storage, meaning that none of "out of tool" changes will be reflected in this tool.

Mod selection screen

This screen contains tool description and mod selection.

  • 1) Select mod to edit.

Editor3.png

Missions selection screen

This screen contains all missions in the selected mod.

  • 1) Select, remove or rename selected mission.
  • 2) Add (create) new mission.

Editor4.png

Mission edit screen

The most important screen where the user can edit all mission's property.

  • 1) Choose section to edit.
  • 2) Save all data.
  • 3) Save all data and generate definition files.

Editor5.png

Step by step example of creating a new mission

A) Create a new mod

  • 1) In the mod management screen enter new mod name and then click to the "Create a new mod" button.
  • 2) Restart the game.

B) Create a new mission

  • 1) Go to the missions management screen with the newly created mod.
  • 2) Click to the "Open definition files editor" button.
  • 3) NDFG tool should open on the missions selection screen.
  • 4) Enter new mission name and click to the "Add new mission" button.
  • 5) Select the newly created mission.

C) Setup new mission

  • 1) For easy start use some preset in the General tab.
  • 2) In the Description tab fill the Mission image field because it's the only field not filled by the preset.
    • Image must be stored in the mod directory to game be able to load it.
  • 3) Click on the "Save and generate files" button to generated required mission definition files.
  • 4) Close the tool.

D) Create new map for the mission

  • 1) Start the game again and in the mod manager activate newly created mod.
  • 2) Restart the game.
  • 3) In the editor missions management screen select newly created mission.
  • 4) Set size of the new map and click to the "Create new map" button.