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 bool bot_waypoints_for_items;
   8
   9 const int WAYPOINTFLAG_GENERATED = BIT(23);
  10 const int WAYPOINTFLAG_ITEM = BIT(22);
  11 const int WAYPOINTFLAG_TELEPORT = BIT(21); // teleports, warpzones and jumppads
  12 //const int WAYPOINTFLAG_NORELINK = BIT(20); // deprecated, see explanation below. Do not recycle this bit.
  13 const int WAYPOINTFLAG_PERSONAL = BIT(19);
  14 const int WAYPOINTFLAG_PROTECTED = BIT(18);  // Useless WP detection never kills these.
  15 const int WAYPOINTFLAG_USEFUL = BIT(17);  // Useless WP detection temporary flag.
  16 const int WAYPOINTFLAG_DEAD_END = BIT(16);  // Useless WP detection temporary flag.
  17 const int WAYPOINTFLAG_LADDER = BIT(15);
  18 const int WAYPOINTFLAG_JUMP = BIT(14);
  19 const int WAYPOINTFLAG_CUSTOM_JP = BIT(13);  // jumppad with different destination waypoint (changed in the editor)
  20 const int WAYPOINTFLAG_CROUCH = BIT(12);
  21 const int WAYPOINTFLAG_SUPPORT = BIT(11);
  22
  23 // removed WAYPOINTFLAG_NORELINK since it breaks backward compatibility
  24 // e.g. support waypoints would have no outgoing links in old Xonotic versions
  25 // In general, old Xonotic versions should spawn a normal waypoint for each unknown waypoint type
  26 const int WAYPOINTFLAG_NORELINK__DEPRECATED = BIT(20);
  27 const int WPFLAGMASK_NORELINK = (WAYPOINTFLAG_TELEPORT | WAYPOINTFLAG_LADDER | WAYPOINTFLAG_JUMP | WAYPOINTFLAG_CUSTOM_JP | WAYPOINTFLAG_SUPPORT);
  28
  29 float bot_custom_weapon;
  30 float bot_weapons_close[REGISTRY_MAX(Weapons)];
  31 float bot_weapons_far[REGISTRY_MAX(Weapons)];
  32 float bot_weapons_mid[REGISTRY_MAX(Weapons)];
  33 float skill;
  34
  35 .float bot_tracewalk_time;
  36 .float bot_attack;
  37 .float bot_dodgerating;
  38 .float bot_dodge;
  39 .float bot_forced_team;
  40 .float bot_moveskill; // moving technique
  41 .float bot_pickup;
  42 .float(entity player, entity item) bot_pickupevalfunc;
  43 .string cleanname;
  44 .float havocbot_role_timeout;
  45 .void(entity this) havocbot_role;
  46 .void(entity this) havocbot_previous_role;
  47 .float isbot; // true if this client is actually a bot
  48 .float lastteleporttime;
  49 .vector lastteleport_origin;
  50 .float navigation_hasgoals;
  51 .float nearestwaypointtimeout;
  52 .entity nearestwaypoint;
  53 .float speed;
  54 .entity wp00, wp01, wp02, wp03, wp04, wp05, wp06, wp07, wp08, wp09, wp10, wp11, wp12, wp13, wp14, wp15;
  55 .entity wp16, wp17, wp18, wp19, wp20, wp21, wp22, wp23, wp24, wp25, wp26, wp27, wp28, wp29, wp30, wp31;
  56 .float wp00mincost, wp01mincost, wp02mincost, wp03mincost, wp04mincost, wp05mincost, wp06mincost, wp07mincost;
  57 .float wp08mincost, wp09mincost, wp10mincost, wp11mincost, wp12mincost, wp13mincost, wp14mincost, wp15mincost;
  58 .float wp16mincost, wp17mincost, wp18mincost, wp19mincost, wp20mincost, wp21mincost, wp22mincost, wp23mincost;
  59 .float wp24mincost, wp25mincost, wp26mincost, wp27mincost, wp28mincost, wp29mincost, wp30mincost, wp31mincost;
  60 .float wpconsidered;
  61 .float wpcost;
  62 .int wpflags;
  63 .entity wphw00, wphw01, wphw02, wphw03, wphw04, wphw05, wphw06, wphw07;
  64
  65 bool bot_aim(entity this, .entity weaponentity, float shotspeed, float shotspeedupward, float maxshottime, float applygravity);
  66 void bot_aim_reset(entity this);
  67 void bot_clientconnect(entity this);
  68 void bot_clientdisconnect(entity this);
  69 void bot_cmdhelp(string scmd);
  70 void bot_endgame();
  71 bool bot_fixcount();
  72 void bot_list_commands();
  73 void bot_queuecommand(entity bot, string cmdstring);
  74 void bot_clear(entity this);
  75 void bot_relinkplayerlist();
  76 void bot_resetqueues();
  77 void bot_serverframe();
  78 bool bot_shouldattack(entity this, entity e);
  79 void bot_think(entity this);
  80
  81 entity find_bot_by_name(string name);
  82 entity find_bot_by_number(float number);
  83
  84 void havocbot_goalrating_enemyplayers(entity this, float ratingscale, vector org, float sradius);
  85 void havocbot_goalrating_items(entity this, float ratingscale, vector org, float sradius);
  86 void havocbot_goalrating_waypoints(entity this, float ratingscale, vector org, float sradius);
  87
  88 bool havocbot_goalrating_item_pickable_check_players(entity this, vector org, entity item, vector item_org);
  89
  90 vector havocbot_middlepoint;
  91 float havocbot_middlepoint_radius;
  92 float havocbot_symmetry_axis_m;
  93 float havocbot_symmetry_axis_q;
  94 float havocbot_symmetry_origin_order;
  95
  96 .float goalentity_lock_timeout;
  97 .float ignoregoaltime;
  98 .entity ignoregoal;
  99
 100 bool bots_would_leave;
 101
 102 int player_count;
 103 int currentbots;
 104
 105 .entity bot_basewaypoint;
 106 .bool navigation_dynamicgoal;
 107 void navigation_dynamicgoal_init(entity this, bool initially_static);
 108 void navigation_dynamicgoal_set(entity this, entity dropper);
 109 void navigation_dynamicgoal_unset(entity this);
 110 entity navigation_findnearestwaypoint(entity ent, float walkfromwp);
 111 void navigation_goalrating_end(entity this);
 112 void navigation_goalrating_start(entity this);
 113 void navigation_goalrating_timeout_set(entity this);
 114 void navigation_goalrating_timeout_force(entity this);
 115 void navigation_goalrating_timeout_expire(entity this, float seconds);
 116 bool navigation_goalrating_timeout(entity this);
 117 void navigation_goalrating_timeout_extend_if_needed(entity this, float seconds);
 118 bool navigation_goalrating_timeout_can_be_anticipated(entity this);
 119 void navigation_markroutes(entity this, entity fixed_source_waypoint);
 120 void navigation_markroutes_inverted(entity fixed_source_waypoint);
 121 void navigation_routerating(entity this, entity e, float f, float rangebias);
 122
 123 vector get_closer_dest(entity ent, vector org);
 124
 125 void set_tracewalk_dest(entity ent, vector org, bool fix_player_dest);
 126 vector set_tracewalk_dest_2(entity ent, vector org);
 127 bool tracewalk(entity e, vector start, vector m1, vector m2, vector end, float end_height, float movemode);
 128
 129 void waypoint_remove_fromeditor(entity pl);
 130 void waypoint_remove(entity wp);
 131 void waypoint_saveall();
 132 void waypoint_schedulerelinkall();
 133 void waypoint_schedulerelink(entity wp);
 134 void waypoint_spawnforitem(entity e);
 135 void waypoint_spawnforitem_force(entity e, vector org);
 136 void waypoint_spawnforteleporter(entity e, vector destination, float timetaken, entity tracetest_ent);
 137 void waypoint_spawnforteleporter_wz(entity e, entity tracetest_ent);
 138 void waypoint_spawn_fromeditor(entity pl, bool at_crosshair, bool is_jump_wp, bool is_crouch_wp, bool is_support_wp);
 139 entity waypoint_spawn(vector m1, vector m2, float f);
 140 void waypoint_unreachable(entity pl);
 141 void waypoint_start_hardwiredlink(entity pl, bool at_crosshair);
 142 void waypoint_lock(entity pl);
 143
 144 void waypoint_getSymmetricalOrigin_cmd(entity caller, bool save, int arg_idx);
 145 void waypoint_getSymmetricalAxis_cmd(entity caller, bool save, int arg_idx);