AzerothCore
waypoint_data
The `waypoint_data` table
This table contains all the path data for creatures that use waypoints and waypoint scripts directly in their creature addon definition. See also Waypoints-Information for general information about waypoints.
Table Structure
| Field | Type | Attributes | Key | Null | Default |
|---|---|---|---|---|---|
| id | INT | UNSIGNED | PRI | NO | 0 |
| point | MEDIUMINT | UNSIGNED | PRI | NO | 0 |
| position_x | FLOAT | NO | 0 | ||
| position_y | FLOAT | NO | 0 | ||
| position_z | FLOAT | NO | 0 | ||
| orientation | FLOAT | YES | NULL | ||
| velocity | FLOAT | NO | 0 | ||
| delay | INT | UNSIGNED | NO | 0 | |
| smoothTransition | TINYINT | NO | 0 | ||
| move_type | INT | NO | 0 | ||
| action | INT | NO | 0 | ||
| action_chance | SMALLINT | NO | 100 | ||
| wpguid | INT | UNSIGNED | NO | 0 |
Description of the fields
id
Unique ID for each path.
The TDB standard way of assigning an ID is to multiply GUID of the creature by 10.
So for a creature with a GUID of 1234 the path ID would be 12340. Any waypoints submitted to TDB should follow this standard.
However, this is only a suggestion when creating your own waypoints. This ID can be anything you want as long as creature_addon.path_id is set to the ID you pick here for the creature you are creating a waypoint for.
point
Unique point ID for each point in a path. Starts at 1 and increases with each path.
position_x
The X coordinate of the destination waypoint.
position_y
The Y coordinate of the destination waypoint.
position_z
The Z coordinate of the destination waypoint.
orientation
The orientation of the creature. (North = 0.0; South = π (3.14159))
velocity
Overrides the creature's default movement speed for this waypoint. Set to 0 to use the default speed.
delay
Time to wait (in ms) between each point.
smoothTransition
When enabled, the creature follows a smooth catmullrom spline curve through waypoints instead of stopping and turning sharply at each point. Custom intermediate spline points can be added via the waypoint_data_addon table.
| Value | Description |
|---|---|
| 0 | Disabled (default) — creature stops at each waypoint |
| 1 | Enabled — smooth spline curve between waypoints |
move_type
| Value | Name | Description |
|---|---|---|
| 0 | Walk | Creature moves at walking speed. |
| 1 | Run | Creature moves at running speed (default). |
| 2 | Land | Sets animation tier to Ground (used when landing from flight). |
| 3 | Takeoff | Sets animation tier to Hover (used when taking off). |
action
ID of the action to be performed. See waypoint_scripts.id.
action_chance
Percentage of action happening (0-100%).
wpguid
This field is used by the core and is NOT to be set by hand.
This field holds the GUID of the waypoint visual when you enable the visual mode for waypoints.
Example Rows
| Id | Point | Position_x | Position_y | Position_z | Orientation | Velocity | Delay | SmoothTransition | Move_type | Action | Action_chance | wpguid |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 20160 | 1 | -4998 | -1167 | 501657 | 0 | 0 | 10000 | 0 | 0 | 0 | 100 | 0 |
| 20160 | 2 | -4958.38 | -1199.34 | 501659 | 0 | 0 | 0 | 0 | 0 | 0 | 100 | 0 |