Combat Trainer Settings - elanthia-online/dr-scripts GitHub Wiki

Combat Trainer is the default combat trainer for dr-scripts. Hunting Buddy runs it when it takes you hunting (T2 and crossing-training both go through Hunting Buddy), or you can run it yourself with ;combat-trainer <args>. Combat Trainer is a central "Class" that runs several "Processes".

Process List

Every loop, Safety runs first, then the rest top to bottom. Any process can end the loop early.
Process Purpose
Safety Stops the hunt when you're bleeding, stunned, low on health, or low on concentration.
Setup Picks the weapon to train, sets your stance, and swaps armor.
Spell Casts buffs, offensive spells, training spells and healing, and weaves them between the other processes' actions.
Pet Necromancer pets: summons and commands your zombie, and dismisses pets at the end.
Ability Non-spell abilities: khri, barbarian buffs, battle cries, warhorn, egg, and so on.
Loot Loots, skins, dissects, and handles necromancer rituals.
Manipulate Empath only. Only runs when manipulate_threshold is set.
Trainer Uses your training_abilities (Hunt, Appraise, Perceive, Tactics, ...).
Attack Handles all the non-magical attacking.

Settings are sorted by process for organizational purposes. Defaults come from base.yaml; a blank default means the setting is off until you set it.

Arguments

Argument Purpose
d# Dance threshold: d2 keeps two enemies alive. Overrides dance_threshold.
r# Retreat threshold: r3 stays at range when three or more enemies are in the room. Overrides retreat_threshold.
construct Empath: allows attacking constructs.
undead Empath: allows hunting undead while Absolution is up.
innocence Empath: avoids actions that would end Innocence.
debug Verbose debug output. UserVars.combat_trainer_debug = true does the same.
anything else Loads <Character>-<word>.yaml on top of your setup file, e.g. ;combat-trainer back loads <Character>-back.yaml.

Startup

Setting Default Purpose
default_stance 100 0 80 Stance to set when starting, before combat logic takes over.
storage_containers Containers to open when starting.
combat_trainer_gear_set standard Gear set to wear when starting (skipped when Trader regalia is in use).
combat_trainer_loop_tick 0.1 Seconds to pause at the end of each loop. Lower reacts faster; higher uses less CPU.

Processes

Safety

Setting Default Purpose
health_threshold 0 Below this vitality, combat-trainer logs you out (EXIT). 0 turns it off.
stop_hunting_if_bleeding true Stop when you start bleeding. While a heal-over-time is active (Empath Heal/Regenerate, Necromancer Devour), it only stops once vitality is also below safety_escape_health_threshold. Set to false to keep hunting; bleeds are still tended via ;tendme.
safety_escape_health_threshold Vitality floor shared by three exits: thieves who know Vanish will Vanish and stop below it (blank disables the Vanish escape); safety_exit_when_stunned uses it as its low-health line; and it's the bleed floor while a heal-over-time is active. Those last two fall back to 80 when blank. Raising it makes Vanish eager and mostly cancels the heal-over-time grace.
safety_exit_when_stunned false Stop when stunned and vitality is below safety_escape_health_threshold.
safety_concentration_minimum 0 Stop when concentration drops below this percentage. Checked first. 0 disables it.
safety_exit_on_bleeding is deprecated: it still turns on both stop_hunting_if_bleeding and safety_exit_when_stunned, with a notice. safety_untendable_threshold has been removed and is ignored.

Setup

stance_override: 100 80 0 - Stops the system from automatically dancing between stances based on mindstates and current weapons. This is not recommended for most users. It's very good if you have trained badly in the past and are trying to fix that. When set, priority_defense and stances are ignored.
priority_defense: Parry Ability/Evasion/Shield Usage - Automatically gives this skill 100%, if the current weapon allows. Use this based on your guild's primary form of damage mitigation.

Skill Suggested Guilds
Parry Ability Barbarian, Warrior Mage, Cleric, Bards
Evasion Thief, Ranger, Necromancer, Moon Mage, Empath
Shield Usage Paladin, Trader

stances - Defense order per weapon skill, using the same keys as weapon_training. The defaults put Evasion first for Bow, Crossbow, Slings and Offhand Weapon.
strict_weapon_stance: false - When false, the first two defenses listed in stances can swap, so the one with the lower learning rate and rank comes first. That learns faster, but can be dangerous when uphunting or with uneven defense ranks. Set true to keep the order exactly as listed.

priority_weapons - An array of weapon skills to prioritize. This effectively lowers the current mind state of the skill by 1, prioritizing it over the others.

priority_weapons:
- Small Edged
- Polearms

cycle_armors - If you are not wearing all types of armors at once, you can swap armor types throughout the hunt to train all types. This lowers your overall hinderance lets you get hit less often. The armor type requires an array of items.

cycle_armors:
  Light Armor:
  - cowl
  Brigandine:
  - scale mask
  - scale helm
  Plate Armor:
  - sallet
  Chain Armor:
  - balaclava

cycle_armors_time: 125 - How often, in seconds, to check whether to swap armor.
cycle_armors_hysteresis: true - When every armor on your list is trained, stop swapping (or swap to default_armor_type) instead of cycling on.
cycle_armors_regalia - Trader only, same as normal armor cycling, but uses Regalia. Needs a regalia gear set.

# If you do NOT have Bespoke Regalia, just put your highest-ranked armor skill here and nothing else!
cycle_armors_regalia:
  - Brigandine
  - Light Armor
  - Chain Armor
  - Plate Armor

default_armor_type: Brigandine - Works with cycle_armors, regalia and hysteresis: the armor skill to use once all the others on your list are trained.

Weapon selection

Setting Default Purpose
weapon_training Weapon skill → weapon to train it with. Weapons must be in your gear.
combat_trainer_target_increment 3 How many mindstates to gain with a weapon before switching.
combat_trainer_action_count 10 How many actions to take with a weapon before switching, if it hasn't reached its target.
combat_trainer_gain_check 0 Consecutive main-hand rounds with no gain before the weapon is switched or skipped. 0 is off; try 5.
combat_trainer_offhand_gain_check 0 The same for the offhand. 0 is off; try 2.
combat_trainer_focus_threshold 0 Once every trained weapon is at least this mindstate, focus on single weapons to switch less. 0 is off; try 10 or higher.
combat_trainer_offhand_trainables false Use aiming_trainables in the offhand only, so they don't compete with main-hand attacks. Needs combat_trainer_focus_threshold.
combat_trainer_ignore_weapon_mindstate false Ignore mindstates, so you can keep hunting when mindlocked or with capped weapons.
dance_threshold 0 Enemies to keep alive by dancing, or by attacking only with harmless: true spells. 0 kills everything.
dance_skill Small Edged Weapon skill to hold while dancing.
dynamic_dance_skill false Pick the dance skill from your lowest-trained weapons instead.
dance_actions analyze, circle, bob, weave Actions to take while dancing.
dance_actions_stealth Actions to take while dancing when Stealth still needs training.
retreat_threshold Retreat and stay at range when fighting this many enemies or more.
summoned_weapons Warrior Mage or Moon Mage summoned weapons. See the Dartellum or Crannach sample setups.
summoned_weapons_element / summoned_weapons_ingot / summoned_weapons_adjective Element, ingot and adjective to summon and shape them with.
damaris_weapon_sets Groups of Damaris weapons that change into one another.

Spell

Spell lists use the options described on buff_spells and offensive_spells, and on Waggle Sets.

Buffs and offensive spells

Setting Default Purpose
buff_spells Spells to keep you buffed with in combat.
combat_buff_waggle Name of a waggle set to use instead of buff_spells.
offensive_spells Spells to cast offensively.
OST_use_waggle Name of a waggle set to use as offensive_spells.
offensive_spell_cycle Names from offensive_spells, in the order to cast them. Useful with several TM or Debilitation spells.
prioritize_offensive_spells false By default combat_spell_training comes before offensive_spells; set true to reverse that.
cast_only_to_train false Only cast offensive spells while their skill still needs training.
combat_spell_training Magic skill → spell to train it with in combat. See training_spells.
combat_spell_timer 45 Seconds between combat_spell_training casts. Too low can crowd out other casting.
combat_spell_training_max_threshold Don't use combat_spell_training when more than this many enemies are in combat.
magic_exp_training_max_threshold 32 Training spells, and cast_only_to_train spells, stop once the skill is above this mindstate.
training_spells_combat_sorcery false Only cast Sorcery training spells while enemies are present.
combat_trainer_magic_gain_check 3 Casts of one skill without a gain (enemy too weak) before it's skipped.
symbiosis_learning_threshold 2 With symbiosis or sorcery spells on use_auto_mana, a cast that gains fewer mindstates than this adds mana next time.
custom_spell_prep Default custom_prep for spells that don't set their own.

Mana and cambrinth

Setting Default Purpose
buff_spell_mana_threshold 40 Don't cast buffs below this much mana.
offensive_spell_mana_threshold 40 Don't cast offensive spells below this much mana.
training_spell_mana_threshold 50 Don't cast training spells below this much mana.
cambrinth armband Cambrinth to charge.
cambrinth_cap 32 Its capacity. If it isn't stored and your Arcana is below 100 + cap × 2, it's removed before charging or invoking.
stored_cambrinth false Your cambrinth is kept in a container.
dedicated_camb_use Extra word for INVOKE, e.g. spell for cambrinth dedicated to a spell.
cambrinth_invoke_exact_amount false Invoke an exact amount. Useful for Traders with an Avtalia array.
combat_trainer_buffs_force_cambrinth true Buff spells always use cambrinth instead of harnessing extra mana.
use_harness_when_arcana_locked false When Arcana is locked, harness extra mana instead of using cambrinth.

Cyclics

Setting Default Purpose
cyclic_no_release Cyclic spells never to release when cyclics are released.
release_cyclic_on_low_mana false Release cyclics when mana is low.
release_cyclic_threshold 30 The mana level that counts as low.
segue_spell_on_stop Bard: segue to this cyclic (abbreviation, e.g. botf) instead of releasing when combat-trainer ends. Best if it's also in cyclic_no_release.
segue_prep_on_stop Prep amount for that segue.

Healing

Setting Default Purpose
empath_healing Empath: spells to heal yourself with in combat. Each key is a spell abbreviation; the values are the prep amount, then optional cambrinth amounts.
empath_vitality_threshold 95 Empath: vitality below which Vitality Healing is cast.
necromancer_healing wound_level_threshold: 1 Necromancer: healing spells and the wound level (1-8) to heal at. Consume Flesh needs thanatology: heal: true. See the Melborne sample setup.
necro_siphon_vit_threshold 85 Necromancer: vitality below which Siphon Vitality is cast.
barb_famine_healing Barbarian: Famine healing, a hash with health_threshold (use it below this health) and inner_fire_threshold (only with at least this much inner fire).

Guild-specific

Setting Default Purpose
aura_frequency Trader: seconds between starlight aura checks. See Trader Tutorials.
avtalia_array Trader: Avtalia cambrinth, built with ;avtalia.
osrel_amount Cleric: amount to infuse Osrel Meraud with.
osrel_mana_threshold 40 Cleric: minimum mana before infusing.
osrel_no_harness false Cleric: skip harnessing before infusing.
hide_type hide hide, or stalk to use slip stalk. Also used by Stealth training and stealth attacks.
tk_ammo Item to get and drop for TKT/TKS.
sliver_recast_delay 180 Moon Mage: seconds between sliver casts.
runestone_storage backpack Where runestones are kept.
ignored_npcs familiars and pets (cat, crow, dog, ...) NPCs to ignore, such as Warrior Mage familiars, so they aren't targeted or appraised.

Pet

Necromancer only.

zombie:
  make: false        # make a zombie in combat (needs a 'zombie' waggle set with CFB)
  summon: false      # call your zombie to you
  stance: offense    # zombie stance
  behavior: defensive
bonebug:
  make: false        # make a bonebug in combat (needs a 'bonebug' waggle set)

Ability

Setting Default Purpose
buff_nonspells Non-spell buffs: khri, barbarian buffs, Warrior Mage pathways, etc. See the Dartellum, Chuno or Evissam sample setups.
kneel_khri false Thief: kneel to activate khri.
khri_adaptation Thief: Khri Adaptation type (PUNCTURE, SLICE, IMPACT, FIRE, COLD or ELECTRIC).
barb_buffs_inner_fire_threshold 15 Barbarian: minimum inner fire before activating a barbarian buff.
meditation_pause_timer 20 Barbarian: seconds to wait for a meditation to activate.
war_stomp_on_cooldown false Barbarian: War Stomp whenever it's available.
pounce_on_cooldown false Ranger: Pounce whenever it's available (trains Instinct).
battle_cries Barbarian roars or Bard screams to use, in order. Each can set target_enemy, min_threshold, max_threshold and command.
battle_cry_cycle The order to use battle_cries in, by name.
battle_cry_cooldown 90 Seconds between battle cries.
roar_helm_noun Noun of a roar helm to use before roaring.
paladin_use_badge false Paladin: pray on your pilgrim badge when it's off cooldown.
paladin_use_mana_glyph false Paladin: use the mana glyph.
combat_trainer_use_yiamura false Use a yiamura.
egg Noun of an egg to use. Cooldown is 15 minutes.

warhorn: warhorn - Will use a warhorn when dancing and on a timer, automatically checks if the warhorn is worn or stowed and handles it appropriately. Automatically stows, you may need a store custom if this matters to you.
warhorn_cooldown: 1200 - Seconds between uses. Some horns are 15 minutes (900).

Loot

Setting Default Purpose
loot_bodies true Loot bodies after killing them.
loot_delay 5 Seconds to wait before looting.
custom_loot_type LOOT type to use: treasure, equipment, all, etc.
loot_specials Special handling for certain loot. See the Sarvatt sample setup.
loot_additions / loot_subtractions Items to add to or remove from the treasure list in base-items.yaml.
box_loot_limit Only loot up to this many boxes.
dump_junk false Dump junk generated by braiding and other training.
dump_item_count 9 Items to wait for before dumping.
worn_trashcan / worn_trashcan_verb A worn trash container, and the verb that empties it.

Gems

Setting Default Purpose
gem_pouch_adjective / gem_pouch_noun / pouch Your gem pouch.
full_pouch_container Where full gem pouches go.
spare_gem_pouch_container Where spare gem pouches are kept.
tie_gem_pouches true Tie full gem pouches.
autoloot_gems false Set true if your gems are autolooted.
autoloot_container Your autoloot container.
autoloot_fill_gem_pouch_delay 120 Seconds between filling your gem pouch from the autoloot container.

Skinning and dissecting

skinning:
  skin: true                     # skin kills
  arrange_all: false             # use ARRANGE ALL (set arrange_count to 1)
  arrange_count: 0               # times to arrange
  arrange_for_dissect: true      # arrange before dissecting
  tie_bundle: false              # tie bundles
  dissect: false                 # dissect kills
  dissect_priority:              # Skinning, First Aid or Thanatology: breaks ties when mindstates are equal
  dissect_retry_once: false      # retry a failed dissect once
  dissect_for_thanatology: false # redeemed necromancers can dissect for Thanatology instead of rituals
  arrange_types:                 # creature noun -> what to arrange for (skin, part, bone); default skin

Necromancer rituals

thanatology:
  ritual_type:        # ritual to perform on kills
  heal: false         # Consume Flesh healing (see necromancer_healing)
  store: false        # store harvested parts
  harvest_container:  # where to store them
  harvest_count: 0    # how many to keep
  butcher_count:      # butchers per corpse; blank butchers until the corpse is used up
Setting Default Purpose
dissect_and_butcher false Dissect after butchering.
necro_redeemed false Redeemed: only the dissect ritual is allowed.
necro_force_rituals false Perform rituals regardless of mindstates.
necro_corpse_priority pet or heal: what a corpse is used for first.
last_rites false Perform last rites.

Manipulate

Empath only. The process only runs when manipulate_threshold is set.

Setting Default Purpose
manipulate_threshold Start manipulating once this many enemies are in combat with you.
manipulate_only_to_train false Only manipulate while Empathy needs training; otherwise manipulate whenever above the threshold.

Trainer

training_abilities lists abilities and how often to use each, in seconds:

training_abilities:
  Hunt: 80
  App Quick: 60
  Tactics: 30

combat_training_abilities_target: 32 - Skip an ability once the skill it trains is above this mindstate. The first ability in your list that's due and still under the target is used, so list order matters; abilities marked not checked ignore mindstate. Full details: training_abilities.

Ability What it does Trains
Hunt HUNT Perception (and Instinct for Rangers)
Perc PERCEIVE Attunement
PercMana Moon Mage/Trader mana perception Attunement
Perc Health PERCEIVE HEALTH (Empath) Empathy
App / App Quick / App Careful Appraise an enemy Appraisal
App Pouch Appraise your gem pouch Appraisal
App Bundle Appraise your bundle Appraisal
Tactics Weave, bob or circle Tactics
Analyze ANALYZE, retried combat_analyze_retry_count (default 3) times Tactics
Charged Maneuver Use the maneuver from charged_maneuvers for your weapon (see Attack) Expertise
Stealth Hide, then stalk (unless dont_stalk; force_unhide unhides after) Stealth
Ret Stealth Retreat, then hide Stealth (not checked)
Confidence Thief: hide Stealth (not checked)
Ambush Stun Ambush stun with stun_weapon / stun_weapon_skill stun_skill (default Debilitation)
Ambush Choke Ambush choke Debilitation
Khri Prowess Thief: KHRI PROWESS Debilitation
Teach Teach combat_teaching_skill (default evasion) to friends in the room Scholarship
Recall RECALL the current enemy Scholarship
Almanac Study your almanac_noun, turning it to almanac_priority_skills, then almanac_skills, then your lowest skill Any
Astro Moon Mage: observe and predict, using astrology_prediction_skills and your telescope settings Astrology
Collect COLLECT forage_item (default rock) Outdoorsmanship
Flee FLEE BLUFF Athletics
Scream Bard: SCREAM CONC Bardic Lore
Pray PRAY favor_god Theurgy
PrayerMat Pray on your prayer_mat (from prayer_mat_container, else theurgy_supply_container) Theurgy
Meraud Cleric: the Meraud commune Theurgy
Favor Orb Rub your favor orb every favor_orb_rub_frequency (default 300) seconds. Added automatically when favor_goal is set and your orb isn't full Any
Smite Paladin: SMITE Conviction
Summon Element Domain Warrior Mage: SUMMON element DOMAIN. Needs 200 Summoning ranks Summoning (not checked)
Barb Research Augmentation / Warding / Utility Barbarian: meditate research Augmentation / Warding / Utility
Berserk Landslide / Berserk Avalanche Barbarian berserks Warding / Utility
Locksmithing Run ;locksmithing once Locksmithing
Herbs Run ;heal-remedy quick. In combat it only uses no-hands herbs unless combat_trainer_herbs_allowhands is true; combat_trainer_use_remedies uses remedies instead of raw herbs Nothing; it heals you (not checked)
Tessera Invest in your tessera while Trading is at or below tessera_mindstates (default 3) Trading

Other settings used by these abilities: favor_goal, have_telescope, telescope_name, telescope_storage, water_holder, flint_lighter, dirt_stacker.

Attack

Setting Default Purpose
attack_overrides Custom attacks to use for main-hand attacks.
use_weak_attacks false Avoid damaging attacks, for enemies that spawn slowly. Doesn't work well with whirlwind.
skip_last_kill false Don't kill the last enemy when combat-trainer ends. You may lose ammo.
fatigue_regen_threshold 90 Below this fatigue percentage, use fatigue_regen_action until rested.
fatigue_regen_action bob Action to take when fatigued.
balance_regen_threshold 8 Minimum balance for certain actions (currently only whirlwind).

Ranged

Setting Default Purpose
aim_fillers bob Actions to take while aiming, per weapon skill.
aim_fillers_stealth Actions to take while aiming when Stealth still needs training.
aiming_trainables Light weapon skills to use in the offhand while a ranged weapon aims.
use_overrides_for_aiming_trainables false Use attack_overrides for aiming trainables.
using_light_crossbow false Allow offhand melee training while aiming a crossbow.
left_hand_free false Keep your left hand free with a bow, for aiming trainables.
firing_delay 15 Delay before shooting.
dual_load false Dual load your bow. Turned off if charged_maneuvers has a Bow entry.
offhand_thrown false Allow throwing offhand weapons.

Stealth

Setting Default Purpose
use_stealth_attacks false Train Stealth by hiding and attacking from hiding.
use_stealth_ranged false Train Stealth with snipe/poach.
stealth_attack_aimed_action poach Ranged attack to use from hiding.
backstab Weapon skill (or list of skills) from weapon_training to backstab with.
backstab_past_mindlock false Keep backstabbing past mindlock.
ambush false Ambush instead of backstabbing.
ambush_location back Body part to ambush.
ambush_stun_weapons Weapon skills that can be used for Ambush Stun.

Maneuvers and engaging

Setting Default Purpose
charged_maneuvers palmstrike, powershot, cleave, crash, twirl, impale, doublestrike, rush Maneuver per weapon skill. Used when Charged Maneuver is in training_abilities.
always_use_maneuvers false Keep using maneuvers regardless of Expertise mindstate.
prioritize_maneuver_doublestrike false Doublestrike by wielding a doublestrike_trainables weapon in the offhand.
doublestrike_trainables Small Edged, Small Blunt, Large Edged, Large Blunt One-handed skills that can doublestrike.
whirlwind_trainables Barbarian: weapon skills to whirlwind with. See the Chuno sample setup.
use_analyze_combos false Use analyze combos (not for Brawling). use_barb_combos is the deprecated name.
flame_inner_fire_threshold 10 Barbarian: minimum inner fire to use Flame with analyze combos.
flame_expertise_training_threshold 28 Barbarian: use Flame while Expertise is below this.
maneuver_rush_to_engage false Use Maneuver Rush to engage.
maneuver_rush_shield Shield to rush with, as adjective noun from your gear.
maneuver_rush_skip_retreat false Don't retreat first if already at melee.
maneuver_rush_engage_only false Only rush to engage, not as a Shield Usage maneuver.
pounce_to_engage false Ranger: Pounce instead of engaging.
stomp_to_engage false Barbarian: War Stomp instead of engaging.

Empath attack restrictions

Setting Default Purpose
permashocked false Attack every hunt as if construct were passed.
import_constructs_list false Use the shared list of constructs.
import_undeads_list false Use the shared list of undead.

Return to DR Scripts Wiki

https://github.com/elanthia-online/dr-scripts/wiki

Return to DR Scripts Tutorials:

https://github.com/elanthia-online/dr-scripts/wiki/DR-Scripts-Tutorials

⚠️ **GitHub.com Fallback** ⚠️