Coder One
  • Welcome!
  • Quick Start Guide
  • References
    • Environment Overview
    • API Reference
    • Submission Instructions
  • Other
    • Starter Kits
    • FAQ
Powered by GitBook
On this page
  • 🛠️ Troubleshooting
  • docker-compose runs old containers and services
  • `docker.errors.DockerException: Error while fetching server API version: {'Connection Aborted.', ConnectionRefusedError(61, 'Connection refused'))`
  • ERROR: The Compose file './docker-compose.yml' is invalid because: Unsupported config option for services.agent-b: 'extends'
  • throw new Error("No agents were instantiated probably due to invalid world configuration")
  • 💥General
  • How do I change what agents are playing?
  • How do I use other programming languages?
  • What resources will be available for my agent during tournament and scrim matches?
  • How do I replay a game?
  • Can I access the game server outside of Docker?
  • How can I suppress the game logs sent by the server?
  • What do the labels fwd in the docker-compose files refer to?
  • What do the labels dev in the docker-compose files refer to?
  • Is there an easy way to restart the game without having to exit and rebuild the containers?
  • 🎮 Game Environment
  • What happens if my Agent makes an invalid move?
  • If both Agents try and occupy the same spot (or explode the same block), which Agent ends up in the spot (or takes the points) on the same tick?
  • Is there a simple way to run the game one step at a time?
  • Can I change the tick rate, starting variables etc?
  • In what order does the game server resolve events?

Was this helpful?

  1. Other

FAQ

PreviousStarter Kits

Last updated 3 years ago

Was this helpful?

🛠️ Troubleshooting

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 .

docker-compose runs old containers and services

You will need to rebuild and restart your containers. Try:

docker-compose down
docker-compose build
docker-compose up --abort-on-container-exit

`docker.errors.DockerException: Error while fetching server API version: {'Connection Aborted.', ConnectionRefusedError(61, 'Connection refused'))`

The Docker CLI is unable to reach the Docker Daemon. Try checking that your Docker is up and running.

ERROR: The Compose file './docker-compose.yml' is invalid because: Unsupported config option for services.agent-b: 'extends'

throw new Error("No agents were instantiated probably due to invalid world configuration")

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.

💥General

How do I change what agents are playing?

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.

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

How do I use other programming languages?

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 ValidAgentPacketdescribed in:

What resources will be available for my agent during tournament and scrim matches?

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:

How do I replay a game?

Can I access the game server outside of Docker?

How can I suppress the game logs sent by the server?

What do the labels fwd in the docker-compose files refer to?

What do the labels dev in the docker-compose files refer to?

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.

Is there an easy way to restart the game without having to exit and rebuild the containers?

🎮 Game Environment

What happens if my Agent makes an invalid move?

If your Agent tries to make an invalid move, the game environment will reject that action and your Agent will do nothing instead.

If both Agents try and occupy the same spot (or explode the same block), which Agent ends up in the spot (or takes the points) on the same tick?

Actions are processed in the order that the agent packets are received, even if they occur within the same tick.

Is there a simple way to run the game one step at a time?

Can I change the tick rate, starting variables etc?

In what order does the game server resolve events?

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)

This might be because you are using an older version of docker-compose which does not support the keyword extends. You will need to update docker-compose to version 1.27+. More info on the issue and info on how to upgrade .

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 ).

Download your JSON replay file and upload it .

Yes, we can provide you with the game server binary upon request. Reach out to @ModMail on .

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 ).

You can also configure your docker-compose file to log server output (documentation ).

This refers to the forward model and forward agent starter kit. More information available .

You can add a restart policy to the game-server service in docker-compose (docs ). 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.

Yes, check out the administrator feature .

Yes, you can change environment variables using the flags .

here
here
here
here
Discord
here
here
here
bomberland/validation.schema.json at master · CoderOneHQ/bomberlandGitHub
Help, Docker Compose Runs Old Containers!vsupalov.com
Logo
Logo
Runtime options with Memory, CPUs, and GPUsDocker Documentation
Logo
here
here
here
here