Merge remote-tracking branch 'origin/terencehill/bot_waypoints'
[xonotic/xonotic-data.pk3dir.git] / qcsrc / server / bot / api.qh
1 #pragma once
2
3 #include <server/defs.qh>
4 #include <common/weapons/_all.qh>
5 #include <common/physics/player.qh>
6
7 const int WAYPOINTFLAG_GENERATED = BIT(23);
8 const int WAYPOINTFLAG_ITEM = BIT(22);
9 const int WAYPOINTFLAG_TELEPORT = BIT(21); // teleports, warpzones and jumppads
10 const int WAYPOINTFLAG_NORELINK = BIT(20);
11 const int WAYPOINTFLAG_PERSONAL = BIT(19);
12 const int WAYPOINTFLAG_PROTECTED = BIT(18);  // Useless WP detection never kills these.
13 const int WAYPOINTFLAG_USEFUL = BIT(17);  // Useless WP detection temporary flag.
14 const int WAYPOINTFLAG_DEAD_END = BIT(16);  // Useless WP detection temporary flag.
15 const int WAYPOINTFLAG_LADDER = BIT(15);
16 const int WAYPOINTFLAG_JUMP = BIT(14);
17
18 entity kh_worldkeylist;
19 .entity kh_worldkeynext;
20
21 float bot_custom_weapon;
22 float bot_weapons_close[Weapons_MAX];
23 float bot_weapons_far[Weapons_MAX];
24 float bot_weapons_mid[Weapons_MAX];
25 float skill;
26
27 .float bot_tracewalk_time;
28 .float bot_attack;
29 .float bot_dodgerating;
30 .float bot_dodge;
31 .float bot_forced_team;
32 .float bot_moveskill; // moving technique
33 .float bot_pickup;
34 .float(entity player, entity item) bot_pickupevalfunc;
35 .string cleanname;
36 .float havocbot_role_timeout;
37 .void(entity this) havocbot_role;
38 .void(entity this) havocbot_previous_role;
39 .float isbot; // true if this client is actually a bot
40 .float lastteleporttime;
41 .vector lastteleport_origin;
42 .float navigation_hasgoals;
43 .float nearestwaypointtimeout;
44 .entity nearestwaypoint;
45 .float speed;
46 .entity wp00, wp01, wp02, wp03, wp04, wp05, wp06, wp07, wp08, wp09, wp10, wp11, wp12, wp13, wp14, wp15;
47 .entity wp16, wp17, wp18, wp19, wp20, wp21, wp22, wp23, wp24, wp25, wp26, wp27, wp28, wp29, wp30, wp31;
48 .float wp00mincost, wp01mincost, wp02mincost, wp03mincost, wp04mincost, wp05mincost, wp06mincost, wp07mincost;
49 .float wp08mincost, wp09mincost, wp10mincost, wp11mincost, wp12mincost, wp13mincost, wp14mincost, wp15mincost;
50 .float wp16mincost, wp17mincost, wp18mincost, wp19mincost, wp20mincost, wp21mincost, wp22mincost, wp23mincost;
51 .float wp24mincost, wp25mincost, wp26mincost, wp27mincost, wp28mincost, wp29mincost, wp30mincost, wp31mincost;
52 .float wpconsidered;
53 .float wpcost;
54 .float wphardwired;
55 .int wpflags;
56
57 bool bot_aim(entity this, .entity weaponentity, float shotspeed, float shotspeedupward, float maxshottime, float applygravity);
58 void bot_aim_reset(entity this);
59 void bot_clientconnect(entity this);
60 void bot_clientdisconnect(entity this);
61 void bot_cmdhelp(string scmd);
62 void bot_endgame();
63 bool bot_fixcount();
64 void bot_list_commands();
65 void bot_queuecommand(entity bot, string cmdstring);
66 void bot_clear(entity this);
67 void bot_relinkplayerlist();
68 void bot_resetqueues();
69 void bot_serverframe();
70 bool bot_shouldattack(entity this, entity e);
71 void bot_think(entity this);
72
73 entity find_bot_by_name(string name);
74 entity find_bot_by_number(float number);
75
76 void havocbot_goalrating_enemyplayers(entity this, float ratingscale, vector org, float sradius);
77 void havocbot_goalrating_items(entity this, float ratingscale, vector org, float sradius);
78 void havocbot_goalrating_waypoints(entity this, float ratingscale, vector org, float sradius);
79
80 bool havocbot_goalrating_item_pickable_check_players(entity this, vector org, entity item, vector item_org);
81
82 vector havocbot_middlepoint;
83 float havocbot_middlepoint_radius;
84 float havocbot_symmetry_axis_m;
85 float havocbot_symmetry_axis_q;
86 float havocbot_symmetry_origin_order;
87
88 .float goalentity_lock_timeout;
89 .float ignoregoaltime;
90 .entity ignoregoal;
91
92 .entity bot_basewaypoint;
93 .bool navigation_dynamicgoal;
94 void navigation_dynamicgoal_init(entity this, bool initially_static);
95 void navigation_dynamicgoal_set(entity this, entity dropper);
96 void navigation_dynamicgoal_unset(entity this);
97 entity navigation_findnearestwaypoint(entity ent, float walkfromwp);
98 void navigation_goalrating_end(entity this);
99 void navigation_goalrating_start(entity this);
100 void navigation_goalrating_timeout_set(entity this);
101 void navigation_goalrating_timeout_force(entity this);
102 void navigation_goalrating_timeout_expire(entity this, float seconds);
103 bool navigation_goalrating_timeout(entity this);
104 bool navigation_goalrating_timeout_can_be_anticipated(entity this);
105 void navigation_markroutes(entity this, entity fixed_source_waypoint);
106 void navigation_markroutes_inverted(entity fixed_source_waypoint);
107 void navigation_routerating(entity this, entity e, float f, float rangebias);
108
109 vector get_closer_dest(entity ent, vector org);
110
111 void set_tracewalk_dest(entity ent, vector org, bool fix_player_dest);
112 vector set_tracewalk_dest_2(entity ent, vector org);
113 bool tracewalk(entity e, vector start, vector m1, vector m2, vector end, float end_height, float movemode);
114
115 void waypoint_remove_fromeditor(entity pl);
116 void waypoint_remove(entity wp);
117 void waypoint_saveall();
118 void waypoint_schedulerelinkall();
119 void waypoint_schedulerelink(entity wp);
120 void waypoint_spawnforitem(entity e);
121 void waypoint_spawnforitem_force(entity e, vector org);
122 void waypoint_spawnforteleporter(entity e, vector destination, float timetaken, entity tracetest_ent);
123 void waypoint_spawnforteleporter_wz(entity e, entity tracetest_ent);
124 void waypoint_spawn_fromeditor(entity pl);
125 entity waypoint_spawn(vector m1, vector m2, float f);
126 void waypoint_unreachable(entity pl);
127
128 void waypoint_getSymmetricalOrigin_cmd(entity caller, bool save, int arg_idx);
129 void waypoint_getSymmetricalAxis_cmd(entity caller, bool save, int arg_idx);