javascript client that communicate with aicup kernel
- first make sure you have nodejs installed on your computer.
you can download it from the official website : https://nodejs.org/en/download - download the repository and unzip it then open the terminal and use cd command to go to the project's directory
- run npm install to install all the project's dependencies
- run the kernel web-server and then set server_ip and server_port of the web-server in config.js file
- put your code and logic for the game in functions inside main.js ( a sample code already exist in this file you can check it to learn how your code should be )
- finally run npm start to run the client
game object is passed to both initilizer and turn function in main.js and you should write your code withing these functions .
game object has some methods which are all marked as async so they return a promise and you should use await keyword everywhere you use them .
all of the methods will throw exception if there is an error , so it's better to wrap each of the method in try catch blocks to handle the errors and prevent the program from crashing .
| method name | description | success result example |
|---|---|---|
| get_owners() | this method is used to get the owners of all nodes. -1 means node has no owner. other numbers are the player_id of the owner. |
{
"1" : -1,
"2" : -1,
"3 : 0,
"4" : 1,
"5" : -1,
} |
| get_strategic_nodes() | this method is used to get the list of strategic nodes and their coresponding score so for example the score of the node in index 2 is the value of score array in index 2 |
{
score: [ 2, 1, 5, 4, 1, 3 ],
strategic_nodes: [ 3, 4, 7, 20, 29, 40 ]
}
|
| get_turn_number() | this method return the current turn number |
{
turn_number: 5
}
|
| get_adj() | return an object with the node's as key and array of adjecent nodes with that node |
{
'0': [ 1, 2 ],
'1': [ 0, 2, 3 ],
'2': [ 0, 1, 3 ],
'3': [ 1, 2, 4 ],
'4': [ 3, 5, 6 ],
'5': [ 4, 6, 8, 7, 14, 13 ],
'6': [ 4, 5, 7, 21 ],
}
|
| get_number_of_troops_to_put() | the number of troops that you own but you havn't place them on any node |
{
number_of_troops: 12
}
|
| put_one_troop(node_id) | this method is used to put one troop inside the node_id | { message : "troop added successfully" } |
| put_troop(node_id , number) | this method is used to put number troop inside the node_id | { message : "troop added successfully" } |