---
title: Eagle Commands
description: Strategic command reference for Eagle command panels.
---

Eagle commands are the strategic actions a faction can take from a province command panel. The server advertises available commands with `AvailableCommand`, and the client posts the matching `SelectedCommand`.

Most commands belong to the province currently acting this turn. Some are reaction commands, such as resolving diplomacy offers, handling captured heroes, or choosing a battle aftermath decision.

<span class="command-reference-marker" aria-hidden="true"></span>

<!--
Source map for numeric command details:
- Alms: src/main/resources/net/eagle0/eagle/settings.tsv fields almsSupportIncreasePerFood=0.01, almsPaladinSupportMultiplier=4, maxAlmsFood=1000; applied in src/main/scala/net/eagle0/eagle/library/actions/impl/command/AlmsCommand.scala and src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableAlmsCommandFactory.scala.
- Feast: settings fields loyaltyGainFromFeast=10, vigorGainFromFeast=10, feastGoldCostPerHero=20; applied in src/main/scala/net/eagle0/eagle/library/actions/impl/command/FeastCommand.scala and src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableFeastCommandFactory.scala.
- Hero Gift: settings fields loyaltyIncreasePerGold=0.25 and maxGiftGold=100; applied in src/main/scala/net/eagle0/eagle/library/actions/impl/command/HeroGiftCommand.scala and src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableHeroGiftCommandFactory.scala.
- Rest: settings field restVigorGain=15; applied in src/main/scala/net/eagle0/eagle/library/actions/impl/command/RestCommand.scala.
- Vigor costs: src/main/resources/net/eagle0/eagle/settings.tsv fields actionVigorCost=15, reconVigorCost=30, apprehendOutlawVigorCost=30, controlWeatherVigorDelta=-40, startEpidemicVigorDelta=-30, vigorGainFromFeast=10, restVigorGain=15.
- Divine: divinable heroes are unaffiliated heroes with RecruitmentInfo.NotDivined; see src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableDivineCommandsFactory.scala and src/main/scala/net/eagle0/eagle/library/actions/impl/command/DivineCommand.scala.
- Issue Orders: order availability comes from src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableIssueOrdersCommandFactory.scala; vassal order behavior comes from src/main/scala/net/eagle0/eagle/library/actions/impl/action/PerformVassalCommandsPhaseAction.scala, src/main/scala/net/eagle0/eagle/library/util/command_choice_helpers/CommandChoiceHelpers.scala, and src/main/scala/net/eagle0/eagle/library/util/command_choice_helpers/ExpandCommandSelector.scala.
- Send Supplies: shipment scheduling comes from src/main/scala/net/eagle0/eagle/library/actions/impl/command/SendSuppliesCommand.scala; arrival comes from src/main/scala/net/eagle0/eagle/library/actions/impl/action/PerformProvinceMoveResolutionAction.scala and src/main/scala/net/eagle0/eagle/library/actions/impl/action/ShipmentArrivedAction.scala; timing/loss settings are src/main/resources/net/eagle0/eagle/settings.tsv fields turnsToResolveShipment=1 and shipSuppliesLoss=0.1.
- Battle Aftermath Decision: availability comes from src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableBattleAftermathDecisionCommandFactory.scala; selection comes from src/main/scala/net/eagle0/eagle/library/actions/impl/command/BattleAftermathDecisionCommand.scala; finalization comes from src/main/scala/net/eagle0/eagle/library/actions/impl/action/FinalizeAftermathAction.scala.
- Manage Prisoners: availability comes from src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableManagePrisonersCommandFactory.scala; option effects come from src/main/scala/net/eagle0/eagle/library/actions/impl/command/ManagePrisonersCommand.scala; prisoner move/return timing comes from src/main/scala/net/eagle0/eagle/library/actions/impl/action/EndPlayerCommandsPhaseAction.scala; settings include prisonerEscapeChance=0.01.
- Handle Captured Hero: availability comes from src/main/scala/net/eagle0/eagle/library/actions/availability/AvailableHandleCapturedHeroCommandFactory.scala; option effects come from src/main/scala/net/eagle0/eagle/library/actions/impl/command/HandleCapturedHeroesCommand.scala; deferred aftermath effects come from src/main/scala/net/eagle0/eagle/library/actions/impl/action/EndBattleAftermathPhaseAction.scala; settings include startingLoyalty=60 and truceMonthsFromReturningLeader=12.
-->

## Normal Command Phase Commands

Most command phase actions spend the acting province's turn.

### Alms

<b>Hero requirements:</b> None. [Paladins](/heroes/#paladin) get a bonus.

<b>Vigor cost:</b> 15.

<b>Available when:</b> the acting province has food to give and an eligible hero with enough vigor.

<b>Effect:</b> Give up to 1000 food from the acting province as charity. The province gains 1 [support](/provinces/#support) per 100 food, capped by the province's maximum 100 support. Paladins multiply the support gain by 4, so a Paladin gives 4 support per 100 food. The acting hero spends vigor and gains charisma XP.

<b>Selection:</b> choose an amount of food and the acting hero.

### Apprehend Outlaw

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> 30.

<b>Available when:</b> an [outlaw hero](/factions/#free-heroes) is present in the acting province and an eligible hero has enough vigor.

<b>Effect:</b> Attempt to capture the outlaw. On success, the outlaw is removed from the province's unaffiliated heroes and re-added as a prisoner with a bias against the imprisoning faction. The acting hero spends vigor, and the game creates a deferred notification/story request.

<b>Selection:</b> choose the outlaw, an optional battalion, and the acting hero.

### Control Weather

<b>Hero requirements:</b> [Mage](/heroes/#mage).

<b>Vigor cost:</b> 40.

<b>Available when:</b> a Mage has enough vigor and the acting province or an adjacent province has a valid weather change.

<b>Effect:</b> Change weather in a target province. Available options can start or end blizzards and droughts. The target province receives a deferred weather change, and the acting hero records a weather backstory event, spends or gains the configured vigor delta, and gains wisdom XP.

<b>Selection:</b> choose the weather control type, target province, and acting hero.

### Diplomacy

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> 15 from the messenger hero.

<b>Available when:</b> a diplomatic option is valid against another faction and an eligible messenger hero can be sent.

<b>Effect:</b> Send a hero to another faction with a diplomatic proposal. The target faction receives the offer at the end of the current round, after any battles this round have taken place. Truce, invitation, alliance, break-alliance, and ransom options create [incoming diplomacy offers](/factions/#incoming-diplomacy-offers) for the target faction and story-generation requests. Most diplomacy options spend gold and cost the messenger vigor.

For truce, invitation, alliance, and break-alliance missions, the envoy leaves the acting province immediately and is unavailable for the rest of the current round, including its battles. The envoy normally returns during **Diplomacy Resolution** near the end of that same round and can act again next round. If the origin province has been lost, the envoy returns elsewhere in the faction when possible. An imprisoned envoy does not return.

<b>Selection:</b> choose the diplomacy option, target faction, and sent hero.

### Exile Vassal

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> this province has at least one [vassal](/heroes/#vassals).

<b>Effect:</b> Remove the selected vassal from your faction.

<b>Selection:</b> choose the hero to exile.

### Feast

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None. This restores up to 10 vigor for each ruling-faction hero in the province.

<b>Gold cost:</b> 20 gold for each ruling-faction hero in the province, multiplied by the province [price index](/provinces/#price-index) and rounded up. For example, a province with 3 ruling-faction heroes and a 1.25 price index pays 75 gold.

<b>Available when:</b> the acting province can pay the full feast cost.

<b>Effect:</b> Hold a feast in the acting province. Every ruling-faction hero in the province gains up to 10 loyalty, capped at 100, and up to 10 vigor, capped by constitution. Faction leaders do not gain loyalty, but can still gain vigor. The province spends gold, the price index may change, and feast-spending quest counters can advance.

<b>Selection:</b> no additional choices.

### Hero Gift

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the province has a non-leader hero with less than 100 LOY and gold available to give.

<b>Effect:</b> Send up to 100 gold as a gift to the selected hero. Loyalty gain depends on the gold amount, the recipient province's price index, and the hero's current loyalty: the base gain is 0.25 loyalty per gold, divided by price index, capped by the remaining room to 100 LOY.

<b>Selection:</b> choose the recipient hero and amount.

### Improve

<b>Hero requirements:</b> None. [Engineers](/heroes/#engineer) get a bonus.

<b>Vigor cost:</b> 15.

<b>Available when:</b> a hero has enough vigor and the province has an available improvement or devastation repair option.

<b>Effect:</b> Improve a province using one of the available improvement types. [Economy, agriculture, and infrastructure](/provinces/#development-stats) rise toward 100; [devastation](/provinces/#devastation) repair reduces all three devastation tracks. The acting hero spends vigor and gains strength/agility XP, and the improvement can optionally be locked as the province's preferred type.

<b>Selection:</b> choose the improvement type, acting hero, and whether to lock the type.

### Issue Orders

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None. This does not take your turn.

<b>Available when:</b> a faction leader is acting and your faction controls more than one province. This command does not take your turn.

<b>Effect:</b> Set [standing orders](/provinces/#province-orders) for your provinces. Orders guide vassal-ruled provinces during the [Vassal Commands phase](/concepts/eagle-round-flow/#vassal-commands); provinces led directly by faction leaders are still commanded directly. Vassals may still handle urgent problems first, such as defense, riots, severe fatigue, low support, beast suppression, loyalty management, or other immediately available crisis commands.

<b>Selection:</b> submit the new province orders and the new focus province, or clear the focus province.

#### Order Meanings

##### Entrust

Use the vassal's judgment. If the province borders an enemy, the vassal tends to act like **Mobilize**. Otherwise, the vassal tends to act like **Develop**.

##### Develop

Build up the province. The vassal may send away surplus gold and food toward your focus province, if one is set, or otherwise toward the nearest faction leader. Then it prefers **Improve** actions that raise economy, agriculture, infrastructure, or repair devastation. If nothing useful is available, the province rests.

##### Mobilize

Prepare for war. The vassal may ship excess gold and food toward your focus province, if one is set, or otherwise toward the nearest faction leader. Then it may organize troops, arm troops, improve infrastructure when it limits training, train battalions, and fall back to improvement or rest.

##### Expand

Look for growth or attack opportunities. The vassal first tries to march into neutral provinces, usually leaving enough heroes behind to keep the origin province held. If expansion is not practical, it may spread heroes among your existing provinces, attack enemies when appropriate, improve the province, or rest.

### March

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> 15 from each marching hero.

<b>Available when:</b> the acting province has movable heroes, battalions, gold, or food and at least one valid destination.

<b>Effect:</b> Move heroes, battalions, gold, and food from one province to another. March is inter-province movement and always has a destination; [Visit Town](#visit-town) is only a local visit within the current province. The selected units and supplies leave the origin province immediately, each marching hero spends vigor and gains wisdom XP, and the destination receives an [incoming army](/provinces/#incoming-armies) scheduled for the next round.

If the destination is already ruled by your faction when the army arrives, the heroes, battalions, gold, and food enter the province during the next round's Province Move Resolution phase, before riots, vassal commands, and player commands.

If the destination is neutral or hostile, the army does not simply appear in the province at Province Move Resolution. It is set up as a hostile army later in that same next round, after player commands. A neutral province can then be taken in the Uncontested Conquest phase; a defended province can lead into attack, defense, battle request, and battle resolution phases. Until one of those outcomes resolves, the marching heroes are still in the moving army rather than ruling the destination.

<!-- Sources:
- March scheduling: src/main/scala/net/eagle0/eagle/library/actions/impl/command/MarchCommand.scala
- Friendly arrival timing: src/main/scala/net/eagle0/eagle/library/actions/impl/action/PerformProvinceMoveResolutionAction.scala
- Hostile setup and neutral conquest timing:
  src/main/scala/net/eagle0/eagle/library/actions/impl/action/PerformHostileArmySetupAction.scala
  src/main/scala/net/eagle0/eagle/library/actions/impl/action/PerformUncontestedConquestAction.scala
- Phase order: src/main/scala/net/eagle0/eagle/model/state/RoundPhase.scala
-->

<b>Selection:</b> choose origin, destination, gold, food, and marching units.

### Organize Troops

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the acting province has battalions to manage, troops to reorganize, or gold to raise new troops.

<b>Effect:</b> Create, resize, merge, transfer, or dismiss battalions in the acting province. New troops cost gold and enter with no training or armament, while transferred troops preserve weighted training and armament. Empty battalions are destroyed, new battalions get generated names and initial backstory requests, and the province price index may change from the gold spend.

<b>Selection:</b> submit changed battalions and new battalions, including troop movements and new troop counts.

### Recon

<b>Hero requirements:</b> [Ranger](/heroes/#ranger).

<b>Vigor cost:</b> 30.

<b>Available when:</b> a Ranger has enough vigor and there is a valid target province to scout.

<b>Effect:</b> Send a hero to scout another province.

<b>Selection:</b> choose the acting hero and target province.

### Rest

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None. This restores up to 15 vigor for each ruling-faction hero in the province.

<b>Available when:</b> the acting province can spend its turn resting.

<b>Effect:</b> Have the acting province rest for the turn. Faction heroes in the province regain up to 15 vigor, capped by constitution, and rest-related quest counters can advance.

<b>Selection:</b> no additional choices.

### Send Supplies

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> 15.

<b>Available when:</b> the acting province has supplies to send, an eligible hero, and a valid destination province.

<b>Effect:</b> Send gold and food from the acting province to another province. The origin province loses the full selected amount immediately, and the destination receives an [incoming shipment](/provinces/#incoming-shipments) scheduled for the next round.

Shipments arrive during the next round's Province Move Resolution phase, before riots, hero departures, vassal commands, player commands, battles, and food consumption. That means food shipped this way is available to feed the destination province later in the same round it arrives. When the shipment arrives, 10% is lost in transit and the destination receives the remaining gold and food, rounded down.

<b>Selection:</b> choose gold, food, acting hero, and destination province.

### Start Epidemic

<b>Hero requirements:</b> [Necromancer](/heroes/#necromancer).

<b>Vigor cost:</b> 30.

<b>Available when:</b> a Necromancer has enough vigor and the acting province or an adjacent province can receive an epidemic.

<b>Effect:</b> Start an epidemic in the target province.

<b>Selection:</b> choose the target province and acting hero.

### Suppress Beasts

<b>Hero requirements:</b> None. Heroes with any profession get a power bonus.

<b>Vigor cost:</b> 15 on success, plus any vigor lost to casualties. If the hero is killed, the command fails.

<b>Available when:</b> the acting province has a [beast event](/provinces/#province-events) and an eligible hero.

<b>Effect:</b> Send a hero, optionally with a battalion, to suppress beasts in the acting province. The fight rolls beast power, applies casualties to the battalion and/or hero, removes the beast event on success or failure, and creates a story notification. Success can award gold, food, support, hero XP, and battalion backstory; failure can kill the hero and destroy the battalion.

<b>Selection:</b> choose the hero and optional battalion.

### Swear Kinship

<b>Hero requirements:</b> The target hero must have at least 95 loyalty.

<b>Vigor cost:</b> None.

<b>Available when:</b> the faction head is in the province, your faction has fewer than 5 faction leaders, and another hero in the province has at least 95 loyalty.

<b>Effect:</b> Choose a hero for a kinship bond. A hero who swears kinship becomes a [faction leader](/heroes/#faction-leaders).

<b>Selection:</b> choose the hero to swear kinship with.

### Train

<b>Hero requirements:</b> None. [Champions](/heroes/#champion) get a bonus.

<b>Vigor cost:</b> 15.

<b>Available when:</b> a hero has enough vigor and the province has at least one battalion with less than 100 TRN.

<b>Effect:</b> Raise the TRN of all trainable battalions in the province. The more troops are present, the lower the amount raised. The acting hero spends vigor and gains charisma, strength, and agility XP.

<b>Selection:</b> choose the acting hero.

### Visit Town

<b>Hero requirements:</b> None. The acting province's ruling hero makes the visit.

<b>Vigor cost:</b> 15.

<b>Available when:</b> the acting province's ruling hero has at least 40 vigor, the hero is not already visiting town, and there is no blizzard.

<b>Effect:</b> Have the ruling hero leave camp to visit the town inside the acting province. Visit Town does not move any hero, battalion, or supplies to another province, so it has no destination; use [March](#march) for inter-province movement.

Visit Town spends the ruling hero's vigor and unlocks whichever town commands below are currently eligible. You can use as many eligible town commands as you want in the same round before using Return to go back to camp. If no town activity currently qualifies, Return may be the only command available.

<b>Selection:</b> no additional choices. Visit Town always uses the current province and never asks you to select a destination.

## Town Commands

You must use Visit Town before these local commands appear. The ruling hero remains in the current province; only the available command set changes from camp duties to town activities. While visiting town, you can use as many eligible town commands as you want in one round before using Return to come back to camp.

### Arm Troops

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the ruling hero is visiting town, the province has gold, and at least one battalion can raise ARM without exceeding effective infrastructure.

<b>Effect:</b> Spend gold to raise armament on existing battalions. New armament must be higher than the battalion's current armament and cannot exceed the province's effective infrastructure. The province spends gold, the price index may change, and each armed battalion records a backstory event.

<b>Selection:</b> choose the battalions to arm and how much armament each receives.

### Decline Quest

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the ruling hero is visiting town and an [unaffiliated hero](/heroes/#unaffiliated-heroes) quest is available in the province.

<b>Effect:</b> Decline one of the unaffiliated hero quests available in the acting province.

<b>Selection:</b> choose the hero whose quest should be declined.

### Divine

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Gold cost:</b> 100 gold per selected hero, multiplied by the province [price index](/provinces/#price-index) and rounded to the nearest whole gold for each hero. The total cost is that per-hero cost multiplied by the number of selected heroes. For example, divining 3 heroes at a 1.25 price index costs 375 gold.

<b>Available when:</b> the ruling hero is visiting town, the province can pay the cost for at least one hero, and there are free heroes who are not yet ready to join your faction but might be won over.

<b>Effect:</b> Spend gold to divine one or more [free heroes](/factions/#free-heroes). For each divined hero, you receive details about what could impress them enough to become recruitable. Fulfill that ask, and the hero can later appear under Recruit Heroes. The province spends gold, and the price index may change.

<b>Selection:</b> choose the heroes to divine.

### Manage Prisoners

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the ruling hero is visiting town and the province has prisoner heroes with available management options.

<b>Effect:</b> Choose what happens to ordinary prisoners in the province. These are heroes who are already in the prisoner state, not newly captured heroes still waiting for a battle aftermath decision.

<b>Selection:</b> choose the prisoner and management option.

#### Options

##### Execute

<b>Effect:</b> Kill the prisoner and remove them from the game.

##### Exile

<b>Available when:</b> the prisoner is not a faction leader.

<b>Effect:</b> Turn the prisoner into an outlaw in the same province.

##### Release

<b>Available when:</b> the prisoner is not a faction leader.

<b>Effect:</b> Release the prisoner as a traveler in the same province. Released prisoners are no longer in your custody, but they do not automatically join another faction.

##### Move

<b>Available when:</b> you control an adjacent province.

<b>Effect:</b> Send the prisoner to one adjacent province ruled by your faction. The prisoner leaves the origin province now and arrives at the destination at the end of the Player Commands phase. There is a 1% chance the prisoner escapes during the move; if that happens, they become an outlaw in the destination province instead of remaining a prisoner.

##### Return

<b>Available when:</b> the prisoner is a faction leader and their faction still controls at least one province.

<b>Effect:</b> Return the prisoner to their faction. They leave your custody now and rejoin their faction at the end of the Player Commands phase as a ruling hero in one of that faction's provinces.

Ordinary prisoners cannot be returned this way. Faction leader prisoners cannot be released or exiled, but they can be executed, moved within your territory, or returned if their faction still exists.

### Recruit Heroes

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the province is ruled by one of the acting faction's faction leaders, that ruling faction leader is visiting town, and at least one unaffiliated hero in the province currently qualifies to join that faction. The visitor may be any faction leader; it does not have to be the faction head. Vassals cannot use this command.

<b>Effect:</b> Recruit available unaffiliated heroes in the acting province. Recruited heroes join the faction at starting loyalty, move from the province's unaffiliated hero list into its ruling faction heroes, and receive a recruitment backstory event.

<b>Selection:</b> choose the heroes to recruit.

See [**What `WOULD_JOIN` Means**](/factions/#what-would_join-means) for the recruitment status, traveler exception, and separate **Please Recruit Me** behavior in vassal-ruled provinces.

### Return

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the ruling hero is visiting town.

<b>Effect:</b> Return the ruling hero from the current province's town to camp and end that province's turn.

<b>Selection:</b> no additional choices.

### Trade

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> the ruling hero is visiting town and the province has enough gold or food for at least one trade.

<b>Effect:</b> Buy or sell food using the acting province's gold and food stores. Food buy and sell prices are based on the province price index. Buying spends gold and adds food; selling removes food and adds gold. The price index may change after the trade.

<b>Selection:</b> choose buy or sell and the amount of food.

## Special and Conditional Commands

These commands appear only when the game is resolving a special situation, response, or pending decision.

### Attack Decision

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> an attack decision is pending.

<b>Effect:</b> Choose how to respond to a pending attack opportunity or battle decision. The command shows involved armies, acting units, and the available attack decision types. **Advance** commits the army to the attack. **Withdraw** sends it back without fighting. **Demand Tribute** lets you request a specific amount of the province's gold and food, up to the displayed maximum; the demand cannot be zero. The defender later chooses whether to pay the full demand or refuse it. See [Attack and Defense Decisions](/concepts/eagle-to-shardok/#attack-and-defense-decisions) and [Resolving a tribute demand](/concepts/march-timeline/#resolving-a-tribute-demand).

<b>Selection:</b> choose one available attack decision.

### Defend

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> a province is under attack and can commit defenders.

<b>Effect:</b> Respond to an incoming attack by committing a defending army. The selected defenders become the province's defending army. If flee provinces are available, one must be selected as the army's fallback destination. See [Attack and Defense Decisions](/concepts/eagle-to-shardok/#attack-and-defense-decisions) for what happens next.

<b>Selection:</b> choose defending units and, when available, an optional flee province.

### Handle Captured Hero

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> a newly captured hero needs a battle aftermath decision.

<b>Effect:</b> Decide what happens to a hero captured during [battle aftermath](/concepts/eagle-to-shardok/#aftermath) or conquest. Captured heroes are not yet ordinary prisoners. If you imprison one, they become a normal prisoner and can later be handled with Manage Prisoners.

<b>Selection:</b> choose the captured hero and the handling option.

#### Options

##### Recruit

<b>Available when:</b> the captured hero is not a faction leader, has not already refused recruitment, and is not someone who will never join your faction.

<b>Effect:</b> Try to persuade the captured hero to join you immediately. The chance depends on your faction head, your faction's prestige, and the captured hero. On success, the hero joins your faction in the captured province with 60 loyalty. On failure, the hero refuses; you cannot try to recruit that captured hero again from this aftermath decision and must choose another option.

##### Imprison

<b>Effect:</b> Keep the hero as a prisoner in the captured province. This converts them into an ordinary prisoner when the aftermath resolves.

##### Exile

<b>Available when:</b> the captured hero is not a faction leader whose faction still controls a province.

<b>Effect:</b> Cast the hero out as an outlaw in the captured province when the aftermath resolves.

##### Execute

<b>Effect:</b> Kill the captured hero and remove them from the game when the aftermath resolves.

##### Return

<b>Available when:</b> the captured hero is a faction leader and their faction still controls at least one province.

<b>Effect:</b> Return the captured faction leader to the closest province ruled by their old faction when the aftermath resolves. Returning a captured leader creates a 12-month truce between your faction and theirs.

### Handle Riot

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> Depends on the option. Crack Down can cost vigor; Give and Do Nothing do not.

<b>Available when:</b> a province has a riot.

<b>Effect:</b> Respond to a [riot](/provinces/#province-events) in the acting province. The client presents this as one command with multiple response options. The [province leader](/provinces/#ruling-faction-and-ruling-hero)'s Charisma matters, even if a different hero is selected to crack down: leader Charisma improves gift success and makes forceful crackdowns face smaller riots.

If you fail to stop the riot, or if the riot is still unresolved when the riot phase ends, the riot happens. The province loses 25 support, gains 25 economy devastation, gains 25 infrastructure devastation, and the riot event is removed.

<!-- Sources:
- Riot options: src/main/scala/net/eagle0/eagle/library/actions/impl/command/HandleRiotGiveCommand.scala
  src/main/scala/net/eagle0/eagle/library/actions/impl/command/HandleRiotCrackDownCommand.scala
  src/main/scala/net/eagle0/eagle/library/actions/impl/command/HandleRiotDoNothingCommand.scala
- Riot consequences: src/main/scala/net/eagle0/eagle/library/actions/impl/command/HandleRiotUtils.scala
- Riot settings: src/main/scala/net/eagle0/eagle/library/settings/BUILD.bazel
-->

#### Options

##### Crack Down

<b>Vigor cost:</b> 15 on success, plus any vigor lost to casualties. If the hero is killed, the command fails.

<b>Effect:</b> Try to suppress the riot by force using a hero and optionally a battalion. The riot size is random from 100 to 1500, but the province leader's Charisma, not the selected acting hero's Charisma, reduces the roll before the size is calculated. Higher leader Charisma therefore makes the riot smaller and easier to defeat.

Casualties are based on riot size against the power of the acting hero and any attached battalion. If a battalion is used, casualties hit the battalion first; the battalion can be destroyed, and excess casualties can injure or kill the acting hero. If no battalion is used, casualties hit the acting hero directly.

Crack Down succeeds if the acting hero survives. On success, the riot event is removed and the acting hero spends 15 vigor, gains Strength and Agility XP, and may take additional vigor damage from casualties. If a battalion helped and survived, its size is reduced by its casualties. A successful crackdown does not directly reduce support, add devastation, or change loyalty; the cost is the violence itself.

Crack Down fails if the acting hero is killed. A failed crackdown does not stop the riot; the riot will still occur and apply the normal riot damage.

<b>Selection:</b> choose the acting hero and an optional battalion.

##### Do Nothing

<b>Vigor cost:</b> None.

<b>Effect:</b> Let the riot proceed without intervention. The riot will occur, causing the normal riot damage: -25 support, +25 economy devastation, and +25 infrastructure devastation.

<b>Selection:</b> no additional choices.

##### Give

<b>Vigor cost:</b> None.

<b>Effect:</b> Offer either food or gold to address the riot. You cannot combine food and gold in the same response. The maximum useful gift is 1000 food or 500 gold, and the selected amount is spent whether the attempt succeeds or fails.

Gift success is probabilistic. The chance is based on the province leader's Charisma plus the fraction of the maximum gift you gave: larger gifts help, and more leader Charisma helps. A partial gift can fail. On success, the riot event is removed. On failure, the gift is still spent and the riot will still occur.

<b>Selection:</b> choose a food amount or a gold amount.

### Please Recruit Me

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> unaffiliated heroes ask to join.

<b>Effect:</b> Respond to unaffiliated heroes who are asking to join a province.

<b>Selection:</b> choose the province, hero, and whether to accept.

### Resolve Alliance Offer

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction offers an alliance.

<b>Effect:</b> Accept or reject an [incoming alliance offer](/factions/#incoming-diplomacy-offers).

<b>Selection:</b> choose the originating faction and the resolution.

### Resolve Break Alliance

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction tries to break an alliance.

<b>Effect:</b> Respond to a faction attempting to break an alliance. Accepting the break replaces the alliance with a 12-month truce; it does not make the factions immediately hostile. The truce remains active through its reset month and changes to **Hostile** when a later **New Round** advances the date past that month. For example, a break accepted in January has a January reset date the following year and becomes hostile when February begins.

Imprisoning the envoy ends the alliance without a truce and makes both relationships **Hostile**. See [Diplomacy Outcomes](/factions/#diplomacy-outcomes) for the other imprisonment consequences.

<b>Selection:</b> choose the originating faction and the resolution.

### Resolve Invitation

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction sends an invitation.

<b>Effect:</b> Accept or reject an invitation from another faction.

<b>Selection:</b> choose the originating faction and the resolution.

### Resolve Ransom Offer

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction makes a ransom offer.

<b>Effect:</b> Accept or reject an incoming ransom offer.

<b>Selection:</b> choose the offering faction, the ransom offer, and the resolution.

### Resolve Truce Offer

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction offers a truce.

<b>Effect:</b> Accept or reject an incoming truce offer.

<b>Selection:</b> choose the originating faction and the resolution.

### Resolve Tribute

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> another faction demands tribute.

<b>Effect:</b> Decide whether to pay demanded tribute. The command shows the demanding factions, requested tribute, their rough strength, and the acting province's available food and gold. A demand must be accepted or refused in full; partial payment and counteroffers are not available. Paying requires the province to have the full requested amount, creates a 12-month truce between the factions, and turns back the demanding faction's hostile armies against the payer's provinces. Refusing transfers no resources and returns that faction's army to **Attacking**, after which normal defense selection and battle resolution continue. Neither response changes prestige directly, although a battle caused by refusal can later affect prestige. See [Resolving a tribute demand](/concepts/march-timeline/#resolving-a-tribute-demand).

<b>Selection:</b> choose the demanding faction and whether tribute is paid.

### Battle Aftermath Decision

<b>Hero requirements:</b> None.

<b>Vigor cost:</b> None.

<b>Available when:</b> multiple allied attacking factions won the same province and Eagle needs to decide which claimant keeps it.

<b>Effect:</b> Decide what your surviving claimant army does during [battle aftermath](/concepts/eagle-to-shardok/#aftermath) after a shared victory. If no ally has claimed the province yet, you may choose **Keep Province** and become the conqueror. If an ally has already claimed it, you must withdraw.

Keeping the province finalizes conquest: your surviving non-fled heroes become the new ruling heroes, surviving battalions become the province battalions, support is reset to 0, province orders reset to **Entrust**, and non-fled defenders or former ruling heroes can become prisoners.

Withdrawing sends your surviving units to an adjacent province as a moving army. You may take up to the gold and food your claimant army brought into the battle. The withdrawal army arrives next round and does not use the normal Send Supplies transit loss.

<b>Selection:</b> choose whether to keep the province or withdraw. If withdrawing, choose destination province and supplies to take.
