Colyseus Bot Template

bot-client.ts

export class BotClient {
  client: Client;
  room: Room<GameState>;
  player: Player;
  sessionId: string;
  
  constructor(server: string | Client) {
    this.client = server instanceof Client ? server : new Client(server); 
  }
    
  dispose() {
    // clean up here
  }
    
  async joinRoom(roodId: string) {
    this.room = await this.client.joinById<GameState>(
      roomId,
      {
        bot: true,
      },
      GameState
    );
    
    this.begin();
  }
    
  // useful if you want to integrate with loadtest
  attachToRoom(room: Room) {
    this.room = room;
    this.begin();
  }
  
  leave() {
    this.room?.leave(true);
  }
    
  private begin() {
    this.sessionId = this.room.sessionId;
    
    // attach message handlers, e.g...
    this.room.onMessage<string>('ping', (message) => {
      this.room.send('pong', { message });
    });
    
    // listen for state changes
  }
}

game-room.ts

export class GameRoom extends Room<GameState> {
  bots: Map<string, BotClient> | null = new Map<string, BotClient>();
  
  async addBot() {
    const bot = new BotClient(SERVER_URL);
    await bot.joinRoom(this.roomId);
    this.bots.set(bot.sessionId, bot);
  }
                                   
  onLeave(client: Client, consented: boolean) {
    const player = this.state.playerWithClient(client);

    if (player.bot) {
      const bot: BotClient = this.bots[client.sessionId];

      if (bot) {
        this.bots.delete(client.sessionId);
        bot.dispose();
      }
    }
  
    // remaining leave actions...
  }
                                   
  onDispose() {
    this.bots.forEach((bot) => {
      bot.dispose();
    });

    this.bots = null;
  
    // remaining dispose actions...
  }
}