Difference between revisions of "Mod Creation"

From Zero-K
Jump to navigation Jump to search
Line 13: Line 13:
 
For LuaUI changes you will need to enabled local widgets and load local widgets first through the advanced settings in <code>Settings/Interface/Misc</code>. Completely new widgets can also be added and loaded.
 
For LuaUI changes you will need to enabled local widgets and load local widgets first through the advanced settings in <code>Settings/Interface/Misc</code>. Completely new widgets can also be added and loaded.
  
−
== Mechanics changes ==
+
== More Significant Changes ==
−
Changing animations, unit behaviour, game mechanics or statistics is a little trickier than cosmetic changes. These types of changes affect everyone in a multiplayer game (as opposed to local interface changes) so require the creation and distribution of a game archive.
+
Changing animations, unit behaviour, game mechanics or statistics is a little trickier than cosmetic changes. These types of changes affect everyone in a multiplayer game (as opposed to local interface changes) so require the creation and distribution of a game archive. Entirely new games for the Spring engine can be made with this method.
  
−
=== Mutator ===
+
=== Mutators ===
−
The relatively simple way to mod Zero-K is to make a mutator, this is a game package that includes modified files but otherwise uses the files of the base game. Here is an example mutator [[:File:Zk.sdd.zip|zk.sdd.zip]] to get you started. Unzip it in Zero-K/games, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this.
+
A mutator is a mod archive that can add and override files relative to a base archive. Mods that make relatively small changes to Zero-K should be made with a mutator, as this keeps filesizes low and allows the mod to stay up to date with fixes or changes to other parts of Zero-K. Even large projects should probably start out as mutators, as it enables the project to build up to handling every aspect of creating a full game archive.
  
−
[[File:AdvOptions.png]]
+
is to make a mutator, this is a game package that includes modified files but otherwise uses the files of the base game. Here is an example mutator [[:File:BaseMod.sdd.zip|BaseMod.sdd.zip]] to get you started. Unzip it in Zero-K/games, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this.
−
[[File:SelectMod.png]]
 
  
−
[[File:Capture1.PNG]]
+
[[File:baseModFile.png]]
  
 
Any file found in the mutator and the base game will be overridden by the version found in the mutator. New files can be added too.
 
Any file found in the mutator and the base game will be overridden by the version found in the mutator. New files can be added too.
  
−
=== Full repository ===
+
=== Downloading the Zero-K repository ===
−
Downloading the full Zero-K repository can be useful for many types of modding. Fork and clone the game repository as seen on the [[Developing]] page. Be warned, you will need to pull changes via git in order to receive updates. With a local repository you can eventually open pull requests and push content to be included in the base game (if you're keen).
+
Maintaining a local development copy of Zero-K is very useful as poking around the repository can reveal a lot about the required structure for mutators, the names of files to override, and provides a place to trace errors. Clone the game repository as seen on the [[Developing]] page. The fork step can be skipped for now if you are just intending to take a look. Be sure to keep your local copy up to date by regularly using git to pull changes. With a local repository you can eventually open pull requests and push content to be included in the base game (if you're keen).
 +
 
 +
=== Running your mod - Singleplayer ===
 +
Open a skirmish via the singleplayer menu and click 'Adv Options'.
 +
 
 +
[[File:AdvOptions.png]]
 +
 
 +
Click 'Select Mod' and select your mod from the list. The example above is called 'Zero-K Base Mutator v1'. Click Apply.
 +
 
 +
[[File:SelectMod.png]]
  
−
=== Running your mod ===
+
The text beneath the Adv Options button should change from 'Zero-K vX.Y.Z.W' to the name of your mod.
−
(outdated, use the game selection in adv options. TODO: Update the example mutator to not be Zero-K $VERSION)
 
  
−
Start a Custom battle lobby, with a password, on the multiplayer server. Type <code>!game zk:dev</code> to switch to your mod, make sure you have a green tick. Other players can join and play your mod if they have the exact same mod files. If you made a mod with the full repository method then they can clone your fork on GitHub.
+
Click 'Start' to start. Note that friends invited via skirmish coop will not be able to join the game unless they have a copy of your mod.
  
−
=== Running your mod, singleplayer ===
+
=== Running your mod - Multiplayer ===
 
* Enable developer mode. Do this by creating an empty text document "devmode.txt" in the same directory as Zero-K.exe. You may need to restart the lobby.
 
* Enable developer mode. Do this by creating an empty text document "devmode.txt" in the same directory as Zero-K.exe. You may need to restart the lobby.
 
* In the Settings menu a new tab appears: Developer. Edit the Singleplayer setting to be Zero-K Dev.
 
* In the Settings menu a new tab appears: Developer. Edit the Singleplayer setting to be Zero-K Dev.

Revision as of 02:09, 19 August 2020

Zero-K runs on the Spring engine, which supports a lot of modification of game files. The most advanced mods may amount to creating an entire new game. The Spring engine wiki is a valuable resource for game and mod development using the engine, especially the gamedev page.

Familiarity with the game repository or main menu repository is important for modding and downloading a searchable version is advised. See Developing#Getting_Sources for how to download a local version of the repository.

Cosmetic and UI changes

Some changes can be made just by adding files to your install directory. The following subfolders of the game repository should support this (feel free to attempt more): unitpics, sounds, unittextures, bitmaps, anims, icons and LuaUI. Replace a file by perfectly matching its name and path.

Here's an example config replacement for team colour config that you can place in LuaUI/Configs/LocalColors.lua.

Everything in the main menu repository can be overridden.

Widgets

For LuaUI changes you will need to enabled local widgets and load local widgets first through the advanced settings in Settings/Interface/Misc. Completely new widgets can also be added and loaded.

More Significant Changes

Changing animations, unit behaviour, game mechanics or statistics is a little trickier than cosmetic changes. These types of changes affect everyone in a multiplayer game (as opposed to local interface changes) so require the creation and distribution of a game archive. Entirely new games for the Spring engine can be made with this method.

Mutators

A mutator is a mod archive that can add and override files relative to a base archive. Mods that make relatively small changes to Zero-K should be made with a mutator, as this keeps filesizes low and allows the mod to stay up to date with fixes or changes to other parts of Zero-K. Even large projects should probably start out as mutators, as it enables the project to build up to handling every aspect of creating a full game archive.

is to make a mutator, this is a game package that includes modified files but otherwise uses the files of the base game. Here is an example mutator BaseMod.sdd.zip to get you started. Unzip it in Zero-K/games, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this.

BaseModFile.png

Any file found in the mutator and the base game will be overridden by the version found in the mutator. New files can be added too.

Downloading the Zero-K repository

Maintaining a local development copy of Zero-K is very useful as poking around the repository can reveal a lot about the required structure for mutators, the names of files to override, and provides a place to trace errors. Clone the game repository as seen on the Developing page. The fork step can be skipped for now if you are just intending to take a look. Be sure to keep your local copy up to date by regularly using git to pull changes. With a local repository you can eventually open pull requests and push content to be included in the base game (if you're keen).

Running your mod - Singleplayer

Open a skirmish via the singleplayer menu and click 'Adv Options'.

AdvOptions.png

Click 'Select Mod' and select your mod from the list. The example above is called 'Zero-K Base Mutator v1'. Click Apply.

SelectMod.png

The text beneath the Adv Options button should change from 'Zero-K vX.Y.Z.W' to the name of your mod.

Click 'Start' to start. Note that friends invited via skirmish coop will not be able to join the game unless they have a copy of your mod.

Running your mod - Multiplayer

  • Enable developer mode. Do this by creating an empty text document "devmode.txt" in the same directory as Zero-K.exe. You may need to restart the lobby.
  • In the Settings menu a new tab appears: Developer. Edit the Singleplayer setting to be Zero-K Dev.
  • Your skirmish/campaign games should now use your modified local copy of zk.sdd. In this mod, the Lotus has 10 times its normal range.

Advanced mutator creation (offline only?)

Retrieved from "https://zero-k.info/mediawiki/index.php?title=Mod_Creation&oldid=6803"
Debug data: