ferravex
GitHub

Crown & Council

A complete, turn-based kingdom strategy game for the Ferravex framework. Rule the river kingdom through 30 individually authored petitions in three acts, choose between competing public obligations, and leave one of four political legacies. There is no reading timer or random event shuffle. Early promises change nine later petitions, including their choices, costs and consequences.

The game uses illuminated parchment, four procedural council portraits, pillar columns that preview every decree, policy wax seals and a permanent chronicle for the current reign. It reads through icons, meters and seals rather than sentences: the only prose on the play screen is each petition's question and its three decrees. It needs no external artwork, libraries or services.

Play

cargo run -p crown-council --offline --locked -j 2

Begin with the shared title screen and the first act's briefing. Each petition has three decisions. A choice applies its resource changes and opens the next decision immediately. Previous choices and actual resource changes remain available in the chronicle. A new briefing introduces each ten-petition act with its name and the promise medallions sealed so far.

ControlAction
1, 2, 3Accept that council decision immediately
Arrows / WASD, then Enter / SpaceSelect and accept a decision or project
Click a decision/project cardAccept the clicked choice
Enter / Space, or click the Begin sealContinue act briefings
Enter / Space in the chronicleReturn to the council
X / E, or click the X button or the work tilesOpen or close the royal works
1-4 in the worksCommission that project
C / Q, or click the C buttonOpen or close the chronicle
Arrows, or click the arrow buttons, in the chroniclePrevious/next accepted decree
HShared paginated field guide
Esc / PShared pause menu
RRestart the entire reign, including all resources, policies and projects
MShared sound toggle

The council advances only when a decision is accepted. Reading records or inspecting projects spends no council. A held movement key or held primary button does not repeat a decree. Every click shortcut runs the same rule as its key. The shared guide (H) lists the controls as key caps plus four short reminders.

Reading the council

Four pillars

Treasury, Commons, Guard and Chapel each start at 60 and are capped at 100. Reaching zero in any one ends the reign immediately, respectively through bankruptcy, revolt, mutiny or schism. The other three pillars cannot compensate for a fallen one.

Every decree pays 2 Treasury upkeep. The card's coin chip already includes this cost. The chips are the decree's resource changes, before any project completing that council. Positive gains above 100 are discarded. Decisions are allowed to exhaust a reserve, so read the forecast before accepting one.

The decree is applied and checked for collapse before projects mature. A future payout cannot rescue a reserve reduced to zero by the current decision. The chronicle records actual before/after resources, including capped changes and completed projects.

Authored reign

CouncilAct I: Roots of a reignCouncilAct II: The price of promisesCouncilAct III: What the crown leaves
1The river's warning11Letters under a white flag21A courier with no seal
2The salt charter12A fever in the abbey22The silver that cracks
3Bells at the north gate13The convoy that never came23A home for old soldiers
4A book with missing pages14The abbey's empty fields24The uncensored chronicle
5Winter muster15The vanished witness25The returning orchard child
6The orchard petition16The armorer's new furnace26A market without masters
7The river takes its due17The apprentice's petition27Bells for two faiths
8A stolen loaf, a broken hand18The winter bread line28The last great flood
9Ink for the villages19A captain before the bench29The heir's difficult question
10The first crown feast20A chair for the succession30The crown on the empty chair

Those are the baseline titles. Seven early promises create nine conditional versions:

Every petition has three authored choices and a distinct consequence for each choice. The chronicle retains the actual variant encountered, rather than reconstructing history from your latest policies.

Investments

Each work can be commissioned once. Costs are immediate, and the countdown advances only after accepted council decisions. Multiple works can be active. The purchase must leave at least one Treasury, and there must be enough councils left for completion. A completed or unaffordable card accepts no purchase and grants no score.

ProjectTreasury costCouncils to finishCompletion reward: Treasury / Commons / Guard / Chapel
The Winter Granary183+2 / +18 / +4 / 0
The Public Archive164+4 / +10 / 0 / +8
The Muster House163+3 / +2 / +18 / 0
The River Exchange205+30 / +4 / −2 / −2

Completed projects and their resource changes remain in the chronicle. The River Exchange returns the most coin, but the demands it places on guard and chapel are real.

Judgment and replay

Each choice carries a Charter, Iron, Commerce or Concordat policy seal. Survive all thirty councils and your most frequent policy determines the settlement:

Ties favor Charter, then Iron, then Commerce, then Concordat. The last decree cannot erase your earlier record. The results card shows the score, the ending, the grade, the final pillars, completed works and badges.

Grades reward the kingdom left behind: S requires every reserve at least 40 and three completed works; A requires 25 and two works; B requires 15; other successful reigns earn C, and a collapsed reign earns F. Badges are Oathkeeper for five named promises, Builder for two completed works, and Four Pillars for every final reserve at least 40. Badges are awarded only to successful reigns.

The score adds 100 plus the lowest remaining reserve for each accepted council, 60 for each completed project, and three times the sum of final reserves for surviving the reign. It cannot be farmed by reopening menus or attempting invalid purchases. The shared host provides completed-run best records and immediate retry. It does not save an unfinished reign or a permanent collection of ending badges.

Strategy

Keep a cash reserve before accepting a generous decree: visible upkeep makes an uninterrupted sequence of public spending unsustainable. Invest early enough for a work to mature before the corresponding crisis. Avoid buying several projects so aggressively that their future rewards are needed to survive the very next choice.

Read both the pillar chips and the policy seal; hover a decree to see it on the pillar columns. Trade income can fund public commitments, and professional service can stabilize the guard without handing it every dispute. A reserve near 100 is often a source of bargaining power; another gain to an already full pillar is wasted. Early institutions produce better later options, but the investment still needs to be paid today.

Headless and verification

cargo run -p crown-council --offline --locked -j 2 -- --headless
cargo test -p crown-council --offline --locked -j 2
cargo clippy -p crown-council --all-targets --offline --locked -j 2 -- -D warnings

The headless adviser uses only the same Input controls as a player. It balances the visible reserves, commissions affordable projects, advances through decisions and advances each act. It does not inject resources, event flags, progress or a terminal outcome. The verified default run completes all 30 councils and all four projects at tick 1980, earning The Merchant Commonwealth, grade S, 5943 points, and the Builder and Four Pillars badges.

Twenty-two unit tests cover legal full-reign play and maximum-grade and Oathkeeper attainability, four materially different successful policy settlements, exact costs and bounded resources, actual later consequence-chain variants reached by legal play, project purchase rejection and delayed payouts, invalid/held controls, genuine legal-policy collapse, terminal invariance, clean restart, chronicle navigation, click shortcuts that mirror the X, C, arrow and Enter keys, a fourth works selection that can no longer select a missing fourth decree, per-tick presentation beats and refusal reasons, effects for decrees, commissions, refusals, acts and collapse, header progress, meter easing, content uniqueness and measured text bounds. One executable rustdoc example starts a reign with ordinary inputs and completes it through the adviser.

model::Game is independent of drawing, wall clocks and platform I/O. Its public interface is new, step, decisions, resources, outcome, ending, score, pilot, grade, badges and summary, plus Default. Ending::name supplies the human-readable settlement. The ArcadeGame implementation supplies the shared host contract. Storage is bounded to 30 decree records, four works, four resource values, four policy counts and seven promise bits, plus an eight-entry presentation beat list and the previous pillar values for meter easing, which the rules never read; badge results contain at most three entries.

The native model tests and headless run establish the recorded behavior on the tested host. Native smoke captures of the petition, works, act briefing, chronicle, danger, victory and collapse screens were reviewed; this is not a claim of a full human playthrough, audio-device coverage, browser/device coverage or cross-platform determinism. Browser packaging and collection-wide integration are handled outside this example. There is no multiplayer, mid-reign save, procedural story generator or external-service requirement.