War.app Wiki - User contributions [en]

Inkscape tips

2018-04-08T02:05:34Z

54.91.6.221: Corrected spelling mistake in the Making Clean Map Borders section.

This page gives tips on how to perform common tasks in Inkscape related to Warzone map development. Also check out [[SVG workarounds]] if you're having problems having your SVG file show up correctly.

==Unioning==

It's possible to have one player-controllable [[territory]] that spans several objects in Inkscape. This can create islands off the coast of a territory, which is used in several Warzone maps.

To accomplish this, first make all of the objects as individual territories. Then select them all at once, and select Path -> Union.

==Fixing small territories==

The union feature can also be used to ensure players can click on small territories. Take, for example, Baja from the [[Earth]] map. In its raw form, it's way too small to fit an army number or be clickable:

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

To rectify this, we draw a circle on top of it:

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

Then select both the new circle and the Baja territory behind it at the same time. Select Path -> Union, and observe the resulting territory:

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

== Cutting holes ==

Sometimes maps call for having territories inside of other territories. It may be logical to just make both territories and put the outer one behind the inner one, but this doesn't work since in Warzone player-controllable territories should never overlap. Instead, a hole should be cut in the bigger territory so the smaller one can persist in the hole.

To accomplish this, we use the Path -> Difference command. To begin, select both territories (the inner and outer one) at the same time using Shift+Click

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

Then select Path -> Difference. This will delete the smaller object and leave the outer one with a hole.

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

Since this deletes the inner object, you should consider making a duplicate of it, and perform the operation with the duplicate.

==Simplify==

Sometimes territories can contain way more data than they need. One example is after drawing territories with the pencil tool, if you view the vertices (F2) you'll see it has an excessive amount.

This is easy to fix simply by selecting Path -> Simplify (Ctrl+L). This reduces the number of vertices drastically, and in most cases, doesn't alter the appearance of the object at all:

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

Not only does this make the object easier to work with and increase the performance of Inkscape, it also reduces the size of your resulting Warzone map which makes it load faster and allows you to fit more objects into your map.

==Making clean map borders==

This section will teach you how to make clean map borders.

Draw the entire map outline. Ignore bonuses for now.

Draw a line where you want your first bonus border to be. Set the line width to 0.8 pixel.

http://i44.tinypic.com/v5anq1.jpg

Do the following. You can get quite quick at it after a while:

Select the path

Press CTRL+ALT+C

Select the path and the map outline you drew earlier

Press CTRL+-

Press CTRL+SHIFT+K

http://i44.tinypic.com/2wlt26g.png

There you go! A clean bonus border! Now do it until all bonuses are separate paths.

Draw a line where you want your first territory border to be. The width of the line doesn't matter now.

http://i40.tinypic.com/ftde15.png

Select both the path and the bonus, and press CTRL+/.

http://i43.tinypic.com/2ylr3n9.png

There you go! A clean territory border! Now do it until all territories are separate paths.

[[Category:Map Making]]

Rules

2018-02-12T00:17:19Z

54.91.6.221: Added ladder rules

Warzone maintains a few '''rules''' that players must follow to help Warzone stay a civil place where everyone feels welcome.

This article discusses the official rules that all players '''must''' follow in order to be allowed to play Warzone. Players sometimes invent their own etiquette around things like [[booting]] and [[voting to end]], however these are not enforced like the official rules are.

==The Rules==

The following three rules are presented to all players the first time they play a game with other players:

# You shall be respectful to other players at all times.
# Racial slurs, personal attacks, excessive profanity, or any other offensive language will not be tolerated.
# You shall not operate more than one Warzone account in a way that gives you an advantage in a game, tournament or ladder.
# You may never operate or access more than one account with a coin balance or that plays coin games, and that account may never be used by another person.

It's also important to note that additional rules exist in the Warzone [https://www.warzone.com/TermsOfService terms of service]. These rules aren't displayed as prominently since they're common sense, but they still apply. Examples include, but are not limited to, impersonating other players, rigging games, launching denial-of-service attacks, or using someone else's account without their permission.

Additionally, since Warzone displays ads, players must also abide by the rules imposed by the advertisers. The following is not allowed to be submitted or linked to:

# pornographic content or links to pornographic content
# erotic stories or descriptions of sexual acts
# sexual jokes
# erotic or sexual forums

==Ladder Rules==

The following are the rules for playing in any of the official Warlight ladders.

# You may not play on the 1v1 Ladder if you have another account which has unexpired games on that ladder. Games expire 5 months after their end date.
# You may not play on the Real Time Ladder if you have another account which is currently ranked. Accounts become unranked after 3 days of inactivity on the ladder.
# You may not use more than one account in any season of the Seasonal Ladder.
# You may not manipulate the Seasonal Ladder's force-finish mechanism in order to win games.
# You many not play on the 2v2 or 3v3 ladders with a team if there is another team on that same ladder consisting of the same players. You may play if at least one of the players on the new team is a new different player or if one or more of the players on the old team is not on the new team. Essentially, if the only difference between two teams is that a player has been replaced by an alt of the same player, then it is not considered to be a different team.

==Enforcement==

Because all players must agree to obey these rules the first time they click the multi-player tab, it's assumed that all players know and understand the rules. Players who knowingly disobey the rules can be [[reported]].

Players who break the rules can be warned, suspended, or banned. A warning is usually given first if the infraction not very severe. However, in extreme cases players can be directly suspended or banned without a warning. For banning or longer suspensions, players may be automatically surrendered in all of their games to allow the remaining players to continue the game without them if they choose to do so.

Warnings are completely anonymous -- other players cannot tell that a player received a warning. However, suspensions and banning are revealed on a player's profile for the duration of the suspension.

==Non-rules==

As mentioned above, players sometimes invent their own etiquette around how the game should be played. It's okay to do this, however, you should not expect that players will be warned or suspended when they break your etiquette. Instead, use your [[black list]] to avoid playing with the problem players.

# Booting: Booting isn't against the rules. If it were, the button simply wouldn't be there! In particular, some players feel that booting within a certain threshold of the boot timer should result in suspensions. Instead, it's recommended to set your boot timer to the duration that you'd first like to see players become bootable. For example, instead of setting the boot timer to 5 minutes and asking nobody click it until 7 minutes have passed, just set the boot timer to 7 minutes. You will save yourself a lot of hassle.
# Not taking their turn fast enough: Warzone can't force people to play, and you should not report players for not playing. If you find yourself waiting on other players longer than you'd like, please create or join games with lower boot times so you can boot them and continue your game.
# Colluding: Players working together is not against the rules, and you should not report players for doing so. To avoid collusion, play in 1 v 1 games where collusion is impossible, or in team games (since then the collusion is pre-arranged), or just play with friends you trust.

[[Category:Warzone]]

Query game API

2017-05-12T03:12:39Z

54.91.6.221: fixed player state documentation to reflect actual API output

WarLight can provide programmatic access to the details about multi-player WarLight 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.

==Usage==

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

This will return data describing basic details 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.

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

==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.
* 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.

Each finished game is guaranteed to have at least one player with a Won state or a VotedToEnd state.

==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 WarLight 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]]

Cards

2017-03-31T13:30:00Z

54.91.6.221: /* Types of Cards */

'''Cards''' can be played to accomplish a variety of tasks, such as gaining additional armies, spying on opponents, airlifting armies around, etc.

==Receiving Cards==
When you successfully attack and capture an enemy or neutral [[territory]], at the end of that turn you will receive a piece of a card, regardless of whether you lose the territory later that turn. You can't get more, no matter how many territories you take.

Games can also be configured to give more than one piece per turn via the [[number of card pieces per turn]] setting. In this case, players who take a territory will always get exactly that number of pieces configured by that game each turn.

If a game has multiple types of cards included, the type of card(s) you get is determined randomly based on their [[Card weights|weight]]. It's also possible for game creators to configure [[Card minimums|minimums]] that remove the randomness, either partially or completely.

==Details==
The game creator can pick which cards will be available in their game, so be sure to check the game [[settings]] to know which types of cards you're dealing with.

Cards can be divided into any number of pieces. You cannot play a card until you have collected the entire card.

You may only hold onto a certain number of cards at one time, as defined by the [[maximum number of cards you can hold]] setting. Therefore, there can be occurrences where you must use or discard a card.

When you play a card, that card is consumed. Even if the card had no effect, you don't get your card back. For example, if you spy on a player who gets eliminated the same turn, the card is just wasted.

==Types of Cards==
WarLight has 13 different cards:

* [[Reinforcement Card]]
* [[Spy, Reconnaissance, and Surveillance Cards]]
* [[Emergency Blockade Card and Blockade Card]]
* [[Order Priority Card]]
* [[Order Delay Card]]
* [[Airlift Card]]
* [[Gift Card]]
* [[Diplomacy Card]]
* [[Sanctions Card]]
* [[Bomb Card]]

==Card Fog==
There are two "fog" settings that determine what is shown to your opponents in regards to cards:

* Visibility of opponent's cards: This setting, visible or hidden, determines whether you can see what cards your opponent is holding as well as the type of card they get at the end of each turn. To see the cards, open the Cards panel and select a player in the drop-down.

* Visibility of opponents playing cards: This setting, visible or hidden, determines whether you can see when your opponents play their cards. If it's set to visible, then all cards being played are public (they'll show up in the [[orders list]].)

{{Cards}}

[[Category:Cards|!]]