How to Play Botomy

Program Your API

Create a local API server that responds to game events. Choose between Node.js or Python templates to get started quickly. Your API receives game state and returns your hero's next moves.

Game Request

// POST /
{
  "own_player": {
    "position": { "x": 100, "y": 200 },
    "health": 100
    ...
  },
  "enemies": [
    {
      "id": "Ghoul1",
      "position": { "x": 400, "y": 300 },
      "health": 50
    }
    ...
  ]
  ...
}

Your Response

[
    {"move_to": {"x": 400, "y": 300}},
    "attack",
    "shield",
  ]

Quick Start

# Clone the template
git clone https://github.com/Brokkli-Labs/botomy-node-starter
cd botomy-node-starter

# Install dependencies
npm install

# Start your server
npm start

# Your API is now ready at localhost:3000
# Open Botomy and press RUN to start calling your endpoint!

Get started with our Node.js template. Includes example strategies and documentation to help you get started quickly.

Additional Resources

Node.js Template

Get started with our Node.js template. Includes example strategies and comprehensive documentation.

Python Template (Coming Soon)

Prefer Python? Our Python template with built-in helper functions and example code is coming soon.

API Documentation

Detailed documentation of all available API endpoints, game states, and action types.