FAQ
If you experience any errors/issues, please check if a solution has already been documented before. If not, please report them in our #🐛-bug-reports channel or raise an issue on our public repo here.
You will need to rebuild and restart your containers. Try:
docker-compose down
docker-compose build
docker-compose up --abort-on-container-exit
The Docker CLI is unable to reach the Docker Daemon. Try checking that your Docker is up and running.
This is likely because you are using a
WORLD_SEED
that is invalid (i.e. game is trying to generate a map that breaks some pre-defined rules). Try using another WORLD_SEED
. Examples of broken WORLD_SEED
's include 5555
and 9999
.You can connect a second agent or switch out any connected agent by changing the services
agent-a
and agent-b
in the docker-compose.yml
file provided in the starter kits.By default,
agent-a
is commented out. Un-comment this block to connect a second version of your agent to the game server.base-compose.yml
contains some default services that you can switch out either agent-a
or agent-b
for. If you want to create your own, you will need to create your own Dockerfile (more docs on this here). You will need to re-build the image after editing
base-compose.yml
(add the--build
flag to your docker-compose up
command). agent-a:
extends:
file: base-compose.yml
# update next line with a service in base-compose.yml to change agent
service: python3-agent-dev # e.g. change to 'python3-agent' to test production build
environment:
- GAME_CONNECTION_STRING=ws://game-server:3000/?role=agent&agentId=agentA&name=python3-agent
- FWD_MODEL_CONNECTION_STRING=ws://fwd-server-a:6969/?role=admin
depends_on:
- game-server
- fwd-server-a
networks:
- coderone-tournament
You will need to create your own starter kit (you can use the Python and TypeScript versions as references) and ensure your agent's packets to the game server conform with the JSON schema under
ValidAgentPacket
described in:It will be safe to assume the following default runtime resources will be available:
--cpus=2
--cpu-period=100000
--memory=1024m
See the Docker documentation here for a more verbose explanation of the above values:
You can suppress some of the logs (e.g. tick counting) by setting the flag
TELEMETRY_ENABLED
to 0
(more info on changing environment flags here).Servers labelled
dev
mount your host volume to the container. When changes are made to your agent, they will be reflected once you restart the agent container, without needing to rebuild the image. Servers without the dev
label are best for testing your production/submission-ready build.You can add a restart policy to the game-server service in
docker-compose
(docs here). Alternatively, you can run the game using docker-compose up --abort-on-container-exit
so that you will not need to exit the containers before restarting them.If your Agent tries to make an invalid move, the game environment will reject that action and your Agent will do nothing instead.
Actions are processed in the order that the agent packets are received, even if they occur within the same tick.
The game server will resolve events in the following order:
- 1.Resolve all placements
- 2.Resolve all detonations
- 3.Resolve all agent movements (up/down/left/right)
Last modified 2yr ago