Launches the xpilot client with the specified command line arguments.

Sets the arguments to use when launching xpilot. Use prior to calling .

Launches the xpilot client. Returns 1 if successful

Sets the maximum turn for self in degrees per frame.

Returns 1 if teamplay is enabled.

Simulates a key press. AI.releaseKey must be called after to complete the key-stroke.

Simulates a key release. Call to release a key pressed by [AI.pressKey] See [AI.pressKey] for a complete list of keys.

Controls the ship’s thrust. 1 to thrust, 0 to not thrust. Resets to not-thrust after every frame.

Turns the ship turn degrees (out of 360). Negative degrees are clockwise, positive counter-clockwise.

Makes the ship shoot. 1 to shoot, 0 to not shoot. Servers limit the shot rate and the number of shots, so AIself.shoot(1) will not always cause a shot to be fired. Use [AIself.reload?] to check the number of frames remaining before it is possible to shoot again.

Start or stop the self-destruct sequence.

1 if self is alive, 0 if not.

Self’s x position, where bottom left of map is [0, 0].

Self’s y position, where bottom left of map is [0, 0].

Self’s velocity (number of pixels moved per frame).

Self’s heading (direction ship’s nose is pointing). 0 degrees is to the right and 90 degrees is straight up.

Self’s track (direction of movement). 0 degrees is to the right and 90 degrees is straight up.

Self’s x position on radar map, using radar map units.

Self’s y position on radar map, using radar map units.

Number of self’s team on server.

Remaining lives on server.

Returns 1 if shield is up, 0 if shield is down.

Returns name of self on server.

Returns score of self as displayed in the rankings See Also: [AIself.HUD.score?]

Number of frames remaining before self is able to shoot. When 0, self is able to shoot.

Ship’s x position, where bottom left of map is [0, 0].

Ship’s y position, where bottom left of map is [0, 0].

Ship’s heading (angle nose is pointing). 0 degrees is to the right, and 90 straight up.

Ship’s track (direction of velocity). 0 degrees is to the right, and 90 straight up.

Ship’s velocity in pixels/frame.

Ship’s distance from self, in pixels.

server assigned id of ship

Direction of ship from self. 0 degrees is to the right and 90 upright.

Returns 1 if ship’s shield is on, 0 if off, or -1 if ship is not on screen

See Also: [AIself.life?]

See Also: [AIself.team?]

This is the number of frames remaining before the ship can fire again. This number is just an estimate, and may not always be correct.

Returns name of ship at index, or "" if ship does not exist.

Calculates the direction that self would need to point to hit the ship, according to self’s track and velocity, the enemy ship’s track and velocity, and the default bullet’s shotspeed. This is a pretty deadly function. Sometimes it can’t calculate correctly and returns some negative number.

Radar ship’s x position (approximate), where bottom left of map is [0, 0].

Radar ship’s y position (approximate), where bottom left of map is [0, 0].

Radar ship’s distance from self, in pixels (approximate).

Direction of radar ship from self. 0 degrees is to the right and 90 upright.

Returns 0 if ship on radar is on team, 1 if ship is an enemy, or -1 if ship is not on screen

shot’s x position, where bottom left of map is [0, 0].

shot’s y position, where bottom left of map is [0, 0].

shot’s track (direction of velocity). 0 degrees is to the right, and 90 straight up.

shot’s velocity in pixels/frame.

shot’s distance from self, in pixels.

Imaginary shots are calculated for every ship on screen. If a ship were to shoot this frame, imaginary bullets tell that shots attributes.

Direction of shot from self. 0 degrees is to the right and 90 upright.

Direction of the location where the shot will be nearest to self, if both self velocity and bullet velocity remain constant. 0 degrees is to the right and 90 upright.

Distance to the location where the shot will be nearest to self, if both self velocity and bullet velocity remain constant, in pixels.

Number of frames until the nearest intercept will occur, if both self velocity and bullet velocity remain constant.

A value derived from [AIshot.idist?] and [AIshot.itime?] . An alert between 0 and 30 means that self will probably be killed by the shot, 30 to 120, that it is a dangerous shot and should be avoided, and above 120, it’s not very dangerous. This variable is just for convience, and should probably not be used in more advanced controllers.

This function checks for walls in a straight line starting from point [x1, y1] to point [x2, y2]. If it finds a wall, it returns the distance (in pixels) from [x1, y1] to that point. If gets to [x2, y2] without finding a wall, it returns -1.

This function checks for walls in a straight line starting from point [x1, y1] to point [x2, y2]. If it finds a wall, it returns the x coordinate of that wall. If gets to [x2, y2] without finding a wall, it returns -1.

This function checks for walls in a straight line starting from point [x1, y1] to point [x2, y2]. If it finds a wall, it returns the y coordinate of that wall. If gets to [x2, y2] without finding a wall, it returns -1.

The map consists of tiles which are 35x35 pixels each. Each tile contains information about that spot on the map, and can have multiple values. For instance, a square block tile may have 5 bit flags set; one for each side, and one to indicate it is a wall tile. The possible flags are listed below. Use the bitwise "and" operator to check the tiles for the flags. To convert a regular game coordinate to a map coordinate, use [tomap] and [frmap] .

The map tiles in Xpilot-AI are 32 bits. Only the lowest order bits are used for Xpilot, so the other bits can be set as desired.

Converts a gamplay pixel value to a map value.

Takes a map value and returns the middle of that map tile, in pixels.