The ViewCenterRule specifies how to determine the center of the world viewport.

A counter used to generate globally unique IDs.

State and data for assigning identifiers to robots

All the robots that currently exist in the game, indexed by ID.

The names of all robots that currently exist in the game, indexed by location (which we need both for e.g. the salvage command as well as for actually drawing the world). Unfortunately there is no good way to automatically keep this up to date, since we don't just want to completely rebuild it every time the robotMap changes. Instead, we just make sure to update it every time the location of a robot changes, or a robot is created or destroyed. Fortunately, there are relatively few ways for these things to happen.

Get a list of all the robots that are "watching" by location.

The names of the robots that are currently not sleeping.

The names of the robots that are currently sleeping, indexed by wake up time. Note that this may not include all sleeping robots, particularly those that are only taking a short nap (e.g. wait 1).

Get a list of all the robots that are "watching" by location.

The current rule for determining the center of the world view. It updates also, viewCenter and focusedRobot to keep everything synchronized.

The current center of the world view. Note that this cannot be modified directly, since it is calculated automatically from the viewCenterRule. To modify the view center, either set the viewCenterRule, or use modifyViewCenter.

The current robot in focus.

It is only a Getter because this value should be updated only when the viewCenterRule is specified to be a robot.

Technically it's the last robot ID specified by viewCenterRule, but that robot may not be alive anymore - to be safe use focusedRobot.

Iterates through all of the currently wait-ing robots, and moves forward the wake time of the ones that are watch-ing this location.

NOTE: Clearing TickNumber map entries from internalWaitingRobots upon wakeup is handled by wakeUpRobotsDoneSleeping

Takes a robot out of the activeRobots set and puts it in the waitingRobots queue.

Takes a robot out of the activeRobots set.

Removes robots whose wake up time matches the current game ticks count from the waitingRobots queue and put them back in the activeRobots set if they still exist in the keys of robotMap.

Mutations

This function modifies:

• wakeLog
• robotsWatching
• internalWaitingRobots
• internalActiveRobots (aka activeRobots)

Makes sure empty sets don't hang around in the robotsByLocation map. We don't want a key with an empty set at every location any robot has ever visited!

Adds a robot to the activeRobots set.

Add a robot to the game state, adding it to the main robot map, the active robot set, and to to the index of robots by location.

Helper function for updating the "robotsByLocation" bookkeeping

Add a concrete instance of a robot template to the game state: First, generate a unique ID number for it. Then, add it to the main robot map, the active robot set, and to to the index of robots by location.

Like addTRobot, but return the newly instantiated robot.

Modify the viewCenter by applying an arbitrary function to the current value. Note that this also modifies the viewCenterRule to match. After calling this function the viewCenterRule will specify a particular location, not a robot.

Unfocus by modifying the view center rule to look at the current location instead of a specific robot, and also set the focused robot ID to an invalid value. In classic mode this causes the map view to become nothing but static.

Recalculate the view center (and cache the result in the viewCenter field) based on the current viewCenterRule. If the viewCenterRule specifies a robot which does not exist, simply leave the current viewCenter as it is.