📚 Fantasy War Sim Help Wiki

• Each side has one Dice to roll input.
• Blank input = auto-select the default dice to roll for the current rules mode.
• Numeric input = manual dice to roll, clamped to the allowed maximum.
• In compare mode, attacker needs at least 5 dice to roll unless cap override is active.

• Shows pool contributors line-by-line, including Total dice, Usable dice, Dice to roll, and the modifiers that move those numbers.
• Advantage/disadvantage are shown as roll modifiers in breakdown and applied at roll stage.
• Breakdown is for transparency; it does not introduce hidden modifiers outside displayed lines.

• Battle scale is derived from Total dice only: Size dice plus STR dice before matchup, weather, doctrine, nearby, or manual modifiers.
• Quality tags are a quick scale read for the current army, from Squalid up through Mythical.
• Very Wealthy and above show a Supply warning. This is advisory only in the current build and does not change battle math.
• Class ceilings are checked when a battle starts, not when you save or import an army.

• War Report opens after Battle when that setting is enabled.
• Battle Again runs one more round immediately.
• Auto-Resolve Until Stop loops rounds until a stop condition occurs.
• Stop reasons include attacker defeated, defender defeated, mutual destruction, phenomena triggered, or safety limit reached.

• Battle panel button changes label to Update Army when a saved army is loaded on that side.
• Without a loaded army, button is Save as Army.
• Armies with size 0 are shown as defeated in Armies list.
• Saved armies now show Total dice and a derived Quality line for quick battle-scale reference.

• Quality is derived from Total dice only. Matchup, weather, doctrines, nearby effects, and manual dice changes do not change the quality tag.
• Rebels cannot exceed Poor. Bandits and Thieves cannot exceed Average.
• Other Standard classes cannot exceed Aristocratic in the standard battle scale.
• If a side exceeds its class ceiling, the simulator blocks the battle start and tells you to split or reduce the army before battle.

• New Faction modal supports empty factions and assigning existing armies before save.
• Faction names are unique case-insensitively.
• Assigning an army in faction flow is authoritative (army moves to the selected faction).

name,classId,size,str,faction,notes,doctrines
Iron Vanguard,infantry,150,120,Northwatch,"Frontline shield wall",heavy_protection;armor_piercing
Storm Lances,cavalry,120,100,Northwatch,"Fast flanking cavalry",anti_air
Arcane Battery,mages,80,140,Starfall Collegium,"Primary caster detachment",battlefield_weavers;elemental_ammunition:fire

name,notes
Northwatch,"Northern coalition armies"
Starfall Collegium,"Mage-focused command"
Free Companies,"Independent mercenary groups"

• Bundle must include armies.csv, factions.csv, and manifest.json.
• If any required file is missing or invalid, import stops and no changes are applied.
• Application order is factions, then armies (after full validation).

• Full export includes armies, factions, history, weather, settings, and battle draft data.
• Full import checks army, settings, and weather values before applying.
• If the file format is invalid, import is rejected with clear error feedback.

Resolution mode

Compare-style uses per-comparison resolution. Quick uses total comparison with configured loss preset.

Quick Total loss preset

Controls loser/tie loss values in Quick Total mode only. Compare-style follows the rules document directly.

Dice pool rules

Three-pool uses Total dice → Usable dice → Dice to roll. Legacy keeps the shipped direct-cap behavior.

Dice caps

Enforce normal dice-cap behavior or allow over-cap flows where supported. In Three-pool mode, over-cap bypasses only the final Dice to roll cap.

Override Doctrine Eligibility

When enabled, doctrine picker shows all doctrine options regardless of class restrictions.

Assist/Hinder system

Master toggle for nearby assist/hinder effects in preview and battle math.

Assist/Hinder dice cap per side

Caps net assist/hinder dice delta per side; roll-manip effects are not capped by this number.

War Report popup after Battle

Shows/hides post-battle modal presentation. Battle/history still resolve regardless.

Season / Climate / Turns per season

Drives weather randomization pools and turn progression behavior.

Current turn / Day starts / Night starts

Controls time-of-day context used by weather-sensitive checks.

Lock season / Lock weather

Prevents automated progression for the locked dimension.

Phenomena base chance

Base chance used when evaluating random phenomena trigger events.

Phenomena lock duration / Intensity drift mode

Controls persistence and intensity evolution once phenomena are active.

Theme toggles + Theme strength

Visual layer only. Does not alter battle mechanics.

• Top banner shows canonical outcome precedence (victory/holds/defeated/mutual).
• Summary rows show losses and updated sizes for both sides.
• View Details includes weather used, next weather, roll details, dice comparisons (if compare mode), and math breakdown.

• History auto-saves after each battle.
• Collapsed card = mini war report (headline + losses + updated sizes).
• Expanded card includes context snapshots, rolls, comparisons, modifiers, and stop reason where present.

• Attacker defeated: attacker size reached 0.
• Defender defeated: defender size reached 0.
• Mutual destruction: both sizes reached 0 in same resolution.
• Strange Phenomenon triggered: post-battle weather transition triggered new phenomena for next battle.
• Safety limit reached: protective max-round stop to avoid infinite loops.

• Strategic layer tracks fronts, movement, and major engagements.
• Cinematic layer creates leverage through focused objectives, sabotage, assassinations, and rescue operations.
• A stage is a complete pulse of war pressure where strategic outcomes and cinematic leverage inform each other.
• GM can run strategic layer directly or share ownership with players; both are valid table modes.

• Attacker Size 150 gives +3 dice; STR 120 gives +12 dice.
• Defender Size 100 gives +2 dice; STR 80 gives +8 dice.
• In Three-pool mode, start with Total dice from Size/STR, cap to attacker 12 / defender 10 for Usable dice, then apply the remaining dice modifiers.
• Dice to roll defaults to attacker 10 / defender 8 unless override paths are active, then defender wins ties in compare-style resolution.

• Move declarations, retreat handling, and occupation outcomes are usually adjudicated by the GM at campaign scale.
• Aftermath options include convert, capture, raze, and liberate based on campaign goals and story stakes.

• Immunity commonly maps to +3 dice, Resistance to +1, Vulnerability to -1, and Deadly to -3.
• Deadly Doctrines can trigger deadly penalties from doctrine presence rather than class type.
• Preferred and undesired weather/terrain cues are useful for deciding deployment and commitment strategy before rolling.

• Augment doctrines apply to specific armies.
• Trade doctrines apply as broader strategic toggles.
• Quiet trade doctrines are stealth/influence-oriented strategic policies.
• Baseline CP cost is generally defined for size 1-100 and scales by additional 50-size increments.

Use these to shape campaign pressure, logistics, and political tempo when your table is running broader war-layer play.

Core weather tags include clear, cloudy, heavy clouds, fog, rain, heavy rain, wind, thunderstorm, freezing, snow, blizzard, dry, scorching heat, smog/ash haze, and strange phenomena.

Use these condensed tables for fast rulings. Open the full rulebook for expanded wording.

High-level tier labels in source include outcomes like Inspired/Broken (morale), Over-Supplied/Collapsing (supply), and Dominant/Irrelevant (influence).

• Cutscene: spotlight dialogue beats in war scenes.
• Dice impact: cinematic outcomes can shift strategic dice quality and pressure.

• Includes retreat, split, flanking, rest, fortify, fallen commander handling, medals, financial overlays, and help/assist variants.
• Many are map- and campaign-context dependent, so adjudication remains GM-led.