Profile settings

Every setting of a fight profile, section by section as the editor shows them, with its JSON key, its values, its default and what it changes in a fight.

Lire cette page en français

This page describes every setting of a fight profile, in the order of the editor's sections. Each one gives the form's label, the key it has in the profile's JSON, its values and its default. A setting you leave out plays its default, so a profile only needs the settings you want to change. Rules have their own page: Rules and conditions.

A short profile already makes a full one:

{
  "version": 1,
  "name": "Air Cra",
  "role": "damage",
  "range": "ranged",
  "elements": ["air"],
  "positioning": "kite"
}

How the module decides explains what the module does with these settings, and Profile examples shows whole profiles for common cases.

General

Extend another profile explains Extends.

Archetype

Role

role: what the character is for in a fight. It sets the weight of each part of a turn's score (How a turn is scored).

Empty, the default, takes the role the game ranks first for the character's class: Damage Dealer, Positioner and Summoner play Damage, Tank plays Tank, Healer plays Healer, and Protector, Buffer and Debuffer play Support. When the class isn't known, Damage.

Range

range: the distance the character fights at, and where it's placed when its spells aren't known yet.

Default: Automatic. The reach counts the character's range bonus and the spells' range changes.

Elements

elements: the elements whose spells it favours, among Earth (earth), Fire (fire), Water (water), Air (air) and Neutral (neutral). A damaging spell of one of them scores 1.2 times as much. Empty, the default, favours none: the module casts whatever hits hardest with the character's real characteristics, which follows its build and gear.

Risk

risk: how much danger the character accepts, from 0 (careful) to 100 (reckless). Default: 50. The module avoids ending a turn where the enemies could deal it more than this percent of its life on their next turn, and where they could kill it, unless the risk is 100. The danger explains how that danger is worked out.

Placement

placement: where the character starts the fight.

Default: Automatic. The module only places the character when the Placement part is on (see Play).

Positioning

positioning: where the character ends its turn, once nothing is left worth casting.

Default: Automatic.

Focus

focus: which enemy it hits first. Hitting that enemy scores twice as much.

Default: Best score. Monsters and rules can add their own focus: see Monsters and Rules and conditions.

Allies

allies: how it treats the other fighters of its team, characters and summons.

Default: Help. Hurting its own side always counts against a turn, by default five times as much as hurting an enemy counts for it, whatever this says.

Play

Parts

parts: the parts of a fight the module decides. Each is on unless the profile switches it off.

The turns themselves are always played: to leave them to someone else, switch the module off, or pass every turn with the setting below.

Pass every turn

Pass every turn after (seconds): when checked, the character ends every turn after that many seconds, without acting. It's a rule without a condition, { "do": { "endTurn": { "after": 5 } } }, which the form shows here rather than among the rules. Idle is exactly that, with every part off.

Weapon

weapon: what it does with the weapon it holds, or with bare hands when it holds none.

Wait for allies

waitForAllies: how many other characters must be on the character's team before it says it's ready. Default: 0. It's for group fights where several bots join one after the other: the character waits for the others, and the placement countdown still starts the fight when it ends.

Spells

spells: what the profile says about some spells. A spell not listed is used normally, so only list the spells you want to change. Listing a spell the character doesn't have does nothing. The entries apply to the spells of a summon the character controls too: list a fairy's spell to change how the fairy uses it.

A spell's condition can also test the fighter it's cast on, with Target · HP (target.life) and Target · Distance (target.distance). For example, an Iop's Chopper (13115), preferred but kept for enemies below a third of their life:

{
  "id": 13115,
  "use": "prefer",
  "when": { "target.life": { "below": "33%" } }
}

The weapon isn't a spell entry: set it with Weapon in Play. An entry without a spell is refused with spells[0].id: required: the weapon is the profile's weapon.

Opening

opening: spells cast first in a turn, in order, whenever they can be cast. The module plays the rest of the turn as usual.

Each list holds spells in the order they're cast. A spell listed twice is cast twice. The opening is the character's alone: a summon it controls never plays it. A step that can't be cast right now, for lack of AP, range or line of sight, is skipped, and the next one is tried.

In the JSON, a step is a spell's id, "weapon" for a weapon hit, or an object that also says whom to cast it on. For an Iop that casts Fervour (14676) on itself in its first turn, then opens every turn with Pressure (13106):

"opening": {
  "firstTurn": [{ "spell": 14676, "target": "self" }],
  "everyTurn": [13106]
}

The target takes the same values as a rule's: see Targets. The form edits plain lists of spells; a list with a step aimed at a target is edited in the JSON.

Monsters

monsters: what it does with some monsters, picked one by one (By monster) or by their race (By race).

An entry applies to every monster of the fight it matches. A monster that matches several entries, such as one by monster and one by its race, gets all of them: the focuses multiply, and the largest distance holds.

For a character that kills L'il Gloots (4109) first and keeps 3 cells away from every monster of the Incarnam Chafers race (137):

"monsters": [
  { "id": 4109, "focus": "first" },
  { "race": 137, "keepAway": 3 }
]

Weights

weights: what each part of a turn's score is worth against the others. The role sets them (How a turn is scored has the table), and a weight set here replaces the role's. Each is a number, 0 or more.

Weights are for fine tuning, after role, range, risk and the other settings. A weight of 0 switches a part off: "safety": 0 makes the character ignore the danger altogether. A name that isn't one of these is ignored, with a warning.

Challenges

Next, Rules and conditions explains rules: what the character does when something happens in the fight.