Difference between revisions of "WkTerrainSync"

From Worms Knowledge Base

Jump to: navigation, search
(uploaded many MANY missing terrain images, gave self RSI xD)
m (Custom terrains)
 
(114 intermediate revisions by 13 users not shown)
Line 4: Line 4:
 
| name = wkTerrainSync
 
| name = wkTerrainSync
 
| developer = nizikawa
 
| developer = nizikawa
| version = v1.2.2 (22 August 2021)
+
| version = v1.2.6.1 (29 May 2022)
 
| games = [[Worms Armageddon|W:A]]
 
| games = [[Worms Armageddon|W:A]]
 
| waver = 3.8.x
 
| waver = 3.8.x
 
| language = C++
 
| language = C++
| license = [https://github.com/nizikawa-worms/wkTerrainSync Open Source]
+
| license = [https://github.com/nizikawa-worms/wkTerrainSync/blob/master/LICENSE WTFPL]
| website = [https://www.tus-wa.com/forums/worms-armageddon/wkterrainsync-v-1-2-2-released-play-custom-missions-online-33098/ TUS thread]
+
| website = [https://www.tus-wa.com/forums/wormkit-modules/wkterrainsync-33098/ TUS thread] [https://github.com/nizikawa-worms/wkTerrainSync GitHub repository]
| download = [https://www.tus-wa.com/forums/worms-armageddon/wkterrainsync-v-1-2-2-released-play-custom-missions-online-33098/?action=dlattach;attach=196130]
+
| download = [https://github.com/nizikawa-worms/wkTerrainSync/releases/latest/download/wkTerrainSync-release.zip]
 
}}
 
}}
  
 
[[Image:DomesticTerrain.png|thumb|230px|Domestic Terrain]]
 
[[Image:DomesticTerrain.png|thumb|230px|Domestic Terrain]]
  
'''wkTerrainSync''' is a module for [[WormKit]] that allows additional W:A terrains to be installed and selected in the [[Map_Editor_Guide|Map editor]]
+
'''wkTerrainSync''' is a module for [[WormKit]] that allows additional W:A terrains to be installed and selected in the [[Map_Editor_Guide|Map editor]].  It supports online multiplayer (providing all players have the module installed) and will automatically download the custom terrain from the host if it doesn't exist locally.
  
It makes it easy for terrains such as Dinos and Domestic (which are present on the [[WWP]] CD) to be installed and played with WA.
+
It makes it easy for terrains such as Dinos and Domestic (which are present on the [[WWP]] CD) to be installed and played with WA. A full list of community-made [[WkTerrainSync#Custom_terrains|Custom Terrains]] can be found below.
  
 
It superseded [[WkTerrain]] adding new features such as data synchronization for network games and sprite addition/replacement.
 
It superseded [[WkTerrain]] adding new features such as data synchronization for network games and sprite addition/replacement.
Line 26: Line 26:
  
 
== Usage ==
 
== Usage ==
wkTerrainSync does not require any special configuration or user interaction.
+
wkTerrainSync does not require any special configuration or user interaction.  Installation is the same as with other WormKit modules, simply extract the files to your Worms Armageddon folder (the same folder with the WA.exe file) and ensure that "Load WormKit modules" in the Advanced options section of the game is enabled.
  
 
If you are joining an online game that uses a new terrain file that you currently don't have installed, you will see an "Invalid map file" in map thumbnail and multiple messages about terrain data download will appear in lobby chat. This means the terrain file is being downloaded from the host and a proper map thumbnail will appear once the terrain is downloaded. This should take few seconds depending on network speed.
 
If you are joining an online game that uses a new terrain file that you currently don't have installed, you will see an "Invalid map file" in map thumbnail and multiple messages about terrain data download will appear in lobby chat. This means the terrain file is being downloaded from the host and a proper map thumbnail will appear once the terrain is downloaded. This should take few seconds depending on network speed.
  
Those using the CD version of WA will require [http://worms.thecybershadow.net/wormkit/wkFileOverride.zip FileOverride] to use this module.
+
Playing on custom terrains with those who do no have the module is possible by first converting the map to PNG. However, the debris, soil, background, custom water and other features of the terrain will be lost.<br>
 +
To convert the map to PNG format:<br>
 +
* Enter the detailed map settings window by right clicking the map in the lobby.
 +
* If not already in preview mode, click the preview terrain button [[Image:PreviewTerrainButton.png|inline|24px|Preview terrain button]].
 +
* Right-click the return to edit mode button [[Image:TerrainButton.png|inline|24px|Return to edit mode button]]. The map will now be a PNG map.
  
 
To troubleshoot the module, enable dev console in .ini file and examine the logged messages
 
To troubleshoot the module, enable dev console in .ini file and examine the logged messages
Line 44: Line 48:
 
An additional feature separate from custom terrains is the ability to use the single player mission functionality in online and offline multiplayer.
 
An additional feature separate from custom terrains is the ability to use the single player mission functionality in online and offline multiplayer.
 
*A [[Worms_Armageddon_mission_file|mission file]] can be placed in the Saved Levels directory with the same name as the map (PNG, IMG and BIT are supported) and it will be loaded by the module when the map is selected.
 
*A [[Worms_Armageddon_mission_file|mission file]] can be placed in the Saved Levels directory with the same name as the map (PNG, IMG and BIT are supported) and it will be loaded by the module when the map is selected.
 
  
 
== Features ==
 
== Features ==
Line 97: Line 100:
  
 
|-
 
|-
| Arachnophobia || [[People/sbs|sbs]], [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2230/ TUS file] || Art by sbs, crafted by Conejo. Source: https://www.wmdb.org/35027 || 2020-12-31
+
| Angel Island(Sonic3) || [[People/JSG|JSG]] || [https://www.tus-wa.com/files/file-2519/ TUS file] || Made with assets from Sonic 3's first level || 2022-04-23
 +
|-
 +
| Arachnophobia || [[People/Conejo|Conejo]], [[People/sbs|sbs]] || [https://www.tus-wa.com/files/file-2230/ TUS file] || Art by sbs, crafted by Conejo. Source: https://www.wmdb.org/35027 || 2020-12-31
 
|-
 
|-
 
| Arcade || [[People/Ducky|Ducky]] || [https://www.tus-wa.com/files/file-2252/ TUS file] || Participation of [[User:OScarDiAnno|oScarDiAnno]] who made the "worm plush grabbed by a claw" object || 2021-01-24
 
| Arcade || [[People/Ducky|Ducky]] || [https://www.tus-wa.com/files/file-2252/ TUS file] || Participation of [[User:OScarDiAnno|oScarDiAnno]] who made the "worm plush grabbed by a claw" object || 2021-01-24
 +
|-
 +
| Berlin Boss || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2444/ TUS file] || Made with Assets from the WWP's Berlin Boss map || 2021-12-21
 +
|-
 +
| Bliss || [[User:M1t3nk0v|M1t3nk0v]] || [https://www.tus-wa.com/files/file-2541/ TUS file] || Based on Windows XP and its default Wallpaper "Bliss" || 2022-05-20
 
|-
 
|-
 
| Blood || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2233/ TUS file] || || 2021-01-04
 
| Blood || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2233/ TUS file] || || 2021-01-04
 
|-
 
|-
| Camping || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2258/ TUS file] || || 2021-08-17
+
| Breaking Bad || [[People/doc|doc]] || [https://www.tus-wa.com/files/file-2584/ TUS file] || || 2022-07-18
 +
|-
 +
| Camping || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2258/ TUS file] || || 2023-01-17
 +
|-
 +
| Candy || unknown || [https://www.tus-wa.com/files/file-2262/ TUS file] || From [[MapGEN]] Candy theme. An improved/updated version can be found here: https://www.tus-wa.com/files/file-2899/ || 2023-08-28
 +
|-
 +
| Cars || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2447/ TUS file] || Made with assets from WA's Cars map || 2021-12-22
 +
|-
 +
| CastleHassle || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2896/ TUS file] || Made with assets from WWP's CastleHassle map || 2023-8-14
 +
|-
 +
| Chateau || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2450/ TUS file] || Made with assets from WA's Chateau map || 2021-12-27
 +
|-
 +
| Chemical Plant Zone || [[User:Placebo_yue|Placebo_yue]] || [https://www.tus-wa.com/files/file-2523 TUS file] || Art ripped from Sonic 2 || 2022-04-26
 +
|-
 +
| Chemistery || [[User:Echiko|Echiko]] || [https://www.tus-wa.com/files/file-2597/ TUS file] || || 2022-07-31
 +
|-
 +
| Chocolate || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2348/ TUS file] || There are 2 variations of this terrain texture; the original cake texture and a cookies texture || 2023-10-14
 
|-
 
|-
| Candy || unknown || [https://www.tus-wa.com/files/file-2262/ TUS file] || created using [[MapGEN]] Candy theme || 2018
+
| CI5 Water || [[People/EmeraldPlay|EmeraldPlay]] || [https://www.tus-wa.com/files/file-2292/ TUS file] || Made with assets from Chicken Invaders: Cluck of the Dark Side || 2021-05-04
 
|-
 
|-
| Chocolate || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2348/ TUS file] || || 2021-08-17
+
| Cosmic || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2208/ TUS file] || || 2022-06-02
 
|-
 
|-
| Cosmic || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2208/ TUS file] || || 2021-08-17
+
| Creeper World 2 || [[People/Orandza|Orandza]] || [https://www.tus-wa.com/files/file-2378/ TUS file] || Made with assets from Creeper World 2 || 2021-08-22
 
|-
 
|-
 
| Diablo || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2235/ TUS file] || || 2021-01-06
 
| Diablo || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2235/ TUS file] || || 2021-01-06
 
|-
 
|-
| Dinos || [[Team17]] || [https://www.tus-wa.com/files/file-1276/ TUS file] || Imported from WWP || 2018
+
| Dinos || [[Team17]] || [https://www.tus-wa.com/files/file-1276/ TUS file] || Imported from WWP || 2017-10-18
 
|-
 
|-
 
| DIY || [[Team17]] || [https://www.tus-wa.com/files/file-2254/ TUS file] || Imported from Worms DC by [[People/Ducky|Ducky]] || 2020-09-01
 
| DIY || [[Team17]] || [https://www.tus-wa.com/files/file-2254/ TUS file] || Imported from Worms DC by [[People/Ducky|Ducky]] || 2020-09-01
 
|-
 
|-
| Domestic || [[Team17]] || [https://www.tus-wa.com/files/file-1276/ TUS file] || Imported from WWP || 2018
+
| Domestic || [[Team17]] || [https://www.tus-wa.com/files/file-1276/ TUS file] || Imported from WWP || 2017-10-18
 
|-
 
|-
 
| Egypt || [[User:ARTemych|ARTemych]], [[People/SiD|SiD]] || [https://www.tus-wa.com/files/file-2180/ TUS file] || Crafted by SiD. Original ARTemych's art from https://www.wmdb.org/28412 || 2020-10-22
 
| Egypt || [[User:ARTemych|ARTemych]], [[People/SiD|SiD]] || [https://www.tus-wa.com/files/file-2180/ TUS file] || Crafted by SiD. Original ARTemych's art from https://www.wmdb.org/28412 || 2020-10-22
 +
|-
 +
| Elastomania || [[People/nizikawa|nizikawa]] || [https://www.tus-wa.com/files/file-2630/ TUS file] || || 2022-02-04
 
|-
 
|-
 
| Electronics || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2213/ TUS file] || || 2020-12-05
 
| Electronics || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2213/ TUS file] || || 2020-12-05
 
|-
 
|-
| Fimbulwinter || [[1gor Melitonov]] || [https://www.tus-wa.com/files/file-2242/ TUS file] || || 2021-01-10
+
| Emerald Hill Zone (sonic 2) || [[User:Placebo_yue|Placebo_yue]] || [https://www.tus-wa.com/files/file-2520/ TUS file] || Made with sprites ripped from Sonic The Hedgehog 2's first level || 2022-04-23
 
|-
 
|-
| Ganja || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2162/ TUS file] || || 2021-08-17
+
| Fimbulwinter || [[People/1gor Melitonov|1gor Melitonov]] || [https://www.tus-wa.com/files/file-2242/ TUS file] || Deleted from TUS || 2021-01-10
 +
|-
 +
| Fruit Bastilles || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2452/ TUS file] || Made with assets from WWP's Fruit Bastilles map || 2021-12-28
 +
|-
 +
| Ganja || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2162/ TUS file] || || 2023-10-20
 +
|-
 +
| Green Hill Zone || [[User:Placebo_yue|Placebo_yue]] || [https://www.tus-wa.com/files/file-2515/ TUS file] || Art ripped from Sonic the Hedgehog || 2022-04-20
 +
|-
 +
| Halloween || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2415/ TUS file] || || 2022-07-19
 +
|-
 +
| Heaven || [[User:Echiko|Echiko]] || [https://www.tus-wa.com/files/file-2567/ TUS file] || Includes an Altaria sprite from Pokémon franchise and a Holy Grenade || 2022-06-13
 +
|-
 +
| Island Antics || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2448/ TUS file] || Made with assets from WWP's Island Antics map || 2021-12-24
 
|-
 
|-
 
| Lowpoly || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2234/ TUS file] || || 2021-01-06
 
| Lowpoly || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2234/ TUS file] || || 2021-01-06
 +
|-
 +
| Mangrove Swamp || [[User:SIBASA|SIBASA]], [[User:King-Gizzard|King-Gizzard]], [[User:FoxHound|FoxHound]] || [https://www.tus-wa.com/files/file-2593/ TUS file] || First version released on the [https://www.unesco.org/en/days/mangrove-ecosystem-conservation-day International Day for the Conservation of the Mangrove Ecosystem] (26 July). Second version was only possible thanks to King-Gizzard joining the party|| 2022-08-11
 +
|-
 +
| Marble Zone || [[User:Placebo_yue|Placebo_yue]] || [https://www.tus-wa.com/files/file-2525/ TUS file] || Images ripped from Sonic the hedgehog || 2022-04-30
 +
|-
 +
| Meadow || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2706/ TUS file] || || 2023-01-20
 +
|-
 +
| Missile Base || [[People/JSG|JSG]], [[Team17]] || [https://www.tus-wa.com/files/file-2453/ TUS file] || Made with assets from WWP's Missile Base map || 2021-12-30
 +
|-
 +
| Money || [[People/EmeraldPlay|EmeraldPlay]] || [https://www.tus-wa.com/files/file-2291/ TUS file] || || 2021-05-04
 
|-
 
|-
 
| Mulheresbarbadas || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2322/ TUS file] || Art from https://mulheresbarbadas.tumblr.com/ || 2021-06-03
 
| Mulheresbarbadas || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2322/ TUS file] || Art from https://mulheresbarbadas.tumblr.com/ || 2021-06-03
 
|-
 
|-
| Worms Space Oddity terrain pack || [[Team17]], [[User:Carmine|Carmine]] || [https://www.tus-wa.com/files/file-2399/ TUS file] || Contains: Cavernia, Earth, Frostal, Kaputzol, Mechanopolis, Tenticilia || 2021-09-12
+
| Ocean || [[User:SIBASA|SIBASA]] || [https://www.tus-wa.com/files/file-2564/ TUS file] || Released on 8th June to tribute [[w:World_Oceans_Day|World Oceans Day]] || 2022-06-08
 
|-
 
|-
 
| Origami || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2214/ TUS file] || || 2020-12-05
 
| Origami || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2214/ TUS file] || || 2020-12-05
 
|-
 
|-
| Picture City || [[User:Gray|gray]] || [https://www.tus-wa.com/files/file-2272 TUS file] || from Rayman 1. Includes a custom water file. || 2021-03-24
+
| Picture City || [[User:Gray|gray]] || [https://www.tus-wa.com/files/file-2272 TUS file] || From Rayman 1. Includes a custom water file. || 2021-03-24
 +
|-
 +
| Piggly || [[User:EmeraldPlay|EmeraldPlay]] || [https://www.tus-wa.com/files/file-2611/ TUS file] || Based on textures from the summer levels in the game "Piggly". || 2022-08-15
 +
|-
 +
| Prehistoria || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2231/ TUS file] || From Lost Vikings || 2021-01-02
 +
|-
 +
| Roman Empire || [[User:Echiko|Echiko]] || [https://www.tus-wa.com/files/file-2604/ TUS file] || || 2022-08-11
 
|-
 
|-
| Prehistoria || [[People/Korydex|Korydex]] || [https://www.tus-wa.com/files/file-2231/ TUS file] || Lost Vikings || 2021-01-02
+
| Super Mario Bros. 3 || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2538/ TUS file] || Contains 2 terrains with different land textures. All art sourced from the original game sprites. || 2022-05-22
 
|-
 
|-
| Worms Reloaded terrain pack || [[Team17]], [[User:Nizikawa|nizikawa]], [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2341/ TUS file] || Contains: Arabian, Arctic, Hawaii, Jurassic, Space, Wild West || 2021-07-01
+
| Super Mario World || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2518/ TUS file] || All art sourced from the original game sprites || 2022-05-30
 
|-
 
|-
| Worms Revolution terrain pack || [[Team17]], [[User:Carmine|Carmine]] || [https://www.tus-wa.com/files/file-2391/ TUS file] || Contains: Beach, Farm, Junkyard, Sewer, Spooky || 2021-09-10
+
| Studiopolis || [[User:King-Gizzard|King-Gizzard]], [[User:Kirill-Gamer|Kirill-Gamer]] || [https://www.tus-wa.com/files/file-2596/ TUS file] || Uses the game sprites from Sonic Mania Studiopolis Zone. Kirill-Gamer - idea and design; King-Gizzard - Converting and integrating into a wkTerrain || 2022-07-30
 
|-
 
|-
 
| Sushi || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2333 TUS file] || || 2021-06-07
 
| Sushi || [[People/Conejo|Conejo]] || [https://www.tus-wa.com/files/file-2333 TUS file] || || 2021-06-07
Line 147: Line 202:
 
| Tetris || [[People/SiD|SiD]] || [https://www.tus-wa.com/files/file-2261/ TUS file] || || 2016-06-28
 
| Tetris || [[People/SiD|SiD]] || [https://www.tus-wa.com/files/file-2261/ TUS file] || || 2016-06-28
 
|-
 
|-
| Worms United terrain pack || [[Team17]], [[User:Nizikawa|nizikawa]] || [https://www.tus-wa.com/files/file-2274/ TUS file] || Contains: Geiger, Graveyard, Hell, Junk, Mars, Money, Nam, Snow, Warzone || 2021-04-03
+
| Trippy || [[User:King-Gizzard|King-Gizzard]] || [https://www.tus-wa.com/files/file-2462/ TUS file] || || 2023-11-08
 
|-
 
|-
 
| Win95 || [[People/Ducky|Ducky]] || [https://www.tus-wa.com/files/file-2253/ TUS file] || || 2020-09-01
 
| Win95 || [[People/Ducky|Ducky]] || [https://www.tus-wa.com/files/file-2253/ TUS file] || || 2020-09-01
 
|-
 
|-
 +
| Woodman || [[People/EmeraldPlay|EmeraldPlay]] || [https://www.tus-wa.com/files/file-2379/ TUS file] || Made with Woodman's mugshot from Mega Man 2 || 2021-08-22
 +
|-
 +
| Worms: A Space Oddity terrain pack || [[User:Carmine|Carmine]], [[Team17]] || [https://www.tus-wa.com/files/file-2399/ TUS file] || Contains: Cavernia, Earth, Frostal, Kaputzol, Mechanopolis, Tenticilia || 2021-09-12
 +
|-
 +
| Worms: Battle Islands terrain pack || [[User:Carmine|Carmine]], [[Team17]] || [https://www.tus-wa.com/files/file-2405/ TUS file] || Contains: Area 51, Chemical, Jungle, Nuclear, Polar, Underwater || 2021-09-19
 +
|-
 +
| Worms Director's Cut - Forest || [[People/Edoardo Moretti|Edoardo Moretti]], [[Team17]] || [https://www.tus-wa.com/files/file-2200/ TUS file] || Alternative version of DIY || 2020-11-12
 +
|-
 +
| Worms Reloaded terrain pack || [[User:King-Gizzard|King-Gizzard]], [[User:Nizikawa|nizikawa]], [[Team17]] || [https://www.tus-wa.com/files/file-2341/ TUS file] || Contains: Arabian, Arctic, Hawaii, Jurassic, Space, Wild West || 2021-07-01
 +
|-
 +
| Worms Revolution terrain pack || [[User:Carmine|Carmine]], [[Team17]] || [https://www.tus-wa.com/files/file-2391/ TUS file] || Contains: Beach, Farm, Junkyard, Sewer, Spooky || 2021-09-10
 +
|-
 +
| Worms United terrain pack || [[User:Nizikawa|nizikawa]], [[Team17]] || [https://www.tus-wa.com/files/file-2274/ TUS file] || Contains: Geiger, Graveyard, Hell, Junk, Mars, Money, Nam, Snow, Warzone || 2021-04-03
 
|}
 
|}
  
Line 163: Line 231:
  
 
<gallery mode="nolines" widths="250px" heights="250px">
 
<gallery mode="nolines" widths="250px" heights="250px">
 +
 +
File:AngelIsland_small.png|'''Angel Island'''|link=Media:AngelIsland_big.jpg
  
 
File:Arachnophobia.png|'''Arachnophobia'''|link=Media:Arachnophobia_full.jpg
 
File:Arachnophobia.png|'''Arachnophobia'''|link=Media:Arachnophobia_full.jpg
  
 
File:Arcade.png|'''Arcade'''|link=Media:Arcade_large.png
 
File:Arcade.png|'''Arcade'''|link=Media:Arcade_large.png
 +
 +
File:BerlinBoss_small.png|'''Berlin Boss'''|link=Media:BerlinBoss_large.png
  
 
File:Blood_small.png|'''Blood'''|link=Media:Blood_large.png
 
File:Blood_small.png|'''Blood'''|link=Media:Blood_large.png
  
File:Camping_Small.png|'''Camping'''|link=Media:1080Camping.png
+
File:BreakingBad_small.png|'''Breaking Bad'''|link=Media:BreakingBad_large.png
 +
 
 +
File:Camping_S.png|'''Camping'''|link=Media:Camping1080.png
  
 
File:Candy.png|'''Candy'''|link=Media:Candy_large.png
 
File:Candy.png|'''Candy'''|link=Media:Candy_large.png
  
File:Chocolate_Small.png|'''Chocolate'''|link=Media:1080Chocolate.png
+
File:Cars_small.png|'''Cars'''|link=Media:Cars_large.jpg
  
File:Cosmic_Small.png|'''Cosmic'''|link=Media:1080Cosmic.png
+
File:CastleHassle_small.png|'''CastleHassle'''|link=Media:CastleHassle_big.jpg
 +
 
 +
File:Chateau_small.png|'''Chateau'''|link=Media:Chateau_large.jpg
 +
 
 +
File:Chemical_Plant_Zone_Small.png|'''Chemical Plant Zone'''|link=Media:Chemical_full.png
 +
 
 +
File:Chocolate_S.png|'''Chocolate / Chocolate Cookies'''|link=Media:ChocolateAndCookies.png
 +
 
 +
File:Cosmic_S2.png|'''Cosmic'''|link=Media:Cosmic_1080-2.png
  
 
File:Diablo_small.png|'''Diablo'''|link=Media:Diablo_large.png
 
File:Diablo_small.png|'''Diablo'''|link=Media:Diablo_large.png
Line 189: Line 271:
  
 
File:Electronics.png|'''Electronics'''|link=Media:Electronics_large.png
 
File:Electronics.png|'''Electronics'''|link=Media:Electronics_large.png
 +
 +
File:Emeral Island Zone_Small.png|'''Emerald Hill Zone'''|link=Media:Emerald Hill Zone full.png
  
 
File:Fimbulwinter_small.png|'''Fimbulwinter'''|link=Media:Fimbulwinter_large.png
 
File:Fimbulwinter_small.png|'''Fimbulwinter'''|link=Media:Fimbulwinter_large.png
  
File:Ganja_Small.png|'''Ganja'''|link=Media:1080Ganja.png
+
File:FruitBastilles_small.png|'''Fruit Bastilles'''|link=Media:FruitBastilles_large.jpg
 +
 
 +
File:Ganja_S.png|'''Ganja'''|link=Media:1080Ganja.png
 +
 
 +
File:GraveyardT_small.png|'''Graveyard'''|link=Media:GraveyardT_big.jpg
 +
 
 +
File:Green Hill Zone_Small.png|'''Green Hill Zone'''|link=Media:green hill zone full.png
 +
 
 +
File:Halloween_Small.png|'''Halloween'''|link=Media:Halloween_Large1080.png
 +
 
 +
File:Thumbnail heven.png|'''Heaven'''|link=Media:HThumbnail heven.png
 +
 
 +
File:IslandAntics_small.png|'''Island Antics'''|link=Media:IslandAntics_large.jpg
  
 
File:Lowpoly.png|'''Lowpoly'''|link=Media:Lowpoly_large.png
 
File:Lowpoly.png|'''Lowpoly'''|link=Media:Lowpoly_large.png
 +
 +
File:Mangrove_Swamp_small.png|'''Mangrove Swamp'''|link=Media:Mangrove_Swamp_Large.png
 +
 +
File:MEADOW_WIKI_ICON.png|'''Meadow'''|link=Media:MEADOW_OPEN_FULL-v1.3.png
 +
 +
File:Marble_small.png|'''Marble Zone'''|link=Media:Marble_full.png
 +
 +
File:MissileBase_small.png|'''Missile Base'''|link=Media:MissileBase_large.jpg
  
 
File:Mulheresbarbadas.png|'''Mulheresbarbadas'''|link=Media:Mulheresbarbadas_large.png
 
File:Mulheresbarbadas.png|'''Mulheresbarbadas'''|link=Media:Mulheresbarbadas_large.png
  
File:Oddity_Cavernia_small.png|'''Oddity Earth'''|link=Media:Oddity_Cavernia_large.png
+
File:Ocean_Terrain.png|'''Ocean'''|link=Media:Ocean_large.png
 +
 
 +
File:Oddity_Cavernia_small.png|'''Oddity Cavernia'''|link=Media:Oddity_Cavernia_large.png
  
 
File:Oddity_Earth_small.png|'''Oddity Earth'''|link=Media:Oddity_Earth_large.png
 
File:Oddity_Earth_small.png|'''Oddity Earth'''|link=Media:Oddity_Earth_large.png
Line 208: Line 314:
 
File:Oddity_Mechanopolis_small.png|'''Oddity Mechanopolis'''|link=Media:Oddity_Mechanopolis_large.png
 
File:Oddity_Mechanopolis_small.png|'''Oddity Mechanopolis'''|link=Media:Oddity_Mechanopolis_large.png
  
File:Oddity_Tenticlia_small.png|'''Oddity Tenticilia'''|link=Media:Oddity_Tenticilia_large.png
+
File:Oddity_Tenticlia_small.png|'''Oddity Tenticilia'''|link=Media:Oddity_Tenticlia_large.png
  
 
File:Origami.png|'''Origami'''|link=Media:Origami_large.png
 
File:Origami.png|'''Origami'''|link=Media:Origami_large.png
Line 236: Line 342:
 
File:Revolution_Sewer_small.png|'''Revolution Sewer'''|link=Media:Revolution_Sewer_large.png
 
File:Revolution_Sewer_small.png|'''Revolution Sewer'''|link=Media:Revolution_Sewer_large.png
  
File:Revolution_Spooky_small.png|'''Revolution'''|link=Media:Revolution_Spooky_large.png
+
File:Revolution_Spooky_small.png|'''Revolution Spooky'''|link=Media:Revolution_Spooky_large.png
 +
 
 +
File:WIKI_SMB3_Thumb.png|'''Super Mario Bros. 3'''|link=Media:TUS_BROWN_FULL1080.png
 +
 
 +
File:Wiki_thumbnail.png|'''Super Mario World'''|link=Media:SMW_1080.png
  
 
File:Sushi.png|'''Sushi'''|link=Media:Sushi_large.png
 
File:Sushi.png|'''Sushi'''|link=Media:Sushi_large.png
  
 
File:Tetris.png|'''Tetris'''|link=Media:Tetris_large.png
 
File:Tetris.png|'''Tetris'''|link=Media:Tetris_large.png
 +
 +
File:Trippy14_Thumb.png|'''Trippy'''|link=Media:Trippy14_1080.png
 +
 +
File:United_GEIGER_small.png|'''United Geiger'''|link=Media:United_GEIGER_large.png
 +
 +
File:United_GRAVEYARD_small.png|'''United Graveyard'''|link=Media:United_GRAVEYARD_large.png
 +
 +
File:United_HELL_small.png|'''United Hell'''|link=Media:United_HELL_large.png
 +
 +
File:United_JUNK_small.png|'''United Junk'''|link=Media:United_JUNK_large.png
 +
 +
File:United_MARS_small.png|'''United Mars'''|link=Media:United_MARS_large.png
 +
 +
File:United_MONEY_small.png|'''United Money'''|link=Media:United_MONEY_large.png
 +
 +
File:United_NAM_small.png|'''United Nam'''|link=Media:United_NAM_large.png
 +
 +
File:United_SNOW_small.png|'''United Snow'''|link=Media:United_SNOW_large.png
 +
 +
File:United_WARZONE_small.png|'''United Warzone'''|link=Media:United_WARZONE_large.png
  
 
File:Win95.png|'''Windows 95'''|link=Media:Win95_large.png
 
File:Win95.png|'''Windows 95'''|link=Media:Win95_large.png
 
</gallery>
 
</gallery>

Latest revision as of 15:27, 8 November 2023

(Up to WormKit)
wkTerrainSync
Developer: nizikawa
Latest version: v1.2.6.1 (29 May 2022)
Supported games: W:A
Supported W:A version: 3.8.x
Language: C++
License: WTFPL
Website: TUS thread GitHub repository
Download: [1]
Domestic Terrain

wkTerrainSync is a module for WormKit that allows additional W:A terrains to be installed and selected in the Map editor. It supports online multiplayer (providing all players have the module installed) and will automatically download the custom terrain from the host if it doesn't exist locally.

It makes it easy for terrains such as Dinos and Domestic (which are present on the WWP CD) to be installed and played with WA. A full list of community-made Custom Terrains can be found below.

It superseded WkTerrain adding new features such as data synchronization for network games and sprite addition/replacement.

In addition to custom terrain functionality, later updates added support for generating custom-sized maps in buit-in map generator and support for playing custom missions in both offline and online multiplayer.

For information on how to put together your own custom terrain, see the Terrain Creation Guide.

Usage

wkTerrainSync does not require any special configuration or user interaction. Installation is the same as with other WormKit modules, simply extract the files to your Worms Armageddon folder (the same folder with the WA.exe file) and ensure that "Load WormKit modules" in the Advanced options section of the game is enabled.

If you are joining an online game that uses a new terrain file that you currently don't have installed, you will see an "Invalid map file" in map thumbnail and multiple messages about terrain data download will appear in lobby chat. This means the terrain file is being downloaded from the host and a proper map thumbnail will appear once the terrain is downloaded. This should take few seconds depending on network speed.

Playing on custom terrains with those who do no have the module is possible by first converting the map to PNG. However, the debris, soil, background, custom water and other features of the terrain will be lost.
To convert the map to PNG format:

  • Enter the detailed map settings window by right clicking the map in the lobby.
  • If not already in preview mode, click the preview terrain button Preview terrain button.
  • Right-click the return to edit mode button Return to edit mode button. The map will now be a PNG map.

To troubleshoot the module, enable dev console in .ini file and examine the logged messages

Terrains:

  • A valid terrain directory contains two files:
    • Level.dir, the main graphics directory which contains all the texture assets. This file can be read and edited using the WA Directory Editor.
    • TEXT.IMG, this represents the texture thumbnail as shown in the map editor.
  • When generating a random map by clicking on map thumbnail, the game selects a random terrain from all available terrains.
    • To limit this selection to only custom terrains, hold CTRL key and click on the thumbnail.
    • To limit this selection to only default terrains, hold ALT key and click on the thumbnail.

Missions: An additional feature separate from custom terrains is the ability to use the single player mission functionality in online and offline multiplayer.

  • A mission file can be placed in the Saved Levels directory with the same name as the map (PNG, IMG and BIT are supported) and it will be loaded by the module when the map is selected.

Features

Data synchronization features:

  • Custom network protocol integrated with WA's original network code - this module works seamlessly with WormNAT2 and direct hosting
  • Terrains are now referenced by their MD5 hash instead of ID - play online games regardless of your terrain list order and terrain directory names
  • File transfers - missing terrain files are automatically downloaded from the host player
  • Terrain metadata is embedded directly in .wagame replay files - replay files will work even when terrain list changes or files are renamed
  • Downloaded terrain directories are stored as "Name #MD5checksum" to avoid file conflicts
  • Incomplete file transfers are stored with .part suffix to prevent adding incomplete downloads to the terrain list

Terrain customization features:

  • Terrain files can include additional parallax sprites - back2.spr displayed in far distance behind regular back.spr ; front.spr displayed in front of the map
  • Removed sprite loader limitations when handling back.spr, back2.spr and front.spr - sprites are no longer limited to 640x160px size and can be animated like regular sprites
  • Terrains can override any sprite in the game, including worm animations, weapon projectiles and clouds - place gfx0/spritename.spr (normal palette) and gfx1/spritename.spr (colorblind palette) within terrain.dir to override any sprite
  • Terrains can override water.dir for custom water color and animations - place water.dir next to level.dir in terrain directory. Use https://worms2d.info/Water_color_editor to generate custom water.dir
  • Support for custom-sized random maps generated with built-in map generator. The maps can be scaled with 0.1x scale increments in both width and height dimensions up to 5.0x scale max.

Mission features:

  • For your convenience the module will automatically copy default WA mission files to User/SavedLevels/Mission/WA/ folder (and slightly fix them).
  • Custom mission replay files are fully supported by wkTerrainSync.
  • By default, the mission files use an empty .WSC scheme file that is later populated by .WAM script when the mission begins - it will be labeled as [ Default mission scheme ]. This scheme can be edited by changing basic parameters such as turn time, round time, etc. It is also possible to enable 3.8 scheme extended options.
  • Mission files can also provide own .WSC scheme, it will be labeled as [ Mission-provided scheme ].
  • The module adds some custom fields to WAM file format:
[HumanTeam] or [CPUTeamX]
Ammo_SkipGo=1
Delay_SkipGo=2
Ammo_Surrender=3
Delay_Surrender=4

[CPUTeamX]
Optional = 1 ; a CPU team will not be spawned if no player team is added to cover this team
TeamNameValue=Team Name Text ; sets custom team name instead of one specified by TeamNameNumber
WormX_NameValue=Worm Name Text ; sets custom worm name instead of one specified by WormX_NameNumber

[EventXXXX]
TypeOfEvent=10 ; show text event
Text_String_Value=Custom text message to be displayed ; sets custom text message instead of one specified by Text_String_Index


Custom terrains

Here are some terrains available to use. Download, extract and place the terrain folder into Worms Armageddon/DATA/Level.

Name Author Download Notes Submission /
Last update
Angel Island(Sonic3) JSG TUS file Made with assets from Sonic 3's first level 2022-04-23
Arachnophobia Conejo, sbs TUS file Art by sbs, crafted by Conejo. Source: https://www.wmdb.org/35027 2020-12-31
Arcade Ducky TUS file Participation of oScarDiAnno who made the "worm plush grabbed by a claw" object 2021-01-24
Berlin Boss JSG, Team17 TUS file Made with Assets from the WWP's Berlin Boss map 2021-12-21
Bliss M1t3nk0v TUS file Based on Windows XP and its default Wallpaper "Bliss" 2022-05-20
Blood Korydex TUS file 2021-01-04
Breaking Bad doc TUS file 2022-07-18
Camping King-Gizzard TUS file 2023-01-17
Candy unknown TUS file From MapGEN Candy theme. An improved/updated version can be found here: https://www.tus-wa.com/files/file-2899/ 2023-08-28
Cars JSG, Team17 TUS file Made with assets from WA's Cars map 2021-12-22
CastleHassle JSG, Team17 TUS file Made with assets from WWP's CastleHassle map 2023-8-14
Chateau JSG, Team17 TUS file Made with assets from WA's Chateau map 2021-12-27
Chemical Plant Zone Placebo_yue TUS file Art ripped from Sonic 2 2022-04-26
Chemistery Echiko TUS file 2022-07-31
Chocolate King-Gizzard TUS file There are 2 variations of this terrain texture; the original cake texture and a cookies texture 2023-10-14
CI5 Water EmeraldPlay TUS file Made with assets from Chicken Invaders: Cluck of the Dark Side 2021-05-04
Cosmic King-Gizzard TUS file 2022-06-02
Creeper World 2 Orandza TUS file Made with assets from Creeper World 2 2021-08-22
Diablo Korydex TUS file 2021-01-06
Dinos Team17 TUS file Imported from WWP 2017-10-18
DIY Team17 TUS file Imported from Worms DC by Ducky 2020-09-01
Domestic Team17 TUS file Imported from WWP 2017-10-18
Egypt ARTemych, SiD TUS file Crafted by SiD. Original ARTemych's art from https://www.wmdb.org/28412 2020-10-22
Elastomania nizikawa TUS file 2022-02-04
Electronics Conejo TUS file 2020-12-05
Emerald Hill Zone (sonic 2) Placebo_yue TUS file Made with sprites ripped from Sonic The Hedgehog 2's first level 2022-04-23
Fimbulwinter 1gor Melitonov TUS file Deleted from TUS 2021-01-10
Fruit Bastilles JSG, Team17 TUS file Made with assets from WWP's Fruit Bastilles map 2021-12-28
Ganja King-Gizzard TUS file 2023-10-20
Green Hill Zone Placebo_yue TUS file Art ripped from Sonic the Hedgehog 2022-04-20
Halloween King-Gizzard TUS file 2022-07-19
Heaven Echiko TUS file Includes an Altaria sprite from Pokémon franchise and a Holy Grenade 2022-06-13
Island Antics JSG, Team17 TUS file Made with assets from WWP's Island Antics map 2021-12-24
Lowpoly Conejo TUS file 2021-01-06
Mangrove Swamp SIBASA, King-Gizzard, FoxHound TUS file First version released on the International Day for the Conservation of the Mangrove Ecosystem (26 July). Second version was only possible thanks to King-Gizzard joining the party 2022-08-11
Marble Zone Placebo_yue TUS file Images ripped from Sonic the hedgehog 2022-04-30
Meadow King-Gizzard TUS file 2023-01-20
Missile Base JSG, Team17 TUS file Made with assets from WWP's Missile Base map 2021-12-30
Money EmeraldPlay TUS file 2021-05-04
Mulheresbarbadas Conejo TUS file Art from https://mulheresbarbadas.tumblr.com/ 2021-06-03
Ocean SIBASA TUS file Released on 8th June to tribute World Oceans Day 2022-06-08
Origami Conejo TUS file 2020-12-05
Picture City gray TUS file From Rayman 1. Includes a custom water file. 2021-03-24
Piggly EmeraldPlay TUS file Based on textures from the summer levels in the game "Piggly". 2022-08-15
Prehistoria Korydex TUS file From Lost Vikings 2021-01-02
Roman Empire Echiko TUS file 2022-08-11
Super Mario Bros. 3 King-Gizzard TUS file Contains 2 terrains with different land textures. All art sourced from the original game sprites. 2022-05-22
Super Mario World King-Gizzard TUS file All art sourced from the original game sprites 2022-05-30
Studiopolis King-Gizzard, Kirill-Gamer TUS file Uses the game sprites from Sonic Mania Studiopolis Zone. Kirill-Gamer - idea and design; King-Gizzard - Converting and integrating into a wkTerrain 2022-07-30
Sushi Conejo TUS file 2021-06-07
Tetris SiD TUS file 2016-06-28
Trippy King-Gizzard TUS file 2023-11-08
Win95 Ducky TUS file 2020-09-01
Woodman EmeraldPlay TUS file Made with Woodman's mugshot from Mega Man 2 2021-08-22
Worms: A Space Oddity terrain pack Carmine, Team17 TUS file Contains: Cavernia, Earth, Frostal, Kaputzol, Mechanopolis, Tenticilia 2021-09-12
Worms: Battle Islands terrain pack Carmine, Team17 TUS file Contains: Area 51, Chemical, Jungle, Nuclear, Polar, Underwater 2021-09-19
Worms Director's Cut - Forest Edoardo Moretti, Team17 TUS file Alternative version of DIY 2020-11-12
Worms Reloaded terrain pack King-Gizzard, nizikawa, Team17 TUS file Contains: Arabian, Arctic, Hawaii, Jurassic, Space, Wild West 2021-07-01
Worms Revolution terrain pack Carmine, Team17 TUS file Contains: Beach, Farm, Junkyard, Sewer, Spooky 2021-09-10
Worms United terrain pack nizikawa, Team17 TUS file Contains: Geiger, Graveyard, Hell, Junk, Mars, Money, Nam, Snow, Warzone 2021-04-03

Gallery

Click the preview picture to view a full-size screenshot of the terrain (where available), with background, debris and all terrain properties.

Personal tools