| | 1 | This query asks the agent to tell you what the nearest object within a specific distance at a specific angle is. The rangefinder detects everything a normal shot in Quake would - so non-colliding entities (such as those "light beams" graphical effects) cannot be detected by this method. The rangefinder sensor originates precisely at the "muzzle point" of the agent, not at its center. |
| | 2 | |
| | 3 | '''Parameters:''' |
| | 4 | * 1 integer distance, the maximum distance of the rangefinder. There is no particular penalty to supplying very large distances that we can find - the maximum distance we've seen this call used with in Quake is 8120, the range of the rail gun. |
| | 5 | * 1 float theta, the number of degrees left of facing to shoot the rangefinder at. |
| | 6 | * 1 float phi, the number of degrees down from facing to shoot the rangefinder at. |
| | 7 | |
| | 8 | '''Responds:''' |
| | 9 | * ''X Y'' where X is the range at which the object was detected (the distance if nothing was found) and Y is either the entity id, -2 if the entity id is normally invalid (a wall or something), and -1 if nothing is in the distance. |
| | 10 | |
| | 11 | '''Reports:''' |
| | 12 | * ''done'' when the task completes. |
| | 13 | * ''popped'' if popped by [[po]]. |
| | 14 | * ''forgotten'' if deleted by [[fa]]. |
| | 15 | |
| | 16 | '''Example:''' |
| | 17 | * User sends: "n rf 512 6000 90 45" |
| | 18 | * Bot replies "rs rf 512 65.2 -2" |
| | 19 | * Bot replies "cp rf 512 done" |
