Document riot handling consequences (#8418)

* Document riot handling consequences

* Simplify riot crackdown power docs

* Clarify riot charisma source
This commit is contained in:
2026-07-10 13:55:40 -07:00
committed by GitHub
parent bc17291691
commit 72c392a2dc
@@ -345,27 +345,45 @@ These commands appear only when the game is resolving a special situation, respo
<b>Available when:</b> a province has a riot.
<b>Effect:</b> Respond to a riot in the acting province. The client presents this as one command with multiple response options.
<b>Effect:</b> Respond to a riot in the acting province. The client presents this as one command with multiple response options. The province leader'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>Effect:</b> Suppress the riot by force using a hero and optionally a battalion. This is the high-control riot response, but it carries the risks and costs of using force instead of spending supplies or standing aside.
<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>Effect:</b> Let a riot proceed without intervention.
<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>Effect:</b> Offer food and/or gold to address a riot. The chosen supplies are spent from the acting province instead of using force.
<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.
<b>Selection:</b> choose food and gold amounts.
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