一种多动作、回合制游戏，用作教授人工智能中使用的算法和方法的工具_python_代码_下载

# ReAntics 2017-18 University of Portland Capstone Project to develop a tool allowing students to create/debug agents using a variety of artificial intelligence techniques ## Caveats - Agents with the same name: undefined behavior # ReAntics Student Manual ## How to Play ReAntics: ### Rules of the Game: **ReAntics is a turn-based tactics game which revolves around two players competing via two colonies of ants. Each player has his own anthill, queen ant and any other ants or tunnels he has built. The anthills can be used for “building” new ants and both anthills and tunnels can store food collected by ants. Each player begins the game with a single queen ant and loses the game if the queen is killed. The other ants must be bought with food that is gathered by worker ants.** Victory can be achieved either through military or economic dominance of the map. Specifically, a player will win if his opponent’s queen is killed, his opponent’s anthill is captured, or if the player collects 11 units of food. The game begins with a 10x10 (grid-based) board where each player places an anthill and tunnel on their side of the board. After placement, the queen ant is placed on the anthill and a worker ant is placed on the tunnel. As depicted by the red and blue boundaries in the game, the board is divided into three parts. The top four rows are Player 1’s side while the bottom four rows are Player 2’s side. The middle two rows belong to neither player. Player 1 begins the game’s setup phase by placing her anthill, tunnel, and 9 grass pieces on her side of the board.. Lastly, players place two food sources on their enemy’s side of the map. After this last step, the players’ queen ants are placed on their respective ant hills, worker’s on their respective tunnels, and the setup phase is complete. After setup, the player designated to go first make one or all of these actions: he may move each ant once which opens up the option to attack or build one ant from his anthill. When the player is done with his turn he clicks the “End” button. Only one ant is allowed to occupy a tile at a time. To move an ant the player will click the ant she wishes to move and its square will be highlighted in green to show its selected. Any tiles the ant is allowed to move to will be highlighted green. Clicking on a highlighted tile will move the ant to that tile and shade it grey to show that it has already moved this turn. If the move puts the ant in attack range of one or more enemy ants, all the enemy ants in range will be highlighted in red. To attack one of the ants the player may click on it. An attack must be made when available and, strategy-wise, there is no reason not to do so. To create an ant the player selects his empty anthill. A popup menu will appear listing the four buildable ants. The player may click the ant type he wants to create and it will be created on top of the anthill if they have enough food. Or the player may click elsewhere on the board or press the esc key to cancel building an ant. The ant that is created cannot be moved until the next turn and so is shaded grey upon creation. Each ant type performs slightly differently in the game according to performance attributes for Movement, Health, Attack, Range, and Build Cost. The performance attributes for the five ant types are summarized in Table 1. **Table. The Ant Performance Attributes** | Attribute | Worker | Drone | Soldier | Ranged Soldier | Queen | | --- | :---: | :---: | :---: | :---: | :---: | | **Special Characteristics** | Can carry food | Ignores grass, movement cost | | Ignores grass, movement cost | Results in loss if killed, Cannot leave home zone | | **Movement:** The number of tiles and ant can move in one turn. | 2 | 3 | 2 | 1 | 2 | | **Health:** The amount of damage an ant can sustain | 4 | 4 | 8 | 2 | 10 | | **Attack:** The amount of damage the ant does when it attacks | 0 | 2 | 4 | 3 | 4 | | **Range:** The distance from which this ant can attack | N/A | 1 | 1 | 3 | 1 | | **Build Cost:** The amount of food it takes to build this ant | 1 | 2 | 2 | 2 | N/A | The statistics for the four different construction types are show below. Constructions can be buildings, obstacles, or food. **Table. The Construction Type Statistics** | Attribute | Anthill | Tunnel | Grass | Food | | --- | :---: | :---: | :---: | :---: | | **Movement Cost:** The number of movement points it takes to move an ant onto this tile. | 1 | 1 | 2 | 1 | | **Capture Health:** The number of turns an ant must be on this construction to capture it. | 3 | N/A | N/A | N/A | ### How to start a game: #### QuickStart: Select 1+ Agents: 1: Human v. AI 2: AI v. AI single set 3+: Round Robin between all of the agents selected Enter a number of games to play (defaults to 1) Click the Green **Quickstart** Button (top right). ( ** Note: Anything selected in **Additional Settings** will also be applied ** ) Start Click on the dropdown menu at the top right, currently labeled “QuickStart”. Select an option: Two Player: select a player one and a player two (must be distinct, with **different names**) Play Self: select a single agent to play against itself. ( ** Note: a copy will be created, with “@@” appended to the name, and its player ID will be the constant COPY (-2) ** ) Round Robin: select 2+ agents to compete in a round robin tournament (every combo plays the specified number of games) Play All: select a single agent to play all of the other agents available in the game Enter the number of games and click the “+” button to add it to the game queue on the left. Continue to add games util you are satisfied with your queue. Click the Green Start Button (bottom left). ( ** Note: Anything selected in **Additional Settings** and **Pause Conditions** will also be applied ** ) #### Additional Settings: (applied to **both** QuickStart and Start) **Alternate Player Start:** eliminate player 1 advantage by alternating which agent is player one each game **Verbose:** print the win/loss record to the terminal **Move Timeout:** Enter a move timeout in seconds (decimals allowed) **AND** check the option to apply **Auto-Restart:** automatically restart the games queue on finish **Pause on Start:** start the game in a paused state (to step through moves or get an accurate non-gameboard updating time) **Pause on Illegal Move:** pause whenever there has been an illegal move submitted **Layout Option:** Select either Player Invoked or Random Override (overrides the human player) #### Pause Conditions: (only applied to the Start Button) Select a the two players and the joint conditions to pause under. Then add them to the list on the left. ### Human vs AI mode: **Move ant:** Select the ant by clicking it, valid possible moves will be highlighted in green. Clicking on a highlighted square will move the ant to that location. **Attack ant:** If an ant’s move takes it within range of an opponent’s ant, then it must make an attack. This is done by simply clicking the ant to attack. (Note: valid attacks options are highlighted in red). **Capture a building:** End an ant’s turn on an enemy’s building. This will reduce the building capture health by 1 and when it reaches 0; either ownership of the building will swap to the capturing player or result in victory if the anthill is captured. **Build ant:** Select the anthill when there is no ant currently on it. This will open a menu listing all available ants to build. Ants which the player can afford will be listed in black, ants which the player cannot afford will be listed in red. Selecting an ant from this list will build the ant on the anthill and deduct the food from the player’s food supply. **End turn:** Simply click the “End” button. **Undo:** Click the undo button to undo moves. The undo button can revert the state up through the beginning of the player’s turn. ### AI vs. AI mode: A