War.app Wiki - User contributions [en]

Making 3d Maps

2025-09-16T22:11:01Z

JK 3:

All Warzone maps work in both 2d mode and 3d mode. However, when in 3d mode, there are a few additional features that are available to map designers to help take advantage of the additional rendering capabilities of Warzone's 3d rendering engine. These are optional, and as a map designer you can choose to use them or ignore them. They just allow your map to stand out better when viewed in 3d. All of these features can be found under the "3d Settings" button in the map designer. This button only appears when viewing your map in 3d mode.

== Texture Image ==

Map designers can upload a '''texture image''' that will be displayed on the top of territories and bonus links. You can upload this image in the "3d Settings" dialog.

The image should be a png for best results, and should use a transparent background for any parts you don't want to alter. This width/height of this image should have the same aspect ratio of your map. For example, if your map is 1500x1000 pixels, your texture image should have a 1.5:1 ratio. Any area of the image that doesn't line up with a territory or bonus link in your map will not be used, so these areas can be transparent in your image.

Map designers can also set a '''texture image strength''' which defines how strongly the texture image, from 0 to 50, that controls how the texture image gets mixed with the normal color of the territory (normally the color of the player who controls the territory). A value of 0 means that the texture image will not show at all, and a theoretical value of 100 would mean that the normal color would not show at all and only the texture image would show. This is why it's capped at 50, since values that are too high would make the game unplayable.

The strength can be changed in the map designer and the results will be displayed in real-time, so map designers can tune in a value they are comfortable with. Uploading a new texture image also gets displayed immediately on the map for rapid iteration.

A good texture image does not use large solid colors, since this may interfere with player's abilities to tell which territories are controlled by which players in a Warzone game.

== Heightmap ==

Map designers can upload two '''heightmap images''' that allow you to give 3d depth of your map when played in 3d mode. This is most commonly used to define hills or mountains or other similar forms of elevation. The main heightmap only applies to your territories and bonus links, and the '''terrain heightmap''' applies to the rest of your map (decorative regions).

This width/height of these images should have the same aspect ratio of your map. For example, if your map is 1500x1000 pixels, your texture image should have a 1.5:1 ratio.

Each pixel in the image defines how high the elevation should be at that spot, where black is the lowest possible elevation and white is the highest possible elevation. Colors have no meaning.

Map designers can define a '''max height''' for each of these heightmaps that defines how much the map will be raised. This value can be altered in the map designer and results are shown in real-time.

Map designers can also define a '''tessellation size''' for each of these heightmaps. This controls how big each polygon in the resulting object will be. In other words, this controls how much the object will be sub-divided. Smaller values will allow a higher resolution for your heightmap, but going too small may result in too many polygons being created for your map which could cause it to perform very poorly. If using a heightmap, you should experiment with different values. The best value to use for this setting is the highest value that still looks good.

Note that uploading a new heightmap image or changing the tessellation size requires clicking "Apply" in the 3d Settings Dialog before results are shown.

== Browser support ==

3d maps are fully supported in browsers.
You can enable 3d mode from your Account Settings.
If you prefer to use 2d mode, games and maps can be forced into 3d mode by adding "&3d=true" to the end of your querystring in your browser.

[[Category:Map Making]]

Raffle in the public chat

2025-07-30T18:11:27Z

JK 3: Fixed typos, grammar and formatting. Added missing fact. Added info on raffle variations.

The Raffle is an event in the [https://www.warzone.com/MultiPlayer?ChatRoom=1 Global Chat], where chatters can win [[coins]] and [[powers]] or [[artifacts]]. Sometimes a raffle will only be coins. A new Raffle will start at a random moment between 10 minutes and 2 hours after the previous one ended.

==Joining a Raffle==

When the Raffle happens, the [https://www.warzone.com/Profile?p=78106080953&u=RaffleBot_2 RaffleBot] announced in chat:

(number) coin and a raffle starting! Say !raffle in the next 60 seconds to enter the raffle. (you must have chatted in the last hour)

If a player successfully joins a raffle by sending "!raffle" while the Raffle is active, the bot will reply in one of two ways:

* @(PlayerName): OK, you're in the raffle! Winner will be announced in (remaining seconds)
* @(PlayerName): You cannot enter since you did not chat in the last hour


At the end of the 60 seconds, a random winner will be chosen from the players that joined the Raffle, and a winner will be announced:

RAFFLE OVER: Congratulations to (PlayerName) for winning (Reward) ! Stay tuned for the next raffle!

==Variations on Raffle==

The term "Raffle" is only used 95% of the time, the other options are "Waffle" (4%) and "Wafaffle" (1%). This is reflected in both the start and end message of the Raffle.

The end of the announcement message is also varying. There is a roughly 2% chance for a Raffle to end with "You are all ruthless!" instead of "Stay tuned for the next raffle/waffle/wafaffle!".

If no player successfully joined the Raffle, it displays "RAFFLE OVER: Nobody entered the raffle! These coins will be added to the next one. Be ready for it!".

==Warzone Facts==

The end of the Raffle is followed by a random Warzone fact, containing the following facts:

# For its first year, this game was invite-only.
# Fizzer quit his job in 2010 to work on this game full time, and has been full-time on it since then. He hopes to continue working on this game for the rest of his life.
# In addition to a global rating, Quickmatch has ratings in many different categories, such as for each template, real-time versus multi-day, 1v1s vs ffas, and more
# The Feature Request Forum is the best place to request changes to the game. It was introduced in 2024 to replace the UserVoice forum.
# The boot timer was added about four months into the game's life. Before that, a single player abandoning a game would cause it to get stuck.
# Warzone uses PostgreSQL as its primary database software. It also uses MongoDB and Sqlite for some things.
# Warzone uses a product called MaxMind to determine player's country flag on their profile, based on the IP they play from.
# Warzone version numbers look like vA.BB.C.D, where A only changes in major overhauls, BB is a normal feature release, C is a bugfix or smaller update, and D is optionally used for hotfixes/patches. It's currently {version number}
# Warzone uses websockets so that your device can instantly be notified when a game advances.
# Warzone uses UTC time internally. If your timezone changes for things like Daylight Savings Time, then the clan wars timeslots will change by an hour for you.
# Warzone relies on volunteer moderators to investigate reports of rule-breaking filed by the community. Every report will be looked into.
# Sanction cards can be configured by game creators to be negative, and then will actually increase your income instead of reducing it.
# The first game ever played was a test game in 2008 between Fizzer and his friend Anthony, who was letting Fizzer use his server to host the game for free at the time.
# The first WarLight Android/iPhone apps were developed on the platform MonoTouch/MonoDroid, and were eventually released in 2013.
# The website changed from http to https in 2014, to keep things more secure.
# In 2024, a whole new map rendering engine, BabylonJS, was added to the website that allows 3d maps.
# This game didn't show any ads for the first 5 years of its existence.
# Multi-attack was one of the very first features added to the game, even before fog or cards.
# The original WarLight Android/iPhone apps were re-written from scratch for the Warzone launch in 2017.
# This game was multi-player only at first. Single-player wasn't added until over a year later in 2009, which only had 5 levels at first.
# Warzone has music in the mobile app, but it's off by default based on the results of A/B testing that found players had a slight preference for silence over music.
# On April 1st 2015, there was an April Fools prank that caused ghost messages to appear in chat of multi-player games.
# Warzone Idle was launched in 2020
# WarLight was ported from Silverlight to Flash in 2010.
# Warzone has 2840 public maps, nearly all of which are made by the community.
# Game IDs started at 1,000,000 and counted up. However, this isn't a reliable way if counting the number of games played, since IDs can sometimes be skipped.
# Warzone has extensive automated tests that get run before every update. They take several hours and Fizzer usually runs them overnight.
# The raffles are not, in fact, rigged.
# The global chat room was added in January of 2019. Raffles were added 8 days later.
# Before the Feature Request Forum, there was the UserVoice forum (launched in 2010). UserVoice was originally free but then started asking tens of thousands of dollars to continue using it, so Fizzer wrote his own.
# The game was ported from Flash to Unity in 2017.
# Fizzer first streamed on Twitch in 2015
# Fizzer created this game in his spare time while working at Microsoft in 2008.
# In 2017, Quickmatch was introduced and it quickly surprassed all other game totals combined.
# The sound that plays when you pick a territory is a microwave door closing.
# Quickmatch ratings give an activity bonus when below 500. This means that ratings below 500 tend to correlate with how active the player is, but ratings above 500 correlate to the player's skill.
# When the 1v1 ladder was new, it was dominated by a player named The Impaller. There was a special game called "The Impaller vs the world" where he played against the entire community, and he won.
# Quickmatch tries to match players of similar skill levels. To accomplish this, it generates a Match Rating for each player, which is 90% of their rating for that template plus 10% of their global rating.
# When multi-attack was first introduced, it also allowed multi-transfers which meant armies could move an infinite number of times in a turn. This was after when players started entering thousands of delay moves to try and out-delay each other.
# Created by Fizzer in 2008 using the technology Silverlight.
# In 2010, auto games were introduced as a way to ensure the Open Games page was never empty, since at the time most open games were filling so fast that it was hard to find one.
# Warzone is primarilly written in the C# programming language. It also uses Haxe, Sql, Scala, Lua, Python, Javascript, Java, C++, Objective-C, and Swift.
# The forum was added in 2009, and all forum posts are still available to read.
# In 2017, mods were introduced, which are ways to customize the game further beyond what is normally allowed.
# When the 1v1 ladder was new, it was dominated by a player named The Impaller. There was a special game called "The Impaller vs the world" where he played against the entire community, and the community won.
# The full history of nearly every multi-player game ever played is stored in Warzone's databases (>30 million)
# Warzone is the sequel to WarLight
# The game has been hosted on many different server providers over the years: Rackspace, AWS, Linode, Google App Engine, and bare hardware. Fizzer can switch providers without any downtime at all.
# Real-time games were introduced in December of 2010. Before that, all games were multi-day.
# I have {number of facts} Warzone facts that I can print out. Each raffle, I pick a random one, and I've been doing that since May of 2025.
# Warzone has been team-building exercises at some companies.
# Activision sued Warzone in 2021
# Auto-boot was controversial when it was first introduced. Before that, some players thought of the boot time as more of a suggestion and would get angry when someone actually booted another player.
# Warzone has been used in classrooms. Teachers in some schools have used it to teach geography and strategic thinking in an educational setting.

[[Category:Community]]

Artifacts

2025-07-30T17:31:35Z

JK 3: Added number of artifacts in wiki text

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a list of the 42 artifacts and their effects. Note: Due to the ambiguity between Army Camp Boost and Army Cache Boost, it is recommended to avoid the abbreviation ACB.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB (A$B) || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB (A^B) || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 1.5% || 3% || 6% || 12% || 25% || 50% || 100%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 1.5% || 3% || 6% || 12% || 25% || 50% || 100%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 1.5% || 3% || 6% || 12% || 25% || 50% || 100%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || IT || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Game ID feed API

2025-06-22T19:25:44Z

JK 3: Added ID of 3v3 ladder

The '''Game ID feed API''' can be used to get all of the game IDs for a [[ladder]] or [[tournament]]. These are used to pass to the [[Query game API]].

==Usage==

This feed can be passed either a TournamentID or a LadderID. Pass these as GET parameters, such as ?TournamentID=1234 or ?LadderID=1.

The ID of the [[1v1 ladder]] is 0, the ID of the [[2v2 ladder]] is 1, and the ID of the [[3v3 ladder]] is 4.

For example, you can call https://www.warzone.com/API/GameIDFeed?LadderID=0 to get all of the game IDs for the [[1v1 ladder]].

To get a tournament ID, open up the tournament in the normal game GUI and click the Tournament Settings button. You will find the tournament ID under the 'Link' field.

==See Also==

* [[Query game API]]

[[Category:API]]

Negative Base Income

2025-03-16T23:28:18Z

JK 3: Added Negative Base Income mod

{{Mod infobox
|name=Negative Base Income
|creatorToken=31105111944
|creatorName=JK_3
|madePublicOnYear=2025
|madePublicOnMonth=03
|madePublicOnDay=16
|appversion=5.33
|tags={{modtag|Strategic}}
|source=https://github.com/WarzoneJK3/WarzoneMods/tree/main/NegativeBaseIncome
|madePublicOnRef={{ref|https://www.warzone.com/Forum/817057-new-mod-negative-base-income}}
}}

This mod makes the base income negative instead of positive.

For example, for a base income of 5 armies, 5 will be subtracted from the players total income instead of being added like it normally would. 
Note that the total income can never become negative, and will be at least 0 armies per turn.

Warning: With negative base income, the game could become unplayable!! 
If a player is unable to capture any more territories they have no way to obtain more income to offset the negative base income, resulting in them getting stuck. 
Make sure the settings give players enough options to bridge the first few turns where the bonus income is less than base income.

Mods

2025-03-16T23:10:37Z

JK 3: Added Negative Base Income mod

[[Mods]] are a way of modifying/expanding the Warzone core gameplay beyond what is possible using the built-in configuration options. Modded games can be created only by [[Membership|members]], however you may ask a member to create a game for you.

Mods are easy to use! When joining a game with mods, Warzone automatically downloads the mod. No installation is required. Simply join or create a game that has mods enabled. Since no installation is required, mods are fully supported on all Warzone platforms, including Android and iOS!

Some mods have a menu where users can interact with the mod. To open this menu, from a game go to Game > Mod: <mod name>.

== Create your own Mod ==
See the [[Mod Developers Guide]] for details on how to get started making your own mod.

To check if a mod idea is possible to implement, check [[Mod Framework Capabilities]].

== List of published mods (not exhaustive) ==
Please note some mods may have bugs. Contact the mod developer (by [https://discord.gg/hqGkVXagyt Discord], private message or using the [[forum]]) to report a bug. Note that if a mod takes more than 10 seconds to run, a crash message will appear. This should only happen if a map that is too big (in terms of number of territories or bonuses).

=== [[Mod Categories|Promoted Mods]] ===
* [[Buy Neutral]]
* [[Diplomacy (mod)|Diplomacy]]
* [[Gift Armies]]
* [[Gift Gold]]
* [[Picks swap]]
* [[Randomized Bonuses]]
* [[Randomized Wastelands]]

=== [[Mod Categories|Standard Mods]] ===
* [[Advanced Diplo Mod V4]]
* [[Airports]]
* [[AI's don't play cards]]
* [[AIs don't deploy]]
* [[Buy Cards]]
* [[Commerce Plus]]
* [[Diplomacy 2 (mod)|Diplomacy 2]]
* [[Essentials (mod)|Essentials]]
* [[Late Airlifts]]
* [[Limited Attacks]]
* [[Limited Multiattacks]]
* [[Meteor Strike]]
* [[Neutral Moves]]
* [[Safe Start]]
* [[Swap Territories]]
* [[Take Turns]]

=== [[Mod Categories|Experimental Mods]] ===
* [[(Beta) BetterCities and group Chat|<nowiki>[Beta] BetterCities and group Chat</nowiki>]]
* [[Advanced Card Distribution (CS+)]]
* [[Advanced Card Distribution (per player)]]
* [[AI Central]]
* [[AIs don't attack]]
* [[Allow Guard to be Killed]]
* [[Army Caches]]
* [[Army Recruiter]]
* [[Artillery Strike]]
* [[Better don't fail an attack]]
* [[Bomb Card+]]
* [[Bomb Reduces Cities]]
* [[Bonus Airlift]]
* [[BonusValue QuickOverrider]]
* [[Buy Cards v2]]
* [[Capitalist]]
* [[Capture The Flag]]
* [[Card Caches]]
* [[CardPack - Card Actions]]
* [[CardPack - Disasters]]
* [[CardPack - OG]]
* [[CardPack - Utility]]
* [[CivLight]]
* [[Clock (mod)|Clock]]
* [[Combo Income]]
* [[Connected Commanders]]
* [[Connected Territories]]
* [[ConstructionWorker Unit]]
* [[Custom Card Package]]
* [[Decoy Card]]
* [[Deployment Limit]]
* [[Diplomat]]
* [[Don't lose a territory]]
* [[Dragons]]
* [[Draw Resolver]]
* [[Dreadful Hypothermia 4]]
* [[Dynamic Bonuses]]
* [[Encirclement]]
* [[Exclude From Auto Dist]]
* [[Expansion+]]
* [[Extended Randomized Bonuses]]
* [[Extended Winning Conditions]]
* [[Factions (mod)|Factions (V2.3)]]
* [[Force Vote to End]]
* [[Forced LD Card]]
* [[Fort Tactics (mod)|Fort Tactics]]
* [[Forts]]
* [[FreeExpansion]]
* [[Gift Armies 2]]
* [[Gift Gold Ultra 3]]
* [[Gold Reserves]]
* [[Goldmines (Commerce+)]]
* [[Highest Income Disadvantage]]
* [[Hospitals (mod)|Hospitals]]
* [[Host can Spy on & Eliminate players]]
* [[Hybrid Distribution]]
* [[Hybrid Distribution 2]]
* [[I.S. Agencies]]
* [[I.S. Character Pack ( Antiquity )]]
* [[I.S. Character Pack ( Ship Props )]]
* [[I.S. City Manager]]
* [[I.S. Terrain Types 2]]
* [[I.S. Zombie Slot]]
* [[Income Threshold]]
* [[Informations for spectators]]
* [[INSS Bonuses]]
* [[King of the Hill]]
* [[Late Gifts]]
* [[Late Wastelands]]
* [[Limited Multimove (multi-attack + multi-transfer)]]
* [[Local Deployment Helper (V3.0)]]
* [[Locked Down Regions]]
* [[Lotto Mod - Instant Random Winner|Lotto Mod -> Instant Random Winner]]
* [[Medics]]
* [[Meteor Strike 2]]
* [[More_Distributions]]
* [[Mystery Card]]
* [[Negative Base Income]]
* [[No income for odd/even number of territories]]
* [[No Wrapped Attacks]]
* [[One Way Connections]]
* [[Orders Cost Income]]
* [[Order Notes]]
* [[Player Manager]]
* [[Portals]]
* [[Press This Button]]
* [[Priests]]
* [[Private Notes (mod)|Private Notes]]
* [[Random settings generator]]
* [[Random Starting Cities]]
* [[Randomized Orderlist]]
* [[Read Game Settings]]
* [[Resurrection Card]]
* [[Reverse Income]]
* [[Reversed Bonus Armies Per Territory]]
* [[Runtime Wastelands]]
* [[Spaced Out Starts]]
* [[Spawnbarriers]]
* [[Smoke Bomb Card]]
* [[Special units are Medics]]
* [[Spectator Mode]]
* [[Stack Limit]]
* [[Stationary commanders]]
* [[Structures Distribution (CS+)]]
* [[Surveillance Card+]]
* [[Swap Territories 2]]
* [[Tank Card]]
* [[Tanks]]
* [[Territories without armies become neutral]]
* [[TerritoryLimit]]
* [[Transport Only Airlift]]
* [[Villages]]
* [[VillagesV2]]
* [[Wastelands+]]
* [[Weaken blockades]]
* [[Where Am I?]]

== Restrictions ==
Single-player modded games are always free for members. Likewise, multi-player games where all players are members are also free. Members can create a modded game for non-members by using the special "Allow non-members to join" check-box on the mods page. Using this special checkbox is free once per week to members, (restarts Monday), but after that it will cost a small fee (2 coins per player, member or not, in the game). This fee exists since mods can run on the server, and modded games are significantly more CPU-intensive for the Warzone server to run than non-modded games.

[[Category:Mods|!]][[Category:Game Settings]]

Player colors

2024-12-23T18:47:28Z

JK 3: Add new premium colors to list of purchasable colors

Player colors

2024-05-30T06:00:53Z

JK 3: Removed mistake

Player colors

2024-05-03T17:42:26Z

JK 3: /* Ladder Colors */

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Orange Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* https://i.imgur.com/nJ90l3t.png Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the [[ladders]] for one week.

* https://i.imgur.com/s8sf8Ie.png Green Archer (from the [[1v1 ladder]])
* https://i.imgur.com/ualbOnd.png Orange Archer (from the [[2v2 ladder]])
* https://i.imgur.com/LrEVJik.png Pink Dice (from the [[3v3 ladder]])
* https://i.imgur.com/Lwj2WcV.png Aqua Elephants (from the [[Seasonal Ladder]])

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2024-05-02T22:04:00Z

JK 3: /* Ladder Colors */

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Orange Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* https://i.imgur.com/nJ90l3t.png Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the [[ladders]] for one week.

* https://i.imgur.com/s8sf8Ie.png Green Archer (from the [[1v1 ladder]])
* Orange Archer (from the [[2v2 ladder]])
* Pink Dice (from the [[3v3 ladder]])
* https://i.imgur.com/Lwj2WcV.png Aqua Elephants (from the [[Seasonal Ladder]])

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Artifacts

2024-03-22T09:52:28Z

JK 3:

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a list of artifacts and their effects. Note: Due to the ambiguity between Army Camp Boost and Army Cache Boost, it is recommended to avoid the abbreviation ACB.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB (A$B) || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB (A^B) || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || IT || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Artifacts

2024-03-22T09:49:30Z

JK 3: Added additional abbreviations for the ACBs

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a list of artifacts and their effects.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB (A$B) || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB (A^B) || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || IT || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Points

2024-03-19T22:26:05Z

JK 3: Added xp calculation example.

Players can earn '''points''' by winning single-player games, multi-player games or [[tournaments]], or unlocking [[achievements]]. Points are used to gain [[levels]], which unlock additional features.

If you visit https://www.warzone.com/Points, you can see how many points you have, the progress to your next level, and all points you've earned in the last 30 days. If you hover your mouse cursor over a point award, you will be shown additional details about how that number was calculated.

== Points from Single-Player Games ==

Defeating one of the built-in levels is worth 2,500 points the first time you defeat it. Getting a gold star on one of these levels is worth an additional 2,500 points. If you get a gold star the first time you defeat it, you'll receive the two awards together as a 5,000 point award.

Community levels do not give points.

== Points from Multi-Player Games ==

When players win a [[ranked versus practice|ranked]] multi-player game, they are awarded points. The number of points the winner(s) are awarded is based off of a number of factors:
* The number of players who didn't win the game. Winning a 3-player FFA gives (on average) twice as many points as a 1v1, since there were two losers as opposed to one. Likewise, winning a 20 player FFA gives 19 times as many points as a 1v1.
* The levels of the players who didn't win the game. Defeating a player who is equal level to you gives a base of 5,000 points. Defeating a player who is 10 or more levels above you gives a base of 10,000 points. Defeating a player who is lower level than you gives fewer than 5,000 points, depending on their level.
* If the winning player is over level 8, their points are also affected by how recently they've defeated this player before. Defeating the same player twice in a 10-day period reduces the points earned from that player by 50%. Defeating the same player three or more times in a 10-day period reduces the points earned from that player by 80%.
* In team games, the team essentially splits the points earned from the defeated players. However, team members can also receive different amounts of points due to the above rules (if the team members are different levels or have defeated some of the opponents recently.)
* Tournament games and coin games award 50% more points. Ladder games award double points. Real-time games award half as many points as multi-day games.

==== Point Multipliers ====
{| class="wikitable"
|-
! Game type
! Points
|-
| Multi-day games
| 100%
|-
| Tournament games
| 150%
|-
| Ladder games
| 200%
|-
| Real-time games
| 50%
|-
| Coin games
| 150%
|}

For example, a Real-time coin tournament will give 50% * 150% * 150% = 112.5% points compared to a normal Multi-day game.

== Points from Tournaments ==

The winner of a [[ranked versus practice|ranked]] tournament is awarded points based on a number of factors:
* The number of players in the tournament. Winning a 128 player tournament awards, on average, twice as many points as a 64 player tournament.
* The levels of the players who didn't win the tournament. Each player who is equal level to you adds 500 points. Each player who is ten levels or more above you adds 1,000 points.
* If a player defeats the same opponent in tournaments multiple times within a 30 day period, the points they earn from that player are reduced by 80% for all victories after the first. This is tracked independently between games and tournaments.
* If a team wins a tournament, they essentially split the points earned from all defeated players. However, team members can also receive different amounts of points due to the above rules (if the team members are different levels or have defeated some of the opponents recently in a tournament.)
* In addition to the tournament points, the winner of course won a bunch of games within the tournament itself which all awarded elevated points.

== See also ==
* [[Levels]]
* [[Hidden settings]]

[[Category:Warzone]]

Making 3d Maps

2024-02-24T23:09:39Z

JK 3: Added note about 3D not working in browser and linked to standalone client

All Warzone maps work in both 2d mode and 3d mode. However, when in 3d mode, there are a few additional features that are available to map designers to help take advantage of the additional rendering capabilities of Warzone's 3d rendering engine. These are optional, and as a map designer you can choose to use them or ignore them. They just allow your map to stand out better when viewed in 3d. All of these features can be found under the "3d Settings" button in the map designer. This button only appears when viewing your map in 3d mode.

== Texture Image ==

Map designers can upload a '''texture image''' that will be displayed on the top of territories and bonus links. You can upload this image in the "3d Settings" dialog.

The image should be a png for best results, and should use a transparent background for any parts you don't want to alter. This width/height of this image should have the same aspect ratio of your map. For example, if your map is 1500x1000 pixels, your texture image should have a 1.5:1 ratio. Any area of the image that doesn't line up with a territory or bonus link in your map will not be used, so these areas can be transparent in your image.

Map designers can also set a '''texture image strength''' which defines how strongly the texture image, from 0 to 50, that controls how the texture image gets mixed with the normal color of the territory (normally the color of the player who controls the territory). A value of 0 means that the texture image will not show at all, and a theoretical value of 100 would mean that the normal color would not show at all and only the texture image would show. This is why it's capped at 50, since values that are too high would make the game unplayable.

The strength can be changed in the map designer and the results will be displayed in real-time, so map designers can tune in a value they are comfortable with. Uploading a new texture image also gets displayed immediately on the map for rapid iteration.

A good texture image does not use large solid colors, since this may interfere with player's abilities to tell which territories are controlled by which players in a Warzone game.

== Heightmap ==

Map designers can upload two '''heightmap images''' that allow you to give 3d depth of your map when played in 3d mode. This is most commonly used to define hills or mountains or other similar forms of elevation. The main heightmap only applies to your territories and bonus links, and the '''terrain heightmap''' applies to the rest of your map (decorative regions).

This width/height of these images should have the same aspect ratio of your map. For example, if your map is 1500x1000 pixels, your texture image should have a 1.5:1 ratio.

Each pixel in the image defines how high the elevation should be at that spot, where black is the lowest possible elevation and white is the highest possible elevation. Colors have no meaning.

Map designers can define a '''max height''' for each of these heightmaps that defines how much the map will be raised. This value can be altered in the map designer and results are shown in real-time.

Map designers can also define a '''tessellation size''' for each of these heightmaps. This controls how big each polygon in the resulting object will be. In other words, this controls how much the object will be sub-divided. Smaller values will allow a higher resolution for your heightmap, but going too small may result in too many polygons being created for your map which could cause it to perform very poorly. If using a heightmap, you should experiment with different values. The best value to use for this setting is the highest value that still looks good.

Note that uploading a new heightmap image or changing the tessellation size requires clicking "Apply" in the 3d Settings Dialog before results are shown.

== Limited browser support ==

At the time of writing, 3d maps are not yet supported in browsers. To make 3d maps, use the [[Standalone Client]].

[[Category:Map Making]]

Uploading your SVG

2024-02-12T18:56:38Z

JK 3:

You can upload your SVG file into Warzone by following these steps:

* Use this link to enable the Design Maps link: [https://www.warzone.com/EnableMapDevelopment Enable Map Development]
* Click the Multi-Player tab then Design Maps
* Click Create New Map
* Select your SVG file
* Enter your map's name and description

Note that your SVG must meet the [[Creating_the_SVG#SVG_file_limitations|SVG file requirements]].

==Updating an existing map's SVG file==

If you need to make changes to your SVG file after uploading it, simply use the "Upload new SVG" button in the map designer.

A word of caution when updating your SVG: If you upload a new SVG file that doesn't contain a territory (by number) that the map used to contain, this territory data will be removed from your map. This is expected, as this is in fact the only way to remove territories. If you accidently upload an empty SVG file, it would effectively remove all of your territories and there is no way to undo this action. Just be aware what SVG you upload, and if you're not confident, you can try uploading into a duplicate version as a test (just remember to delete the duplicate when you're done to save space.)

==See also==

* [[Map Making]]
* [[Creating the SVG]]
* [[Map requirements]]

[[Category:Map Making|Upload]]

Map requirements

2024-02-12T18:52:29Z

JK 3: /* See Also */

This page lists the requirements that all maps must meet in order to [[Making maps public|go public]].

== Requirements ==

=== Connections are Visible ===

Players must be able to tell what territories connect just by looking at the map.

The biggest mistake some map creators make is to connect two territories over water, but don't include any indication on the map that they connect. It's customary to use yellow lines to show where the connections are - see the [https://www.warzone.com/SinglePlayer?PreviewMap=12 Earth Map] for an example. It's not necessary to use yellow lines, it just must be obvious where the connections are. It may be obvious that the territories connect in the map designer, but it needs to be obvious in the real game too.

https://d32kaghj56y4ei.cloudfront.net/static/img/ConnectionMissing.png

In maps with tricky connections, you may need to take special care to ensure that the connections can be reasonably figured out just by looking at the map (without clicking around). A common rule of thumb is that territories that touch must connect, and territories that connect but don't touch must show the connection somehow.

=== Tiny Territories ===

All territories must be big enough to fit a two-digit army number. Often people's first instinct is to keep territories real-life sized, however this doesn't work well in Warzone's engine. This is especially evident once you try playing the [[Mobile Client|mobile version of Warzone]].

Take, for example, Hawaii in the [https://www.warzone.com/SinglePlayer?PreviewMap=12 Earth Map]. Hawaii is a very small island, but in the Earth map it's sized significantly larger so that it can fit the army number.

In the map designer, you'll find a button labeled Show Example Armies. When clicking this, all army numbers must fit entirely within the territory's borders.

https://d32kaghj56y4ei.cloudfront.net/static/img/TinyTerritories.png

See [[Inkscape tips]] for a guide on how to enlarge territories to make them fit their army number.

=== Copyright Violations ===

By uploading a map to Warzone, you are asserting that you own or have the necessary licenses, rights, consents, and permissions to the content within. See the [https://www.warzone.com/TermsOfService Terms of Service] for full details.

=== Missing or Mistaken Connections ===

Maps makers should make an effort to find and missing or mistaken territory connections. Missing connections are a very common problem, as it is difficult to find every last connection error within the map designer alone.

The best way to find these kinds of mistakes is to play the map with real humans. If you need help finding players to test your map, make a thread on the map development [[forum]] asking for volunteers to help test your map. There are always lots of people willing to help test.

Incorrect or missing connections are also much more pronounced in the map previewer (which you can access via links in the Get Link for Sharing window), where all territories connected to the clicked one turn bright yellow. Map creators should create several [[Testing maps|test games]] on their map with real human players and play them out.

=== Territories are named ===

All territories should be named appropriately. Naming many territories the same thing, or just typing gibberish makes it hard for players to coordinate in team games.

=== Bonus Links ===

Bonus Links are the small boxes that show how many armies each bonus is worth. Without these, it is difficult to tell where the bonuses are. See [[Creating the SVG]] for instructions on how to add bonus links.

When possible, bonus links should be placed near or on top of the bonus they correspond to and be big enough to fit the army number that appears inside of it.

=== Appropriate Size ===

The SVG file specifies the width and height of the map in pixels. The recommended starting point is 1000x1000, however map creators can reduce this if they are making a small map or increase it if they're making a big map.

The size specified in the SVG file determines how big the army numbers will be on the map. This size must be appropriate for the map. If a very small map is stretched into a huge SVG file, the army numbers will be too small to see without zooming in. In order to avoid unnecessary zooming, a large SVG file should only be used if the map really needs that much room to fit all of its territories.

See [[Map_Making#Map_limitations|Map limitations]] for the applicable limits.

=== Territories should not overlap ===

Player-controllable territories can never overlap with each other. If you find yourself in a situation where you feel like you want one territory to be on top of another, you need to cut a hole in the outer territory in the shape of the inner one. This makes the inner one look like it's on top, even though technically the territories aren't overlapping.

=== Testing Maps ===

The map must be a real map and not just a test. It's a good idea to make your first map just a couple of territories to prove you understand how to make a real map, however maps without any strategic value should not go public. You're free to put these into testing mode to play games on them, however.

== Grandfathered Maps ==

Players sometimes notice maps that are already public that don't meet some of these requirements. Older maps that were created before these requirements existed are grandfathered in, such as the Wheel map that does not have bonus links or the United States Big map that had tiny territories. The presence of the old violations does not exempt new maps from the requirements.

== See Also ==

* [[Map Making]]
* [[Creating the SVG]]
* [[Uploading your SVG]]
* [[Map guidelines]]
* [[Inkscape tips]]

[[Category:Map Making]]

Player colors

2024-02-12T18:51:12Z

JK 3: Removed duplicate image link to Hearts color

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Orange Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* https://i.imgur.com/nJ90l3t.png Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the [[ladders]] for one week.

* Green Archer (from the [[1v1 ladder]])
* Orange Archer (from the [[2v2 ladder]])
* Pink Dice (from the [[3v3 ladder]])
* https://i.imgur.com/Lwj2WcV.png Aqua Elephants (from the [[Seasonal Ladder]])

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Creating the SVG

2024-02-12T18:46:52Z

JK 3: Renamed "Map limitations" to "SVG limitations", since map requirements has its own page

The first step in making a map is create an SVG file. This SVG file defines what the map looks like, where the territories are, what their shapes are, as well as the "bonus link" rectangles that show the bonus values.

You can use any SVG editor you want. Many graphic design applications have the ability to export to SVG, so if you're already familiar with one you may use that. If you don't know what to use, try Inkscape. Inkscape is a good choice since it's free, works across all of the major operating systems, and is overall very nice application. You can download it at http://inkscape.org.

It's a good idea to test your SVG file as you are building it. Don't wait until you've spent a bunch of time building the perfect map before uploading it into Warzone the first time. You want to make sure the tools and techniques you are using will work with Warzone, as Warzone [[SVG Limitations|doesn't support some SVG features]].

==Getting Started==

After opening Inkscape, you should do a few things to set up your document:

* Optionally, set the background to black: This is so it fits in with Warzone's theme. In Inkscape, click "Document Properties" (top-rightmost button, or shift-control-D) and click the "Background" (under the default "Page" tab). Set the R,B, and G to 0 and the A to full to get black. This isn't a required step, as Warzone will ignore the background color you set here and always have a black background. However, making it black in Inkscape helps you visualize how it will appear when you upload it.
* Set the document size: Go back to "Document Properties" and look at "Custom Size". First set the Units to "px", then set the Width and Height to the desired size of your map (900x900 is a good starting point). Then expand the "Viewbox" drop down and set the Width and Height to the same values as your "Custom size". You can adjust the size for your own map's needs, up to a maximum of 3500x2500. If army numbers appear too small when you test your map, that means your map is too big and had to be shrunken down, causing the army numbers to shrink. Thanks to the magic of SVG, you can reduce the size of your map without losing any detail.
* Ensure the Scale is also set to 1 (both x and y)

Then just start drawing, using Inkscape's drawing tools. For learning how to draw in Inkscape, there are many good tutorials on the web. Try searching with search engines or on Youtube.

==Assign Territories==

As you are drawing, you will need to designate which objects will be player-controllable territories and which are just for decoration. To mark an object as a player-controllable territory, give it an id of Territory_#. For example, Territory_1, Territory_2, Territory_3, etc. To do this in Inkscape, right-click on the object and select "Object Properties." Then set the "ID" to Territory_1.

Inkscape will tell you if you try to re-use the same number more than once (it will say "id exists!"), so you don't need to pay super close attention to where you left off in the numbering. Also, you don't need to use every number - it's okay to jump around (for example, skipping from Territory_11 to Territory_19.) This is also good if you decide to delete one; you don't need to go back and fill in the gap.

Anything that doesn't start with Territory_ won't be a territory, so you can include extra objects for decoration or instruction, such as lines, arrows, etc.

If you're making a really large map, note that maps may not contain more than 4000 territories or 1500 bonuses and your SVG file cannot be bigger than 3 megabytes. For very large maps (>3000 territories), keep this filesize limitation in mind. One strategy that helps is to use as few nodes as possible for your shapes.

==Starting from an image==

If you're modeling your map after something you have an image of, it's often helpful to insert an image, set its opacity to 50% and just draw over the top of it. The image itself won't show up when you upload it to Warzone.

To insert an image in Inkscape, just drag the image file into your canvas. Then, you can move it to the back by selecting Object -> Lower to Bottom. You can adjust its opacity by selecting Object -> Fill and Stroke.

==Overridden Properties==

Warzone will override a few properties of each player-controllable territory. Therefore, it does not matter what you set for these properties when designing the map, since the values will be overwritten when the map is used in a real game:

* Fill color: The fill color will be replaced with the color of the player who controls the territory
* Stroke color (border color): The stroke color will be replaced with the color of the bonus the territory belongs to (you'll set these colors for each bonus later)
* Stroke width (border width): The stroke width will always be 1.

Player-controllable territories are "brought to the front." That is, you can't overlap a player-controllable territory with another object and expect it to stay that way.

Further, player-controllable territories should not overlap each other - you don't want to have territories that players can't click on. If you want a territory to be on top of another, you really need to cut a hole in the outer territory in the shape of the inner one. This makes the inner one look like it's on top, even though technically the territories aren't overlapping.

==Bonus Links==

You can make a small "bonus link" rectangle that shows the number of armies a bonus gives. This is preferred over making your own rectangles with a number in them for two reasons:

* If players click on the bonus link, it selects the bonus.
* If players override the value of the bonus, the game will show the correct number.

To make a bonus link, make an object near the bonus. A 16x16 rectangle is the standard, but some players prefer to use circles or other artistic styles. Give the object an ID of BonusLink_BonusName. Remove any spaces or punctuation, special letters (like the ß), letters of any other alphabet then the latin alphabet, or letters with diacritics (such as ë, î, ú) from the bonus name. For example, the Earth map has a bonus named "Middle East" and the rectangle's name is "BonusLink_MiddleEast". Be sure to use the same casing; for example, bonuslink_middleeast would not work.

If you are not sure what to name your bonus link box, Warzone will help you out. After uploading your SVG file and creating the bonuses in the map designer, open the Bonuses window and look at the text. The Bonuses window will tell you what to name your Bonus Link rectangle. If you've named the object correctly, but Warzone still isn't recognizing it, it may be because your bonus link is a group (a "g" node in the svg file.) Only individual objects can be bonus links, not groups. To fix this, in Inkscape, just right-click the offending object and select "Ungroup."

The fill color of a bonus link will be set to the color assigned to the bonus. The stroke color of the bonus link will always be set to yellow, and this color is not overridable. However, the yellow stroke can be hidden by setting the stroke opacity to zero.

== Including Text ==

To include text in your SVG file, please follow these steps:

* Make the text using the text tool in Inkscape.
* Arrange the text exactly as you want it.
* Select the text.
* Select Path -> Object to Path

After doing this, your text will behave as an object. If you need to modify what the text says, you must delete and re-create the object.

If you followed these steps but the text still is not showing up, please also verify that the text isn't overlapping any player-controllable territories, and that the text's color isn't the same as what's behind it. A common mistake is to make black text, and if you didn't change your Inkscape background to black as instructed above, it will appear in Inkscape but not when Warzone changes your background to black.

== SVG file limitations ==

New Warzone maps are currently subject to the following limitations:

* Max 3500 x 2500 pixels (W x H)
* Max 1500 bonuses
* Max 4000 territories
* Max SVG file size: 3 MB
* Max height map size: 2 MB
* Max texture size: 2 MB

==See also==

* [[Map Making]]
* [[Uploading your SVG]]
* [[Map requirements]]

[[Category:Map Making]]

Uploading your SVG

2024-02-12T18:43:17Z

JK 3: Linked to SVG file requirements

You can upload your SVG file into Warzone by following these steps:

* Use this link to enable the Design Maps link: [https://www.warzone.com/EnableMapDevelopment Enable Map Development]
* Click the Multi-Player tab then Design Maps
* Click Create New Map
* Select your SVG file
* Enter your map's name and description

Note that your SVG must meet the [[Creating_the_SVG#Map_limitations|SVG file requirements]].

==Updating an existing map's SVG file==

If you need to make changes to your SVG file after uploading it, simply use the "Upload new SVG" button in the map designer.

A word of caution when updating your SVG: If you upload a new SVG file that doesn't contain a territory (by number) that the map used to contain, this territory data will be removed from your map. This is expected, as this is in fact the only way to remove territories. If you accidently upload an empty SVG file, it would effectively remove all of your territories and there is no way to undo this action. Just be aware what SVG you upload, and if you're not confident, you can try uploading into a duplicate version as a test (just remember to delete the duplicate when you're done to save space.)

==See also==

* [[Map Making]]
* [[Creating the SVG]]
* [[Map requirements]]

[[Category:Map Making|Upload]]

Uploading your SVG

2024-02-12T18:38:39Z

JK 3: /* See also */

You can upload your SVG file into Warzone by following these steps:

* Use this link to enable the Design Maps link: [https://www.warzone.com/EnableMapDevelopment Enable Map Development]
* Click the Multi-Player tab then Design Maps
* Click Create New Map
* Select your svg file
* Enter your map's name and description

==Updating an existing map's SVG file==

If you need to make changes to your SVG file after uploading it, simply use the "Upload new SVG" button in the map designer.

A word of caution when updating your SVG: If you upload a new SVG file that doesn't contain a territory (by number) that the map used to contain, this territory data will be removed from your map. This is expected, as this is in fact the only way to remove territories. If you accidently upload an empty SVG file, it would effectively remove all of your territories and there is no way to undo this action. Just be aware what SVG you upload, and if you're not confident, you can try uploading into a duplicate version as a test (just remember to delete the duplicate when you're done to save space.)

==See also==

* [[Map Making]]
* [[Creating the SVG]]
* [[Map requirements]]

[[Category:Map Making|Upload]]

Creating the SVG

2024-02-12T18:38:00Z

JK 3: expanded See Also section to link to Uploading SVG page

The first step in making a map is create an SVG file. This SVG file defines what the map looks like, where the territories are, what their shapes are, as well as the "bonus link" rectangles that show the bonus values.

You can use any SVG editor you want. Many graphic design applications have the ability to export to SVG, so if you're already familiar with one you may use that. If you don't know what to use, try Inkscape. Inkscape is a good choice since it's free, works across all of the major operating systems, and is overall very nice application. You can download it at http://inkscape.org.

It's a good idea to test your SVG file as you are building it. Don't wait until you've spent a bunch of time building the perfect map before uploading it into Warzone the first time. You want to make sure the tools and techniques you are using will work with Warzone, as Warzone [[SVG Limitations|doesn't support some SVG features]].

==Getting Started==

After opening Inkscape, you should do a few things to set up your document:

* Optionally, set the background to black: This is so it fits in with Warzone's theme. In Inkscape, click "Document Properties" (top-rightmost button, or shift-control-D) and click the "Background" (under the default "Page" tab). Set the R,B, and G to 0 and the A to full to get black. This isn't a required step, as Warzone will ignore the background color you set here and always have a black background. However, making it black in Inkscape helps you visualize how it will appear when you upload it.
* Set the document size: Go back to "Document Properties" and look at "Custom Size". First set the Units to "px", then set the Width and Height to the desired size of your map (900x900 is a good starting point). Then expand the "Viewbox" drop down and set the Width and Height to the same values as your "Custom size". You can adjust the size for your own map's needs, up to a maximum of 3500x2500. If army numbers appear too small when you test your map, that means your map is too big and had to be shrunken down, causing the army numbers to shrink. Thanks to the magic of SVG, you can reduce the size of your map without losing any detail.
* Ensure the Scale is also set to 1 (both x and y)

Then just start drawing, using Inkscape's drawing tools. For learning how to draw in Inkscape, there are many good tutorials on the web. Try searching with search engines or on Youtube.

==Assign Territories==

As you are drawing, you will need to designate which objects will be player-controllable territories and which are just for decoration. To mark an object as a player-controllable territory, give it an id of Territory_#. For example, Territory_1, Territory_2, Territory_3, etc. To do this in Inkscape, right-click on the object and select "Object Properties." Then set the "ID" to Territory_1.

Inkscape will tell you if you try to re-use the same number more than once (it will say "id exists!"), so you don't need to pay super close attention to where you left off in the numbering. Also, you don't need to use every number - it's okay to jump around (for example, skipping from Territory_11 to Territory_19.) This is also good if you decide to delete one; you don't need to go back and fill in the gap.

Anything that doesn't start with Territory_ won't be a territory, so you can include extra objects for decoration or instruction, such as lines, arrows, etc.

If you're making a really large map, note that maps may not contain more than 4000 territories or 1500 bonuses and your SVG file cannot be bigger than 3 megabytes. For very large maps (>3000 territories), keep this filesize limitation in mind. One strategy that helps is to use as few nodes as possible for your shapes.

==Starting from an image==

If you're modeling your map after something you have an image of, it's often helpful to insert an image, set its opacity to 50% and just draw over the top of it. The image itself won't show up when you upload it to Warzone.

To insert an image in Inkscape, just drag the image file into your canvas. Then, you can move it to the back by selecting Object -> Lower to Bottom. You can adjust its opacity by selecting Object -> Fill and Stroke.

==Overridden Properties==

Warzone will override a few properties of each player-controllable territory. Therefore, it does not matter what you set for these properties when designing the map, since the values will be overwritten when the map is used in a real game:

* Fill color: The fill color will be replaced with the color of the player who controls the territory
* Stroke color (border color): The stroke color will be replaced with the color of the bonus the territory belongs to (you'll set these colors for each bonus later)
* Stroke width (border width): The stroke width will always be 1.

Player-controllable territories are "brought to the front." That is, you can't overlap a player-controllable territory with another object and expect it to stay that way.

Further, player-controllable territories should not overlap each other - you don't want to have territories that players can't click on. If you want a territory to be on top of another, you really need to cut a hole in the outer territory in the shape of the inner one. This makes the inner one look like it's on top, even though technically the territories aren't overlapping.

==Bonus Links==

You can make a small "bonus link" rectangle that shows the number of armies a bonus gives. This is preferred over making your own rectangles with a number in them for two reasons:

* If players click on the bonus link, it selects the bonus.
* If players override the value of the bonus, the game will show the correct number.

To make a bonus link, make an object near the bonus. A 16x16 rectangle is the standard, but some players prefer to use circles or other artistic styles. Give the object an ID of BonusLink_BonusName. Remove any spaces or punctuation, special letters (like the ß), letters of any other alphabet then the latin alphabet, or letters with diacritics (such as ë, î, ú) from the bonus name. For example, the Earth map has a bonus named "Middle East" and the rectangle's name is "BonusLink_MiddleEast". Be sure to use the same casing; for example, bonuslink_middleeast would not work.

If you are not sure what to name your bonus link box, Warzone will help you out. After uploading your SVG file and creating the bonuses in the map designer, open the Bonuses window and look at the text. The Bonuses window will tell you what to name your Bonus Link rectangle. If you've named the object correctly, but Warzone still isn't recognizing it, it may be because your bonus link is a group (a "g" node in the svg file.) Only individual objects can be bonus links, not groups. To fix this, in Inkscape, just right-click the offending object and select "Ungroup."

The fill color of a bonus link will be set to the color assigned to the bonus. The stroke color of the bonus link will always be set to yellow, and this color is not overridable. However, the yellow stroke can be hidden by setting the stroke opacity to zero.

== Including Text ==

To include text in your SVG file, please follow these steps:

* Make the text using the text tool in Inkscape.
* Arrange the text exactly as you want it.
* Select the text.
* Select Path -> Object to Path

After doing this, your text will behave as an object. If you need to modify what the text says, you must delete and re-create the object.

If you followed these steps but the text still is not showing up, please also verify that the text isn't overlapping any player-controllable territories, and that the text's color isn't the same as what's behind it. A common mistake is to make black text, and if you didn't change your Inkscape background to black as instructed above, it will appear in Inkscape but not when Warzone changes your background to black.

== Map limitations ==

New Warzone maps are currently subject to the following limitations:

* Max 3500 x 2500 pixels (W x H)
* Max 1500 bonuses
* Max 4000 territories
* Max SVG file size: 3 MB
* Max height map size: 2 MB
* Max texture size: 2 MB

==See also==

* [[Map Making]]
* [[Uploading your SVG]]
* [[Map requirements]]

[[Category:Map Making]]

Creating the SVG

2024-02-12T18:35:02Z

JK 3: Added list of map limitations

The first step in making a map is create an SVG file. This SVG file defines what the map looks like, where the territories are, what their shapes are, as well as the "bonus link" rectangles that show the bonus values.

You can use any SVG editor you want. Many graphic design applications have the ability to export to SVG, so if you're already familiar with one you may use that. If you don't know what to use, try Inkscape. Inkscape is a good choice since it's free, works across all of the major operating systems, and is overall very nice application. You can download it at http://inkscape.org.

It's a good idea to test your SVG file as you are building it. Don't wait until you've spent a bunch of time building the perfect map before uploading it into Warzone the first time. You want to make sure the tools and techniques you are using will work with Warzone, as Warzone [[SVG Limitations|doesn't support some SVG features]].

==Getting Started==

After opening Inkscape, you should do a few things to set up your document:

* Optionally, set the background to black: This is so it fits in with Warzone's theme. In Inkscape, click "Document Properties" (top-rightmost button, or shift-control-D) and click the "Background" (under the default "Page" tab). Set the R,B, and G to 0 and the A to full to get black. This isn't a required step, as Warzone will ignore the background color you set here and always have a black background. However, making it black in Inkscape helps you visualize how it will appear when you upload it.
* Set the document size: Go back to "Document Properties" and look at "Custom Size". First set the Units to "px", then set the Width and Height to the desired size of your map (900x900 is a good starting point). Then expand the "Viewbox" drop down and set the Width and Height to the same values as your "Custom size". You can adjust the size for your own map's needs, up to a maximum of 3500x2500. If army numbers appear too small when you test your map, that means your map is too big and had to be shrunken down, causing the army numbers to shrink. Thanks to the magic of SVG, you can reduce the size of your map without losing any detail.
* Ensure the Scale is also set to 1 (both x and y)

Then just start drawing, using Inkscape's drawing tools. For learning how to draw in Inkscape, there are many good tutorials on the web. Try searching with search engines or on Youtube.

==Assign Territories==

As you are drawing, you will need to designate which objects will be player-controllable territories and which are just for decoration. To mark an object as a player-controllable territory, give it an id of Territory_#. For example, Territory_1, Territory_2, Territory_3, etc. To do this in Inkscape, right-click on the object and select "Object Properties." Then set the "ID" to Territory_1.

Inkscape will tell you if you try to re-use the same number more than once (it will say "id exists!"), so you don't need to pay super close attention to where you left off in the numbering. Also, you don't need to use every number - it's okay to jump around (for example, skipping from Territory_11 to Territory_19.) This is also good if you decide to delete one; you don't need to go back and fill in the gap.

Anything that doesn't start with Territory_ won't be a territory, so you can include extra objects for decoration or instruction, such as lines, arrows, etc.

If you're making a really large map, note that maps may not contain more than 4000 territories or 1500 bonuses and your SVG file cannot be bigger than 3 megabytes. For very large maps (>3000 territories), keep this filesize limitation in mind. One strategy that helps is to use as few nodes as possible for your shapes.

==Starting from an image==

If you're modeling your map after something you have an image of, it's often helpful to insert an image, set its opacity to 50% and just draw over the top of it. The image itself won't show up when you upload it to Warzone.

To insert an image in Inkscape, just drag the image file into your canvas. Then, you can move it to the back by selecting Object -> Lower to Bottom. You can adjust its opacity by selecting Object -> Fill and Stroke.

==Overridden Properties==

Warzone will override a few properties of each player-controllable territory. Therefore, it does not matter what you set for these properties when designing the map, since the values will be overwritten when the map is used in a real game:

* Fill color: The fill color will be replaced with the color of the player who controls the territory
* Stroke color (border color): The stroke color will be replaced with the color of the bonus the territory belongs to (you'll set these colors for each bonus later)
* Stroke width (border width): The stroke width will always be 1.

Player-controllable territories are "brought to the front." That is, you can't overlap a player-controllable territory with another object and expect it to stay that way.

Further, player-controllable territories should not overlap each other - you don't want to have territories that players can't click on. If you want a territory to be on top of another, you really need to cut a hole in the outer territory in the shape of the inner one. This makes the inner one look like it's on top, even though technically the territories aren't overlapping.

==Bonus Links==

You can make a small "bonus link" rectangle that shows the number of armies a bonus gives. This is preferred over making your own rectangles with a number in them for two reasons:

* If players click on the bonus link, it selects the bonus.
* If players override the value of the bonus, the game will show the correct number.

To make a bonus link, make an object near the bonus. A 16x16 rectangle is the standard, but some players prefer to use circles or other artistic styles. Give the object an ID of BonusLink_BonusName. Remove any spaces or punctuation, special letters (like the ß), letters of any other alphabet then the latin alphabet, or letters with diacritics (such as ë, î, ú) from the bonus name. For example, the Earth map has a bonus named "Middle East" and the rectangle's name is "BonusLink_MiddleEast". Be sure to use the same casing; for example, bonuslink_middleeast would not work.

If you are not sure what to name your bonus link box, Warzone will help you out. After uploading your SVG file and creating the bonuses in the map designer, open the Bonuses window and look at the text. The Bonuses window will tell you what to name your Bonus Link rectangle. If you've named the object correctly, but Warzone still isn't recognizing it, it may be because your bonus link is a group (a "g" node in the svg file.) Only individual objects can be bonus links, not groups. To fix this, in Inkscape, just right-click the offending object and select "Ungroup."

The fill color of a bonus link will be set to the color assigned to the bonus. The stroke color of the bonus link will always be set to yellow, and this color is not overridable. However, the yellow stroke can be hidden by setting the stroke opacity to zero.

== Including Text ==

To include text in your SVG file, please follow these steps:

* Make the text using the text tool in Inkscape.
* Arrange the text exactly as you want it.
* Select the text.
* Select Path -> Object to Path

After doing this, your text will behave as an object. If you need to modify what the text says, you must delete and re-create the object.

If you followed these steps but the text still is not showing up, please also verify that the text isn't overlapping any player-controllable territories, and that the text's color isn't the same as what's behind it. A common mistake is to make black text, and if you didn't change your Inkscape background to black as instructed above, it will appear in Inkscape but not when Warzone changes your background to black.

== Map limitations ==

New Warzone maps are currently subject to the following limitations:

* Max 3500 x 2500 pixels (W x H)
* Max 1500 bonuses
* Max 4000 territories
* Max SVG file size: 3 MB
* Max height map size: 2 MB
* Max texture size: 2 MB

==See also==

* [[Map Making]]

[[Category:Map Making]]

Map Making

2024-02-12T18:07:19Z

JK 3: Added link to 3D maps page

This page will teach you how you can make your very own Warzone map! Anyone may make a map -- you do not need to purchase a membership or be a certain level.

== Overview ==

Creating a Warzone map is a four-step process. See the links below for instructions on how to accomplish each of these steps.

# Create your SVG file (defines what the map looks like)
# Enter the details (connections, [[bonuses]], etc.)
# Test the map (play games on it to ensure it works correctly)
# Mark the map as public (allows other players to play your map)

== Required Reading ==

Please refer to the following sections for a full guide on making your map. You may wish to watch the [https://www.youtube.com/watch?v=AkQn1pIZdY4 recommended tutorial video], but you should also read the wiki as it contains important information that isn't in the video.

* [[Creating the SVG]]
* [[Uploading your SVG]]
* [[Map requirements]]
* [[Entering map details]]
* [[Testing maps|Testing your map]]
* [[Making maps public|Make the map public]]
* [[Map versioning|Managing different versions of your map]]
* [[Making 3d Maps|Making 3D Maps]]

If you get stuck or have questions, feel free to post on the [[map development forum]].

== Additional Resources ==

* [[Map guidelines|Guidelines for making a great map]]
* [[Inkscape tips]]
* [[SVG Limitations]]
* [https://www.youtube.com/watch?v=AkQn1pIZdY4 Tutorial Video]
* [[Automating the map creation process]]

[[Category:Map Making|!]]

Map requirements

2024-01-30T23:11:19Z

JK 3: Added link to Map Limitations

This page lists the requirements that all maps must meet in order to [[Making maps public|go public]].

== Requirements ==

=== Connections are Visible ===

Players must be able to tell what territories connect just by looking at the map.

The biggest mistake some map creators make is to connect two territories over water, but don't include any indication on the map that they connect. It's customary to use yellow lines to show where the connections are - see the [https://www.warzone.com/SinglePlayer?PreviewMap=12 Earth Map] for an example. It's not necessary to use yellow lines, it just must be obvious where the connections are. It may be obvious that the territories connect in the map designer, but it needs to be obvious in the real game too.

https://d32kaghj56y4ei.cloudfront.net/static/img/ConnectionMissing.png

In maps with tricky connections, you may need to take special care to ensure that the connections can be reasonably figured out just by looking at the map (without clicking around). A common rule of thumb is that territories that touch must connect, and territories that connect but don't touch must show the connection somehow.

=== Tiny Territories ===

All territories must be big enough to fit a two-digit army number. Often people's first instinct is to keep territories real-life sized, however this doesn't work well in Warzone's engine. This is especially evident once you try playing the [[Mobile Client|mobile version of Warzone]].

Take, for example, Hawaii in the [https://www.warzone.com/SinglePlayer?PreviewMap=12 Earth Map]. Hawaii is a very small island, but in the Earth map it's sized significantly larger so that it can fit the army number.

In the map designer, you'll find a button labeled Show Example Armies. When clicking this, all army numbers must fit entirely within the territory's borders.

https://d32kaghj56y4ei.cloudfront.net/static/img/TinyTerritories.png

See [[Inkscape tips]] for a guide on how to enlarge territories to make them fit their army number.

=== Copyright Violations ===

By uploading a map to Warzone, you are asserting that you own or have the necessary licenses, rights, consents, and permissions to the content within. See the [https://www.warzone.com/TermsOfService Terms of Service] for full details.

=== Missing or Mistaken Connections ===

Maps makers should make an effort to find and missing or mistaken territory connections. Missing connections are a very common problem, as it is difficult to find every last connection error within the map designer alone.

The best way to find these kinds of mistakes is to play the map with real humans. If you need help finding players to test your map, make a thread on the map development [[forum]] asking for volunteers to help test your map. There are always lots of people willing to help test.

Incorrect or missing connections are also much more pronounced in the map previewer (which you can access via links in the Get Link for Sharing window), where all territories connected to the clicked one turn bright yellow. Map creators should create several [[Testing maps|test games]] on their map with real human players and play them out.

=== Territories are named ===

All territories should be named appropriately. Naming many territories the same thing, or just typing gibberish makes it hard for players to coordinate in team games.

=== Bonus Links ===

Bonus Links are the small boxes that show how many armies each bonus is worth. Without these, it is difficult to tell where the bonuses are. See [[Creating the SVG]] for instructions on how to add bonus links.

When possible, bonus links should be placed near or on top of the bonus they correspond to and be big enough to fit the army number that appears inside of it.

=== Appropriate Size ===

The SVG file specifies the width and height of the map in pixels. The recommended starting point is 1000x1000, however map creators can reduce this if they are making a small map or increase it if they're making a big map.

The size specified in the SVG file determines how big the army numbers will be on the map. This size must be appropriate for the map. If a very small map is stretched into a huge SVG file, the army numbers will be too small to see without zooming in. In order to avoid unnecessary zooming, a large SVG file should only be used if the map really needs that much room to fit all of its territories.

See [[Map_Making#Map_limitations|Map limitations]] for the applicable limits.

=== Territories should not overlap ===

Player-controllable territories can never overlap with each other. If you find yourself in a situation where you feel like you want one territory to be on top of another, you need to cut a hole in the outer territory in the shape of the inner one. This makes the inner one look like it's on top, even though technically the territories aren't overlapping.

=== Testing Maps ===

The map must be a real map and not just a test. It's a good idea to make your first map just a couple of territories to prove you understand how to make a real map, however maps without any strategic value should not go public. You're free to put these into testing mode to play games on them, however.

== Grandfathered Maps ==

Players sometimes notice maps that are already public that don't meet some of these requirements. Older maps that were created before these requirements existed are grandfathered in, such as the Wheel map that does not have bonus links or the United States Big map that had tiny territories. The presence of the old violations does not exempt new maps from the requirements.

== See Also ==

* [[Map Making]]
* [[Map guidelines]]
* [[Inkscape tips]]

[[Category:Map Making]]

Map Making

2024-01-30T23:09:04Z

JK 3: Added map limitations section

This page will teach you how you can make your very own Warzone map! Anyone may make a map -- you do not need to purchase a membership or be a certain level.

== Overview ==

Creating a Warzone map is a four-step process. See the links below for instructions on how to accomplish each of these steps.

# Create your SVG file (defines what the map looks like)
# Enter the details (connections, [[bonuses]], etc.)
# Test the map (play games on it to ensure it works correctly)
# Mark the map as public (allows other players to play your map)

== Required Reading ==

Please refer to the following sections for a full guide on making your map. You may wish to watch the [https://www.youtube.com/watch?v=AkQn1pIZdY4 recommended tutorial video], but you should also read the wiki as it contains important information that isn't in the video.

* [[Creating the SVG]]
* [[Uploading your SVG]]
* [[Map requirements]]
* [[Entering map details]]
* [[Testing maps|Testing your map]]
* [[Making maps public|Make the map public]]
* [[Map versioning|Managing different versions of your map]]

If you get stuck or have questions, feel free to post on the [[map development forum]].

== Map limitations ==

New Warzone maps are currently subject to the following limitations:

* Max 3500 x 2500 pixels (W x H)
* Max 1500 bonuses
* Max 4000 territories
* Max SVG file size: 3 MB
* Max height map size: 2 MB
* Max texture size: 2 MB


'''''Warning: Many map makers abandon their biggest maps because they are unable to meet the SVG file size limit without throwing away all their work.

Keep the file sizes in mind when making maps!

Use as few nodes as possible for your shapes, or reduce the size of your map by a lot...'''''


== Additional Resources ==

* [[Map guidelines|Guidelines for making a great map]]
* [[Inkscape tips]]
* [[SVG Limitations]]
* [https://www.youtube.com/watch?v=AkQn1pIZdY4 Tutorial Video]
* [[Automating the map creation process]]

[[Category:Map Making|!]]

Player colors

2023-12-07T22:33:32Z

JK 3: Added Aqua Elephants

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Orange Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the https://www.warzone.com/Ladders 4 official ladders for 1 week.

* Green Archer (First place on [https://www.warzone.com/LadderSeason?ID=0 1v1 ladder])
* Orange Archer (First place on [https://www.warzone.com/LadderSeason?ID=1 2v2 ladder])
* Pink Dice (First place on [https://www.warzone.com/LadderSeason?ID=4 3v3 ladder])
* https://i.imgur.com/Lwj2WcV.png Aqua Elephants (First place on [https://www.warzone.com/LadderSeasons Seasonal ladder]

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2023-11-26T23:20:48Z

JK 3: Fix issue with listing Orange Dice as reward for 3v3 ladder while it should be Pink Dice

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Orange Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the [https://www.warzone.com/Ladders 4 official ladders] for 1 week.

* Green Archer (First place on [https://www.warzone.com/LadderSeason?ID=0 1v1 ladder])
* Orange Archer (First place on [https://www.warzone.com/LadderSeason?ID=1 2v2 ladder])
* Pink Dice (First place on [https://www.warzone.com/LadderSeason?ID=4 3v3 ladder])
* Elephants (First place on [https://www.warzone.com/LadderSeasons Seasonal ladder]

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2023-11-26T23:16:11Z

JK 3: Reworded section headings to be more in line with the rest of the document, added ladder colors (still needs some images)

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Seasonal Packages Colors ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Dice (Orange color, part of the Summer Sale package, as well as reward for first place on 3v3 ladder)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Ladder Colors ==

There are also colors that can be unlocked by holding first place in one of the [https://www.warzone.com/Ladders 4 official ladders] for 1 week.

* Green Archer (First place on [https://www.warzone.com/LadderSeason?ID=0 1v1 ladder])
* Orange Archer (First place on [https://www.warzone.com/LadderSeason?ID=1 2v2 ladder])
* https://i.imgur.com/faDANQN.png Orange Dice (First place on [https://www.warzone.com/LadderSeason?ID=4 3v3 ladder])
* Elephants (First place on [https://www.warzone.com/LadderSeasons Seasonal ladder]

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2023-11-26T23:03:15Z

JK 3: Added images of colors for the Seasonal Packages

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Colors from Seasonal Packages ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/faDANQN.png Dice (Orange color, part of the Summer Sale package)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* https://i.imgur.com/PifHAFe.png Warlight (Red color, part of the Birthday package)

== Colors from Ladders ==

To-do

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2023-11-26T22:47:48Z

JK 3: /* Colors from Seasonal Packages */

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Colors from Seasonal Packages ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/i7OD1pp.jpg Dice (Orange color, part of the Summer Sale package)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color, part of the Valentine's Day Sale package)
* Warlight (Red color, part of the Birthday package)

== Colors from Ladders ==

To-do

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Player colors

2023-11-26T22:43:46Z

JK 3: Split the colors with patterns into limited edition/from packages/from ladders

Warzone players may select from 24 standard different colors to represent themselves. There is no default color, as the sign-up page randomly selects a color each time it is loaded.

This page lists the colors along with the hex-codes that represent them.

== Standard Colors ==

*      <tt>59009D</tt> Purple
*      <tt>FF7D00</tt> Orange
*      <tt>606060</tt> Dark Gray
*      <tt>FF697A</tt> Hot Pink
*      <tt>00FF8C</tt> Sea Green
*      <tt>009B9D</tt> Teal
*      <tt>AC0059</tt> Dark Magenta
*      <tt>FFFF00</tt> Yellow
*      <tt>FEFF9B</tt> Ivory
*      <tt>B70AFF</tt> Electric Purple
*      <tt>FF00B1</tt> Deep Pink
*      <tt>4EFFFF</tt> Aqua
*      <tt>008000</tt> Dark Green
*      <tt>FF0000</tt> Red
*      <tt>00FF05</tt> Green
*      <tt>94652E</tt> Saddle Brown
*      <tt>FF4700</tt> Orange Red
*      <tt>23A0FF</tt> Light Blue
*      <tt>FF87FF</tt> Orchid
*      <tt>943E3E</tt> Brown
*      <tt>AD7E7E</tt> Copper Rose
*      <tt>FFAF56</tt> Tan
*      <tt>8EBE57</tt> Lime
*      <tt>0000FF</tt> Blue

== Premium Colors ==

The premium colors can be purchased. Purchasing a color gives you unlimited use of that color forever.
 [https://www.warzone.com/ChangeColor https://www.warzone.com/ChangeColor]

*      <tt>990024</tt> Tyrian Purple
*      <tt>880085</tt> Mardi Gras
*      <tt>4169E1</tt> Royal Blue
*      <tt>FF43A4</tt> Wild Strawberry
*      <tt>100C08</tt> Smoky Black

== Limited Edition Colors ==

In addition to the colors above, a few limited edition colors have also been released:
* https://i.imgur.com/EwKhbMM.png Blue Diagonals (also called Support Blue, is a reward for purchasing a support bundle when Warzone was raising funds to go to court)
* https://i.imgur.com/2f3AcRB.png Prison Green

Please note that the limited edition colors are no longer for sale.

== Colors from Seasonal Packages ==

These colors are one of the colors mentioned above combined with a unique pattern. They can be unlocked by purchasing one of the Seasonal Packages. The most up-to-date reporting of these packages can be found in the [https://www.warzone.com/Forum/657840-anyone-know-different-bought-packages-2 "Does anyone know the different bought packages? #2" forum]

* https://i.imgur.com/i7OD1pp.jpg Dice (Orange color)
* [https://i.imgur.com/epYpqqb.png https://i.imgur.com/nJ90l3t.png] Hearts (Wild Strawberry color)

== Colors from Ladders ==

To-do

== Reserve Colors ==

Games with more than 24 players will offer additional color choices, up to the max of 40. Because these colors are often too similar to other colors or the neutral color, these colors are only available in large games to minimize the number of times that similar colors are used. Note that they cannot be selected as a default player color.

*      <tt>DAA520</tt> Goldenrod
*      <tt>00FFFF</tt> Cyan
*      <tt>8F9779</tt> Artichoke
*      <tt>00755E</tt> Rain Forest
*      <tt>FFE5B4</tt> Peach
*      <tt>8DB600</tt> Apple Green
*      <tt>40826D</tt> Viridian
*      <tt>C04000</tt> Mahogany
*      <tt>FFDDF4</tt> Pink Lace
*      <tt>CD7F32</tt> Bronze
*      <tt>C19A6B</tt> Wood Brown
*      <tt>C09999</tt> Tuscany

== Custom Game Colors ==

There are a few hidden colors beyond the 40 player colors. These colors cannot be obtained by a player due to the 40 player limit, but these colors do appear when assigning territories to slots AO through AW in Custom Game.

*      <tt>B0BF1A</tt> Acid Green
*      <tt>3B7A57</tt> Amazon
*      <tt>4B5320</tt> Army Green
*      <tt>664C28</tt> Donkey Brown
*      <tt>893F45</tt> Cordovan
*      <tt>D2691E</tt> Cinnamon
*      <tt>36454F</tt> Charcoal
*      <tt>FF00FF</tt> Fuchsia
*      <tt>76FF7A</tt> Screamin' Green

[[Category:Warzone]]

Mines

2023-10-29T22:14:02Z

JK 3: Add order of multipliers for calculating mine output

'''Mines''' are the core way to get ore in [[Warzone Idle]]. Mines generate ore every second. You can find mines by exploring on the map and conquering them.

Mines can be upgraded to produce more ore per second. The upgrade cost varies depending on the mine and the level, so the costs are not listed in this wiki.

The ore that mines generate can be refined into bars via [[Smelters/Crafters|Smelters]]

== Generation Rate ==

Each mine generates different types of resources, and in different ratios. For example, a mine could generate 100% copper, or 30% copper and 70% tin.

The total ore each mine generates is based on this formula:

(0.3 * Level ^ 2) + (Level + 2)

If mine's level is 1, multiply result by 0.3. If mine level is 2, multiply result by 0.6. If mine level is 3, multiply result by 0.8.

The result of this formula is then divided into the resource types it generates.
--
{| border="1" style="border-collapse:collapse" {{table}}
| align="center" style="background:#f0f0f0;"|'''Level'''
| align="center" style="background:#f0f0f0;"|'''Mining Rate'''
| align="center" style="background:#f0f0f0;"|'''Increase'''
| align="center" style="background:#f0f0f0;"|'''%'''
|-
| 1 || 0.99/sec || - || -
|-
| 2 || 3.2/sec || +2.21/sec || +223%
|-
| 3 || 6.16/sec || +2.96/sec || +92.5%
|-
| 4 || 10.8/sec || +4.64/sec || +75%
|-
| 5 || 14.5/sec || +3.7/sec || +34%
|-
| 6 || 18.8/sec || +4.3/sec || +30%
|-
| 7 || 23.7/sec || +4.9/sec || +26%
|-
| 8 || 29.2/sec || +5.5/sec || +23%
|-
| 9 || 35.3/sec || +6.1/sec || +21%
|-
| 10 || 42.0/sec || +6.7/sec || +19%
|-
| 11 || 49.3/sec || +7.3/sec || +17%
|-
| 12 || 57.2/sec || +7.9/sec || +16%
|-
| 13 || 65.7/sec || +8.5/sec || +15%
|-
| 14 || 74.8/sec || +9.1/sec || +14%
|-
| 15 || 84.5/sec || +9.7/sec || +13%
|-
| 16 || 94.8/sec || +10.3/sec || +12%
|-
| 17 || 105.7/sec || +10.9/sec || +11%
|-
| 18 || 117.2/sec || +11.5/sec || +11%
|-
| 19 || 129.3/sec || +12.1/sec || +10%
|-
| 20 || 142.0/sec || +12.7/sec || +10%

|}

These numbers can be increased via your tech upgrades, advancement upgrades, supercharge powers, etc.

Multipliers are applied to the base value in the order: 
a) sum of techs and advancements 
b) supercharged mine (x20 multiplier) 
c) mine doubler (Rock Candy reward from Hardened Far Land) 
d) ad watch bonus (+20% or +30% depending on Couch Potato reward from Hard Siege of Feldmere)

== Mine Generation Ratios ==

Mines produce either one, two or three different kinds of ore. The total production of a mine depends on the level of the mine and other upgrades, however the ratios of ores a mine produces doesn't change per level unless increased ore production advancements are purchased. The basic ratios are displayed in the table below, with the first 42 mines in the same order as displayed in Idle.

{| border="1" style="border-collapse:collapse" {{table}}
| align="center" style="background:#f0f0f0;"|'''Mine'''
| align="center" style="background:#f0f0f0;"|'''Ore#1'''
| align="center" style="background:#f0f0f0;"|'''Ore#2'''
| align="center" style="background:#f0f0f0;"|'''Ore#3'''
|-
| Gaspo || 100% Copper || - || -
|-
| Hopesonen || 85% Copper || 15% Tin || -
|-
| Freadwels || 50% Copper || 50% Tin || -
|-
| Valinia || 80% Tin || 20% Iron || -
|-
| Keleginary || 20% Copper || 30% Tin || 50% Iron
|-
| Proftor || 100% Iron || - || -
|-
| Handow || 40% Copper || 40% Tin || 20% Zinc
|-
| Censborogeol || 40% Copper || 60% Zinc || -
|-
| Foremotions || 80% Zinc || 20% Nickel || -
|-
| Andorcel || 20% Iron || 30% Zinc || 50% Nickel
|-
| Fectly || 100% Nickel || - || -
|-
| Ciliked || 40% Iron || 40% Nickel || 20% Lead
|-
| Stramentension || 50% Zinc || 50% Lead || -
|-
| Bragpose || 20% Nickel || 80% Lead || -
|-
| Probnonders || 40% Tin || 40% Lead || 20% Silicon
|-
| Suffergizes || 50% Lead || 50% Silicon || -
|-
| Sparterchacks || 20% Iron || 80% Silicon || -
|-
| Judingsions || 40% Nickel || 40% Silicon || 20% Aluminum
|-
| Gicabbonies || 50% Silicon || 50% Aluminum || -
|-
| Rivulstenspers || 20% Lead || 80% Aluminum || -
|-
| Draugerhytics || 40% Silicon || 40% Aluminum || 20% Silver
|-
| Shadambuzzler || 50% Aluminum || 50% Silver || -
|-
| Excienested || 20% Aluminum || 80% Silver || -
|-
| Echnuthfirones || 40% Zinc || 40% Silver || 20% Gold
|-
| Flautify || 50% Silver || 50% Gold || -
|-
| Grincurvinding || 20% Silver || 80% Gold || -
|-
| Rowskiman || 40% Iron || 40% Gold || 20% Platinum
|-
| Herobbing || 50% Gold || 50% Platinum || -
|-
| Mufficatormes || 20% Gold || 80% Platinum || -
|-
| Diserbalned || 40% Tin || 40% Platinum || 20% Titanium
|-
| Ottornood || 50% Platinum || 50% Titanium || -
|-
| Arraight || 20% Platinum || 80% Titanium || -
|-
| Sketeematic || 40% Lead || 40% Titanium || 20% Thorium
|-
| Neutinoclar || 50% Titanium || 50% Thorium || -
|-
| Bewillo || 20% Titanium || 80% Thorium || -
|-
| Explum || 40% Aluminum || 40% Thorium || 20% Neodymium
|-
| Catated || 50% Thorium || 50% Neodymium || -
|-
| Facipaz || 20% Thorium || 80% Neodymium || -
|-
| Bruther || 40% Silver || 40% Neodymium || 20% Chromium
|-
| Wagorget || 50% Neodymium || 50% Chromium || -
|-
| Beconch || 20% Neodymium || 80% Chromium || -
|-
| Runnett || 40% Gold || 40% Chromium || 20% Uranium
|-
| Farbors || 50% Chromium || 50% Uranium || -
|-
| Throomize || 20% Chromium || 80% Uranium || -
|-
| Apiesters || 40% Platinum || 40% Uranium || 20% Lanthanum
|-
| Ounded || 50% Uranium || 50% Lanthanum || -
|-
| Chase-on || 20% Uranium || 80% Lanthanum || -
|-
| Chase-off || 40% Titanium || 40% Lanthanum || 20% Samarium
|-
| Purson || 50% Lanthanum || 50% Samarium || -
|-
| Fondord || 20% Lanthanum || 80% Samarium || -
|-
| Pirelapperots || 40% Thorium || 40% Samarium || 20% Terbium
|-
| Gallinstent || 50% Samarium || 50% Terbium || -
|-
| Naldors || 20% Samarium || 80% Terbium || -
|-
| Randix || 40% Neodymium || 40% Terbium || 20% Erbium
|-
| Defegustical || 50% Terbium || 50% Erbium || -
|-
| Oppingeast || 20% Terbium || 80% Erbium || -
|-
| Norsents || 40% Chromium || 40% Erbium || 20% Yttrium
|-
| Janeroces || 50% Erbium || 50% Yttrium || -
|-
| Tronnegated || 20% Erbium || 80% Yttrium || -
|-
| Spikover || 40% Uranium || 40% Yttrium || 20% Dysprosium
|-
| Pacizantry || 50% Yttrium || 50% Dysprosium || -
|-
| Sponiansumble || 20% Yttrium || 80% Dysprosium || -
|-
| Toportienative || 40% Lanthanum || 40% Dysprosium || 20% Unobtanium
|-
| Contairily || 50% Dysprosium || 50% Unobtanium || -
|-
| Ganishare || 20% Dysprosium || 80% Unobtanium || -

|}

[[Category:Warzone Idle]]

Mod Developers Guide

2023-10-10T13:16:29Z

JK 3: Added link to Lua extension for VS Code

This page describes information necessary for making [[Mods]].

This guide assumes that you know the Lua programming language. If you've worked with other languages, such as Javascript, Lua should be very easy to learn. Many tutorials are available on the internet if you search for them.

Note that you must be a Warzone [[member]] to develop mods, as mods are a member feature.

== Getting started creating a mod ==

There are two ways to load mod code into Warzone: Using the Standalone Client, or directly uploading from your editor. Uploading from your editor is the preferred way since it allows for more rapid iteration. However, it also requires an extension to your editor, which only exists for VS Code. If you want to develop from an editor other than VS Code, or if you want to develop without an active internet connection, you should use the Standalone Client method.

=== Developing with the Standalone Client ===

# Open the page https://www.warzone.com/EnableModDevelopment to enable mod development for your Warzone account.
# Download the [[Standalone Client]] and run it.
# Obtain the source code to an example mod, such as the Randomized Wastelands Mod from https://github.com/FizzerWL/ExampleMods/tree/master/RandomizedWastelandsMod. Download the lua files to a folder on your device. (The easiest way is to use Github's "Download zip" button if you're not a git user)
# Launch the Standalone Client, sign in. Click the "Mod Development Console" button. You can also use the hotkey Ctrl+Shift+M to bring up this dialog any time, and also note that this dialog can be docked to sides of your screen if you wish.
# Click the "Create New Mod" button and give your mod a name.
# Provide path to your folder with lua files that you downloaded in step 3.
# Click Submit to create the mod.
# From the single-player main menu, click "Custom Game", then scroll down and click Change Mods.
# You should see the mod you created here. Check the box to turn it on and click Submit.
# If you've cloned the Randomized Wastelands mod, you'll also need to turn on wastelands if you want it to do anything. You can also turn off fog to more easily see its effects. Create the game, and see the wastelands be adjusted!

Now you can make modifications to the lua code, press the "Reload code" button and try them out!

=== Developing with direct upload from your editor ===

# Open the page https://www.warzone.com/EnableModDevelopment to enable mod development for your Warzone account.
# Install VS Code from https://code.visualstudio.com/
# Obtain the source code to an example mod, such as the Randomized Wastelands Mod from https://github.com/FizzerWL/ExampleMods/tree/master/RandomizedWastelandsMod. Download the lua files to a folder on your device. (The easiest way is to use Github's "Download zip" button if you're not a git user)
# Download the Warzone Mod Helper VS Code extension VSIX file from https://github.com/FizzerWL/WarzoneModHelper/releases. Install it by launching VS Code, pressing Ctrl+Shift+P, entering "Install from VSIX" and selecting the VSIX file you downloaded.
# (optional) Install the Lua IDE extension: https://marketplace.visualstudio.com/items?itemName=sumneko.lua
# Open the Mod Development Console at https://www.warzone.com/Mods/Develop
# Click the "Create New Mod" button and give your mod a name. Ensure the "Development" box is checked. After creating it, make note of your Mod ID.
# In VS Code, open the RandomizedWastelandsMod folder you downloaded earlier. Open one of the lua files in this folder.
# Visit https://www.warzone.com/API/GetAPIToken and copy your API Token to the clipboard.
# In VS Code, press Ctrl+Shift+P and select "Upload Mod". Enter your Mod ID you noted earlier, and paste your API Token when prompted. Ensure it says "Mod updated successfully" in the bottom right corner.
# Now that your mod is updated, let's run it. Visit https://www.warzone.com/SinglePlayer?CustomGame=1 and click Change Mods. You should see the mod you created here. Check the box to turn it on and click Submit.
# If you've cloned the Randomized Wastelands mod, you'll also need to turn on wastelands if you want it to do anything. You can also turn off fog to more easily see its effects. Create the game, and see the wastelands be adjusted!

Now you can make modifications to the lua code, press and invoke the "Upload Mod" feature again to try them out!

Be sure to read the rest of this page for essential information on mod development.

== Video Tutorial ==

If you prefer to learn via video, check out this YouTube tutorial on how to make a mod: https://www.youtube.com/watch?v=mwVDv5PXyrg

== Hooks ==

Warzone will call into a mod's lua code using what are called '''hooks'''. For example, it will call a hook named <code>Server_StartGame</code> when a game is beginning and give your mod an opportunity to change things about how the map is set up.

For full details on what hooks are available, see [[Mod Hooks]].

== Sharing code with "require" ==

You can call the "require" function to share code between different lua files.

For example, if you have utility functions in a file named 'Utilities.lua', simply write <code>require('Utilities')</code> at the top of another file to include it (omit the <code>.lua</code>).

Note that all lua files must be in the same directory (subdirectories are currently not supported).

== Printing Output ==

In lua, you can print output with lua's <code>print</code> function. For example: <code>print("Hello, world!")</code>

To see this output, open the Mod Development Console (Ctrl+Shift+M) and click View Mod Output. Then create a single-player game using that mod, and when the print statement runs, you'll see the output appear in this window in real-time.

This is useful to assist in debugging.

In multi-player games, the output of mods that run on the server is currently not viewable anywhere, unless the mod crashes which will display recently printed lines in a report in the Mod Development Console. For this reason, it's easier to debug mods in single-player before moving to multi-player.

== Global State ==

Never assume any state will persist, unless specifically called out in the documentation. For example, don't write to a global variable in one hook and access it in another.

If you try to in a single-player game, you may find that global state does persist. However, don't be tempted to rely on this, since globals are always wiped in multi-player, and globals will also get wiped in single-player if someone saves and re-loads their game. Therefore, ensure you code as if globals will never persist between hook calls, except where expliclty allowed.

== Data Storage ==

Mods can store public, private, or player-specific data within a game. See [[Mod Game Data Storage]] for details.

== Mod Timeout ==

Note that if a game takes more than a minute to advance, the mods will time out and the game will not advance. This time counts all mods enabled for that game combined, so mod authors should work to ensure their mods are efficient as possible.

If a game times out more than 10 times in a row, Warzone will end the game automatically.

== Tips ==

Be sure to test in multi-player! When running Server code in multi-player, your lua code runs on the Warzone server which uses a different lua engine. In theory, everything should be the same, but there is still an opportunity for differences. To ensure everything you're doing works, it's recommended you test in multi-player, not only before you're ready to go public, but also occasionally during your development process.

Note that all mods uploaded to Warzone must use the MIT license, or something equally or more permissable. Any mods without a license specified are assumed to be using MIT.

== See Also ==
* [[Mod API Reference]]
* [[Mod Backwards Compatibility]]
* [[Public Mods]]
* [[Mod Hooks]]
* [[Mod Game Data Storage]]
[[Category:Mod Developers Guide]]

Artifacts

2023-09-27T22:48:58Z

JK 3: Updated ACB/A$B abbreviations

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a (currently incomplete) list of artifacts and their effects.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || A$B || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACB || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || IT || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Hotkeys

2023-07-16T22:11:40Z

JK 3: Remove notes about Unity only, since it also works on browser for quite a while now

Warzone supports a few hotkeys to make navigating the UI easier. Once you get used to the game, these can make playing easier.

==Phase Manipulation==

* '''A''' - While building your turn, you can press the A key to advance to the next phase.
* '''Q''' - While building your turn, you can press the Q key to go back to the previous phase.
* '''Z''' - When done building your turn, you can press the Z key to commit your orders assuming you've advanced to the confirmation phase.

* '''CTRL''' - While in the Attack/Transfer phase, you can hold down '''Control''' to cause clicks to initiate a deployment (just as would happen in the Deployment phase.) Many players prefer to just skip immediately to the Attack/Transfer phase and then deploy using this shortcut. This allows you to issue a deployment and the corresponding attack order at the same time rather than having to do all of your deployments separately from attacks.

==Main Game Elements==
* '''W''' - When watching the latest turn, you can press W as a substitute for clicking the Watch Turn button.
* '''G''' - Shortcut to opening the [[History]] window.
*''' B''' - Shortcut to opening the [[Cards]] window.
* '''P''' and '''M''' - Short for Plus and Minus, these are shortcuts for zooming in and out. These are useful for systems without mousewheel support.
* Escape - Closes any open pop-up windows.
* '''T''' - Shortcut to opening the Chat window. (Multi-player only)
* '''R''' - Clicks the Refresh button. (Multi-player only)
* '''Y''' - Opens the Statistics dialog.
* '''U''' - Opens the Autopilot dialog. (Member only)
* '''C''' - Toggles the Commander box in the attack/transfer dialog.

==History Navigation==

* Left/right arrow keys go forward/backward through history by one turn.
* Up/down arrows keys go forward/backward through history by one order.
* Home key - opens up history to the first turn (or territory distribution in a manual distribution game)
* End key - goes to the last turn (you may also wish to use escape to close history completely)
* Number keys - View perspective as players, or 0 key to view All again.

==Chat Window==
While the chat window is open, you can hold down '''Shift''' or '''Control''' and click any territory on the map to paste its name into the chat edit box.
For bonus names, click on the box that indicates the bonus value.
* '''SHIFT''' - Paste territory or bonus names into the edit box of the '''public''' chat.
* '''CTRL''' ( '''Command''' on a Mac ) - Paste territory or bonus names into the edit box of the '''team-only''' chat. If used in a 1v1 or FFA game, it's pasted in the public chat instead.

To link into '''private chat''', just make sure the main chat box is closed and hold either '''SHIFT''' or '''CTRL / Command''' while clicking a territory. It will go into whatever '''private chat''' window is open.

==Outside of Games==

* '''Ctrl+G''' - Opens the Go-To Dialog, which allows you to go to any game, map, template, etc by Url (Unity only)
* '''Ctrl+Shift+M''' - Opens the Mod Development Dialog (Unity only, mod development must be enabled)
* '''Ctrl+Shift+,''' - Opens the Mod Development Log (Unity only, mod development must be enabled)

[[Category:Gameplay]]

Levels

2023-07-15T10:37:09Z

JK 3: Add commanders to page

By earning [[points]], players can gain '''levels'''. Gaining levels unlocks additional features or [[map]]s that players can use, among other things.

== Levels don't make you stronger ==
The idea of leveling up is familiar to anyone who's played an RPG. However, Warzone’s leveling system has an important distinction: In Warzone, levels don’t actually make you stronger. Warzone is fundamentally a competitive strategy game, and games will always be won or lost based on your strategy alone. Levels will not do anything that gives you an advantage in a game. It’s just as easy for a level 1 player to defeat a level 30 player as it is for a level 40 player.

== Rewards ==
Leveling up unlocks rewards. Once a reward is unlocked, you have it permanently.

{| class="wikitable" width="90%"
|-
! width="5%" | Level
! width="5%" | Points (Delta)
! width="5%" | Points (Sum)
! width="40%" | Reward
|-
| style="text-align:center;" | 2 || style="text-align:right;" | 7,000 || style="text-align:right;" | 7,000 || Can create 6 player games
|-
| style="text-align:center;" | 3 || style="text-align:right;" | 7,300 || style="text-align:right;" | 14,300 || Can join tournaments
|-
| style="text-align:center;" | 4 || style="text-align:right;" | 7,800 || style="text-align:right;" | 22,100 || Can post to the [[forums]] (all except [[Ladder]])
|-
| style="text-align:center;" | 5 || style="text-align:right;" | 8,100 || style="text-align:right;" | 30,200 || Three days of ad-free play
|-
| style="text-align:center;" | 6 || style="text-align:right;" | 8,600 || style="text-align:right;" | 38,800|| Can create 7 player games
|-
| style="text-align:center;" | 7 || style="text-align:right;" | 9,100 || style="text-align:right;" | 47,900|| Can use the [[Statistics Window]]
|-
| style="text-align:center;" | 8 || style="text-align:right;" | 9,500 || style="text-align:right;" | 57,400|| Can include the [[Diplomacy Card]] when creating games
|-
| style="text-align:center;" | 9 || style="text-align:right;" | 10,000 || style="text-align:right;" | 67,400|| Can create 8 player games
|-
| style="text-align:center;" | 10 || style="text-align:right;" | 10,500 || style="text-align:right;" | 77,900|| Can include the [[Emergency Blockade Card]] when creating games
|-
| style="text-align:center;" | 11 || style="text-align:right;" | 11,100 || style="text-align:right;" | 89,000|| Can use [[Open Seat Prerequisites]] when creating games
|-
| style="text-align:center;" | 12 || style="text-align:right;" | 11,700 || style="text-align:right;" | 100,700|| Can create 10 player games
|-
| style="text-align:center;" | 13 || style="text-align:right;" | 12,300 || style="text-align:right;" | 113,000|| Can create [[tournaments]]
|-
| style="text-align:center;" | 14 || style="text-align:right;" | 12,900 || style="text-align:right;" | 125,900|| Can include the [[Airlift Card]] when creating games
|-
| style="text-align:center;" | 15 || style="text-align:right;" | 13,600 || style="text-align:right;" | 139,500|| Can create 12 player games
|-
| style="text-align:center;" | 16 || style="text-align:right;" | 14,300 || style="text-align:right;" | 153,800|| Can use [[vacations]]
|-
| style="text-align:center;" | 17 || style="text-align:right;" | 15,100 || style="text-align:right;" | 168,900|| Can include the [[Sanctions Card]] when creating games
|-
| style="text-align:center;" | 18 || style="text-align:right;" | 15,900 || style="text-align:right;" | 184,800|| Can create 14 player games
|-
| style="text-align:center;" | 19 || style="text-align:right;" | 16,700 || style="text-align:right;" | 201,500|| Can use the [[extra armies for territories]] setting when creating games
|-
| style="text-align:center;" | 20 || style="text-align:right;" | 17,600 || style="text-align:right;" | 219,100|| Can change the [[offensive and defensive kill rate]] when creating games
|-
| style="text-align:center;" | 21 || style="text-align:right;" | 18,500 || style="text-align:right;" | 237,600|| Can create 16 player games
|-
| style="text-align:center;" | 22 || style="text-align:right;" | 19,400 || style="text-align:right;" | 257,000|| Can have two created [[tournaments]] at a time
|-
| style="text-align:center;" | 23 || style="text-align:right;" | 20,500 || style="text-align:right;" | 277,500|| Can include the [[spy card]], [[surveillance card]], and [[reconnaissance card]] when creating games
|-
| style="text-align:center;" | 24 || style="text-align:right;" | 21,600 || style="text-align:right;" | 299,100|| Can create 18 player games
|-
| style="text-align:center;" | 25 || style="text-align:right;" | 22,700 || style="text-align:right;" | 321,800|| Can include [[wastelands]] when creating games
|-
| style="text-align:center;" | 26 || style="text-align:right;" | 23,900 || style="text-align:right;" | 345,700|| Can enable the [[attack only and transfer only]] settings when creating games
|-
| style="text-align:center;" | 27 || style="text-align:right;" | 25,100 || style="text-align:right;" | 370,800|| Can create 20 player games
|-
| style="text-align:center;" | 28 || style="text-align:right;" | 26,400 || style="text-align:right;" | 397,200|| Can include the [[blockade card]] when creating games
|-
| style="text-align:center;" | 29 || style="text-align:right;" | 27,900 || style="text-align:right;" | 425,100|| Can take up to 3 [[vacations]] per year
|-
| style="text-align:center;" | 30 || style="text-align:right;" | 29,300 || style="text-align:right;" | 454,400|| Can create 22 player games
|-
| style="text-align:center;" | 31 || style="text-align:right;" | 30,800 || style="text-align:right;" | 485,200|| Can enable the [[local deployments]] setting when creating games
|-
| style="text-align:center;" | 32 || style="text-align:right;" | 32,500 || style="text-align:right;" | 517,700|| Can have up to three created [[tournaments]] at a time
|-
| style="text-align:center;" | 33 || style="text-align:right;" | 34,200 || style="text-align:right;" | 551,900|| Can create 24 player games
|-
| style="text-align:center;" | 34 || style="text-align:right;" | 35,900 || style="text-align:right;" | 587,800|| Can use Dense, Heavy, and Complete [[fog]] levels
|-
| style="text-align:center;" | 35 || style="text-align:right;" | 37,900 || style="text-align:right;" | 625,700|| Can include the [[gift card]] when creating games
|-
| style="text-align:center;" | 36 || style="text-align:right;" | 39,800 || style="text-align:right;" | 665,500|| Can create 26 player games
|-
| style="text-align:center;" | 37 || style="text-align:right;" | 41,900 || style="text-align:right;" | 707,400|| Can enable [[multi-attack]] and [[attack by percentage]] settings when creating games
|-
| style="text-align:center;" | 38 || style="text-align:right;" | 44,200 || style="text-align:right;" | 751,600|| Can have up to four created [[tournaments]] at a time, and use [[commanders]] when creating games
|-
| style="text-align:center;" | 39 || style="text-align:right;" | 46,400 || style="text-align:right;" | 798,000|| Can create 28 player games
|-
| style="text-align:center;" | 40 || style="text-align:right;" | 48,900 || style="text-align:right;" | 846,900|| Can enable [[no-split mode]] when creating games
|-
| style="text-align:center;" | 41 || style="text-align:right;" | 51,400 || style="text-align:right;" | 898,300|| Can include the [[order priority card]] and [[order delay card]] when creating games
|-
| style="text-align:center;" | 42 || style="text-align:right;" | 54,100 || style="text-align:right;" | 952,400|| Can create 30 player games
|-
| style="text-align:center;" | 43 || style="text-align:right;" | 57,000 || style="text-align:right;" | 1,009,400|| Can have up to five created [[tournaments]] at a time
|-
| style="text-align:center;" | 44 || style="text-align:right;" | 60,000 || style="text-align:right;" | 1,069,400|| Can create 32 player games
|-
| style="text-align:center;" | 45 || style="text-align:right;" | 63,100 || style="text-align:right;" | 1,132,500|| Can [[override bonuses]] when creating games
|-
| style="text-align:center;" | 46 || style="text-align:right;" | 66,400 || style="text-align:right;" | 1,198,900|| Can create 34 player games
|-
| style="text-align:center;" | 47 || style="text-align:right;" | 69,900 || style="text-align:right;" | 1,268,800|| Can use [[custom scenarios]] when creating multi-player games
|-
| style="text-align:center;" | 48 || style="text-align:right;" | 73,600 || style="text-align:right;" | 1,342,400|| Can join the [[1 v 1 Ladder]]
|-
| style="text-align:center;" | 49 || style="text-align:right;" | 77,400 || style="text-align:right;" | 1,419,800|| Can take up to 5 [[vacations]] per year
|-
| style="text-align:center;" | 50 || style="text-align:right;" | 81,500 || style="text-align:right;" | 1,501,300|| Can create 36 player games
|-
| style="text-align:center;" | 51 || style="text-align:right;" | 85,800 || style="text-align:right;" | 1,587,100|| Can join the [[2 v 2 Ladder]]
|-
| style="text-align:center;" | 52 || style="text-align:right;" | 90,300 || style="text-align:right;" | 1,677,400 || Can join the [[Seasonal Ladder]]
|-
| style="text-align:center;" | 53 || style="text-align:right;" | 95,000 || style="text-align:right;" | 1,772,400 || Can create 40 player games
|-
| style="text-align:center;" | 54 || style="text-align:right;" | 100,000 || style="text-align:right;" | 1,872,400 || Can join the [[3 v 3 Ladder]]
|-
| style="text-align:center;" | 55 || style="text-align:right;" | 220,400 || style="text-align:right;" | 2,092,800 || -
|-
| style="text-align:center;" | 56 || style="text-align:right;" | 479,000 || style="text-align:right;" | 2,571,800 || -
|-
| style="text-align:center;" | 57 || style="text-align:right;" | 830,600 || style="text-align:right;" | 3,402,400 || -
|-
| style="text-align:center;" | 58 || style="text-align:right;" | 1,308,400 || style="text-align:right;" | 4,710,900 || -
|-
| style="text-align:center;" | 59 || style="text-align:right;" | 1,957,900 || style="text-align:right;" | 6,668,800 || -
|-
| style="text-align:center;" | 60 || style="text-align:right;" | 2,840,700 || style="text-align:right;" | 9,509,500 || -
|-
| style="text-align:center;" | 61 || style="text-align:right;" | 4,040,300 || style="text-align:right;" | 13,549,800 || -
|-
| style="text-align:center;" | 62 || style="text-align:right;" | 5,670,900 || style="text-align:right;" | 19,220,700 || -
|-
| style="text-align:center;" | 63 || style="text-align:right;" | 7,886,900 || style="text-align:right;" | 27,107,600 || -
|-
| style="text-align:center;" | 64 || style="text-align:right;" | 10,898,900 || style="text-align:right;" | 38,006,500 || -
|-
| style="text-align:center;" | 65 || style="text-align:right;" | 14,992,400 || style="text-align:right;" | 52,998,900 || -
|-
| style="text-align:center;" | 66 || style="text-align:right;" | 20,556,000 || style="text-align:right;" | 73,554,900 || -
|-
| style="text-align:center;" | 67 || style="text-align:right;" | 28,117,800 || style="text-align:right;" | 101,672,700 || -
|-
| style="text-align:center;" | 68 || style="text-align:right;" | 38,394,900 || style="text-align:right;" | 140,067,600 || -
|-
| style="text-align:center;" | 69 || style="text-align:right;" | 52,362,900 || style="text-align:right;" | 192,430,500 || -
|}

== Map Levels ==
By gaining levels, players can gain access to additional maps. Players only need access to a map in order to ''create'' games or tournaments on that map. If they are invited to a game or tournament, they can always join it no matter what level they are.

Map creators are in full control of what level their maps unlock. As a map creator, you can log into your map at any time, click the "Edit Name/Description" button and set the level. You can do this even after it's public. If you want your map available to everyone regardless of their level, you can just set your map to level 1 and everyone will be able to use it.

The advantage of setting a level to your map is increased visibility. For example, if you set your map to level 10, whenever someone levels up to 10 it'll pop up a message on their screen letting them know they've unlocked your map. For best visibility, you should try to set your map to a level that has few other maps assigned to it (or at least, where your map is rated more highly than the others at that level.)

== See also ==
* [[Points]]
* [[Hidden settings]]

Artifacts

2023-06-11T12:05:49Z

JK 3: added IT for idle time

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a (currently incomplete) list of artifacts and their effects.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || IT || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Mod API Reference

2023-05-29T17:55:41Z

JK 3: Fixed GameOrderCustom reference

This explains how to use Warzone's [[Mods|mod]] API and links to the documentation for each object type.

== Types ==

When writing a mod, you'll encounter variables/objects of three basic types:
* Primitives: strings, numbers, booleans, etc.
* Tables: collections of key/value pairs. A table is a lot like a hashmap or dictionary in other languages. Note that in Warzone, the key of a table will always be either a string or an integer. Some places in this reference will refer to Arrays which are just tables with numeric keys starting at 1.
* Proxy objects: Discussed in the next section.

== Proxy Objects ==

A '''proxy object''' proxies information back and forth between your mod and Warzone. You can tell if an object is a proxy object by looking for a <code>proxyType</code> field. All proxy objects always have the following fields:

* proxyType: A string identifying the type of proxy object.
* readOnly: False if you're allowed to make changes to this proxy object, or true if it's read-only.
* readableKeys: An array containing all fields you're allowed to read from this object.
* writableKeys: An array containing all fields you're allowed to change on this object if readOnly is False.

To read a field, simply read it like a property: <code>obj.field</code>. Similarly, to write to a proxy object, just assign to that field: <code>obj.field = newVal</code>.

Here's a handy function you can include in your mod to print out everything on a proxy object:
function PrintProxyInfo(obj)
print('type=' .. obj.proxyType .. ' readOnly=' .. tostring(obj.readonly) .. ' readableKeys=' .. table.concat(obj.readableKeys, ',') .. ' writableKeys=' .. table.concat(obj.writableKeys, ','));
end

== Writing Tables ==

If a writable Warzone proxy object exposes a table, and you wish to make changes to that table, you must assign the table back to the proxy object. For example, assume you have a <code>GameStanding</code> object named <code>standing</code> which exposes the <code>Cards</code> table, and you want to add something at index 9:

standing.Cards[9] = something --WRONG!

This code won't work since the proxy object isn't having anything assigned to it. Proxy objects are only aware of changes when something is directly assigned into them. To make this work, you must assign the table into the proxy object's field:
local cards = standing.Cards
cards[9] = something
standing.Cards = cards; --Right

Note: If you use lua's <code>type</code> function, proxy objects will identify themselves as tables. However, that should be considered an implementation detail. For the purposes of this wiki, proxy objects aren't considered tables.

== API Reference ==

* [[Mod API Reference:ActiveCard|ActiveCard]]
* [[Mod API Reference:ActiveCardWoreOff|ActiveCardWoreOff]]
* [[Mod API Reference:Armies|Armies]]
* [[Mod API Reference:BonusDetails|BonusDetails]]
* [[Mod API Reference:Boss1|Boss1]]
* [[Mod API Reference:Boss2|Boss2]]
* [[Mod API Reference:Boss3|Boss3]]
* [[Mod API Reference:Boss4|Boss4]]
* [[Mod API Reference:CardGame|CardGame]]
* [[Mod API Reference:CardGameAbandon|CardGameAbandon]]
* [[Mod API Reference:CardGameAirlift|CardGameAirlift]]
* [[Mod API Reference:CardGameBlockade|CardGameBlockade]]
* [[Mod API Reference:CardGameBomb|CardGameBomb]]
* [[Mod API Reference:CardGameDiplomacy|CardGameDiplomacy]]
* [[Mod API Reference:CardGameGift|CardGameGift]]
* [[Mod API Reference:CardGameOrderDelay|CardGameOrderDelay]]
* [[Mod API Reference:CardGameOrderPriority|CardGameOrderPriority]]
* [[Mod API Reference:CardGameReconnaissance|CardGameReconnaissance]]
* [[Mod API Reference:CardGameReinforcement|CardGameReinforcement]]
* [[Mod API Reference:CardGameSanctions|CardGameSanctions]]
* [[Mod API Reference:CardGameSpy|CardGameSpy]]
* [[Mod API Reference:CardGameSurveillance|CardGameSurveillance]]
* [[Mod API Reference:CardInstance|CardInstance]]
* [[Mod API Reference:ClanPlayerInfo|ClanPlayerInfo]]
* [[Mod API Reference:ClientGame|ClientGame]]
* [[Mod API Reference:Commander|Commander]]
* [[Mod API Reference:CustomScenario|CustomScenario]]
* [[Mod API Reference:CustomScenarioTerritory|CustomScenarioTerritory]]
* [[Mod API Reference:DistributionMode|DistributionMode]]
* [[Mod API Reference:Game|Game]]
* [[Mod API Reference:GameColor|GameColor]]
* [[Mod API Reference:GameOpenSeat|GameOpenSeat]]
* [[Mod API Reference:GameOrder|GameOrder]]
* [[Mod API Reference:GameOrderAttackTransfer|GameOrderAttackTransfer]]
* [[Mod API Reference:GameOrderAttackTransferResult|GameOrderAttackTransferResult]]
* [[Mod API Reference:GameOrderBossEvent|GameOrderBossEvent]]
* [[Mod API Reference:GameOrderCustom|GameOrderCustom]]
* [[Mod API Reference:GameOrderDeploy|GameOrderDeploy]]
* [[Mod API Reference:GameOrderDiscard|GameOrderDiscard]]
* [[Mod API Reference:GameOrderEvent|GameOrderEvent]]
* [[Mod API Reference:GameOrderPlayCard|GameOrderPlayCard]]
* [[Mod API Reference:GameOrderPlayCardAbandon|GameOrderPlayCardAbandon]]
* [[Mod API Reference:GameOrderPlayCardAirlift|GameOrderPlayCardAirlift]]
* [[Mod API Reference:GameOrderPlayCardAirliftResult|GameOrderPlayCardAirliftResult]]
* [[Mod API Reference:GameOrderPlayCardBlockade|GameOrderPlayCardBlockade]]
* [[Mod API Reference:GameOrderPlayCardBomb|GameOrderPlayCardBomb]]
* [[Mod API Reference:GameOrderPlayCardDiplomacy|GameOrderPlayCardDiplomacy]]
* [[Mod API Reference:GameOrderPlayCardFogged|GameOrderPlayCardFogged]]
* [[Mod API Reference:GameOrderPlayCardGift|GameOrderPlayCardGift]]
* [[Mod API Reference:GameOrderPlayCardOrderDelay|GameOrderPlayCardOrderDelay]]
* [[Mod API Reference:GameOrderPlayCardOrderPriority|GameOrderPlayCardOrderPriority]]
* [[Mod API Reference:GameOrderPlayCardReconnaissance|GameOrderPlayCardReconnaissance]]
* [[Mod API Reference:GameOrderPlayCardReinforcement|GameOrderPlayCardReinforcement]]
* [[Mod API Reference:GameOrderPlayCardSanctions|GameOrderPlayCardSanctions]]
* [[Mod API Reference:GameOrderPlayCardSpy|GameOrderPlayCardSpy]]
* [[Mod API Reference:GameOrderPlayCardSurveillance|GameOrderPlayCardSurveillance]]
* [[Mod API Reference:GameOrderReceiveCard|GameOrderReceiveCard]]
* [[Mod API Reference:GameOrderStateTransition|GameOrderStateTransition]]
* [[Mod API Reference:GamePlayer|GamePlayer]]
* [[Mod API Reference:GameSettings|GameSettings]]
* [[Mod API Reference:GameStanding|GameStanding]]
* [[Mod API Reference:GameWL|GameWL]]
* [[Mod API Reference:IncomeMod|IncomeMod]]
* [[Mod API Reference:IsVersionOrHigher|IsVersionOrHigher]]
* [[Mod API Reference:MapDetails|MapDetails]]
* [[Mod API Reference:MapFamily|MapFamily]]
* [[Mod API Reference:NoParameterCardInstance|NoParameterCardInstance]]
* [[Mod API Reference:PendingStateTransition|PendingStateTransition]]
* [[Mod API Reference:PlayerCards|PlayerCards]]
* [[Mod API Reference:PlayerInfo2|PlayerInfo2]]
* [[Mod API Reference:ReinforcementCardInstance|ReinforcementCardInstance]]
* [[Mod API Reference:ServerGame|ServerGame]]
* [[Mod API Reference:SpecialUnit|SpecialUnit]]
* [[Mod API Reference:TerritoryConnection|TerritoryConnection]]
* [[Mod API Reference:TerritoryDetails|TerritoryDetails]]
* [[Mod API Reference:TerritoryModification|TerritoryModification]]
* [[Mod API Reference:TerritoryStanding|TerritoryStanding]]
* [[Mod API Reference:UI|UI]]
[[Category:Mod Developers Guide]][[Category:Mod API Reference]]

Query game API

2023-05-25T15:58:11Z

JK 3: Updated Settings parameter and added GetChat

Warzone can provide programmatic access to the details about multi-player Warzone games. This allows for the more technical users to write a program that can analyze information about games. This data is only available for ladder games, tournament games, games created by the [[Create game API]], or games that you played in.

There's nothing the feed can see that isn't already available through the game's normal interface. This is just a way to write custom analyzers which allows for a broader analysis across games.

The primary goals of this API is to enable tools that do statistical analysis of finished games and to enable custom ladders or custom tournaments to check on the winners of the game after it's over.

==Usage==

To access the data, use a URL like this: https://www.warzone.com/API/GameFeed?GameID=1212978

This will return data describing basic details(id, state, name, numberOfTurns, lastTurnTime, templateID, players) about the game.

If you want to get the entire turn history of the game, add an additional querystring parameter '''GetHistory=true'''. Adding this will cause the API to return you details about every turn of the game assuming it's finished.

If you want to get a game's settings, add an additional querystring parameter '''Settings=true'''. Adding this will cause the API to return you details about the settings of the game.

If you want to get a game's public chat message, add an additional querystring parameter '''GetChat=true'''.

==JSON Definition==

* A '''standing''' is the state of the board at any given point in time. This contains one entry per territory that contains the number of armies on that territory, who controls it, and the fog level.
* A '''turn''' is just a collection of orders. This includes all the orders each player submitted, mixed together in the sequence they played out.
* An '''order''' is obviously one order that a player submitted. But it can also include other things, such notifications when a player gets eliminated, or when cards are received, etc. Essentially, this represents what you see in the '''Orders''' panel on the right side of a game when viewing history.
In the JSON, you'll find:
* The players in the game (their names, color, their state, etc.)
* All of the details of the map (it's name, all of its territories and what they connect to, all of its bonuses and what territories are in each bonus)
* The '''distribution standing''': This is what the map looked like when it was time to pick the territories you started with. This is only present for manual distribution games.
* The picks: This tells you which territories each player picked, and in what order. Like the distribution standing, this is only present for manual distribution games.
* Standing 0: This tells you what the map looked like at the beginning of the game.
* Turn 0: This is all of the orders that played out on the first turn of the game.
* Standing x/turn x: Standings and turns then alternate for each turn of the game, all the way until the final standing.

== Game State ==

This API returns a "state" attribute on the game. This will be one of the following values:
* WaitingForPlayers: This game is in the lobby and has not yet begun.
* DistributingTerritories: This game is waiting for players to make their territory selections. This state will not exist for games with automatic distribution.
* Playing: The game is in progress.
* Finished: The game has finished.

== Player States ==

This API returns a "players" collection which contains information about each player in the game. Each player will have a "state" attribute with one of the following values:
* Invited: The game is waiting on this player to accept or decline the game. This state will only ever be present for games still in the lobby.
* Playing: This player is in the game, and still alive. This state will never be present in a game that has finished.
* Eliminated: This player has been eliminated from the game.
* SurrenderAccepted: This player has surrendered and is no longer in the game.
* Booted: This player was booted from the game.
* Won: This player has won the game. This state will only be present in games that have finished.
* EndedByVote: This player, along with the other remaining players in the game, have voted to end the game. This state will only ever be present for games that are finished by voting-to-end.
* Declined: This player declined the game and did not play.
* RemovedByHost: This player was removed by the host via the "Add/Remove Players" button and did not play. If you created the game via the Create Game API, you don't have to worry about this state since you're the host, and only you could remove players.

==Getting a list of Game IDs==

In order to use the game feed, you'll need to know the game ID. This can be obtained through the graphical Warzone client by opening up the Settings panel and examining the "Link to Game" field. At the end of this field, you'll see GameID= followed by a number.

To find game IDs programmatically, you can use the [[Game ID feed API]].

==See Also==

* [[Game ID feed API]]

[[Category:API]]

Mod API Reference

2023-04-16T22:13:11Z

JK 3: Added GameOrderCustom

This explains how to use Warzone's [[Mods|mod]] API and links to the documentation for each object type.

== Types ==

When writing a mod, you'll encounter variables/objects of three basic types:
* Primitives: strings, numbers, booleans, etc.
* Tables: collections of key/value pairs. A table is a lot like a hashmap or dictionary in other languages. Note that in Warzone, the key of a table will always be either a string or an integer. Some places in this reference will refer to Arrays which are just tables with numeric keys starting at 1.
* Proxy objects: Discussed in the next section.

== Proxy Objects ==

A '''proxy object''' proxies information back and forth between your mod and Warzone. You can tell if an object is a proxy object by looking for a <code>proxyType</code> field. All proxy objects always have the following fields:

* proxyType: A string identifying the type of proxy object.
* readOnly: False if you're allowed to make changes to this proxy object, or true if it's read-only.
* readableKeys: An array containing all fields you're allowed to read from this object.
* writableKeys: An array containing all fields you're allowed to change on this object if readOnly is False.

To read a field, simply read it like a property: <code>obj.field</code>. Similarly, to write to a proxy object, just assign to that field: <code>obj.field = newVal</code>.

Here's a handy function you can include in your mod to print out everything on a proxy object:
function PrintProxyInfo(obj)
print('type=' .. obj.proxyType .. ' readOnly=' .. tostring(obj.readonly) .. ' readableKeys=' .. table.concat(obj.readableKeys, ',') .. ' writableKeys=' .. table.concat(obj.writableKeys, ','));
end

== Writing Tables ==

If a writable Warzone proxy object exposes a table, and you wish to make changes to that table, you must assign the table back to the proxy object. For example, assume you have a <code>GameStanding</code> object named <code>standing</code> which exposes the <code>Cards</code> table, and you want to add something at index 9:

standing.Cards[9] = something --WRONG!

This code won't work since the proxy object isn't having anything assigned to it. Proxy objects are only aware of changes when something is directly assigned into them. To make this work, you must assign the table into the proxy object's field:
local cards = standing.Cards
cards[9] = something
standing.Cards = cards; --Right

Note: If you use lua's <code>type</code> function, proxy objects will identify themselves as tables. However, that should be considered an implementation detail. For the purposes of this wiki, proxy objects aren't considered tables.

== API Reference ==

* [[Mod API Reference:ActiveCard|ActiveCard]]
* [[Mod API Reference:ActiveCardWoreOff|ActiveCardWoreOff]]
* [[Mod API Reference:Armies|Armies]]
* [[Mod API Reference:BonusDetails|BonusDetails]]
* [[Mod API Reference:Boss1|Boss1]]
* [[Mod API Reference:Boss2|Boss2]]
* [[Mod API Reference:Boss3|Boss3]]
* [[Mod API Reference:Boss4|Boss4]]
* [[Mod API Reference:CardGame|CardGame]]
* [[Mod API Reference:CardGameAbandon|CardGameAbandon]]
* [[Mod API Reference:CardGameAirlift|CardGameAirlift]]
* [[Mod API Reference:CardGameBlockade|CardGameBlockade]]
* [[Mod API Reference:CardGameBomb|CardGameBomb]]
* [[Mod API Reference:CardGameDiplomacy|CardGameDiplomacy]]
* [[Mod API Reference:CardGameGift|CardGameGift]]
* [[Mod API Reference:CardGameOrderDelay|CardGameOrderDelay]]
* [[Mod API Reference:CardGameOrderPriority|CardGameOrderPriority]]
* [[Mod API Reference:CardGameReconnaissance|CardGameReconnaissance]]
* [[Mod API Reference:CardGameReinforcement|CardGameReinforcement]]
* [[Mod API Reference:CardGameSanctions|CardGameSanctions]]
* [[Mod API Reference:CardGameSpy|CardGameSpy]]
* [[Mod API Reference:CardGameSurveillance|CardGameSurveillance]]
* [[Mod API Reference:CardInstance|CardInstance]]
* [[Mod API Reference:ClanPlayerInfo|ClanPlayerInfo]]
* [[Mod API Reference:ClientGame|ClientGame]]
* [[Mod API Reference:Commander|Commander]]
* [[Mod API Reference:CustomScenario|CustomScenario]]
* [[Mod API Reference:CustomScenarioTerritory|CustomScenarioTerritory]]
* [[Mod API Reference:DistributionMode|DistributionMode]]
* [[Mod API Reference:Game|Game]]
* [[Mod API Reference:GameColor|GameColor]]
* [[Mod API Reference:GameOpenSeat|GameOpenSeat]]
* [[Mod API Reference:GameOrder|GameOrder]]
* [[Mod API Reference:GameOrderAttackTransfer|GameOrderAttackTransfer]]
* [[Mod API Reference:GameOrderAttackTransferResult|GameOrderAttackTransferResult]]
* [[Mod API Reference:GameOrderBossEvent|GameOrderBossEvent]]
* [[Mod API Reference:GameOrderDeploy|GameOrderCustom]]
* [[Mod API Reference:GameOrderDeploy|GameOrderDeploy]]
* [[Mod API Reference:GameOrderDiscard|GameOrderDiscard]]
* [[Mod API Reference:GameOrderEvent|GameOrderEvent]]
* [[Mod API Reference:GameOrderPlayCard|GameOrderPlayCard]]
* [[Mod API Reference:GameOrderPlayCardAbandon|GameOrderPlayCardAbandon]]
* [[Mod API Reference:GameOrderPlayCardAirlift|GameOrderPlayCardAirlift]]
* [[Mod API Reference:GameOrderPlayCardAirliftResult|GameOrderPlayCardAirliftResult]]
* [[Mod API Reference:GameOrderPlayCardBlockade|GameOrderPlayCardBlockade]]
* [[Mod API Reference:GameOrderPlayCardBomb|GameOrderPlayCardBomb]]
* [[Mod API Reference:GameOrderPlayCardDiplomacy|GameOrderPlayCardDiplomacy]]
* [[Mod API Reference:GameOrderPlayCardFogged|GameOrderPlayCardFogged]]
* [[Mod API Reference:GameOrderPlayCardGift|GameOrderPlayCardGift]]
* [[Mod API Reference:GameOrderPlayCardOrderDelay|GameOrderPlayCardOrderDelay]]
* [[Mod API Reference:GameOrderPlayCardOrderPriority|GameOrderPlayCardOrderPriority]]
* [[Mod API Reference:GameOrderPlayCardReconnaissance|GameOrderPlayCardReconnaissance]]
* [[Mod API Reference:GameOrderPlayCardReinforcement|GameOrderPlayCardReinforcement]]
* [[Mod API Reference:GameOrderPlayCardSanctions|GameOrderPlayCardSanctions]]
* [[Mod API Reference:GameOrderPlayCardSpy|GameOrderPlayCardSpy]]
* [[Mod API Reference:GameOrderPlayCardSurveillance|GameOrderPlayCardSurveillance]]
* [[Mod API Reference:GameOrderReceiveCard|GameOrderReceiveCard]]
* [[Mod API Reference:GameOrderStateTransition|GameOrderStateTransition]]
* [[Mod API Reference:GamePlayer|GamePlayer]]
* [[Mod API Reference:GameSettings|GameSettings]]
* [[Mod API Reference:GameStanding|GameStanding]]
* [[Mod API Reference:GameWL|GameWL]]
* [[Mod API Reference:IncomeMod|IncomeMod]]
* [[Mod API Reference:IsVersionOrHigher|IsVersionOrHigher]]
* [[Mod API Reference:MapDetails|MapDetails]]
* [[Mod API Reference:MapFamily|MapFamily]]
* [[Mod API Reference:NoParameterCardInstance|NoParameterCardInstance]]
* [[Mod API Reference:PendingStateTransition|PendingStateTransition]]
* [[Mod API Reference:PlayerCards|PlayerCards]]
* [[Mod API Reference:PlayerInfo2|PlayerInfo2]]
* [[Mod API Reference:ReinforcementCardInstance|ReinforcementCardInstance]]
* [[Mod API Reference:ServerGame|ServerGame]]
* [[Mod API Reference:SpecialUnit|SpecialUnit]]
* [[Mod API Reference:TerritoryConnection|TerritoryConnection]]
* [[Mod API Reference:TerritoryDetails|TerritoryDetails]]
* [[Mod API Reference:TerritoryModification|TerritoryModification]]
* [[Mod API Reference:TerritoryStanding|TerritoryStanding]]
* [[Mod API Reference:UI|UI]]
[[Category:Mod Developers Guide]][[Category:Mod API Reference]]

Mod API Reference:GameSettings

2023-04-07T20:10:20Z

JK 3: Removed IsCustomCoinGame key since using it gives missing key errors

'''GameSettings''': All settings the game was started with. These are never changed once the game is created.
* '''AIsSurrenderWhenOneHumanRemains''' ''boolean'':
* '''AllowAttackOnly''' ''boolean'':
* '''AllowPercentageAttacks''' ''boolean'':
* '''AllowTransferOnly''' ''boolean'':
* '''AllowVacations''' ''boolean'':
* '''ArmyCap''' ''[[Mod API Reference:Nullable|Nullable]]<number>'':
* '''AtStartDivideIntoTeamsOf''' ''integer'':
* '''AutoBootEnabled''' ''boolean'':
* '''AutoBootTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''AutoForceJoinTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''AutomaticTerritoryDistribution''' ''boolean'':
* '''AutoStartGame''' ''boolean'':
* '''BankDuration''' ''integer'':
* '''BankingBootTimes''' ''[[Mod API Reference:Nullable|Nullable]]<integer>'':
* '''BonusArmyPer''' ''integer'':
* '''BootedPlayersTurnIntoAIs''' ''boolean'':
* '''CardHoldingsAndReceivesFogged''' ''boolean'':
* '''CardPlayingsFogged''' ''boolean'':
* '''Cards''' ''Table<[[Mod API Reference:CardID|CardID]],[[Mod API Reference:CardGame|CardGame]]>'':
* '''CoinEntryFee''' ''integer'':
* '''CoinPrize''' ''integer'':
* '''Commanders''' ''boolean'':
* '''CommerceArmyCostMultiplier''' ''[[Mod API Reference:Nullable|Nullable]]<integer>'':
* '''CommerceCityBaseCost''' ''[[Mod API Reference:Nullable|Nullable]]<integer>'':
* '''CommerceGame''' ''boolean'':
* '''Created''' ''[[Mod API Reference:DateTime|DateTime]]'':
* '''CustomScenario''' ''[[Mod API Reference:CustomScenario|CustomScenario]]'':
* '''DefenseKillRate''' ''number'':
* '''DirectBootTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''DirectBootTimeSummaryString''' ''string'':
* '''DistributionModeID''' ''[[Mod API Reference:DistributionID|DistributionID]]'':
* '''FogLevel''' ''[[Mod API Reference:GameFogLevel|GameFogLevel]] (enum)'':
* '''ForceJoinTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''HasAnySortOfFog''' ''boolean'':
* '''HasSpecialUnits''' ''boolean'':
* '''InitialBank''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''InitialNeutralsInDistribution''' ''integer'':
* '''InitialNonDistributionArmies''' ''integer'':
* '''InitialPlayerArmiesPerTerritory''' ''integer'':
* '''InstantSurrender''' ''boolean'':
* '''IsArchived''' ''boolean'':
* '''IsCoinsGame''' ''boolean'':
* '''IsTournamentLadderQuickmatchOrClanWar''' ''boolean'':
* '''KillRatesAreModified''' ''boolean'':
* '''LadderID''' ''[[Mod API Reference:Nullable|Nullable]]<[[Mod API Reference:LadderID|LadderID]]>'':
* '''LimitDistributionTerritories''' ''integer'':
* '''LocalDeployments''' ''boolean'':
* '''LuckModifier''' ''number'':
* '''MapID''' ''[[Mod API Reference:MapID|MapID]]'':
* '''MapTestingGame''' ''boolean'':
* '''MaxCardsHold''' ''integer'':
* '''MinimumArmyBonus''' ''integer'':
* '''MinimumBootTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''MinimumVersionRequired''' ''integer'':
* '''MoveOrder''' ''[[Mod API Reference:MoveOrderEnum|MoveOrderEnum]] (enum)'':
* '''MultiAttack''' ''boolean'':
* '''MultiPlayer''' ''boolean'':
* '''Name''' ''string'':
* '''NoSplit''' ''boolean'':
* '''NumberOfCardsToReceiveEachTurn''' ''integer'':
* '''NumberOfWastelands''' ''integer'':
* '''OffenseKillRate''' ''number'':
* '''OneArmyMustStandGuardOneOrZero''' ''integer'':
* '''OneArmyStandsGuard''' ''boolean'':
* '''OverriddenBonuses''' ''Table<[[Mod API Reference:BonusID|BonusID]],integer>'':
* '''PersonalMessage''' ''string'':
* '''PrivateMessaging''' ''boolean'':
* '''RankedGame''' ''boolean'':
* '''RealTimeGame''' ''boolean'':
* '''RoundingMode''' ''[[Mod API Reference:RoundingModeEnum|RoundingModeEnum]] (enum)'':
* '''SinglePlayer''' ''boolean'':
* '''StartedBy''' ''[[Mod API Reference:Nullable|Nullable]]<[[Mod API Reference:PlayerID|PlayerID]]>'':
* '''StartedByInfo''' ''[[Mod API Reference:PlayerInfo2|PlayerInfo2]]'':
* '''SurrenderedPlayersTurnIntoAIs''' ''boolean'':
* '''TemplateIDUsed''' ''[[Mod API Reference:Nullable|Nullable]]<[[Mod API Reference:TemplateID|TemplateID]]>'':
* '''TemplateName''' ''string'':
* '''TimesCanComeBackFromAI''' ''integer'':
* '''TournamentID''' ''[[Mod API Reference:Nullable|Nullable]]<integer>'':
* '''VoteBootTime''' ''[[Mod API Reference:TimeSpan|TimeSpan]]'':
* '''WastelandSize''' ''integer'':
[[Category:Mod API Reference]]

Idle FAQ

2023-01-29T19:30:14Z

JK 3: Added link to artifact abriviation page

'''Frequently Asked Questions''' about [[Warzone Idle]]

== How can I inspect a territory without conquering it? ==

Inspect one of its neighbors, such as a territory you own or a fogged territory, then click "connections list" and select it from the list.

== Why is it slow? ==

Warzone Idle is meant to be played in short sessions throughout your day, not in one sitting. Feel free to take a break, and come back in an hour or two. Your armies will accumulate even when you're offline.

== Yes, but even then it's taking forever! ==

Be sure to upgrade your army camps! Army camps are where you will get most of your armies. Also be sure to get the techs that increase your army camp production, and purchase all mercenaries.

If you can't afford to do all this, see the next question.

== What does AV (or any other abbreviation) mean? ==

It's probably referring to an artifact, see [[Artifacts]] for more info.

== How do I get money faster? ==

You'll get most of your money by selling items that are made by your crafters. Be sure to keep your smelters and crafters active -- anytime they are waiting for resources, you are losing out on potential money. In general, the longer it takes to craft an item, the better investment it is, so try to keep your crafters on the slowest recipes as much as possible.

Be sure to sell off any items or ore that you don't need for techs or your smelters. Selling stuff is important for maximizing money generation.

== Why is there waiting? ==

The recommended way to play is to check in every once in a while and re-invest your profits while you're doing other stuff. With this strategy, there's virtually no waiting involved in playing Warzone Idle.

== Increased Money From Territories didn't increase my income as much as advertised ==

Not all of your money/sec comes from territories -- some of it comes from bonuses. If you get the Statistics advancement, you can easily see how much of your money comes from territories versus bonuses.

If you don't have the Statistics advancement yet, you can get an idea of where your money is coming from by clicking around the map. Territories and Bonuses will identify themselves in the inspect area at the bottom, and each will say how much money per second they generate.

== Army Camp upgrade didn't increase my armies/sec as much as advertised ==

Some increases are added together, not multiplied. For example, say you're getting 100 armies per second, and you get an upgrade of 10%. Now you're getting 110 armies per second. Then you get another upgrade of 10%, it makes your total increase 20% bringing your armies per second to 120. But if you look only at that second upgrade in isolation, you might be confused on why 110 to 120 isn't quite 10%. The answer is because the upgrades are added together with your previous upgrades, not multiplied.

== I'm out of mercenaries and all I have left to spend money on is army camps! ==

A common mistake players make is buying mercenaries too early.

Think of it this way: You're spending some money on mercenaries and some money on army camp upgrades. Buying mercenaries gives you armies immediately, but buying army camp upgrades gives you armies over time. Therefore, it's far better to do those army camp upgrades first and buy the mercenaries later, so your camp upgrades have more time to produce armies. Upgrading army camps when a level is almost complete is not an efficient plan.

When to buy mercenaries is a balancing act and there's no sure-fire rules on when to do it. Ideally, you want to be purchasing your last mercenaries to conquer the last territory on the map.

The speed at which you progress through Warzone Idle is based on your strategy, so if things are going too slow you should try revisiting your play style.

== How do I gain Advancement Points (AP)? ==

You can get Advancement Points by finishing levels of Warzone Idle. You can also get Advancement Points by abandoning levels partway. When you abandon a level, Warzone will tell you how much AP you can get for your partial progress. Note that this partial AP will be subtracted from how much AP you can gain the next time you play that same level.

Be warned that using this abandoned method to decrease the final awarded points reduced the amount of the bonus you receive when paying the coins for a % bonus.

== Any more tips? ==

Once you have a bunch of AP upgrades, you should consider going back and playing previous levels again. You'll be able to clear them much more quickly than the first time, and you can earn some extra AP this way. Each level gives 25% less AP each time you beat it, so it's best to defeat each level a few times then move on.

== Cheating ==

Any attempts to cheat will result in your Warzone account being banned (along with any of your alts). Do not attempt to modify the game data, modify your system clock, or automate the game in any fashion except as provided within the game's normal UI. You have been warned.

== Syncing Between Devices ==
See [[Warzone Idle Syncing]]
[[Category:Warzone Idle]]

Artifacts

2023-01-29T19:25:31Z

JK 3: Added missing values for rarities (Note: might have made a mistake, pls double check)

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a (currently incomplete) list of artifacts and their effects.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || 4% || 8% || 16% || 32%
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || 2 || 4 || 8 || 14 || 24 || 50 || 64
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12% || 14%
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Idle Time || - || Passive || Increase your maximum idle time by XX || 10m || 20m || 40m || 1h 20m || 2h 40m || 5h 20m || 10h 40m
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || 120% || 240% || 480%
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || 28% || 56% || 112%
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || 40% || 80%
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || 32% || 64% || 128%
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || 36% || 72% || 144% || 288%
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || 96% || 192% || 384%
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || 240% || 480% || 960%
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || 35% || 50% || 65%
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || 400% || 800%
|-
|Time Warp || TW || Active || Advance time by XX || 7.5m || 15m || 30m || 1h || 2h || 4h || 8h
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|}

[[Category:Warzone Idle]]

Artifacts

2023-01-29T12:57:59Z

JK 3: Added abbreviations for artifact names, since people in forums tend to be confused about those

'''Artifacts''' are permanent upgrades you can find in [[Warzone Idle]]. Artifacts and [[advancements]] are the only things that give permanent Warzone Idle upgrades.

You may only have 3 artifacts equipped at any time. Those are the only 3 that have any effect. Some artifacts are Passive which means their effects always apply while equipped, and others must be activated and then have a cooldown until you can activate them again.

To change the three artifacts you have equipped, open the Advancements tab and click View All next to artifacts. Then drag the one you want to equip into a box at the top.

To activate a non-passive artifact, equip it and then look for the Activate button on the advancements tab. It will then "cool down" until it can be used again.

Note that you cannot un-equip an artifact that's cooling down. You also cannot equip two identical artifacts (regardless of rarity).

== Getting Artifacts ==

Artifacts can be found by digging at dig sites that you find while playing Warzone Idle. All Warzone Idle levels have dig sites other than the tutorial, the first level, and the bonus level.

Once started, a dig site disappears from the map and will be shown on the Advancements tab. Starting a new Warzone Idle level does not affect the current dig but all dig sites left on the map will be lost.

== Timing ==

Note that the times specified in dig sites, as well as artifact cooldown and upgrade time, are in real-world time and are not affected by how often you open the game or what your maximum Idle Time is set to. They ''are'', however, affected by Time Warp, both the power and the artifact (though the artifact does not affect its own cooldown).

Additionally some clan war rewards may reduce artifact cooldown, affecting the Time Warp cooldown. There also exists an advancement which reduces digging time.

== Rarities and Upgrades ==

Each artifact has a rarity. Higher rarities correspond to stronger effects.

The rarities are, from lowest to highest:
* Poor
* Common
* Uncommon
* Rare
* Epic
* Legendary
* Insane

An artifact may have its rarity upgraded by sacrificing four artifacts of the same rarity. The upgrade will take some time, during which the artifact cannot be used. The amount of time required depends on the rarity:

{| class="wikitable"
|-
! Old rarity
! New rarity
! Time required
|-
|Poor || Common || 6 hours
|-
|Common || Uncommon || 12 hours
|-
|Uncommmon || Rare || 1 day
|-
|Rare || Epic || 2 days
|-
|Epic || Legendary || 5 days
|-
|Legendary || Insane || 10 days
|}

== List of artifact types ==

This is a (currently incomplete) list of artifacts and their effects.

{| class="wikitable"
|-
! rowspan="2" | Name
! rowspan="2" | Abbreviation
! rowspan="2" | Type
! rowspan="2" | Effect
! colspan="7" | Rarity
|-
! Poor
!Common
!Uncommon
!Rare
!Epic
!Legendary
!Insane
|-
|Alloy Values || AV || Passive || Alloy sell value increased by XX% || 3.5% || 7% || 14% || 28% || 56% || 112% || 224%
|-
|Army Cache || AC || Active || Instantly get an army cache of size XX% || 10% || 20% || 40% || 80% || 160% || 320% || 640%
|-
|Army Cache Boost || ACacheB || Passive || Increases armies received from all caches by XX% || 1% || 2% || 4% || 8% || 16% || 32% || 64%
|-
|Army Camp Boost || ACampB || Passive || Increases armies produced by army camps by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Army Camp Discount || ACD || Passive || Reduces cost of upgrading army camps by XX% || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Bonus Money Boost || BMB || Passive || Increases the money received from bonuses by XX% || 5% || 10% || 20% || 40% || 80% || 160% || 320%
|-
|Cache Boost || CB || Passive || Money, armies, and resources received from all caches increased by XX% || 0.4% || 0.8% || 1.6% || 3.2% || 6.4% || 12.8% || 25.6%
|-
|Craft Double || CD || Passive || XX% chance of crafters producing two items instead of one || 0.75% || 1.5% || 3% || 6% || 12% || 24% || 48%
|-
|Damage Territory || DT || Active || Reduce armies needed to conquer a territory by XX% || 1.5% || 3% || 6% || 12% || 24% || 48% || 96%
|-
|Discount Army Camp || DAC || Active || Purchase an army camp upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Hospital || DH || Active || Purchase a hospital upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Discount Mine || DM || Active || Purchase a mine upgrade at a XX% discount || 3% || 6% || 12% || 24% || 48% || 96% || 192%
|-
|Draft Boost || DB || Passive || Draft values increased by XX% || 2% || 4% || 8% || 16% || E || L || I
|-
|Efficient Crafters || EC || Passive || Crafter ingredients reduced by XX% || 0.5% || 1% || 2% || R || E || L || I
|-
|Efficient Smelters || ES || Passive || Smelter ingredients reduced by XX% || 0.5% || 1% || 2% || R || E || L || I
|-
|Field Hospital || FH || Active || Deploy a field hospital that saves XX% from conquering neighboring territories || 1.5% || 3% || 6% || 12% || E || 48% || I
|-
|Fog Buster || FB || Active || Reveals XX fogged territories on the map || P || 4 || 8 || 14 || E || L || I
|-
|Hospital Boost || HB || Passive || Armies saved by hospitals increased by XX% || 1% || 2% || 4% || 8% || 10% || 12 || I
|-
|Hospital Discount || HD || Passive || Reduces the cost of upgrading hospitals by XX% || 0.75% || 1.5% || 3% || 6% || E || L || I
|-
|Idle Time || - || Passive || Increase your maximum idle time by XX || 10 minutes || 20 minutes || 40 minutes || 80 minutes || 160 minutes || L || I
|-
|Inspire Mercenaries || IM || Active || Get XX% of mercenaries from a mercenary camp for free || 1.5% || 3% || 6% || R || E || L || I
|-
|Item Values || IV || Active || Item sell values increased by X% || 2% || 4% || 8% || 16% || 32% || L || I
|-
|Market Raid || MR || Active || Instantly conduct a market raid of size XX% || 7.5% || 15% || 30% || 60% || E || L || I
|-
|Mercenary Discount || MD || Passive || Decrease cost of mercenaries by XX% || 1% || 2% || 4% || 8% || 16% || L || I
|-
|Mine Boost || MB || Passive || Ore received from mines increased by XX% || 1.75% || 3.5% || 7% || 14% || E || L || I
|-
|Mine Discount || - || Passive || Reduces the cost of upgrading mines by XX% || 1.25% || 2.5% || 5% || 10% || 20% || L || I
|-
|Money Cache || MC || Active || Instantly get a money cache of size XX% || 15% || 30% || 60% || R || E || L || I
|-
|Money Cache Boost || MCB || Passive || Increases money received from all caches by XX% || 2% || 4% || 8% || 16% || E || L || I
|-
|Ore Values || OV || Passive|| Ore sell values increased by XX% || 4.5% || 9% || 18% || R || E || L || I
|-
|Quadruple Strike || QS || Active|| Conquer a territory you have four or more borders to at a XX% discount || 6% || 12% || 24% || 48% || E || L || I
|-
|Resource Cache || RC || Active || Instantly get a resource cache of size XX% || 15% || 30% || 60% || 120% || E || L || I
|-
|Resource Cache Boost || RCB || Passive || Increases resources received from all caches by XX% || 5% || 10% || 20% || 40% || E || L || I
|-
|Smelt Double || SD || Passive || XX% chance of smelters producing two alloys instead of one || 0.75% || 1.5% || 3% || 6% || E || L || I
|-
|Speedy Crafters || SC || Passive || Crafters work XX% faster || 5% || 10% || 15% || 25% || E || L || I
|-
|Speedy Smelters || SS || Passive || Smelters work XX% faster || 5% || 10% || 15% || 25% || E || L || I
|-
|Supercharge Army Camp || SAC || Active || Supercharge an army camp for XX || 7.5 minutes || 15 minutes || 30 minutes || 60 minutes || 120 minutes || L || I
|-
|Supercharge Mine || SM || Active || Supercharge a mine for XX || 7.5 minutes || 15 minutes || 30 minutes || 60 minutes || E || 240 minutes || I
|-
|Tech Discount || TD || Passive || Reduces requirements of techs by XX% || 0.75% || 1.5% || 3% || 6% || E || L || I
|-
|Territory Money Boost || TMB || Passive || Increases the money received from territories by XX% || 12.5% || 25% || 50% || 100% || 200% || L || I
|-
|Time Warp || TW || Active || Advance time by XX || 7.5 minutes || 15 minutes || 30 minutes || 60 minutes || 120 minutes || L || I
|-
|Triple Strike || TS || Active|| Conquer a territory you have three or more borders to at a XX% discount || 5% || 10% || 20% || 40% || 80% || 160% || I
|}

[[Category:Warzone Idle]]

Set map details API

2022-12-24T02:58:51Z

JK 3: Fixed wrong example (keys were not strings, but they should be)

The '''set map details API''' can be used by map creators to assist in creating their [[map]]. This API can do the things that the built-in Warzone map UI can do, such as setting [[Territories|territory]] names, setting territory center points, defining the connections between territories, etc.

== Preparation ==

To use the API, you must first have uploaded your SVG file via the [[Map Making|normal process]]. After it's uploaded, click the button named "Get link for sharing" and you'll get a URL such as:

https://www.warzone.com/play?PreviewMap=5859

The number at the end of the URL is your map ID. In the example shown, the map ID is 5859.

==Usage==

To enter the details of your map without using the UI, you POST some JSON to https://www.warzone.com/API/SetMapDetails

The beginning of the JSON should look like this:

{
"email": "your@email.com",
"APIToken": "yourapitoken",
"mapID": 5859,
"commands": [
]
}

Your Warzone account's e-mail address and API token are always required, as is the map ID you're modifying. You may get your API token using the [[Get API Token API]]. You may only enter the ID of a map you own, and the map must be in development mode (the same restrictions apply to editing the map with the UI.)

Note that after updating a map with the API, your browser may need to be refreshed to see the changes reflected in the UI.

==Commands==

You can specify commands within the commands node shown above. You may specify as many copies of each command as you need, and you do not need to specify every command.

===Set Territory Name===

{ command: 'setTerritoryName', id: 12, name: 'Kamchatka' },
{ command: 'setTerritoryName', id: 34, name: 'Ukraine' }

This sets the name of a territory, similar to typing in its name in the left side after clicking on it. Specify the territory id (from the Territory_ format of your SVG file) and the name you wish to set it to.

===Set Territory Center Point===

{ command: 'setTerritoryCenterPoint', id: 12, x: '43.34', y: '98.12' }

Specify the territory id and the coordinates of the center point. Coordinates are measured from the top-left corner of the SVG file.

===Specify Connections===

{ command: 'addTerritoryConnection', id1: 12, id2:34, wrap: "Normal" },
{ command: 'addTerritoryConnection', id1: 56, id2:78, wrap: "WrapHorizontally" }

Specify the two territory IDs as id1 and id2 attributes. It does not matter which territory is 1 and which is 2, since all connections in Warzone are two-way.

As the wrap attribute, specify either Normal, WrapHorizontally, or WrapVertically to tell Warzone whether or not the connections wrap around the edge of the map.

Connections cannot be removed via the API, only added. If you accidentally add a mistaken connection, it can be removed through the UI or you can delete the map and start over.

===Add Bonus===

{ command: 'addBonus', name: "South America", armies: 4, color: "#DD0000" }

Adding a [[bonus]] is similar to clicking the "Add new Bonus" button. The new bonus will initially have no territories assigned, but you can use addTerritoryToBonus below to add territories.

The armies attribute specifies how many armies per turn the bonus is worth, and the color attribute supports six hex characters is in the format #RRGGBB. The hash sign must be included and all six characters must be specified.

===Add Territory to Bonus===

{ command: 'addTerritoryToBonus', id:12, bonusName: "South America" }

This is equivalent to selecting the territory and checking the bonus name check-box. The bonus must have already been created, either via addBonus above or via the UI. Attributes specify the territory ID and the bonus name. The bonus name is case-sensitive, so be sure it's entered perfectly.

===Add Distribution Mode===

{ command: 'addDistributionMode', name: "Warlords" },
{ command: 'addDistributionMode', name: "Top vs Bottom", scenarios: ['Top', 'Bottom'] }

Just like making a bonus, this creates an empty distribution mode just as if you clicked "Add new Distribution" in the UI.

There are two types: [[Normal Distribution|Normal]] and [[Scenario distributions]]. To create a normal distribution, just specify a name, as is shown in the first example above.

The second example shows how to create a scenario distribution. When creating a scenario distribution, also specify the name of each scenario. There must be at least two scenarios defined, although there can be more.

===Add Territory to a Distribution Mode===

{ command: 'addTerritoryToDistribution', id:12, distributionName: "Warlords" },
{ command: 'addTerritoryToDistribution', id:12, distributionName: "Top vs Bottom", scenario:"Top" }

To add a territory to a normal distribution, as is shown in the first example, just specify the territory id and distribution name. The distribution name is case-sensitive, so be sure it's entered perfectly.

To add a territory to a scenario distribution, as is shown in the second example, specify the territory id, distribution name, and scenario name.

[[Category:API]]

Points

2022-07-20T10:56:05Z

JK 3: Added coin game multiplier

Players can earn '''points''' by winning single-player games, multi-player games or [[tournaments]], unlocking [[achievements]], or from [[ladders]]. Points are used to gain [[levels]], which unlock additional features.

If you visit https://www.warzone.com/Points, you can see how many points you have, the progress to your next level, and all points you've earned in the last 30 days. If you hover your mouse cursor over a point award, you will be shown additional details about how that number was calculated.

== Points from Single-Player Games ==

Defeating one of the built-in levels is worth 2,500 points the first time you defeat it. Getting a gold star on one of these levels is worth an additional 2,500 points. If you get a gold star the first time you defeat it, you'll receive the two awards together as a 5,000 point award.

Community levels do not give points.

== Points from Multi-Player Games ==

When players win a [[ranked versus practice|ranked]] multi-player game, they are awarded points. The number of points the winner(s) are awarded is based off of a number of factors:
* The number of players who didn't win the game. Winning a 3-player FFA gives (on average) twice as many points as a 1v1, since there were two losers as opposed to one. Likewise, winning a 20 player FFA gives 19 times as many points as a 1v1.
* The levels of the players who didn't win the game. Defeating a player who is equal level to you gives a base of 5,000 points. Defeating a player who is 10 or more levels above you gives a base of 10,000 points. Defeating a player who is lower level than you gives fewer than 5,000 points, depending on their level.
* If the winning player is over level 8, their points are also affected by how recently they've defeated this player before. Defeating the same player twice in a 10-day period reduces the points earned from that player by 50%. Defeating the same player three or more times in a 10-day period reduces the points earned from that player by 80%.
* In team games, the team essentially splits the points earned from the defeated players. However, team members can also receive different amounts of points due to the above rules (if the team members are different levels or have defeated some of the opponents recently.)
* Tournament games and coin games award 50% more points. Ladder games award double points. Real-time games award half as many points as multi-day games.

==== Point Multipliers ====
{| class="wikitable"
|-
! Game type
! Points
|-
| Multi-day games
| 100%
|-
| Tournament games
| 150%
|-
| Ladder games
| 200%
|-
| Real-time games
| 50%
|-
| Coin games
| 150%
|}

== Points from Tournaments ==

The winner of a [[ranked versus practice|ranked]] tournament is awarded points based on a number of factors:
* The number of players in the tournament. Winning a 128 player tournament awards, on average, twice as many points as a 64 player tournament.
* The levels of the players who didn't win the tournament. Each player who is equal level to you adds 500 points. Each player who is ten levels or more above you adds 1,000 points.
* If a player defeats the same opponent in tournaments multiple times within a 30 day period, the points they earn from that player are reduced by 80% for all victories after the first. This is tracked independently between games and tournaments.
* If a team wins a tournament, they essentially split the points earned from all defeated players. However, team members can also receive different amounts of points due to the above rules (if the team members are different levels or have defeated some of the opponents recently in a tournament.)
* In addition to the tournament points, the winner of course won a bunch of games within the tournament itself which all awarded elevated points.

== Points from Ladders ==

The [[1 v 1 Ladder|1v1]] and [[2v2 ladder]]s award points every 24 hours to each player that holds a rank of 30 or better. The [[seasonal ladder]] awards points at the end of each season to each player that holds a rank of 30 or better.

They award points based on this formula: (31 – rank) ^ 3 * 0.6 + 1000

The seasonal ladder additionally multiplies the result of this formula by the number of days in the season.

== See also ==
* [[Levels]]
* [[Hidden settings]]

Mod API Reference:UI

2022-02-06T23:12:33Z

JK 3: As suggested by awaythro: make button colors code for even more readability

Mods can put UI (user interface) onto the screen when called from one of the Client '''Present''' [[Mod Hooks|hooks]]. This page describes how to create and update UI elements.

UI elements are created by accessing the <code>UI</code> global. For example, mods can call UI.CreateButton(...) to create a button. Any UI element listed below can be created in a similar manner.

Behind the scenes, these objects are implemented using Unity's UI and layout system. Being familiar with Unity's UI system will make understanding how to build UI easier, but it's not a requirement.

== Parents ==
All UI constructors take a single <code>parent</code> argument. This allows you to construct hierarchies. For example, mods can create a vertical stack of three buttons like this:

local vert = UI.CreateVerticalLayoutGroup(rootParent);
local btn1 = UI.CreateButton(vert);
local btn2 = UI.CreateButton(vert);
local btn3 = UI.CreateButton(vert);

When a mod is called to present UI, it will be passed a root UI element (rootParent). Your mod should pass the rootParent to a UI element that will be the root of all other elements you need. This element is most often a VerticalLayoutGroup, as shown in the example above.

You can never make more than one element a child of the rootParent. If you need more than one, simply make your own container to house them.

== Properties ==

UI elements have properties that can be read or set. For example, Buttons have a Text property that allows you to set the text that appears on the button.

To read or write a UI element's property, you must use getter/setter functions named GetX() and SetX(). For example, to set the text of a button you can write <code>btn1.SetText('Click me!')</code> and can retrieve it using <code>btn1.GetText()</code>.

All getter and setter functions return the UI element, which means you can chain them together to easily set lots of properties. For example:

UI.CreateButton(vert)
.SetText('Click me!')
.SetColor('#00FF00')
.SetOnClick(someFunction);

== Common Properties ==

All UI elements have the following properties:
* '''PreferredWidth''' ''number'': How wide the element prefers to be. It may not be this wide if there is not enough space, and it may be wider if FlexibleWidth is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''PreferredHeight''' ''number'': How tall the element prefers to be. It may not be this tall if there is not enough space, and it may be taller if FlexibleHeight is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''FlexibleWidth''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no wider than PreferredWidth. Set it to 1 to indicate the object should grow to encompass all remaining horizontal space it can.
* '''FlexibleHeight''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no taller than PreferredHeight. Set it to 1 to indicate the object should grow to encompass all remaining vertical space it can.

== UI Elements ==

'''Empty''': A simple UI element that displays nothing. This can be used as a container or to create space.

'''VerticalLayoutGroup''': A container that stacks its children vertically.

'''HorizontalLayoutGroup''': A container that stacks its children horizontally.

'''Label''': A way to display text on the screen.
* '''Text''' ''string'': The text to display.
* '''Color''' ''string'': The color of the text. Pass this as a string in #RRGGBB format.

'''Button''': A button that players can click on to do something.
* '''Text''' ''string'': The text to display on the button.
* '''Color''' ''string'': The color of the button. Pass this as a string in #RRGGBB format. Only the following colors are supported for buttons:
:: <code>#BABABC, #6C73D1, #FF00ED, #FFC200, #00A0FF, #00B5FF, #F3FFAE, #43C731, #43C631, #1274A4, #1274A5, #B03B3B, #0021FF, #359029, #00E9FF, #00FF21, #FFF700, #AA3A3A, #43C732, #00D4FF, #B03C3C, #00F4FF, #00BFFF, #4EC4FF, #615DDF, #100C08, #0000FF, #4EFFFF, #59009D, #008000, #FF7D00, #FF0000, #606060, #00FF05, #FF697A, #94652E, #00FF8C, #FF4700, #009B9D, #23A0FF, #AC0059, #FF87FF, #FFFF00, #943E3E, #FEFF9B, #AD7E7E, #B70AFF, #FFAF56, #FF00B1, #8EBE57, #DAA520, #990024, #00FFFF, #8F9779, #880085, #00755E, #FFE5B4, #4169E1, #FF43A4, #8DB600, #40826D, #C04000, #FFDDF4, #CD7F32, #C19A6B, #C09999, #B0BF1A, #3B7A57, #4B5320, #664C28, #893F45, #D2691E, #36454F, #FF00FF, #76FF7A</code>
* '''TextColor''' ''string'': The color of the text on the button. Pass this as a string in #RRGGBB format.
* '''OnClick''' ''function'': Pass the name of a lua function to be called whenever the player clicks the button.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''CheckBox''': A toggleable check box that players can check and uncheck.
* '''IsChecked''' ''bool'': Whether the check box is checked or unchecked.
* '''Text''' ''string'': The label displayed to the right of the check box.
* '''OnValueChanged''' ''function'': Pass the name of a lua function to be called whenever the IsChecked property changes, either by your code or by the player clicking the check box.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''TextInputField''': A box where players can type a string.
* '''Text''' ''string'': The string that appears in the box, or that players typed.
* '''PlaceholderText''' ''string'': The text that appears in the box grayed out when it's empty. For example, "Enter name here..."
* '''CharacterLimit''' ''integer'': The maximum number of characters that players can type into this text field.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''NumberInputField''': Allows players to input a number. Presents an input box and a slider that are linked, so players can either use the box to type a number or slide the slider. This makes it friendly for mobile users who don't have a hardware keyboard, while also allowing any number to be entered if someone wants to exceed the range allowable by the slider.
* '''Value''' ''number'': The value to show in the box+slider, or the value entered by the player.
* '''WholeNumbers''' ''bool'': If true, only integers will be selectable by the player. If false, partial numbers will be selectable. Defaults to true.
* '''SliderMinValue''' ''number'': The minimum value selectable by the slider. Numbers below this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''SliderMaxValue''' ''number'': The maxium value selectable by the slider. Numbers above this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''BoxPreferredWidth''' ''number'': Allows setting the preferred width of just the box. See '''Common Properties''' above.
* '''SliderPreferredWidth''' ''number'': Allows setting the preferred width of just the slider. See '''Common Properties''' above.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

== Helper Functions ==

'''UI.Destroy''': Destroys (removes) any UI that the mod previously created. Simply pass a UI element created by one of the UI.CreateXXX functions to UI.Destroy and it will disappear forever.

'''UI.Alert''': Pops up a dialog with a message and an Okay button to close the message. Call this as simply <code>UI.Alert(msg)</code>

'''UI.PromptFromList''': Pops up a dialog with a series of buttons to choose from. This takes two arguments:
* '''Message''' ''string'': Text to appear at the top of the dialog.
* '''Options''' ''array'': A list of options, each of which will show up as a button. Each entry in this array should be a table with two fields, '''text''' and '''selected'''. '''text''' populates the text that will appear on that button, and '''selected''' is a zero-argument function that gets called if the player selects that option.

'''UI.InterceptNextTerritoryClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a territory on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a territory, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:TerritoryDetails|TerritoryDetails]] object, which can be used to get the Territory ID or the name of the territory that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextTerritoryClick before a territory is clicked.

'''UI.InterceptNextBonusLinkClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a bonus link on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a bonus link, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:BonusDetails|BonusDetails]] object, which can be used to get the bonus ID or the name of the bonus that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextBonusLinkClick before a bonus link is clicked.

InterceptNextTerritoryClick
[[Category:Mod API Reference]]

Mod API Reference:UI

2022-02-06T23:00:57Z

JK 3: Added spaces to list of button colors so the text can resize with the window

Mods can put UI (user interface) onto the screen when called from one of the Client '''Present''' [[Mod Hooks|hooks]]. This page describes how to create and update UI elements.

UI elements are created by accessing the <code>UI</code> global. For example, mods can call UI.CreateButton(...) to create a button. Any UI element listed below can be created in a similar manner.

Behind the scenes, these objects are implemented using Unity's UI and layout system. Being familiar with Unity's UI system will make understanding how to build UI easier, but it's not a requirement.

== Parents ==
All UI constructors take a single <code>parent</code> argument. This allows you to construct hierarchies. For example, mods can create a vertical stack of three buttons like this:

local vert = UI.CreateVerticalLayoutGroup(rootParent);
local btn1 = UI.CreateButton(vert);
local btn2 = UI.CreateButton(vert);
local btn3 = UI.CreateButton(vert);

When a mod is called to present UI, it will be passed a root UI element (rootParent). Your mod should pass the rootParent to a UI element that will be the root of all other elements you need. This element is most often a VerticalLayoutGroup, as shown in the example above.

You can never make more than one element a child of the rootParent. If you need more than one, simply make your own container to house them.

== Properties ==

UI elements have properties that can be read or set. For example, Buttons have a Text property that allows you to set the text that appears on the button.

To read or write a UI element's property, you must use getter/setter functions named GetX() and SetX(). For example, to set the text of a button you can write <code>btn1.SetText('Click me!')</code> and can retrieve it using <code>btn1.GetText()</code>.

All getter and setter functions return the UI element, which means you can chain them together to easily set lots of properties. For example:

UI.CreateButton(vert)
.SetText('Click me!')
.SetColor('#00FF00')
.SetOnClick(someFunction);

== Common Properties ==

All UI elements have the following properties:
* '''PreferredWidth''' ''number'': How wide the element prefers to be. It may not be this wide if there is not enough space, and it may be wider if FlexibleWidth is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''PreferredHeight''' ''number'': How tall the element prefers to be. It may not be this tall if there is not enough space, and it may be taller if FlexibleHeight is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''FlexibleWidth''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no wider than PreferredWidth. Set it to 1 to indicate the object should grow to encompass all remaining horizontal space it can.
* '''FlexibleHeight''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no taller than PreferredHeight. Set it to 1 to indicate the object should grow to encompass all remaining vertical space it can.

== UI Elements ==

'''Empty''': A simple UI element that displays nothing. This can be used as a container or to create space.

'''VerticalLayoutGroup''': A container that stacks its children vertically.

'''HorizontalLayoutGroup''': A container that stacks its children horizontally.

'''Label''': A way to display text on the screen.
* '''Text''' ''string'': The text to display.
* '''Color''' ''string'': The color of the text. Pass this as a string in #RRGGBB format.

'''Button''': A button that players can click on to do something.
* '''Text''' ''string'': The text to display on the button.
* '''Color''' ''string'': The color of the button. Pass this as a string in #RRGGBB format. Only the following colors are supported for buttons:
** #BABABC, #6C73D1, #FF00ED, #FFC200, #00A0FF, #00B5FF, #F3FFAE, #43C731, #43C631, #1274A4, #1274A5, #B03B3B, #0021FF, #359029, #00E9FF, #00FF21, #FFF700, #AA3A3A, #43C732, #00D4FF, #B03C3C, #00F4FF, #00BFFF, #4EC4FF, #615DDF, #100C08, #0000FF, #4EFFFF, #59009D, #008000, #FF7D00, #FF0000, #606060, #00FF05, #FF697A, #94652E, #00FF8C, #FF4700, #009B9D, #23A0FF, #AC0059, #FF87FF, #FFFF00, #943E3E, #FEFF9B, #AD7E7E, #B70AFF, #FFAF56, #FF00B1, #8EBE57, #DAA520, #990024, #00FFFF, #8F9779, #880085, #00755E, #FFE5B4, #4169E1, #FF43A4, #8DB600, #40826D, #C04000, #FFDDF4, #CD7F32, #C19A6B, #C09999, #B0BF1A, #3B7A57, #4B5320, #664C28, #893F45, #D2691E, #36454F, #FF00FF, #76FF7A
* '''TextColor''' ''string'': The color of the text on the button. Pass this as a string in #RRGGBB format.
* '''OnClick''' ''function'': Pass the name of a lua function to be called whenever the player clicks the button.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''CheckBox''': A toggleable check box that players can check and uncheck.
* '''IsChecked''' ''bool'': Whether the check box is checked or unchecked.
* '''Text''' ''string'': The label displayed to the right of the check box.
* '''OnValueChanged''' ''function'': Pass the name of a lua function to be called whenever the IsChecked property changes, either by your code or by the player clicking the check box.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''TextInputField''': A box where players can type a string.
* '''Text''' ''string'': The string that appears in the box, or that players typed.
* '''PlaceholderText''' ''string'': The text that appears in the box grayed out when it's empty. For example, "Enter name here..."
* '''CharacterLimit''' ''integer'': The maximum number of characters that players can type into this text field.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''NumberInputField''': Allows players to input a number. Presents an input box and a slider that are linked, so players can either use the box to type a number or slide the slider. This makes it friendly for mobile users who don't have a hardware keyboard, while also allowing any number to be entered if someone wants to exceed the range allowable by the slider.
* '''Value''' ''number'': The value to show in the box+slider, or the value entered by the player.
* '''WholeNumbers''' ''bool'': If true, only integers will be selectable by the player. If false, partial numbers will be selectable. Defaults to true.
* '''SliderMinValue''' ''number'': The minimum value selectable by the slider. Numbers below this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''SliderMaxValue''' ''number'': The maxium value selectable by the slider. Numbers above this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''BoxPreferredWidth''' ''number'': Allows setting the preferred width of just the box. See '''Common Properties''' above.
* '''SliderPreferredWidth''' ''number'': Allows setting the preferred width of just the slider. See '''Common Properties''' above.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

== Helper Functions ==

'''UI.Destroy''': Destroys (removes) any UI that the mod previously created. Simply pass a UI element created by one of the UI.CreateXXX functions to UI.Destroy and it will disappear forever.

'''UI.Alert''': Pops up a dialog with a message and an Okay button to close the message. Call this as simply <code>UI.Alert(msg)</code>

'''UI.PromptFromList''': Pops up a dialog with a series of buttons to choose from. This takes two arguments:
* '''Message''' ''string'': Text to appear at the top of the dialog.
* '''Options''' ''array'': A list of options, each of which will show up as a button. Each entry in this array should be a table with two fields, '''text''' and '''selected'''. '''text''' populates the text that will appear on that button, and '''selected''' is a zero-argument function that gets called if the player selects that option.

'''UI.InterceptNextTerritoryClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a territory on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a territory, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:TerritoryDetails|TerritoryDetails]] object, which can be used to get the Territory ID or the name of the territory that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextTerritoryClick before a territory is clicked.

'''UI.InterceptNextBonusLinkClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a bonus link on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a bonus link, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:BonusDetails|BonusDetails]] object, which can be used to get the bonus ID or the name of the bonus that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextBonusLinkClick before a bonus link is clicked.

InterceptNextTerritoryClick
[[Category:Mod API Reference]]

Mod API Reference:UI

2022-02-06T22:40:20Z

JK 3: Split button colors into 3 lines so its actually readable

Mods can put UI (user interface) onto the screen when called from one of the Client '''Present''' [[Mod Hooks|hooks]]. This page describes how to create and update UI elements.

UI elements are created by accessing the <code>UI</code> global. For example, mods can call UI.CreateButton(...) to create a button. Any UI element listed below can be created in a similar manner.

Behind the scenes, these objects are implemented using Unity's UI and layout system. Being familiar with Unity's UI system will make understanding how to build UI easier, but it's not a requirement.

== Parents ==
All UI constructors take a single <code>parent</code> argument. This allows you to construct hierarchies. For example, mods can create a vertical stack of three buttons like this:

local vert = UI.CreateVerticalLayoutGroup(rootParent);
local btn1 = UI.CreateButton(vert);
local btn2 = UI.CreateButton(vert);
local btn3 = UI.CreateButton(vert);

When a mod is called to present UI, it will be passed a root UI element (rootParent). Your mod should pass the rootParent to a UI element that will be the root of all other elements you need. This element is most often a VerticalLayoutGroup, as shown in the example above.

You can never make more than one element a child of the rootParent. If you need more than one, simply make your own container to house them.

== Properties ==

UI elements have properties that can be read or set. For example, Buttons have a Text property that allows you to set the text that appears on the button.

To read or write a UI element's property, you must use getter/setter functions named GetX() and SetX(). For example, to set the text of a button you can write <code>btn1.SetText('Click me!')</code> and can retrieve it using <code>btn1.GetText()</code>.

All getter and setter functions return the UI element, which means you can chain them together to easily set lots of properties. For example:

UI.CreateButton(vert)
.SetText('Click me!')
.SetColor('#00FF00')
.SetOnClick(someFunction);

== Common Properties ==

All UI elements have the following properties:
* '''PreferredWidth''' ''number'': How wide the element prefers to be. It may not be this wide if there is not enough space, and it may be wider if FlexibleWidth is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''PreferredHeight''' ''number'': How tall the element prefers to be. It may not be this tall if there is not enough space, and it may be taller if FlexibleHeight is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''FlexibleWidth''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no wider than PreferredWidth. Set it to 1 to indicate the object should grow to encompass all remaining horizontal space it can.
* '''FlexibleHeight''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no taller than PreferredHeight. Set it to 1 to indicate the object should grow to encompass all remaining vertical space it can.

== UI Elements ==

'''Empty''': A simple UI element that displays nothing. This can be used as a container or to create space.

'''VerticalLayoutGroup''': A container that stacks its children vertically.

'''HorizontalLayoutGroup''': A container that stacks its children horizontally.

'''Label''': A way to display text on the screen.
* '''Text''' ''string'': The text to display.
* '''Color''' ''string'': The color of the text. Pass this as a string in #RRGGBB format.

'''Button''': A button that players can click on to do something.
* '''Text''' ''string'': The text to display on the button.
* '''Color''' ''string'': The color of the button. Pass this as a string in #RRGGBB format. Only the following colors are supported for buttons:
#BABABC,#6C73D1,#FF00ED,#FFC200,#00A0FF,#00B5FF,#F3FFAE,#43C731,#43C631,#1274A4,#1274A5,#B03B3B,#0021FF,#359029,#00E9FF,#00FF21,#FFF700,#AA3A3A,#43C732,#00D4FF,#B03C3C,#00F4FF,#00BFFF,#4EC4FF,#615DDF,#100C08,#0000FF,#4EFFFF,#59009D,#008000,
#FF7D00,#FF0000,#606060,#00FF05,#FF697A,#94652E,#00FF8C,#FF4700,#009B9D,#23A0FF,#AC0059,#FF87FF,#FFFF00,#943E3E,#FEFF9B,#AD7E7E,#B70AFF,#FFAF56,#FF00B1,#8EBE57,#DAA520,#990024,#00FFFF,#8F9779,#880085,#00755E,#FFE5B4,#4169E1,#FF43A4,#8DB600,
#40826D,#C04000,#FFDDF4,#CD7F32,#C19A6B,#C09999,#B0BF1A,#3B7A57,#4B5320,#664C28,#893F45,#D2691E,#36454F,#FF00FF,#76FF7A
* '''TextColor''' ''string'': The color of the text on the button. Pass this as a string in #RRGGBB format.
* '''OnClick''' ''function'': Pass the name of a lua function to be called whenever the player clicks the button.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''CheckBox''': A toggleable check box that players can check and uncheck.
* '''IsChecked''' ''bool'': Whether the check box is checked or unchecked.
* '''Text''' ''string'': The label displayed to the right of the check box.
* '''OnValueChanged''' ''function'': Pass the name of a lua function to be called whenever the IsChecked property changes, either by your code or by the player clicking the check box.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''TextInputField''': A box where players can type a string.
* '''Text''' ''string'': The string that appears in the box, or that players typed.
* '''PlaceholderText''' ''string'': The text that appears in the box grayed out when it's empty. For example, "Enter name here..."
* '''CharacterLimit''' ''integer'': The maximum number of characters that players can type into this text field.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''NumberInputField''': Allows players to input a number. Presents an input box and a slider that are linked, so players can either use the box to type a number or slide the slider. This makes it friendly for mobile users who don't have a hardware keyboard, while also allowing any number to be entered if someone wants to exceed the range allowable by the slider.
* '''Value''' ''number'': The value to show in the box+slider, or the value entered by the player.
* '''WholeNumbers''' ''bool'': If true, only integers will be selectable by the player. If false, partial numbers will be selectable. Defaults to true.
* '''SliderMinValue''' ''number'': The minimum value selectable by the slider. Numbers below this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''SliderMaxValue''' ''number'': The maxium value selectable by the slider. Numbers above this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''BoxPreferredWidth''' ''number'': Allows setting the preferred width of just the box. See '''Common Properties''' above.
* '''SliderPreferredWidth''' ''number'': Allows setting the preferred width of just the slider. See '''Common Properties''' above.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

== Helper Functions ==

'''UI.Destroy''': Destroys (removes) any UI that the mod previously created. Simply pass a UI element created by one of the UI.CreateXXX functions to UI.Destroy and it will disappear forever.

'''UI.Alert''': Pops up a dialog with a message and an Okay button to close the message. Call this as simply <code>UI.Alert(msg)</code>

'''UI.PromptFromList''': Pops up a dialog with a series of buttons to choose from. This takes two arguments:
* '''Message''' ''string'': Text to appear at the top of the dialog.
* '''Options''' ''array'': A list of options, each of which will show up as a button. Each entry in this array should be a table with two fields, '''text''' and '''selected'''. '''text''' populates the text that will appear on that button, and '''selected''' is a zero-argument function that gets called if the player selects that option.

'''UI.InterceptNextTerritoryClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a territory on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a territory, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:TerritoryDetails|TerritoryDetails]] object, which can be used to get the Territory ID or the name of the territory that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextTerritoryClick before a territory is clicked.

'''UI.InterceptNextBonusLinkClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a bonus link on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a bonus link, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:BonusDetails|BonusDetails]] object, which can be used to get the bonus ID or the name of the bonus that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextBonusLinkClick before a bonus link is clicked.

InterceptNextTerritoryClick
[[Category:Mod API Reference]]

Mod API Reference:UI

2022-02-06T22:21:23Z

JK 3: Removed duplicate colors for 100C08, FFFF00, and 943E3E

Mods can put UI (user interface) onto the screen when called from one of the Client '''Present''' [[Mod Hooks|hooks]]. This page describes how to create and update UI elements.

UI elements are created by accessing the <code>UI</code> global. For example, mods can call UI.CreateButton(...) to create a button. Any UI element listed below can be created in a similar manner.

Behind the scenes, these objects are implemented using Unity's UI and layout system. Being familiar with Unity's UI system will make understanding how to build UI easier, but it's not a requirement.

== Parents ==
All UI constructors take a single <code>parent</code> argument. This allows you to construct hierarchies. For example, mods can create a vertical stack of three buttons like this:

local vert = UI.CreateVerticalLayoutGroup(rootParent);
local btn1 = UI.CreateButton(vert);
local btn2 = UI.CreateButton(vert);
local btn3 = UI.CreateButton(vert);

When a mod is called to present UI, it will be passed a root UI element (rootParent). Your mod should pass the rootParent to a UI element that will be the root of all other elements you need. This element is most often a VerticalLayoutGroup, as shown in the example above.

You can never make more than one element a child of the rootParent. If you need more than one, simply make your own container to house them.

== Properties ==

UI elements have properties that can be read or set. For example, Buttons have a Text property that allows you to set the text that appears on the button.

To read or write a UI element's property, you must use getter/setter functions named GetX() and SetX(). For example, to set the text of a button you can write <code>btn1.SetText('Click me!')</code> and can retrieve it using <code>btn1.GetText()</code>.

All getter and setter functions return the UI element, which means you can chain them together to easily set lots of properties. For example:

UI.CreateButton(vert)
.SetText('Click me!')
.SetColor('#00FF00')
.SetOnClick(someFunction);

== Common Properties ==

All UI elements have the following properties:
* '''PreferredWidth''' ''number'': How wide the element prefers to be. It may not be this wide if there is not enough space, and it may be wider if FlexibleWidth is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''PreferredHeight''' ''number'': How tall the element prefers to be. It may not be this tall if there is not enough space, and it may be taller if FlexibleHeight is greater than 0. Defaults to -1, which is a special value meaning the object will meansure its own size based on its contents.
* '''FlexibleWidth''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no wider than PreferredWidth. Set it to 1 to indicate the object should grow to encompass all remaining horizontal space it can.
* '''FlexibleHeight''' ''number'': A number from 0 to 1 indicating how much of the remaining space this element wishes to take up. Defaults to 0, which means the element will be no taller than PreferredHeight. Set it to 1 to indicate the object should grow to encompass all remaining vertical space it can.

== UI Elements ==

'''Empty''': A simple UI element that displays nothing. This can be used as a container or to create space.

'''VerticalLayoutGroup''': A container that stacks its children vertically.

'''HorizontalLayoutGroup''': A container that stacks its children horizontally.

'''Label''': A way to display text on the screen.
* '''Text''' ''string'': The text to display.
* '''Color''' ''string'': The color of the text. Pass this as a string in #RRGGBB format.

'''Button''': A button that players can click on to do something.
* '''Text''' ''string'': The text to display on the button.
* '''Color''' ''string'': The color of the button. Pass this as a string in #RRGGBB format. Only the following colors are supported for buttons: #BABABC,#6C73D1,#FF00ED,#FFC200,#00A0FF,#00B5FF,#F3FFAE,#43C731,#43C631,#1274A4,#1274A5,#B03B3B,#0021FF,#359029,#00E9FF,#00FF21,#FFF700,#AA3A3A,#43C732,#00D4FF,#B03C3C,#00F4FF,#00BFFF,#4EC4FF,#615DDF,#100C08,#0000FF,#4EFFFF,#59009D,#008000,#FF7D00,#FF0000,#606060,#00FF05,#FF697A,#94652E,#00FF8C,#FF4700,#009B9D,#23A0FF,#AC0059,#FF87FF,#FFFF00,#943E3E,#FEFF9B,#AD7E7E,#B70AFF,#FFAF56,#FF00B1,#8EBE57,#DAA520,#990024,#00FFFF,#8F9779,#880085,#00755E,#FFE5B4,#4169E1,#FF43A4,#8DB600,#40826D,#C04000,#FFDDF4,#CD7F32,#C19A6B,#C09999,#B0BF1A,#3B7A57,#4B5320,#664C28,#893F45,#D2691E,#36454F,#FF00FF,#76FF7A
* '''TextColor''' ''string'': The color of the text on the button. Pass this as a string in #RRGGBB format.
* '''OnClick''' ''function'': Pass the name of a lua function to be called whenever the player clicks the button.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''CheckBox''': A toggleable check box that players can check and uncheck.
* '''IsChecked''' ''bool'': Whether the check box is checked or unchecked.
* '''Text''' ''string'': The label displayed to the right of the check box.
* '''OnValueChanged''' ''function'': Pass the name of a lua function to be called whenever the IsChecked property changes, either by your code or by the player clicking the check box.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''TextInputField''': A box where players can type a string.
* '''Text''' ''string'': The string that appears in the box, or that players typed.
* '''PlaceholderText''' ''string'': The text that appears in the box grayed out when it's empty. For example, "Enter name here..."
* '''CharacterLimit''' ''integer'': The maximum number of characters that players can type into this text field.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

'''NumberInputField''': Allows players to input a number. Presents an input box and a slider that are linked, so players can either use the box to type a number or slide the slider. This makes it friendly for mobile users who don't have a hardware keyboard, while also allowing any number to be entered if someone wants to exceed the range allowable by the slider.
* '''Value''' ''number'': The value to show in the box+slider, or the value entered by the player.
* '''WholeNumbers''' ''bool'': If true, only integers will be selectable by the player. If false, partial numbers will be selectable. Defaults to true.
* '''SliderMinValue''' ''number'': The minimum value selectable by the slider. Numbers below this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''SliderMaxValue''' ''number'': The maxium value selectable by the slider. Numbers above this can still be entered by typing them into the box, so ensure to always validate the number you retrieve.
* '''BoxPreferredWidth''' ''number'': Allows setting the preferred width of just the box. See '''Common Properties''' above.
* '''SliderPreferredWidth''' ''number'': Allows setting the preferred width of just the slider. See '''Common Properties''' above.
* '''Interactable''' ''bool'': If false, the control will be grayed out and unusable by the player.

== Helper Functions ==

'''UI.Destroy''': Destroys (removes) any UI that the mod previously created. Simply pass a UI element created by one of the UI.CreateXXX functions to UI.Destroy and it will disappear forever.

'''UI.Alert''': Pops up a dialog with a message and an Okay button to close the message. Call this as simply <code>UI.Alert(msg)</code>

'''UI.PromptFromList''': Pops up a dialog with a series of buttons to choose from. This takes two arguments:
* '''Message''' ''string'': Text to appear at the top of the dialog.
* '''Options''' ''array'': A list of options, each of which will show up as a button. Each entry in this array should be a table with two fields, '''text''' and '''selected'''. '''text''' populates the text that will appear on that button, and '''selected''' is a zero-argument function that gets called if the player selects that option.

'''UI.InterceptNextTerritoryClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a territory on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a territory, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:TerritoryDetails|TerritoryDetails]] object, which can be used to get the Territory ID or the name of the territory that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextTerritoryClick before a territory is clicked.

'''UI.InterceptNextBonusLinkClick''': Added in [[Mod_API_Reference:IsVersionOrHigher|5.17.0]]. After calling this function, the next time the player clicks a bonus link on the map, your mod will be notified of the click. After calling this, you should also instruct the player to click a bonus link, and it's also a good idea to let them know they can move dialogs out of the way to see the map.
* '''Callback''' ''function'': Pass a function that will be called on the next click. This function will be passed a [[Mod_API_Reference:BonusDetails|BonusDetails]] object, which can be used to get the bonus ID or the name of the bonus that was clicked. This function can also be called with nil if the intercept request is cancelled, which can happen if another mod calls UI.InterceptNextBonusLinkClick before a bonus link is clicked.

InterceptNextTerritoryClick
[[Category:Mod API Reference]]