Based on the official Hasbro rules - refer to these for any disputes.
Hacker Risk is avaliable on pip with pip install risk. This will get you the risk module which has the relavent classes and methods in order to play the game. Currently the actual actions taken by each of the players are not implemented, but rather are designed to be sub-classed for a specific implementation. The Hacker Risk Battleroom (source) is the core example of such an implementation. Adding command line functionality to this core implementation is on the future roadmap.
The game board is a graph of 6 continents divided into 42 countries. Each continent contains from 4 to 12 countries.
The country names and graph data are available in the board_graph.json file.
Armies are simply represented by an integer value, as part of the data for a country.
There are 42 cards, marked with a territory and an infantry, cavalry, or artillery. There are two wild cards marked with all three pictures, but no territory.
To conquer the world by occupying every country, thus eliminating all your opponents.
The number of troops that each player will need:
- 3 Players: 35 Troops Each
- 4 Players: 30 Troops Each
- 5 Players: 25 Troops Each
- 6 Players: 20 Troops Each
The order of play will be selected randomly by the server. Each player will take turns placing a troop into an empty country on the board. Once all countries have been taken, players continue placing troops on countries that they own, until they have run out of troops to place.
Each turn consists of three steps, in this order:
- Place new troops
- Attack (optional)
- Fortify one country
At the beginning of your turn, you will be able to trade in any risk cards (explained later). The number of troops you may place is then:
max(ceiling([# OF COUNTRIES YOU CONTROL] / 3), 3) + [TROOPS BOUGHT WITH RISK CARDS] + [CONTINENT BONUSES]
Thus you will always receive at least 3 troops on every turn.
You may also gain 2 additional troops from trading in risk cards for a country you own, but since you do not get to control the placement of those units, they will simply be added to that country.
At the end of any turn in which you have captured at least one territory, you will earn one (and only one) risk card. You are trying to collect sets of 3 cards in any of the following combinations:
- 3 cards of the same design (Infantry, Cavalry, Artillery)
- 1 of each three designs
- Any two card plus a wild card
If you have collected a set of three risk cards, you may turn them in at the beginning of your next turn, or you may wait. However, if you have 5 or 6 cards at the beginning of your turn, you must trade in at least one set, and you may choose to turn in more than one if you have it.
The game starts with all players choosing countries one at a time, using the choose_country command. After all countries have been chosen, players will place troops using the deploy_troops command, one troop at a time.
At the beginning of a player's turn, if the player has a useable set of card, the use_cards. If you have less than 5 cards, you will also recieve the pass option.
Next, the deploy_troops options will be available. This step is required.
During the main phase of a turn, the actions available are attack and end_attacking_phase. A player may attack as many times as they want during a turn, and when the player is done attacking, they must call end_attacking_phase.
The final options after the attacking phase will be reinforce and end_turn. Calling end_turn will end the player's turn and move on to the next without reinforcing any countries.