Lugo - The Dummies JS

The Dummies JS is a Nodejs implementation of a player (bot) for Lugo game.

This bot was made using the Node Client Player.

Use this bot as a starting point to a new one.

Dependencies

• Docker (https://docs.docker.com/get-docker/)
• Docker Compose (https://docs.docker.com/compose/install/)
• (optional) NodeJS with NPM (https://nodejs.org/en/download/current/)

Before starting

Are you familiar with Lugo? If not, before continuing, please visit the project website and read about the game.

How to use this source code

1. (optional to speed up next steps) Download the images that you will need

   docker pull lugobots/server
   docker pull lugobots/the-dummies-go:latest
   docker pull node:18

2. First run to install dependencies: The first run may take a while because the dependencies will be installed

   docker compose up

   and open http://localhost:8080/ to watch the game.

3. Now, make your changes: (see ❓How to change the bot)

4. Play again to see your changes results:

   docker compose up

5. Are you ready to compete? Build your Docker image:

   docker build -t my-super-bot .

How to edit the bot

The only files that you may need to edit are the ones inside ./src. Ignore all the other ones.

Main file src/main.ts

You probably will not change this file. It only initializes the bot.

Settings file src/settings.ts

Settings file only stores configurations that will affect the player behaviour, e.g. positions, tactic, etc.

Settings file src/my_bot.ts

👀 This is the most important file!

There will be 5 important methods that you must edit to change the bot behaviour.

 /**
     * OnDisputing is called when no one has the ball possession
     */
    onDisputing: (inspector: GameSnapshotInspector) => Lugo.Order[] | null

    /**
     * OnDefending is called when an opponent player has the ball possession
     */
    onDefending: (inspector: GameSnapshotInspector) => Lugo.Order[] | null

    /**
     * OnHolding is called when this bot has the ball possession
     */
    onHolding: (inspector: GameSnapshotInspector) => Lugo.Order[] | null


    /**
     * OnSupporting is called when a teammate player has the ball possession
     */
    onSupporting: (inspector: GameSnapshotInspector) => Lugo.Order[] | null

    /**
     * AsGoalkeeper is only called when this bot is the goalkeeper (number 1). This method is called on every turn,
     * and the player state is passed at the last parameter.
     */
    asGoalkeeper: (inspector: GameSnapshotInspector, state: PLAYER_STATE) => Lugo.Order[] | null

Running directly in your machine (:ninja: advanced)

If you want to run the NodeJS code in your machine instead of inside the container, you definitely can do this.

The command to start locally is BOT_NUMBER=1 BOT_TEAM=home npm run start. However, when you run the Docker compose file, all players from both teams will start. Then, if you run another bot directly from your machine, it will not be allowed to join the game.

But you also cannot start your bot before the game server has started.

You have two options to run your bot locally.

Option 1 - comment out the bot from the Docker compose file

You can edit the file docker-compose.yml and comment out the player that you want to run locally.

The game server will wait all 11 players from both teams to connect before starting the game.

Option 2 - starting the game server first

You can start only the game server with the command game_server. The game will wait for the players. Then, you start your local bot (BOT_NUMBER=1 BOT_TEAM=home npm run start), and finally start the rest of the players with the command docker compose up