Files
ql-lg-server/home/minqlx-plugins/lgbot.py
T

225 lines
9.7 KiB
Python

# LG training bot movement: steers the bot named "lgbot" like a human LG duelist (ground ADAD
# strafing with uneven holds and fakes, keeps LG range, never jumps). Aim comes from the bot's
# character file (botfiles/bots/lgbot_c.c, the number in "addbot lgbot N"); this plugin only moves it.
# Settings are cvars (the ./lgbot script sets them): lgbot_move 1-5 picks a preset, the detail cvars
# override one part of it, -1 = use the preset. The pattern code below has no minqlx dependency so
# tools/test_lgbot.py and tools/lgbot.py can import it.
import math
import random
import time
RUN_SPEED = 320 # QL ground run speed, units/s
# Ground friction takes ~25% of the velocity we set before the frame's move happens (measured:
# 288 set -> ~220 actual), so on the ground we set this much more to end up at the wanted speed.
# In the air there is no friction, so no boost (vertical speed 0 = on the ground, near enough).
FRICTION_COMP = 1.3
KEYS = ["strafe_min", "strafe_max", "fake", "range", "range_play", "speed", "lane"]
LIMITS = {"strafe_min": (50, 2000), "strafe_max": (50, 2000), "fake": (0, 100),
"range": (150, 750), "range_play": (0, 1), "speed": (50, 100), "lane": (0, 2000)}
PRESETS = {
1: {"strafe_min": 600, "strafe_max": 1000, "fake": 0, "range": 450, "range_play": 0, "speed": 80, "lane": 600},
2: {"strafe_min": 400, "strafe_max": 800, "fake": 10, "range": 450, "range_play": 0, "speed": 90, "lane": 500},
3: {"strafe_min": 250, "strafe_max": 600, "fake": 25, "range": 400, "range_play": 1, "speed": 100, "lane": 400},
4: {"strafe_min": 180, "strafe_max": 450, "fake": 35, "range": 380, "range_play": 1, "speed": 100, "lane": 350},
5: {"strafe_min": 120, "strafe_max": 350, "fake": 50, "range": 350, "range_play": 1, "speed": 100, "lane": 300},
}
PUSH_RANGE, BACKOFF_RANGE = 250, 700
BACKOFF_HEALTH, PUSH_LEAD = 60, 30
MAX_TARGET_DIST = 1500
BOT_STEAM_ID = 90071996842377216 # minqlx gives bots this + their client number
def is_bot(steam_id):
return steam_id == 0 or steam_id >= BOT_STEAM_ID
def is_lgbot(name, steam_id):
"""The training bot: named lgbot AND a bot (a human can't take it over by renaming)."""
return name.lower() == "lgbot" and is_bot(steam_id)
def to_int(text):
"""Cvar text -> int, None when unset or junk (so a typo falls back to the preset)."""
try:
return int(float(text))
except (TypeError, ValueError):
return None
def resolve(move, overrides):
"""Preset for movement level `move` with the valid (>= 0) overrides applied, clamped."""
try:
move = min(5, max(1, int(move)))
except (TypeError, ValueError):
move = 3
s = dict(PRESETS[move])
for k, v in overrides.items():
if k in LIMITS and isinstance(v, int) and v >= 0:
lo, hi = LIMITS[k]
s[k] = min(hi, max(lo, v))
s["strafe_max"] = max(s["strafe_max"], s["strafe_min"])
return s
class Strafer:
"""Strafe direction over time: holds one side for strafe_min..strafe_max ms, then switches.
A fake is a 60-120 ms tap to the other side followed by a new hold on the original side.
Lane: strafing sideways to someone moves you around them, and fakes keep you going the same
way, so the net sideways drift is tracked and the bot turns back once it is more than `lane`
units off centre (0 = no limit). That keeps it doing ADAD in front of you instead of circling."""
def __init__(self, rng=random):
self.rng = rng
self.direction = 1
self.until = 0
self.faking = False
self.drift = 0 # signed ms of strafing, + = direction 1
self.last = None
def step(self, now_ms, s):
if self.last is not None:
self.drift += self.direction * (now_ms - self.last)
self.last = now_ms
if s["lane"]:
lane_ms = s["lane"] * 1000.0 / (RUN_SPEED * s["speed"] / 100.0)
if self.direction * self.drift >= lane_ms:
self.direction = -self.direction
self.faking = False
self.until = now_ms + self.rng.randint(s["strafe_min"], s["strafe_max"])
return self.direction
if now_ms >= self.until:
self.direction = -self.direction
if self.faking:
self.faking = False
self.until = now_ms + self.rng.randint(s["strafe_min"], s["strafe_max"])
elif self.rng.random() * 100 < s["fake"]:
self.faking = True
self.until = now_ms + self.rng.randint(60, 120)
else:
self.until = now_ms + self.rng.randint(s["strafe_min"], s["strafe_max"])
return self.direction
def wanted_range(s, my_hp, target_hp):
if s["range_play"]:
if my_hp < BACKOFF_HEALTH:
return BACKOFF_RANGE
if my_hp >= target_hp + PUSH_LEAD:
return PUSH_RANGE
return s["range"]
def steer(bot_xy, target_xy, direction, s, want):
"""Horizontal velocity: strafe sideways to the target, plus in/out to hold `want` distance."""
cap = RUN_SPEED * s["speed"] / 100.0
dx, dy = target_xy[0] - bot_xy[0], target_xy[1] - bot_xy[1]
dist = math.hypot(dx, dy)
if dist < 1:
return (direction * cap, 0.0)
ux, uy = dx / dist, dy / dist
radial = max(-0.7 * cap, min(0.7 * cap, (dist - want) * 2.0))
side = math.sqrt(max(0.0, cap * cap - radial * radial))
return (-uy * direction * side + ux * radial, ux * direction * side + uy * radial)
def fix_z(vz):
"""Cancel a jump (QL jump velocity is ~275); leave slopes, falling and jump pads alone."""
return 0.0 if 200 <= vz <= 320 else vz
def pick_target(bot_xy, candidates, max_dist=MAX_TARGET_DIST):
best, best_d = None, max_dist
for xy, obj in candidates:
d = math.hypot(xy[0] - bot_xy[0], xy[1] - bot_xy[1])
if d <= best_d:
best, best_d = obj, d
return best
try:
import minqlx
except ImportError: # imported by tests / the setup script outside the server
minqlx = None
if minqlx:
class lgbot(minqlx.Plugin):
def __init__(self):
super().__init__()
self.set_cvar_once("lgbot_move", "3")
for k in KEYS:
self.set_cvar_once("lgbot_" + k, "-1")
self.set_cvar_once("lgbot_debug", "0")
self.set_cvar_once("lgbot_target_bots", "0") # test aid: let it fight other bots
self.strafer = Strafer()
self.settings, self.read_at, self.log_at = None, 0.0, 0.0
self.debug = self.target_bots = False
self.failed = False
self.last_cmd, self.slow_frames, self.stuck = None, 0, 0 # debug stats
self.add_hook("frame", self.handle_frame)
def handle_frame(self):
try:
self.tick()
except Exception:
if not self.failed: # log once, never spam 40 tracebacks a second
self.failed = True
minqlx.log_exception(self)
def read_cvars(self, now):
if self.settings is None or now - self.read_at >= 1.0:
over = {k: to_int(self.get_cvar("lgbot_" + k)) for k in KEYS}
self.settings = resolve(to_int(self.get_cvar("lgbot_move")), over)
self.debug = bool(to_int(self.get_cvar("lgbot_debug")))
self.target_bots = bool(to_int(self.get_cvar("lgbot_target_bots")))
self.read_at = now
return self.settings
def tick(self):
players = self.players()
bot = next((p for p in players if is_lgbot(p.clean_name, p.steam_id)), None)
if bot is None or not bot.is_alive:
return
now = time.time()
s = self.read_cvars(now)
cands = []
for p in players:
if p.id == bot.id or p.team == "spectator" or not p.is_alive:
continue
if is_bot(p.steam_id) and not self.target_bots:
continue
pos = p.position()
cands.append(((pos.x, pos.y), p))
bpos = bot.position()
target = pick_target((bpos.x, bpos.y), cands)
if target is None:
return # nobody to duel: stock AI roams
tpos = target.position()
direction = self.strafer.step(int(now * 1000), s)
want = wanted_range(s, bot.health, target.health)
vx, vy = steer((bpos.x, bpos.y), (tpos.x, tpos.y), direction, s, want)
vel = bot.velocity()
comp = FRICTION_COMP if abs(vel.z) < 1 else 1.0
bot.velocity(x=vx * comp, y=vy * comp, z=fix_z(vel.z))
if self.debug:
self.debug_line(now, vel, (vx, vy), tpos, bpos, want, direction)
def debug_line(self, now, vel, cmd, tpos, bpos, want, direction):
# cos = how well last frame's command survived the frame (1 = exactly our direction);
# stuck = times actual speed stayed under half the command for > 0.5 s (walls)
actual = math.hypot(vel.x, vel.y)
cos = 0.0
if self.last_cmd:
lc = math.hypot(*self.last_cmd)
if lc > 1 and actual > 1:
cos = (vel.x * self.last_cmd[0] + vel.y * self.last_cmd[1]) / (lc * actual)
self.slow_frames = self.slow_frames + 1 if actual < lc / 2 else 0
if self.slow_frames == 20:
self.stuck += 1
self.last_cmd = cmd
if now - self.log_at >= 1.0:
self.log_at = now
self.logger.info("lgbot dist=%d want=%d dir=%d cmd=%d actual=%d cos=%.2f stuck=%d z=%d",
math.hypot(tpos.x - bpos.x, tpos.y - bpos.y), want, direction,
math.hypot(*cmd), actual, cos, self.stuck, vel.z)