admin/eagle0
1
0
Fork 0
mirror of https://github.com/nolen777/eagle0.git synced 2026-07-28 22:35:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

Structure Shardok command reference (#8410)

Browse Source
This commit is contained in:
admin
2026-07-10 10:57:20 -07:00
committed by GitHub
parent 06c76daba2
commit bb777da84a
1 changed files with 234 additions and 112 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/eagle0pedia/src/content/docs/shardok-commands/index.md
+234 -112
View File
@@ -7,196 +7,318 @@ Shardok commands are the tactical actions available during a battle. The tactica
Commands shown in `current_command` can be posted now. Commands shown in `preview_command` are useful for the UI, but are not currently postable.
## Command List
<span class="command-reference-marker" aria-hidden="true"></span>
- [Melee](#melee)
- [Archery](#archery)
- [Charge](#charge)
- [Move](#move)
- [Lightning Bolt](#lightning-bolt)
- [Meteor](#meteor)
- [Start Fire](#start-fire)
- [Extinguish Fire](#extinguish-fire)
- [Freeze Water](#freeze-water)
- [Build Bridge](#build-bridge)
- [Blow Bridge](#blow-bridge)
- [Placement](#placement)
- [Scout](#scout)
- [Raise Dead](#raise-dead)
- [Dismiss Unit](#dismiss-unit)
- [Holy Wave](#holy-wave)
- [Stop and Rest](#stop-and-rest)
- [Challenge Duel](#challenge-duel)
- [Fear](#fear)
- [Repair](#repair)
- [Reduce](#reduce)
- [Flee and Retreat](#flee-and-retreat)
- [Control](#control)
- [Reinforce](#reinforce)
- [Brave Water](#brave-water)
- [Release Unit](#release-unit)
- [End Turn and Setup](#end-turn-and-setup)
- [Hide](#hide)
- [Fortify](#fortify)
- [Become Outlaw](#become-outlaw)
- [Evacuate Prisoners](#evacuate-prisoners)
## Tactical Commands
## Melee
Shardok commands do not have separate command phases like Eagle commands. The commands available at any moment depend on the selected unit, the battle state, setup state, terrain, and any profession attached to the unit.
Attack an adjacent enemy unit in close combat. The command descriptor identifies the acting unit, target unit or hex, action-point cost, and combat odds when available.
### Melee
## Archery
<b>Unit requirements:</b> a unit that can make a close-combat attack.
Make a ranged attack with an archery-capable unit. Archery commands usually target a unit at range instead of requiring adjacency.
<b>Available when:</b> an enemy target is adjacent and the acting unit can still act.
## Charge
<b>Effect:</b> Attack the target in close combat. The command descriptor identifies the acting unit, target unit or hex, action-point cost, and combat odds when available.
Move into an attack as one action. Charge is a tactical attack command with movement built into the command path.
<b>Selection:</b> choose the attacking unit and adjacent target.
## Move
### Archery
Move a unit across one or more hexes. Multi-step movement uses the descriptor `path` field to list every traversed hex in order.
<b>Unit requirements:</b> an archery-capable unit.
## Lightning Bolt
<b>Available when:</b> a valid enemy target is in range and line of fire is valid.
Cast a lightning attack at a target. This is a magic command and may include odds or roll information when the client can display expected results.
<b>Effect:</b> Make a ranged attack without requiring adjacency.
Requires: Mage attached to a casting-capable unit.
<b>Selection:</b> choose the firing unit and target unit or hex.
## Meteor
### Charge
Meteor is represented as several command types: start, target, cast, and cancel. The start and target steps establish the spell, while cast resolves it and cancel backs out of the pending meteor.
<b>Unit requirements:</b> a unit that can move and make a charge attack.
Requires: Mage attached to a casting-capable unit, with enough vigor to start the spell.
<b>Available when:</b> a valid path reaches a target that can be attacked at the end of the move.
## Start Fire
<b>Effect:</b> Move into an attack as one action. The descriptor path lists the movement built into the command.
Set a target hex on fire when the acting unit has access to the command.
<b>Selection:</b> choose the charging unit, path, and target.
Profession note: Mage is not required, but mages improve the start-fire odds.
### Move
## Extinguish Fire
<b>Unit requirements:</b> a unit with remaining movement.
Remove or reduce fire on a target hex.
<b>Available when:</b> one or more reachable destination hexes are valid for the acting unit.
## Freeze Water
<b>Effect:</b> Move the unit across one or more hexes. Multi-step movement uses the descriptor `path` field to list every traversed hex in order.
Turn water into traversable frozen terrain where the command is valid.
<b>Selection:</b> choose the unit and destination path.
Requires: Mage attached to a casting-capable unit.
### Lightning Bolt
## Build Bridge
<b>Unit requirements:</b> Mage attached to a casting-capable unit.
Create a bridge across a valid water or gap target.
<b>Available when:</b> the caster has a valid lightning target and enough vigor or action capacity to cast.
Requires: Engineer.
<b>Effect:</b> Cast a lightning attack at the target. The descriptor may include odds or roll information when the client can display expected results.
## Blow Bridge
<b>Selection:</b> choose the casting unit and target.
Destroy an existing bridge target.
### Meteor
Requires: Engineer standing on a bridge.
<b>Unit requirements:</b> Mage attached to a casting-capable unit with enough vigor to start the spell.
## Placement
<b>Available when:</b> the caster can begin, target, cast, or cancel the pending meteor sequence.
Place units during battle setup. Shardok distinguishes visible placement and hidden placement with `PLACE_UNIT_COMMAND` and `PLACE_HIDDEN_UNIT_COMMAND`.
<b>Effect:</b> Resolve the meteor spell through multiple command types: start, target, cast, and cancel. Start and target establish the spell, cast resolves it, and cancel backs out of the pending meteor.
Profession note: normal placement is not profession-restricted. Hidden placement requires a defending Ranger attached to a stealth-capable unit.
<b>Selection:</b> choose the caster, spell target, or cancel option depending on the current meteor step.
## Scout
### Start Fire
Reveal information using a scouting unit. Scout commands can be advertised as previews when the UI needs to show setup or hidden-unit possibilities.
<b>Unit requirements:</b> a unit with access to start-fire. Mage is not required, but mages improve the odds.
Requires: Ranger attached to a stealth-capable unit.
<b>Available when:</b> a target hex can be set on fire.
## Raise Dead
<b>Effect:</b> Attempt to start a fire on the target hex.
Create or restore undead forces through necromantic action.
<b>Selection:</b> choose the acting unit and target hex.
Requires: Necromancer attached to a casting-capable unit, and the hero must not already control a unit.
### Extinguish Fire
## Dismiss Unit
<b>Unit requirements:</b> a unit with access to extinguish-fire.
Remove a unit from the tactical battle when dismissal is allowed.
<b>Available when:</b> a target hex contains fire that can be reduced or removed.
## Holy Wave
<b>Effect:</b> Remove or reduce fire on the target hex.
Use a holy-area effect from a capable unit.
<b>Selection:</b> choose the acting unit and burning target hex.
Requires: Paladin.
### Freeze Water
## Stop and Rest
<b>Unit requirements:</b> Mage attached to a casting-capable unit.
`UNIT_STOP_COMMAND` stops a unit. `UNIT_REST_COMMAND` has a unit spend its action resting instead of acting aggressively.
<b>Available when:</b> a valid water hex can be frozen.
## Challenge Duel
<b>Effect:</b> Turn water into traversable frozen terrain where the command is valid.
Challenge an opposing unit to a duel. The tactical action emits accepted or declined outcomes directly.
<b>Selection:</b> choose the caster and water hex.
Requires: Champion.
### Build Bridge
## Fear
<b>Unit requirements:</b> Engineer.
Use a fear effect against an eligible target.
<b>Available when:</b> the engineer has a valid water or gap target where a bridge can be built.
Requires: Necromancer attached to a casting-capable unit.
<b>Effect:</b> Create a bridge across the target.
## Repair
<b>Selection:</b> choose the engineer unit and bridge target.
Repair a damaged unit or battlefield object when an engineer-style action is available.
### Blow Bridge
Requires: Engineer.
<b>Unit requirements:</b> Engineer standing on a bridge.
## Reduce
<b>Available when:</b> the bridge can be destroyed.
Reduce a target, generally used for siege-like or structure-focused tactical effects.
<b>Effect:</b> Destroy the existing bridge target.
Requires: Engineer in a castle or fortified position.
<b>Selection:</b> choose the engineer unit and bridge.
## Flee and Retreat
### Placement
`FLEE_COMMAND` handles immediate flight from a tactical situation. `RETREAT_COMMAND` handles a more formal withdrawal command.
<b>Unit requirements:</b> a unit available for setup placement. Hidden placement requires a defending Ranger attached to a stealth-capable unit.
## Control
<b>Available when:</b> the battle is in setup and a valid placement hex is available.
Take control of a target when the command is available.
<b>Effect:</b> Place a unit into the battle. Shardok distinguishes visible placement and hidden placement with `PLACE_UNIT_COMMAND` and `PLACE_HIDDEN_UNIT_COMMAND`.
## Reinforce
<b>Selection:</b> choose the unit and setup hex.
Bring reinforcements into the battle.
### Scout
## Brave Water
<b>Unit requirements:</b> Ranger attached to a stealth-capable unit.
Move through water despite the usual danger or restriction.
<b>Available when:</b> a valid scouting or hidden-unit reveal option exists.
Profession note: Ranger is not required, but rangers get a brave-water odds bonus.
<b>Effect:</b> Reveal information using a scouting unit. Scout commands can be advertised as previews when the UI needs to show setup or hidden-unit possibilities.
## Release Unit
<b>Selection:</b> choose the scouting unit and target.
Release a controlled, held, or otherwise constrained unit.
### Raise Dead
## End Turn and Setup
<b>Unit requirements:</b> Necromancer attached to a casting-capable unit, and the hero must not already control a unit.
`END_TURN_COMMAND` ends the active tactical turn. `END_PLAYER_SETUP_COMMAND` ends that player's setup phase.
<b>Available when:</b> there is a valid undead creation or restoration target.
## Hide
<b>Effect:</b> Create or restore undead forces through necromantic action.
Hide a unit when it can enter or remain in hidden status.
<b>Selection:</b> choose the necromancer unit and target.
Requires: Ranger attached to a stealth-capable unit.
### Dismiss Unit
## Fortify
<b>Unit requirements:</b> a unit that is allowed to be dismissed.
Have a unit fortify its current position.
<b>Available when:</b> dismissal is valid for the current tactical state.
Requires: Engineer.
<b>Effect:</b> Remove the unit from the tactical battle.
## Become Outlaw
<b>Selection:</b> choose the unit to dismiss.
Mark a unit or hero as becoming an outlaw as a battle consequence.
### Holy Wave
## Evacuate Prisoners
<b>Unit requirements:</b> Paladin.
Move prisoners out of danger when the battlefield state allows prisoner evacuation.
<b>Available when:</b> the paladin has a valid holy-wave action.
Requires: Warden on a unit that can flee.
<b>Effect:</b> Use a holy-area effect from the capable unit.
<b>Selection:</b> choose the paladin unit and command target, if one is required.
### Stop and Rest
<b>Unit requirements:</b> a unit that can stop or rest.
<b>Available when:</b> the unit can end movement or spend its action resting.
<b>Effect:</b> `UNIT_STOP_COMMAND` stops a unit. `UNIT_REST_COMMAND` has a unit spend its action resting instead of acting aggressively.
<b>Selection:</b> choose stop or rest for the acting unit.
### Challenge Duel
<b>Unit requirements:</b> Champion.
<b>Available when:</b> an opposing unit can be challenged.
<b>Effect:</b> Challenge an opposing unit to a duel. The tactical action emits accepted or declined outcomes directly.
<b>Selection:</b> choose the champion unit and duel target.
### Fear
<b>Unit requirements:</b> Necromancer attached to a casting-capable unit.
<b>Available when:</b> an eligible target can be affected by fear.
<b>Effect:</b> Use a fear effect against the target.
<b>Selection:</b> choose the necromancer unit and target.
### Repair
<b>Unit requirements:</b> Engineer.
<b>Available when:</b> a damaged unit or battlefield object can be repaired.
<b>Effect:</b> Repair the damaged target.
<b>Selection:</b> choose the engineer unit and repair target.
### Reduce
<b>Unit requirements:</b> Engineer in a castle or fortified position.
<b>Available when:</b> a valid structure-focused or siege-like target can be reduced.
<b>Effect:</b> Reduce the target's defensive or structural value.
<b>Selection:</b> choose the engineer unit and target.
### Flee and Retreat
<b>Unit requirements:</b> a unit that is allowed to leave or withdraw.
<b>Available when:</b> flight or retreat is valid for the current battlefield state.
<b>Effect:</b> `FLEE_COMMAND` handles immediate flight from a tactical situation. `RETREAT_COMMAND` handles a more formal withdrawal command.
<b>Selection:</b> choose the fleeing or retreating unit.
### Control
<b>Unit requirements:</b> a unit with access to a control effect.
<b>Available when:</b> a valid target can be controlled.
<b>Effect:</b> Take control of the target when the command is available.
<b>Selection:</b> choose the acting unit and control target.
### Reinforce
<b>Unit requirements:</b> reinforcements available to enter the battle.
<b>Available when:</b> the battle state allows reinforcement and there is a valid entry option.
<b>Effect:</b> Bring reinforcements into the battle.
<b>Selection:</b> choose the reinforcement option and entry placement.
### Brave Water
<b>Unit requirements:</b> a unit that can attempt brave-water movement. Ranger is not required, but rangers get an odds bonus.
<b>Available when:</b> the unit has a valid water path or water target.
<b>Effect:</b> Move through water despite the usual danger or restriction.
<b>Selection:</b> choose the unit and water movement target.
### Release Unit
<b>Unit requirements:</b> a unit that can release a constrained target.
<b>Available when:</b> a controlled, held, or otherwise constrained unit can be released.
<b>Effect:</b> Release the constrained unit.
<b>Selection:</b> choose the acting unit and unit to release.
### End Turn and Setup
<b>Unit requirements:</b> None.
<b>Available when:</b> the active player can end the tactical turn or finish setup.
<b>Effect:</b> `END_TURN_COMMAND` ends the active tactical turn. `END_PLAYER_SETUP_COMMAND` ends that player's setup phase.
<b>Selection:</b> choose the end-turn or end-setup command.
### Hide
<b>Unit requirements:</b> Ranger attached to a stealth-capable unit.
<b>Available when:</b> the unit can enter or remain in hidden status.
<b>Effect:</b> Hide the unit.
<b>Selection:</b> choose the ranger unit.
### Fortify
<b>Unit requirements:</b> Engineer.
<b>Available when:</b> the engineer can fortify its current position.
<b>Effect:</b> Have the unit fortify its current position.
<b>Selection:</b> choose the engineer unit.
### Become Outlaw
<b>Unit requirements:</b> a unit or hero eligible for the outlaw consequence.
<b>Available when:</b> the battle result or tactical state allows the outlaw transition.
<b>Effect:</b> Mark the unit or hero as becoming an outlaw as a battle consequence.
<b>Selection:</b> choose the outlaw command when offered.
### Evacuate Prisoners
<b>Unit requirements:</b> Warden on a unit that can flee.
<b>Available when:</b> prisoners can be moved out of danger.
<b>Effect:</b> Move prisoners out of danger when the battlefield state allows prisoner evacuation.
<b>Selection:</b> choose the warden unit and evacuation command.