Method tryMovementAbility

src/bot.ts:1191–1233

* Try to use an ability flagged as `isMovementAbility` (teleport, flying dash, etc.) * to reposition the creature. * Returns true if an ability was triggered.

(opts: { requireTrapSafe?: boolean } = {})

	 * Returns true if an ability was triggered.
	 */
	tryMovementAbility(opts: { requireTrapSafe?: boolean } = {}): boolean {
		const creature = this.game.activeCreature;
		if (!creature) return false;
		const requireTrapSafe = opts.requireTrapSafe ?? false;

		const strategy = this.getStrategyFor(creature);
		const abilityOrder =
			strategy?.getAbilityPriority?.(creature, this) ?? creature.abilities.map((_, i) => i);

		for (const i of abilityOrder) {
			const ability = creature.abilities[i];
			if (
				!ability ||
				!ability.isMovementAbility ||
				(requireTrapSafe && ability.isMovementAbility !== 'safe') ||
				this.failedAbilityIds.has(i) ||
				ability.getTrigger() !== 'onQuery' ||
				ability.used ||
				typeof ability.require !== 'function'
			) {
				continue;
			}
			try {
				if (!ability.require()) continue;
			} catch {
				continue;
			}
			this.setPendingAction({ type: 'ability', abilityIndex: i });
			const previousQueryOpt = this.game.grid?.lastQueryOpt;
			ability.use();
			if (this.pendingAction === null) {
				continue;
			}
			if (this.game.grid?.lastQueryOpt === previousQueryOpt) {
				this.clearPendingAction();
				this.failedAbilityIds.add(i);
				continue;
			}
			return true;
		}

		return false;
	}

	private setPendingAction(action: BotPendingAction) {
		this.pendingAction = action;