wiki:Running Quagents

Version 1 (modified by jpawlick, 13 years ago) (diff)

--

Once you have a have compiled Quagents, or fetched a binary version, you will probably want to run it. The executable to do this is located at ???/build/release-PLATFORM-ARCHITECTURE/ioquake3.ARCHITECTURE by default (where ??? is the quake top-level directory (so on URCS machines, it's build/release-linux-i368/ioquake3.i386). Running the executable without arguments will bring up the game menu.

The most useful command-line argument to run Quagents with is the "+map MAPNAME" argument. See the list of Built-In Maps for valid mapnames. Giving this command loads the map as soon as Quagents starts with no enemy bots, and so allows you to connect with your client agents without a bunch of Quake 3 bots running around blasting everyone to bits.

Once Quagents is running, you can type ` (backtick) to bring up the game console, which allows you to chat as well as issue game console commands. A useful command for Quagents experimentation is "\follow". Typing \follow will make you an observer for the rest of the game (as a sort of free-floating point of view: jump to rise, crouch to fall, normal movement otherwise), and "\follow [ENTITYID]" sticks your camera on the head of entity number [ENTITIYID]. Typically, "\follow 1" will follow the first bot to connect, "\follow 2" will follow the second, etc.

You may have to do "\follow [ENTITYID]" before you are allowed to do the basic "\follow".

To connect and spawn bots, you just have to open a TCP connection to port 6000 on whatever machine the Quagents server is running, and send the ASCII string "ready" across it. Alternatively, you can build on top of the code the Quagents team has already provided. See Getting Started for more information.