Document province order behavior (#8415)

* Document province order behavior

* Clarify vassal supply shipping orders
This commit is contained in:
2026-07-10 13:14:16 -07:00
committed by GitHub
parent 0adf8b3765
commit 93b639e452
@@ -16,6 +16,7 @@ Source map for numeric command details:
- 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.
- 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.
-->
## Normal Command Phase Commands
@@ -106,12 +107,30 @@ Most command phase actions spend the acting province's turn.
<b>Hero requirements:</b> None.
<b>Available when:</b> you can review or update province orders. This command does not take your turn.
<b>Available when:</b> a faction leader is acting, your faction controls more than one province, and you can review or update province orders. This command does not take your turn.
<b>Effect:</b> Set standing orders for provinces and optionally change the focus province. The command shows current orders, available order types, and available focus provinces.
<b>Effect:</b> Set standing orders for your provinces. Orders guide vassal-ruled provinces during the vassal command phase; 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.