Difference between revisions of "Mod Creation"
(Fixes, polish) |
GoogleFrog (talk | contribs) |
||
| Line 17: | Line 17: | ||
The relatively simpler way is to make a mutator, this is a game package that depends on the base game. Here is an example mutator [https://github.com/ZeroK-RTS/Zero-K/files/1963055/zk.sdd.zip]. Unzip it in games such, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this. | The relatively simpler way is to make a mutator, this is a game package that depends on the base game. Here is an example mutator [https://github.com/ZeroK-RTS/Zero-K/files/1963055/zk.sdd.zip]. Unzip it in games such, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this. | ||
| − | [[File: | + | [[File:mutatordir.jpg]] |
Overwrite any files to make edits. | Overwrite any files to make edits. | ||
Revision as of 23:11, 30 April 2018
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.
Contents
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.
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.
Mechanics changes
Changing animations, unit behaviour, game mechanics or statistics is a little trickier than cosmetic changes. These changes are also incompatible with the base game. There are two ways to make these changes.
Mutator
The relatively simpler way is to make a mutator, this is a game package that depends on the base game. Here is an example mutator [1]. Unzip it in games such, and yes, the folder should be named with the extension ".sdd". Your file stucture should look like this.
Overwrite any files to make edits.
Full repository
Fork and clone the game repository as seen on the Developing page.
Running your mod
Start a Custom battle lobby, with a password, on the multiplayer server. Type "!game zk:dev" 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.
Running your mod, singleplayer
- 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 games should now use your modified local copy of zk.sdd. In this mod, the Lotus has 10 times its normal range.
Debug data:
[SQLBagOStuff] MainObjectStash using store ReplicatedBagOStuff[objectcache] MainWANObjectCache using store EmptyBagOStuffIP: 18.219.151.245Start request GET /mediawiki/index.php?diff=3800&oldid=3799&title=Mod_Creation
HTTP HEADERS:
CONTENT-TYPE:
CONTENT-LENGTH: 0
PRIORITY: u=0, i
SEC-FETCH-DEST: document
SEC-FETCH-USER: ?1
SEC-FETCH-MODE: navigate
SEC-FETCH-SITE: none
UPGRADE-INSECURE-REQUESTS: 1
SEC-CH-UA-PLATFORM: "Windows"
SEC-CH-UA-MOBILE: ?0
SEC-CH-UA: "HeadlessChrome";v="129", "Not=A?Brand";v="8", "Chromium";v="129"
USER-AGENT: Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
HOST: zero-k.info
ACCEPT-ENCODING: gzip, deflate, br, zstd
ACCEPT: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7
PRAGMA: no-cache
CONNECTION: close
CACHE-CONTROL: no-cache[localisation] LocalisationCache: using store LCStoreDB[session] SessionManager using store SqlBagOStuff[DBReplication] Cannot use ChronologyProtector with EmptyBagOStuff[DBReplication] Wikimedia\Rdbms\LBFactory::getChronologyProtector: request info {
"IPAddress": "18.219.151.245",
"UserAgent": "Mozilla\/5.0 AppleWebKit\/537.36 (KHTML, like Gecko; compatible; ClaudeBot\/1.0; +claudebot@anthropic.com)",
"ChronologyProtection": false,
"ChronologyPositionIndex": 0,
"ChronologyClientId": false
}[DBConnection] Wikimedia\Rdbms\LoadBalancer::lazyLoadReplicationPositions: executed chronology callback.[DBConnection] Wikimedia\Rdbms\LoadBalancer::getLocalConnection: connected to database 0 at 'localhost'.[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[session] SessionBackend "v5s9mf2rjfkvhrkiqb6v9pro180jeu26" is unsaved, marking dirty in constructor[session] SessionBackend "v5s9mf2rjfkvhrkiqb6v9pro180jeu26" save: dataDirty=1 metaDirty=1 forcePersist=0[cookie] already deleted setcookie: "wikidb229_mw__session", "", "1712149950", "/", "", "", "1"[cookie] already deleted setcookie: "wikidb229_mw_UserID", "", "1712149950", "/", "", "", "1"[cookie] already deleted setcookie: "wikidb229_mw_Token", "", "1712149950", "/", "", "", "1"[cookie] already deleted setcookie: "forceHTTPS", "", "1712149950", "/", "", "", "1"[DBConnection] Wikimedia\Rdbms\LoadBalancer::getLocalConnection: connected to database 0 at 'localhost'.Title::getRestrictionTypes: applicable restrictions to [[Mod Creation]] are {edit,move}[ContentHandler] Created handler for wikitext: WikitextContentHandlerArticle::view: showing diff pageDifferenceEngine old '3799' new '3800' rcid ''[MessageCache] MessageCache using store SqlBagOStuff[localisation] LocalisationCache::isExpired(en): cache for en expired due to GlobalDependency[localisation] LocalisationCache::recache: got localisation for en from source[DBQuery] startAtomic: entering level 0 (LCStoreDB::finishWrite)[DBQuery] endAtomic: leaving level 0 (LCStoreDB::finishWrite)[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] SqlBagOStuff::lock failed due to timeout for wikidb229-mw_:messages:en.[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[MessageCache] MessageCache::load: Loading en... local cache is empty, global cache is expired/volatile, loading from databaseParserFactory: using preprocessor: Preprocessor_HashUnstubbing $wgLang on call of $wgLang::_unstub from ParserOptions->__constructDifferenceEngine old '0' new '0' rcid '0'WikiPage::getParserOutput: using parser cache: no[caches] parser: SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuff[SQLBagOStuff] Connection mysql object #127 (handle id #121) will be used for SqlBagOStuffParser cache options found.[Preprocessor] Cached preprocessor output (key: wikidb229-mw_:preprocess-hash:dc1ecddb436c64a7ba9b1c622aa008e6:0)[objectcache] Rejected set() for wikidb229-mw_:file:c9e9e23e37c87bb3197e9f3537bf0e2bf45024d6 due to pending writes.[objectcache] Rejected set() for wikidb229-mw_:image_redirect:147be67bbe0651cfa5681787391b9a2e due to pending writes.ForeignAPIRepo: HTTP GET: https://commons.wikimedia.org/w/api.php?titles=File%3AMutatordir.jpg&iiprop=timestamp%7Cuser%7Ccomment%7Curl%7Csize%7Csha1%7Cmetadata%7Cmime%7Cmediatype%7Cextmetadata&prop=imageinfo&iimetadataversion=2&iiextmetadatamultilang=1&format=json&action=query&redirects=true&uselang=en[http] * Error fetching URL: SSL certificate problem: unable to get local issuer certificate
* There was a problem during the HTTP request: 0 Error[Preprocessor] Cached preprocessor output (key: wikidb229-mw_:preprocess-hash:dc1ecddb436c64a7ba9b1c622aa008e6:0)MediaWiki::preOutputCommit: primary transaction round committedMediaWiki::preOutputCommit: pre-send deferred updates completedMediaWiki::preOutputCommit: session changes committedMediaWiki::preOutputCommit: LBFactory shutdown completedTitle::getRestrictionTypes: applicable restrictions to [[Mod Creation]] are {edit,move}
