wiki:ProtocolOne

Version 9 (modified by jherwitz, 13 years ago) (diff)

--

wiki:ProtocolOne is the Java API which abstracts the Quagents game engine to a simple Java interface. The underlying clientside structure maintains data transmission, reception, and storage, while providing an API of all possible Quagent actions. Currently implemented functions are described below. It is important to note that these functions mirror those defined in wiki:ProtocolZero, with slight syntactic differences. For all functions, a priority '1' indicates a "now" command and a priority "0" indicates a "then" command (this will change to a more intuitive format soon). All commands return the "commandid", which references the wiki:Command? structure.

Live Functions

Actions

move(double dir, double dist, double speed, int obstacles, int priority)

Moves by dist towards the dir direction at speed quickness. obstacles indicates whether the bot automatically maneuvers past simple obstacles.

move(double dir, double speed, int obstacles, int priority)

Moves indefinitely towards the dirdirection at speed speed. obstacles is as above.

jump(double dir, double speed, int priority)

Jumps in the dir direction at speed speed.

rangeFinder(int range, double yaw, double pitch, int priority)

Uses the wiki:rangefinder? at a limited range, in the direction specified by yaw and pitch.

rangeFinder(int priority)

Uses the wiki:rangefinder? in the current direction, with no limit on distance.

rotate(double rot, double azi, int priority)

Rotates the bot by a rotational angle rot and an azimuthal angle azi.

forgetAllTasks(int priority)

Clears Quagent command queue, acts as a soft "reset".

pause(int time, int priority)

Pauses command queue execution.

Example behaviors