FloatPilot Battle AI Settings Guide

This guide follows the current Settings → Character → Battle tab. It is organized to help you create one working rule first, then add filters, sorting, and fallback Target Profiles step by step.

The numbers in this guide are the option values currently used by the program. They are not free-form input. If this guide and the App differ, follow the options currently shown in the App.

Quick start

How does a rule execute?

Character rules and pet rules are stored separately. Whenever a character or pet can act, FloatPilot checks that actor's rules in order:

1. Check whether the trigger condition is true.
2. Ask the Target Profile to find a legal target.
3. Execute the action only when both checks pass.
4. If no legal target is found, skip the rule and continue with the next one.

Put emergency protection rules before attack rules. Put unconditional rules near the end. An unconditional rule that finds a legal target can prevent all later rules from running.

If no rule succeeds, FloatPilot uses a fallback action: attack the enemy with the lowest current HP; if there are no enemies, defend.

Create your first rule

Example: use a healing skill on yourself when character HP is below 35%:

1. Open the character settings window and select the Battle tab.
2. Select 00_人物當前HP百分比 as the trigger condition.
3. Select 單一 as the aggregation.
4. Select <= as the comparison and enter 35 as the trigger value.
5. Select action 01_人物使用技能, then choose a skill that can heal yourself.
6. Select 自己人物 as the Target Profile.
7. Click 添加到人物規則 and confirm that the rule appears in the character rule list.
8. Click Save in the settings window.

If the button is disabled, read the hint beside it. The trigger value, skill, or Target Profile is usually incomplete.

Rule field reference

Trigger conditions

The Battle tab currently provides these trigger conditions:

The current UI does not provide “target current HP value” or “target current SP value” as trigger conditions. An enum retained in the program does not mean that the option is available in the UI. Do not use the non-Battle “current map ID” as a Battle trigger.

Aggregation

Aggregation only determines whether the condition is true. The Target Profile still determines the final target.

• 單一 (single): compare one value.
• 任一 (any): at least one candidate must match.
• 全部 (all): every candidate must match.
• 最低 / 最高 (lowest / highest): take the lowest or highest candidate value before comparing.
• 平均 (average): calculate the candidate average before comparing.

數量 (Count) is not currently available as a Battle aggregation. Do not create a “Target ID + Count” rule from an old guide.

Comparisons and trigger values

Available comparisons are: =, !=, <, <=, >, >=, and 無條件 (unconditional).

• HP/SP percentages: enter an integer from 0 to 100, such as 35.
• HP/SP, rounds, counts, levels, and IDs: enter an integer.
• Target elements: choose one from the element menu; do not type the text yourself.
• 無條件 (unconditional): no trigger value is required, but rule order still matters.

Actions and rule ownership

Normal attack cannot target allies. Flee, logout, and defend cannot target enemies. Always use the skill data to determine target restrictions; do not infer them from a skill name.

Target Profile

A Target Profile is a “find a target” rule: choose a target group, add filters, and then choose the sorting priority.

Target groups

The action and skill can restrict the available groups:

• Enemy-only skills: 敵人 only.
• Ally-only skills: yourself, your active pet, teammate characters, or teammate pets.
• Skills that support both sides: enemy and ally groups are available.
• Flee, logout, and defend: yourself only.
• 自己人物 and 自己出戰寵物 contain one object and do not show a sorting editor.

Enemy filters

These filters appear only when the target group is 敵人: 屬性優勢, 屬性劣勢, 屬性, 人型, 非人型, 已封印, and 未封印.

The following filters are mutually exclusive within one Profile:

• 屬性優勢 and 屬性劣勢.
• 人型 and 非人型.
• 已封印 and 未封印.

After selecting 屬性, choose 無屬性, 地屬性, 火屬性, 水屬性, or 風屬性 from the menu. There is currently no specific ID, level-range, front-row, back-row, or custom-row filter. ID can only be used as a trigger condition.

Sorting

Enemies can be sorted by position order, area-skill coverage, HP, SP, level, level difference, MaxHP, MaxSP, STR, CON, INT, WIS, AGI, critical rate, bow resistance, ID, party position, status count, battlefield row, or battlefield column.

Teammate characters and teammate pets can be sorted by position order, HP, SP, level, level difference, party position, status count, battlefield row, or battlefield column.

Except for 站位順序優先 and 技能範圍命中數最多, every sorting option supports 最低 or 最高. After choosing position order, drag the ally or enemy slots 1–4 and front/back-row positions; the top position has priority.

Advanced Profiles and fallback

Normal mode has only Profile 1. Advanced mode supports up to 8 Profiles. FloatPilot tries Profile 1, Profile 2, and so on: it tries the next Profile only when the previous one cannot find a legal target. If none finds a target, the rule is skipped and the next rule is checked.

Put strict conditions in Profile 1 and a safe fallback in Profile 2:

Profile 1: 敵人 + 屬性優勢 + 當前 HP + 最低
Profile 2: 敵人 + 當前 HP + 最低

Ready-to-use examples

Heal yourself when character HP is low

Trigger: 00_人物當前HP百分比
Aggregation: 單一
Comparison: <=
Value: 35
Action: 01_人物使用技能
Skill: A healing skill that can target yourself
Profile: 自己人物

Defend when pet SP is low

Trigger: 07_出戰寵物當前SP值
Aggregation: 單一
Comparison: <=
Value: 20
Action: 05_防禦
Profile: 自己出戰寵物

Attack the lowest-HP enemy starting in round 2

Trigger: 10_當前戰鬥回合數
Aggregation: 單一
Comparison: >=
Value: 2
Action: 01_人物使用技能
Skill: Enemy-only skill
Profile: 敵人 + 當前 HP + 最低

Finish when any enemy HP% is <= 30

Trigger: 13_目標當前HP百分比
Aggregation: 任一
Comparison: <=
Value: 30
Action: 01_人物使用技能
Skill: Single-target skill
Profile: 敵人 + 當前 HP + 最低

Use an area skill when every enemy HP% is <= 60

Trigger: 13_目標當前HP百分比
Aggregation: 全部
Comparison: <=
Value: 60
Action: 01_人物使用技能
Skill: Area skill
Profile: 敵人 + 技能範圍命中數最多

Use a specific strategy against fire-element enemies

Trigger: 16_目標屬性
Aggregation: 任一
Comparison: = (equal)
Value: 火屬性 (choose it from the menu)
Action: 01_人物使用技能
Skill: Enemy-only skill
Profile: 敵人 + 屬性 = 火屬性 + 當前 HP + 最低

Prioritize the highest-level enemy

Trigger: 15_目標等級
Aggregation: 最高
Comparison: >=
Value: 120
Action: 01_人物使用技能
Skill: Enemy-only skill
Profile: 敵人 + 等級 + 最高

Recommended rule order

Arrange rules from top to bottom in this order:

1. Emergency protection: logout, healing, or defense.
2. Character/pet resource protection: low HP or low SP.
3. Specific strategies: round, element, seal state, or enemy count.
4. Area skills: when enemy count or overall HP is suitable.
5. Finishing skills: when few enemies remain or the lowest HP reaches a threshold.
6. Normal attack or final unconditional defense.

Do not place an unconditional attack first. Once it finds a legal enemy, later rules will not execute.

Common questions and troubleshooting

The button is disabled

Check, in order: is the trigger value an integer, has a skill been selected, are character and pet skills in the correct rule list, is the Target Profile complete, and are the action and target group compatible?

The rule was added but never executes

Check these items in order:

1. Is it being preempted by an earlier rule?
2. Has the actual trigger value reached the comparison threshold?
3. Can the Target Profile find a living, legal target?
4. Does the skill belong to the correct character or pet?
5. Does the skill require more SP?

Normal attacks keep appearing

Usually no rule is true, the Target Profile cannot find a target, the skill is missing, SP is insufficient, or the skill does not allow the selected target. Start with “normal attack → enemy → lowest current HP” to verify the basic flow, then add conditions gradually.

The wrong target was selected

Check two separate things: which candidates the trigger condition evaluates, and which filters and sorting the Target Profile applies. A true trigger does not guarantee that the triggered candidate is attacked; the Profile still chooses the final target.

Final checklist

• Emergency protection rules are above attack rules.
• Character skills are only in character rules; pet skills are only in pet rules.
• Normal attack uses an enemy Profile.
• Flee, logout, and defend use a self Profile.
• Every Profile has a legal target group and sorting configuration.
• 數量 is not used as an aggregation.
• 目標 ID is not treated as a specific Profile ID filter.
• Save the settings and observe several combat rounds.