On the game world, there are troops and resources. There are 2 win conditions:
- destroy each enemy troop before turn 1000
- have more resources than the enemy at exactly turn 1000 If both enemy troops are destroyed in the same turn, or if both players have the same resources at the final turn, the game is considered a draw.
Resources are also used to spawn new ally troops or to level up their statistics.
The world is a 11x11 grid, with coordinate (0,0) in the bottom left corner. Player 1 spawn position is at (2, 2). Player 2 spawn position is at (8, 8).
Each player can:
- Move each troop once per turn
- Use each troop to attack enemy troops or resources
- Improve how many troop statistics you want, consuming resources in the process. Each troop can be upgraded multiple times, even the same statistic.
- Spawn at most 1 new troop per turn, consuming resources in the process. You can control at most 10 troops at the same time.
Players and world alternate between reading and writing data into a txt called a "channel". Your bot will receive the name of the txt as a command line argument when started. Each turn you'll be able to read the latest state of the game and to write your commands for this turn.
Inside the channel you'll immediately read a spawn_pos <x> <y> information, telling you what your spawn position is, followed by a match_startcommand.
When your bot is ready to start you should write ready inside the same channel. You might overwrite previous information without any problem, the game will do the same in the following turns.
After the ready command is accepted from bot players the world will start the game, writing for each turn the latest state of the game and the latest important events.
The game always finishes writing data with a "world_done" statement, you'll then be able to write your own commands (see below for more information).
Players always should finish writing data with an "end_turn" statement, so the world can calculate what happens and pass to the next turn, replying with new data.
When the game is finished you'll read a end_match statement. You might safely close your bot or ignore it as you please.
-
move : moves a troop in a straight line in a given direction by a given number of steps. Each troop can only move once per turn. If multiple move command with the same id are given, only the first one will be executed. If an obstacle is found while moving the troop will collide with the obstacle, meaning each cell can only be occupied by 1 troop or 1 resource at the same time. : integer number which uniquely identifies the troop to move : one of "up", "down", "left", "right" : integer number [0, maxSpeed] of how many steps to take in that direction, if amount is more than the troop's movement speed, the troop will only move by its max speed example: move 0 right 1 move 1 up 5
-
action : lets a troop attacks or harvests in a given direction. Each troop can only make an action once per turn. If multiple action commands with the same id are given, only the first one will be executed The troop attacks a cell directly in front him. If the cell is an enemy troop or a resource, damage is inflicted, based on the troops damage stat. If a resource is destroyed each player who attacked the resource in this turn will be awarded with a portion of the resource value. Each resource grants 6 resource points. : integer number which uniquely identifies the troop which attacks/harvests : one of "up", "down", "left", "right" example: action 0 right action 1 up
-
powerup : powers up a troop statistic, consuming 3 resources. If the player doesn't have enough resources the powerup command is ignored. You can powerup how many times you want in a single turn. : integer number which uniquely identifies the troop to powerup : one of "health", "speed" or "damage": health -> increases current HP by 1 speed -> increases current Move Speed by 1 damage -> increases current Damage by 1
-
create: creates a new troop at the player spawn position, consuming 5 resources. If the player doesn't have enough resources the create command is ignored. If the spawn position is occupied by something the command will be ignored. Because of this you might spawn at most 1 troop per turn. You can control at most 10 troops at the same time.
-
end_turn: finishes a turn. Other commands sent after this are ignored. Turn doesn't resume until end_turn is written by both players into each channel.
-
turn tells the current turn number : integer of current turn : float amount of resources the player has
-
troop <x_position> <y_position> <move_speed> tells information on a troop in the game : "ally" or "enemy", your bots are always "ally" : integer number [0, n] where n is how many bots that team has <x_position>: the troop's x position in range [0, w] as an integer <y_position>: the troop's y position in range [0, h] as an integer : the troop's health as an integer <move_speed>: the troop's move speed as an integer, see troop's move command for more info : the troop's damage as an integer, see troop's action command for more info example: troop ally 0 2 2 2 1 1 troop enemy 1 8 8 2 1 1
-
resource <x_position> <y_position> tells information on a resource in the game <x_position>: the resource's x position in range [0, w] as an integer <y_position>: the resource's y position in range [0, h] as an integer : integer health remaining of the resource : integer amount of resource gained when destroyed
-
action tells the last meaningful actions examples: "action troop ally 1 10 20 move 11 20" "action troop ally 1 10 20 harvest 11 20" "action troop ally 1 10 20 attack 11 20" "action troop enemy 2 4 6 powerup damage" "action troop enemy 2 spawn" formats: "action troop" <x_position> <y_position> <move | harvest | attack> <x_target> <y_target> "action troop" <x_position> <y_position> "powerup" <damage | health | speed> "action troop" "spawn"
-
world_done tells the player the world's turn has ended, meaning the bot can now write into the channel his actions for the turn
-
end_match tells the player the match has finished. The bot may safely close after having read this command. If the bot is not closed after some time it will be closed automatically
To run your bots and play your game locally:
- open a first console, then start a world game with the command
./world.py <debug> <print_speed>where = "True" or "False" and <print_speed> is a float from 0 to n, where n is the number of seconds to wait before writing the next important event to console. - open a second console, then start a bot accordingly
- if the bot is yours you might start it as required
- if the bot is a python script use the command
python <bot_name>.py channel1.txt - if the bot is an exe use the command
./<bot_name>.exe channel1.txt
- open a third console with the other bot to play against, sending the
channel2.txtinstead
Requirements: python version 3.10.4 pip install rich a coding language that can
- accept command line arguments as input
- read and write txt files
To let the bot be able to play competitively you should send us its source code (we don't trust executables!)