Unknown

DEBUG COMMANDS

The debug commands allow you to view the internal data of the AI system in the form of Dark Basic 3D objects. Free objects for all debugging information are found by starting at object ID 65535 and decreasing until a free object is found. This object is then occupied until the debug data is hidden again using the appropriate command, at which point the object is deleted.

Some frequently changing debug objects, such as avoidance angles, can cause a performance hit whilst displaying due to calculations required to create the debug object displayed. Waypoints, waypoint edges, and obstacle bounds are only calculated once in the 'show' command, and remain static until hidden. If any changes are made to waypoints or obstacles after displaying the debug object it needs to be hidden and re-shown for the changes to display.

In addition to displaying data directly in the Dark Basic world, the console commands can be used to display detailed information about the parameters of an entity, such as destinations, targets and general parameters, which can sometimes help explain why an entity is behaving a certain way. As such it's probably most useful when using the manual entity commands to create custom behaviours.

Finally there are error control commands that allow you to suppress or display error messages in response to invalid parameters. The former is useful when there are parameters that are not known before hand, such as user defined or script defined values, that you do not want ending the program. Displaying error messages is the recommended mode in most cases.