Query game API

2017-08-04T06:17:06Z

Master of the Dead: /* Usage */

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(id, state, name, numberOfTurns, lastTurnTime*, templateID, players) about the game.

<nowiki>*</nowiki> - lastTurnTime is the timestamp of the last turn or the game finish date

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

Seasonal Ladder

2017-07-28T20:56:23Z

Master of the Dead: /* Rankings */

'''Seasonal Ladder''' is a kind of ladder which was announced by Fizzer on the 23rd of November, 2011[https://www.warlight.net/blog/index.php/2011/11/announcing-the-seasonal-ladder/]. Unlike the other ladders, which are never-ending grinds for top spot, the seasonal ladder is divided into a 60 days seasons, where each season will use different [[settings]]. The first season started on 9 December, 2011[https://www.warlight.net/LadderSeason?ID=4000].

== Games ==
Each player that plays in a season will get 20 games [[#Notes|*]], and will never play the same opponent more than once.

On the first day of a season, every player will get 4 games. Every 4 days after that, one more game is added until all players have 20 games. If a player joins the season late or leaves it early, they are not guaranteed to get 20 games. However, the ladder will try to catch them up with the crowd.

=== Force-finish ===
In order to ensure a winner can be declared and the rankings can be finalized, all games in a season must end by the ending date, which is exactly 60 days after it began. If a game isn't finished when the season ends, WarLight will immediately end it. The winner will be determined by adding up how many armies each player controls on the [[map]], then adding in each player's income times two.

Players are expected to make a reasonable effort to finish a game before the season ends. If you try to intentionally win a game by force-finish that you would have otherwise lost, the win will be taken away from you.

== Rankings ==
The rankings are determined using the same ELO scale that the existing [[ladders]] use, with one small modification, players who play fewer than 20 games (due to leaving the ladder early or joining late) get a penalty of 65 rating points per game. It’s best to join the season before it starts and stay in it for the whole 60 days to ensure you do not receive a penalty. The penalty exists to ensure that players can't get a game from the system by intentionally joining the season late and riding to a high-rank by getting a few lucky games.

== Notes ==
<nowiki>*</nowiki> - some players may get more games, since there are cases where it's not mathematically possible to give everyone exactly the same amount without duplicates. Getting more games is neither an advantage nor disadvantage. 

== List of winners ==
{| class="wikitable" style="text-align: left;"
|-
! Season !! Winner !! Started
|-
| Season I || Rubik87 || 12/9/2011
|-
| Season II || PaniX || 2/9/2012
|-
| Season III || Rubik87 || 4/13/2012
|-
| Season IV || Fizzer || 6/19/2012
|-
| Season V || professor dead piggy || 8/21/2012
|-
| Season VI || unknownsoldier || 10/22/2012
|-
| Season VII || fatality || 1/2/2013
|-
| Season VIII || Heyheuhei || 3/5/2013
|-
| Season IX || brisk • apex || 5/7/2013
|-
| Season X || The Duke of Ben || 7/9/2013
|-
| Season XI || Yeon || 9/10/2013
|-
| Season XII || Ruthless Bastard || 11/12/2013
|-
| Season XIII || Krzychu || 1/15/2014
|-
| Season XIV || Killua Zaoldyeck || 3/31/2014
|-
| Season XV || JV || 6/10/2014
|-
| Season XVI || Verzehrer || 8/12/2014
|-
| Season XVII || Gol D. Roger || 11/4/2014
|-
| Season XVIII || timon92 || 1/23/2015
|-
| Season XIX || Rento || 4/22/2015
|-
| Season XX || Latnox || 7/10/2015
|-
| Season XXI || #Master [QB] || 9/28/2015
|-
| Season XXII || master of desaster || 12/10/2015
|-
| Season XXIII || Master Jz || 2/11/2016
|-
| Season XXIV || MisterT || 5/16/2016
|-
| Season XXV || timon92 || 8/15/2016
|-
| Season XXVI || ''In progress'' || 11/2/2016
|}

== See also ==
* [[1 v 1 Ladder]]
* [[2 v 2 Ladder]]
* [[Real-Time Ladder]]

{{Seasonal Ladder seasons}}

[[:Category:Ladders]]

War.app Wiki - User contributions [en]

Query game API

Seasonal Ladder