Difference between revisions of "Map Creation"
(added beginner tutorial) |
(Basic rundown on startboxes and metal spots.) |
||
| Line 11: | Line 11: | ||
Here are some SpringRTS (the engine) links [https://springrts.com/wiki/Mapdev:Main] [https://springrts.com/wiki/Map,_Game,_And_Unit_Development_Programs#Map_Creation] | Here are some SpringRTS (the engine) links [https://springrts.com/wiki/Mapdev:Main] [https://springrts.com/wiki/Map,_Game,_And_Unit_Development_Programs#Map_Creation] | ||
| + | |||
| + | == Startboxes == | ||
| + | |||
| + | Startboxes are loaded from /mapconfig/map_startboxes.lua and can be generated ingame with the Startbox Editor widget included with the game. Alt-F11 to toggle. | ||
| + | |||
| + | Full guide for the startbox editor here: http://zero-k.info/Forum/Thread/20485 | ||
| + | |||
| + | == Metal Configuration and Spot Graphics == | ||
| + | |||
| + | Metal spots on maps are done via Lua configs. They can be generated ingame with the dbg_mouse_to_mex_portable.lua widget, available at [https://github.com/The-Yak/mexes_grounddecal_autoplacer | TheMooseIsLoose's github.] | ||
| + | |||
| + | Download that repo as a zip and extract into your map folder. Load the map in ZK, enable cheats, and then enable Debug Mouse to Mex in your alt-f11 widget menu. Alt-M to toggle on and off. Click to create new metal spots, the values and positions will be automatically saved to your game data directory. Copy and paste the content from MexSpots_YourMap to your /mapconfig/map_metal_layout.lua | ||
= Running maps = | = Running maps = | ||
Revision as of 12:10, 3 May 2018
Maps are 7z archives which, at their most basic, consist of three image files packaged in a particular way. They can be found in Zero-K/Maps and be zipped or unziped with 7zip. Maps can contain more than their three image files, including:
- Metal spot layout.
- Start area configuration.
- Tree, rock or any other models to be placed as map features.
- Arbitrary code and units changes that can arbitrarily modify the game. See Mod Creation.
Contents
Creating maps
Beginner mapping tutorial for SpringRTS is located here: https://springrts.com/wiki/Mapdev:Tutorial_Simple
Ask for help in #zkmap in on the Zero-K Discord server.
Here are some SpringRTS (the engine) links [1] [2]
Startboxes
Startboxes are loaded from /mapconfig/map_startboxes.lua and can be generated ingame with the Startbox Editor widget included with the game. Alt-F11 to toggle.
Full guide for the startbox editor here: http://zero-k.info/Forum/Thread/20485
Metal Configuration and Spot Graphics
Metal spots on maps are done via Lua configs. They can be generated ingame with the dbg_mouse_to_mex_portable.lua widget, available at | TheMooseIsLoose's github.
Download that repo as a zip and extract into your map folder. Load the map in ZK, enable cheats, and then enable Debug Mouse to Mex in your alt-f11 widget menu. Alt-M to toggle on and off. Click to create new metal spots, the values and positions will be automatically saved to your game data directory. Copy and paste the content from MexSpots_YourMap to your /mapconfig/map_metal_layout.lua
Running maps
Local testing
To run a map locally put it in Zero-K/Maps then start the game. Untick 'Only featured maps' in Settings -> Lobby and start a singleplayer skirmish game. Select 'Advanced', click 'Change Map' and select your map from the list.
Multiplayer
Upload your map to https://springfiles.com/ to make it downloadable and playable by others. Some admin action to feature/support the map may also be required.
Debug data:
[SQLBagOStuff] MainObjectStash using store ReplicatedBagOStuff[objectcache] MainWANObjectCache using store EmptyBagOStuffIP: 3.145.116.170Start request GET /mediawiki/index.php?diff=prev&oldid=3819&title=Map_Creation
HTTP HEADERS:
CONTENT-TYPE:
CONTENT-LENGTH: 0
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, br, zstd, deflate
ACCEPT: */*[localisation] LocalisationCache: using store LCStoreDB[session] SessionManager using store SqlBagOStuff[DBReplication] Cannot use ChronologyProtector with EmptyBagOStuff[DBReplication] Wikimedia\Rdbms\LBFactory::getChronologyProtector: request info {
"IPAddress": "3.145.116.170",
"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 "mmn89tds74l8go6spl3d8fq2n8sg0pjm" is unsaved, marking dirty in constructor[session] SessionBackend "mmn89tds74l8go6spl3d8fq2n8sg0pjm" save: dataDirty=1 metaDirty=1 forcePersist=0[cookie] already deleted setcookie: "wikidb229_mw__session", "", "1715588329", "/", "", "", "1"[cookie] already deleted setcookie: "wikidb229_mw_UserID", "", "1715588329", "/", "", "", "1"[cookie] already deleted setcookie: "wikidb229_mw_Token", "", "1715588329", "/", "", "", "1"[cookie] already deleted setcookie: "forceHTTPS", "", "1715588329", "/", "", "", "1"[DBConnection] Wikimedia\Rdbms\LoadBalancer::getLocalConnection: connected to database 0 at 'localhost'.Title::getRestrictionTypes: applicable restrictions to [[Map Creation]] are {edit,move}[ContentHandler] Created handler for wikitext: WikitextContentHandlerArticle::view: showing diff pageDifferenceEngine old '3819' new 'prev' rcid ''[MessageCache] MessageCache using store 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] 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:5a38a82bddb61e961c2cec8a9c68bd49:0)[Preprocessor] Cached preprocessor output (key: wikidb229-mw_:preprocess-hash:5a38a82bddb61e961c2cec8a9c68bd49: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 [[Map Creation]] are {edit,move}
