How to Play

Game Rules

Victory Condition

Free for All

The player with the highest XP at the end of the match wins. Combine strategies around item collection, combat mechanics, and skill progression to best other players.

Survival

Work together with other players to survive as many stages as you can. Levelling and combat strategy are key.

Gaining XP

Earn experience points by:

• Collecting items scattered around the map
• Defeating other players
• Killing monsters

Character Progression

• Gain 1 skill point per level up to level 20
• Spend points on:
  • Speed (move faster)
  • Attack (deal more damage)
  • Health (increase max HP)
• Equip power-ups for special attacks

Gameplay Rules

• Only one power-up can be equipped at a time
• Dash ability only works when near danger (enemies, players, bombs, etc.)
• Unlimited deaths with a respawn delay
• Fixed number of monsters and items spawn on the map
• Kill streaks enable overclocking:
  • Boosts speed and damage
  • Enables health regeneration
  • Each kill prolongs the overclocking duration

tip

Level up quickly to gain an advantage! More skill points means better stats.

Architecture

Botomy uses a client-server architecture where:

1. The game client sends level data to your bot server via HTTP POST requests
2. Your server processes the data and returns a list of moves
3. The game executes those moves for your character

Each frame, the game sends updated level data and expects new moves in response.

Real-Time Gameplay

The game runs in real-time:

• Your server must respond quickly to keep up
• The game will not pause while waiting for your response
• If your server is too slow, you may miss opportunities to act

Basic Movement

Move your character by returning coordinates to move towards:

{
  "move_to": {
    "x": 100,
    "y": 200
  }
}

tip

The coordinate system starts at (0,0) in the top-left corner

Combat

Return these actions to engage in combat:

[
  "attack",     // Basic attack
  "shield",     // Block incoming damage
  "dash",       // Quick movement burst
  "special"      // Use equipped special attack
]

Multiple actions can be combined in a single frame:

[{ "move_to": { "x": 100, "y": 200 } }, "attack", "shield"]

Using Items

Activate items in your inventory:

{"use": "big_potion"}    // Heal to full health
{"use": "speed_zapper"}  // Slow nearby enemies
{"use": "ring"}         // Become invisible

Skill Points

When you level up, redeem skill points to improve your character:

{"redeem_skill_point": "health"}   // More HP
{"redeem_skill_point": "speed"}    // Move faster
{"redeem_skill_point": "attack"}   // Deal more damage

Debugging

Add debug information to help track your bot's decision making:

{
  "debug_info": {
    "target_id": "enemy_1",
    "message": "Pursuing nearest enemy"
  }
}

Debug info appears above your character in-game.

Character Messages

Make your character speak:

{ "speak": "Hello world!" }

Messages appear as speech bubbles above your character.

tip

Combine multiple actions in a single frame to create complex behaviors:

[
  { "move_to": { "x": 100, "y": 200 } },
  "attack",
  { "speak": "Take that!" },
  { "debug_info": { "message": "Attacking enemy" } }
]