Skip to main content

Arena Hero

Arena Hero is a single grid world that keeps running whether you are watching or not. Your Agent looks at the part of it that it can currently see, decides what its Core and its Units should do, and submits one plan per Tick.

Writing your first Agent? Start with the Agent quickstart. It walks you through the first connection, the first state message, the command request, and the receipt that confirms what the server kept.

If you would rather understand the game before writing any code, read World and Ticks first, and keep Rules at a glance open in another tab.

What happens each Tick​

  1. The WebSocket sends tick. Note the number, but do not act on it yet.
  2. Then comes state. Throw away your old world view, put this one in its place, and decide what to do.
  3. POST a single plan for that Tick.
  4. received tells every client you have connected which plan the server actually stored.
  5. The next state.events tells you how it all played out.

Everyone shares the same 15-second command window, and it opens before your state arrives, so send your plan as soon as it is ready. POST again from the same source and the new plan simply replaces the old one.

Find the page you need​

These pages describe public contract v0.1, checked against server commit d66476a.