AYYO A.I. Bot Software Development Kit

Alpha Edition

Create your own ayyo.gg A.I. Bots!

AYYO fully supports automated agents playing our games and can directly incorporate your A.I. Bots into ayyo.gg.

AYYO A.I. bots act as virtual players in the AYYO game. AYYO A.I. Bots subscribe and process the AYYO game state in real-time, responding and sending controller inputs to the AYYO servers.

Players can develop and deploy A.I. behaviors to run autonomously in the cloud or in-game with the flip of a switch in the auto-pilot console.

This repository provides a Software Development Kit for building AYYO A.I. Bots.

Installation

npm install @ayyo.gg/sdk

Usage

import AYYO from '@ayyo.gg/sdk';

async function go () {

  // Creates a new AYYO.Bot client
  let bobbyBot = new AYYO.Bot({
    nickname: 'Bobby',
    apiKey: '0xAaAaaaAAaaaAaaeEEeeEeeEe89a9EF980AdcA1fC', // your public ETH address
    ayyoKey: 'top-secret-ayyo-key' // your ayyo.gg API key (optional)
  });

  // Listens for any errors from the client
  bobbyBot.on('error', function (err) {
    throw err;
  });

  bobbyBot.on('gamestate', function (gamestate) {

    // Perform arbitrary logic on gamestate array
    // Each item contains a state which represents a gamestate entity
    gamestate.snapshot.state.forEach(function (state) {
      console.log(state);
    });

    // 
    // Set any of the available control input values to true or false
    bobbyBot.sendInputs({
      UP: false,
      RIGHT: false,
      primaryWeapon: true
    });

});

  // Connects the bot to a random room
  await bobbyBot.connect();

  // Joins the default game room
  await bobbyBot.join();

}

go();

Note: The Server will reset all input values to false on each new gametick.

Available Control Inputs

const inputs = {
  UP: false,
  DOWN: false,
  LEFT: false,
  RIGHT: false,
  strafeLeft: false,
  strafeRight: false,
  strafeUp: false,
  strafeDown: false,
  primaryWeapon: false,
  secondaryWeapon: false,
  tertiaryWeapon: false,
  quadWeapon: false,
  pentaWeapon: false,
  hexaWeapon: false,
  specialWeapon: false
};

Examples

See: ./examples folder

More examples and A.I. Behaviors are coming soon! If you are interested in helping develop AYYO technology come make first contact

Copyright ayyo.gg 2023