Palota: /* waypoint_autoflag */

2025-08-13T06:40:41Z

waypoint_autoflag

← Older revision		Revision as of 06:40, 13 August 2025
Line 57:		Line 57:
	''Example:'' waypoint_autofeature		''Example:'' waypoint_autofeature
	* Attempts to add waypoints at all detected map features. This includes spawn points, mg42, and portals. If used, it should be used first before adding any other waypoints in the map. The detected features are game dependent; meaning not all games will have all listed features detected.		* Attempts to add waypoints at all detected map features. This includes spawn points, mg42, and portals. If used, it should be used first before adding any other waypoints in the map. The detected features are game dependent; meaning not all games will have all listed features detected.

	~~=== waypoint_autoflag ===~~

	~~''Usage:'' waypoint_autoflag <flag>~~

	~~''Example:'' waypoint_autoflag crouch~~
	* Toggles whether or not waypoints are autoflagged. '''Currently not used'''

	=== waypoint_autoradius ===		=== waypoint_autoradius ===

Palota: /* waypoint_view */

2025-08-11T15:11:53Z

waypoint_view

← Older revision		Revision as of 15:11, 11 August 2025
Line 372:		Line 372:
	=== waypoint_view ===		=== waypoint_view ===

	''Usage:'' waypoint_view enable[1,0,true,false,on,off]		''Usage:'' waypoint_view enable[1,0,true,false,on,off,toggle]

	''Example:'' waypoint_view 1		''Example:'' waypoint_view 1

Palota: 1 revision imported

2023-02-13T07:02:37Z

1 revision imported

← Older revision	Revision as of 07:02, 13 February 2023
(No difference)

Palota: 1 revision imported

2021-07-13T19:07:21Z

1 revision imported

New page

{{TOCright}}
== Waypoint Commands ==

* [[Console|How to open console and execute command]]

=== waypoint_add ===

''Usage:'' waypoint_add

''Example:'' waypoint_add
* Adds a waypoint at the location where you are currently standing. When executing waypoint_add, a new waypoint will be created at the location you are currently standing. Some waypoint flags may be automatically placed on the waypoint.
** If the waypoint is underwater, the underwater flag should be automatically added.
** If you are crouching when you place the waypoint, the crouch flag should be automatically added.
** If you are proning when you place the waypoint, the crouch flag should be automatically added instead of adding prone flag.

=== waypoint_addflag ===

''Usage:'' waypoint_addflag flags[string] ...

''Example:'' waypoint_addflag crouch
* Flags the nearest waypoint with named properties, or clears the flag from the waypoint if it already exists. This command can take any number of waypoint flags. See [[Waypoint_Flags | the list of flags]] here.

=== waypoint_addflagx ===

''Usage:'' waypoint_addflagx flags[string] ...

''Example:'' waypoint_addflagx crouch
* Same as waypoint_addflag, only instead of the nearest waypoint, uses the waypoint you are currently aimed at.

=== waypoint_addx ===

''Usage:'' waypoint_addx

''Example:'' waypoint_addx
* Same as waypoint_add, only instead of location you are currently standing., it adds a waypoint where you are currently aimed at.
* Note for 0.7 and above only

=== waypoint_autobuild ===

''Usage:'' waypoint_autobuild dc[1/0] bbox[1/0] limitheight[#] limitdist[#] maxconnections[#]

''Example:'' waypoint_autobuild 1 0 32 1024 4
* This command automatically creates connections between waypoints based on the parameters used. It is a time saving function that can generate a pretty good starting point for paths between waypoints. It is not meant to do all the work for you, and will likely need additional cleanup after using where you may need to add additional connections it missed, or removed bad connections in may have added.

** dc - Disconnect all current connections before auto connecting.
** bbox - Use a small bounding box when casting the ray between waypoints. Useful for filtering out some connections that clip closely to a wall.
** limitheight - Only make connections to waypoints that are only within this height difference. Useful to prevent connections between multiple levels in a wide open room, even if there is line of sight between them.
** limitdist - Only make connections to other waypoints within this distance.
** maxconnections - Only make a maximum of this many connections. 3-5 tends to be a good range to start with.

=== waypoint_autofeature ===

''Usage:'' waypoint_autofeature

''Example:'' waypoint_autofeature
* Attempts to add waypoints at all detected map features. This includes spawn points, mg42, and portals. If used, it should be used first before adding any other waypoints in the map. The detected features are game dependent; meaning not all games will have all listed features detected.

=== waypoint_autoflag ===

''Usage:'' waypoint_autoflag <flag>

''Example:'' waypoint_autoflag crouch
* Toggles whether or not waypoints are autoflagged. '''Currently not used'''

=== waypoint_autoradius ===

''Usage:'' waypoint_autoradius all/cur[string] height[#] minradius[#] maxradius[#]

''Example:'' waypoint_autoradius all 32 20 200
* Automatically detects a waypoint radius on the nearest or all waypoints(depending on 1st parameter).
** all/cur - all performs autoradius on all waypoints, cur performs it on the nearest.
** height - A vertical offset from the waypoint position to perform the collision tests with. This is useful due to differences in waypoint position between games. In Doom3 & HL2 engine games, the position is at the ground, while in ET the position is about half-way up a players height.
** minradius - The minimum radius to use.
** maxradius - The maximum radius to use.

=== waypoint_biconnect ===

''Usage:'' waypoint_biconnect

''Example:'' waypoint_biconnect
* Same as waypoint_connect, but results in a 2 way connection between the waypoints.

=== waypoint_biconnectx ===

''Usage:'' waypoint_biconnectx

''Example:'' waypoint_biconnectx
* Same as waypoint_connectx, but results in a 2 way connection between the waypoints.

=== waypoint_boxselect ===

''Usage:'' waypoint_boxselect

''Example:'' waypoint_boxselect
* Creates a box area to select all waypoints within the boundaries. First usage starts the select area, use the cursor to expand the box, then use the command again to finish the selection.

=== waypoint_boxselectroom ===

''Usage:'' waypoint_boxselectroom

''Example:'' waypoint_boxselectroom
* Not fully implemented

=== waypoint_changeradius ===

''Usage:'' waypoint_changeradius change[#]

''Example:'' waypoint_changeradius -10
* Change the radius of the nearest waypoint by the change amount. Useful if you want to bind a increase and decrease radius key, such as a mouse wheel.

=== waypoint_clearallflags ===

''Usage:'' waypoint_clearallflags flags[string] ...

''Example:'' waypoint_clearallflags crouch
* Clears a list of flags from all waypoints in the map. Like waypoint_addflag, it can take any number of flag names, and clears the flags from all waypoints in the map. Useful if you want to remove all of a particular flag from a map.

=== waypoint_clearcon ===

''Usage:'' waypoint_clearcon

''Example:'' waypoint_clearcon
* Clears all the connections from the nearest waypoint or all selected waypoints(if any).

=== waypoint_clearproperty ===

''Usage:'' waypoint_clearproperty name[string]

''Example:'' waypoint_clearproperty bias
* Clears a property from a waypoint by its name.

=== waypoint_color ===

''Usage:'' waypoint_color

''Example:'' waypoint_color type[string] red[#] green[#] blue[#]
* Allows colors to be configured for certain types of waypoints.
** waypoint_color - Default color of waypoints.
** waypoint_selected - Selected waypoints.
** link_closedcolor - If the waypoint has a closed flag.
** link_teleport - If the waypoint has a teleport flag.
** link_1way - One-way connection links.
** link_2way - Two-way connection link.
** blockable_blocked - Blockable line indicators when it is blocked.
** blockable_open - Blockable line indicators when it is open(unblocked).
** aimentity - Color of the box drawn around entities when you aim at them with waypoint_view enabled.
** radius - Color of the radius indicator.
** team1 - Team 1 flagged waypoints
** team2 - Team 2 flagged waypoints
** team3 - Team 3 flagged waypoints (not for ET)
** team4 - Team 4 flagged waypoints (not for ET)

=== waypoint_connect ===

''Usage:'' waypoint_connect

''Example:'' waypoint_connect
* Flags the nearest waypoint for a connection. If a waypoint is already flagged for connection that waypoint will be connected to this waypoint with a 1-way connection.

=== waypoint_connectx ===

''Usage:'' waypoint_connectx

''Example:'' waypoint_connectx
* Same as waypoint_connect, only uses the waypoint you are aiming at.

=== waypoint_dcall ===

''Usage:'' waypoint_dcall

''Example:'' waypoint_dcall
* Disconnect all waypoints in the map. This removes all connections, while leaving only the waypoints.

=== waypoint_del ===

''Usage:'' waypoint_del

''Example:'' waypoint_del
* Deletes a nearest waypoint that you are standing within 100 units of. All connections from and to the waypoint will get automatically removed as well.

=== waypoint_delx ===

''Usage:'' waypoint_delx

''Example:'' waypoint_delx
* Same as waypoint_del, but removes the waypoint you are aiming at.

=== waypoint_deleteaxis ===

''Usage:'' waypoint_deleteaxis axis[string]

''Example:'' waypoint_deleteaxis
* Deletes all waypoints on a specified side of a specified axis.
** axis - x, y, z, -x, -y, -z, which side of which axis to delete all waypoints from. Mainly useful for symmetrical maps when you wish to delete a side, make adjustments, and re-mirror the waypoints.

=== waypoint_goto ===

''Usage:'' waypoint_goto <waypoint GUID>

''Example:'' waypoint_goto 127
* Teleports the player to the given waypoint by GUID
* Requires game specific implementation, not all games support it.

=== waypoint_ground ===

''Usage:'' waypoint_ground

''Example:'' waypoint_ground
* Grounds all waypoints based on the navigation rendering offsets.

=== waypoint_info ===

''Usage:'' waypoint_info

''Example:'' waypoint_info
* Prints some basic information about the nearest waypoint.

=== waypoint_load ===

''Usage:'' waypoint_load name[string, optional]

''Example:'' waypoint_load
* name is optional and if used, loads the waypoints for the currently loaded map with the suffix name. For example, if the map d3ctf1 is loaded, waypoint_load half would load from the nav directory the file d3ctf1half.way
* Loads the waypoints for the currently loaded map. Waypoints are loaded from the nav directory under the mod currently running. Warning: Any changes you may have made to the waypoints since the last load will be lost. This command is typically used for undoing changes made after the last save.

=== waypoint_lockselected ===

''Usage:'' waypoint_lockselected

''Example:'' waypoint_lockselected
* Locks all currently selected waypoints. Locked waypoints aren't effected by waypoint_translate.

=== waypoint_maxradius ===

''Usage:'' waypoint_maxradius <radius>

''Example:'' waypoint_maxradius 70
* Clamps all waypoints maximum radius to this value

=== waypoint_minradius ===

''Usage:'' waypoint_minradius <radius>

''Example:'' waypoint_minradius 70
* Clamps all waypoints minimum radius to this value

=== waypoint_mirror ===

''Usage:'' waypoint_mirror axis[string] p[optional]
* If axis parameter is x, y, or z, waypoints are rotated around provided axis.
* If axis parameter is m, waypoints are mirrored, north to south.
* If axis parameter is mz, waypoints are mirrored, west to east.
* p is optional, and if defined will use your current position to define origin (map center)

''Example:'' waypoint_mirror z
* This command duplicates all or selected waypoints and rotates or mirrors the duplicated waypoints across the origin of a provided axis. This function is useful for mirroring the waypoints in a symmetrical map, where each team has an identical base. The optional p parameter is useful for when the map isn't centered around the 0 axis. Stand as closely to the center of the map as possible and execute the command including the optional p parameter and the waypoints will be mirrored and offset based on the player position.

=== waypoint_move ===

''Usage:'' waypoint_move

''Example:'' waypoint_move
* Grabs the nearest waypoint for moving. If a waypoint has already been grabbed by a previous call to waypoint_move, it is dropped at your current position. Connections are maintained throughout waypoint moving.

=== waypoint_save ===

''Usage:'' waypoint_save

''Example:'' waypoint_save
* name is optional and if used, saves the waypoints for the currently loaded map with the suffix name. For example, if the map d3ctf1 is loaded, waypoint_save half would save the waypoints to the nav directory as the file d3ctf1half.way
* Saves the waypoints for the currently loaded map. Waypoints are saved to a file called mapname.way in the nav directory under the mod currently running. Warning: This will overwrite an existing waypoint file of the same name without asking. Rename or backup your original waypoint files when you want to experiment.

=== waypoint_select ===

''Usage:'' waypoint_select radius[#]

''Example:'' waypoint_select 500
* Selects all waypoints in the provided radius. If no radius is provided, the selection is cleared. Some of the above functions work on selected waypoints.

=== waypoint_setdefaultradius ===

''Usage:'' waypoint_setdefaultradius radius[#]

''Example:'' waypoint_setdefaultradius 100
* Sets the default radius that is used with all waypoints placed. Useful if you plan to waypoint_add a bunch of waypoints that will share a radius different from the current default to save time going back and changing radius manually.

=== waypoint_setfacing ===

''Usage:'' waypoint_setfacing

''Example:'' waypoint_setfacing
* Sets the facing for the nearest waypoint to your current facing. A waypoint's facing is basically a vector associated with a waypoint. It was used in Omni-bot 0.71 to tell the bot in which direction to look when the bot was camping on that waypoint (due to a sniper or defend flag in most cases). Goals do not use waypoint facing since Omni-bot 0.8, but it can be used for various purposes in map scripts.

=== waypoint_setname ===

''Usage:'' waypoint_setname name[string]

''Example:'' waypoint_setname spawnarea
* Sets the name of the nearest waypoint. Waypoint names are used as part of the map goal name if goal entity does not have name. It usually happens only for goals MOUNTMG42, REPAIRMG42, AMMOCAB, HEALTHCAB. It's much easier and less error-prone to manipulate goals in a map script based on meaningful names rather than UIDs.
* Note: Omni-bot 0.71 and older used waypoint name for any goals that were created as a result of the flags on a waypoint. For example, if you set a waypoint's name to "barrier_axis1" and the waypoint had a sniper flag set, it appeared as SNIPE_barrier_axis1 in the bots' goal list.

=== waypoint_setproperty ===

''Usage:'' waypoint_setproperty name[string] value[string]

''Example:'' waypoint_setproperty paththrough Navigation_PT:ladder1
* Sets an arbitrary propery value by name. It is usually used to set [[Paththrough]].

=== waypoint_setradius ===

''Usage:'' waypoint_setradius radius[#]

''Example:'' waypoint_setradius 100
* Sets the radius of the nearest waypoint.

=== waypoint_shownames ===

''Usage:'' waypoint_shownames expression[string, optional]

''Example:'' waypoint_shownames ATTACK.*
* Prints all waypoint id's and names that optionally match an expression.

=== waypoint_showproperty ===

''Usage:'' waypoint_showproperty

''Example:'' waypoint_showproperty
* Shows all properties on the current waypoint.

=== waypoint_slice ===

''Usage:'' waypoint_slice

''Example:'' waypoint_slice maxsegmentlength[#]
* Slices a 2 way connection so that it doesn't exceed a specified length.

=== waypoint_split ===

''Usage:'' waypoint_split
* Splits a 2 way connection to 2 parts. A new waypoint is created near the location where you are currently standing.

=== waypoint_stats ===

''Usage:'' waypoint_stats

''Example:'' waypoint_stats
* Prints out some basic information for the waypoint pathing system. Primarily a debug tool, but useful if you want to see the total number of waypoints currently placed.

=== waypoint_translate ===

''Usage:'' waypoint_translate x[#] y[#] z[#]

''Example:'' waypoint_translate 10 0 0
* Translates(moves) all waypoints, or the currently selected waypoints by Vector3(x,y,z)

=== waypoint_unlockall ===

''Usage:'' waypoint_unlockall

''Example:'' waypoint_unlockall
* Unlocks all waypoints.

=== waypoint_unsplit ===

''Usage:'' waypoint_unsplit

* Deletes a nearest waypoint which has 2 connections and makes 1 connection.

=== waypoint_view ===

''Usage:'' waypoint_view enable[1,0,true,false,on,off]

''Example:'' waypoint_view 1
* Enables or disables waypoint rendering.

=== waypoint_viewfacing ===

''Usage:'' waypoint_viewfacing enable[1,0,true,false,on,off]

''Example:'' waypoint_viewfacing 1
* Enables or disables rendering of the facing vector for waypoints if they have a facing vector.

Waypoint Commands - Revision history

Palota: /* waypoint_autoflag */

Palota: /* waypoint_view */

Palota: 1 revision imported

Palota: 1 revision imported