FloatPilot Battle AI Setup Guide

This guide explains how to set up battle rules for your character and pet. You do not need to write code. Just answer three questions:

1. What should it do? For example, use a basic attack, defend, heal, or use a skill.
2. Who should it act on? For example, the current character, your pet, or an enemy.
3. When should it do it? For example, when HP is below 30%, at least 3 enemies are alive, or after round 2.

Character and pet rules are configured separately. A rule created in one tab belongs only to that tab.

Quick start

Remember these three questions

Think of every rule as one sentence:

When “this situation” happens, make “this actor” perform “this action” on “this target.”

For example:

When the character's own HP is below 30%, make the current character defend.

The setup screen breaks this sentence into fields for you.

How rules are checked

Rules are checked from top to bottom:

1. The system checks the rule at the top.
2. If every condition passes, it performs that rule.
3. The next action starts checking from the top again.
4. If a rule does not pass, the system checks the next rule.
5. One failed condition is enough to skip a rule.

For this reason, survival rules usually belong above attack rules.

The shortest first setup

1. Open “Battle Setup.”
2. Choose “Character Battle Setup” or “Pet Battle Setup.”
3. Click “Use a quick example.”
4. Choose a template that matches your need.
5. Check the order, then click “Apply and save.”
6. If the other tab should use rules too, configure that tab separately.

Game terms in plain language

Basic rule fields

Character and pet battle setup

Battle Setup has two tabs:

• “Character Battle Setup”: creates character rules only.
• “Pet Battle Setup”: creates pet rules only.

Both tabs use the same fields and controls. The only difference is which side owns the rule, so there is no separate “Executor” dropdown.

“Use a quick example” applies only to the tab you are viewing. Applying “Normal Grinding” on the character tab does not create pet rules automatically. To use it for the pet, switch to the pet tab and apply it there too.

Rule list

The rule list is the order used by the Battle AI:

• Rules higher in the list have higher priority.
• A matching earlier rule is normally performed first.
• Put survival and healing rules above attack rules.
• You can add, edit, delete, and reorder rules.

If no rule matches, the system uses the “fallback action” at the bottom, such as a basic attack or defend.

Actions

“Action” is what the system actually does after the conditions pass.

Choose the action first, then decide who it affects and when it should run. An action with no useful conditions may run too often.

Target setup

Who should it act on?

This asks which group the system should search. It does not yet decide which individual unit wins.

What must the target be like?

This filters the individual target that will receive the action. All conditions for the same target must pass.

For example, to attack “the enemy with the lowest HP”:

1. Set “Who should it act on?” to enemies.
2. Add “alive” under “What must the target be like?”
3. Add any other needed HP, level, or type conditions.
4. Under “If several match, which one should it choose?”, choose “lowest current HP.”

Common conditions include alive status, HP percentage, SP percentage, name, type, and position. Click “Add a filter (all must pass)” to add more conditions; every condition is required.

When should this rule run?

This asks whether the battle is currently in a situation where this rule should start. It checks the battle or the selected observation scope before performing the action.

Common examples:

• Run only after round 2.
• Use an area skill only when at least 3 enemies are alive.
• Defend only when your own HP is below 30%.
• Continue only while a selected character or pet is alive.

The difference is:

• “What must the target be like?” filters the target that receives the action.
• “When should this rule run?” decides whether the rule starts at all.

Who should it observe?

When adding a run condition, first choose “Who should it observe?” You can observe the current actor, characters, pets, enemies, or the whole battle.

For example:

• To check your own HP: observe the current character or pet.
• To count enemies: observe an enemy group or the whole battle.
• To check whether a teammate can be healed: observe a character or pet group.

If several match, which one should it choose?

Use the specified position order

Choose “Use the specified position order” when you want a fixed party position to be preferred, such as always healing the first position first.

Cover the most living enemies

For an area skill, choose “Cover the most living enemies.” The system uses known positions and skill range to estimate which position can affect the most living enemies. This is an estimate, not a guarantee.

Quick examples

Click “Use a quick example” to create common rules:

Templates apply only to the current tab. You can edit, delete, or reorder the rules after applying one.

Common rules you can copy

1. Normal Grinding

In either the character or pet tab, click “Use a quick example” → “Normal Grinding.”

It creates two rules:

1. Own HP strictly below 30%: defend.
2. Otherwise, use a basic attack on the living enemy with the lowest current HP.

This template belongs only to the current tab. To use it for both character and pet, apply it once in each tab.

Note: “below 30%” means less than 30%. Exactly 30% does not match.

2. Defend when your own HP is low

Create a rule with the “Defend” action:

• “Who should it act on?”: current character or pet.
• “When should this rule run?”: observe the current actor.
• Condition: HP percentage is less than 30%.

Place this rule above attack rules.

3. Heal a low-HP teammate

Create a rule using a healing skill:

• “Who should it act on?”: a character, pet, or teammate group.
• “What must the target be like?”: alive and below your chosen HP percentage.
• “If several match, which one should it choose?”: choose the lowest HP percentage first.

Confirm that the actor knows the skill, has enough SP, and that the skill accepts that target type.

4. Attack the lowest-HP enemy from round 2

• Action: basic attack.
• “Who should it act on?”: enemies.
• Target condition: alive.
• Run condition: round is greater than or equal to 2.
• If several match: choose the lowest current HP.

5. Use an area skill when enough enemies are present

• Action: use an area skill.
• “Who should it act on?”: enemies.
• Target condition: alive.
• Run condition: at least 3 living enemies are present.
• If several match: cover the most living enemies.

Suggested rule order

A useful general order is:

1. Defend when your own HP is too low.
2. Remove a dangerous status when needed.
3. Heal a low-HP teammate.
4. Use an area skill when enough enemies are present.
5. Use a single-target skill or basic attack.
6. Use the fallback action when no rule matches.

This handles survival first, then special situations, and finally normal attacks.

Save, check, and adjust

Edit and reorder

Check the action, target group, all target conditions, run conditions, and rule order. Survival rules should be above attack rules.

Check this rule first

Before saving, click “Check this rule first” to find missing required fields or incompatible settings. Passing the check means the rule is structurally complete. It does not guarantee that a target, enough SP, or a usable skill exists in the game at that moment.

Apply and save

After checking the rule content and order, click “Apply and save.” Character and pet rules are saved separately, so save the correct tab.

Common questions and troubleshooting

I applied a template, but the pet does not attack

The template applies only to the current tab. Switch to “Pet Battle Setup” and apply it there.

The unit does not defend at exactly 30% HP

The current template says “below 30%,” which means less than 30. Exactly 30% does not match. If you want 30% to defend too, change it to “less than or equal to 30%.”

There are enemies, but the basic attack does not run

Check that the enemy is alive, passes every target condition, and is not blocked by an earlier matching rule. Also confirm that the current actor can perform a basic attack and that no battle state, cooldown, or game restriction prevents it.

A skill rule does not run

Check that the character or pet knows the skill, has enough SP, the target type is accepted, and every run condition passes.

The two condition sections look similar

“What must the target be like?” filters which target receives the action. “When should this rule run?” decides whether the whole rule starts. For “heal the teammate with the lowest HP,” put teammate HP under the first section and “enough SP” or “round is greater than 1” under the second.

Several targets match, but the wrong one is chosen

Set “If several match, which one should it choose?” If no selection method is configured, the system uses its default order, which may not be what you expect.

Final checklist

• I configured the correct character or pet tab.
• The action in each rule is correct.
• “Who should it act on?” selects the right candidate group.
• I understand that all target conditions must pass.
• I understand that run conditions control whether the rule starts.
• Survival and healing rules are above normal attacks.
• I configured a selection method when several targets can match.
• I clicked “Check this rule first.”
• I clicked “Apply and save.”