docs: economy v0.3 lockdown (custom mod + UI + tiers + plots) #63

2026-06-06T22:27:07Z

Matt commented

2026-06-06 22:27:07 +00:00

Locks in the architecture revisions from the latest design discussion.

Custom companion mod 'bnstoolkit' on FTB Library UI framework — proper GUI screens, not chat commands.
Tier ladder locked: Peasant -> Citizen -> Patron -> Notable -> Baron -> Noble -> Lord -> Sovereign (8 tiers, Civic theme).
Spawn plots clarified as a distinct system from wilderness claims (predefined regions, individually purchased, slot-limited by tier).
Wilderness claims are now tier-allocated (no per-chunk pricing).
Tier perks JSON-configured for easy tuning.
Phasing updated to include the mod scaffolding pass.

Next step: write a separate architecture doc for bnstoolkit itself, then ship Phase 0a mod additions.

Locks in the architecture revisions from the latest design discussion. - Custom companion mod 'bnstoolkit' on FTB Library UI framework — proper GUI screens, not chat commands. - Tier ladder locked: Peasant -> Citizen -> Patron -> Notable -> Baron -> Noble -> Lord -> Sovereign (8 tiers, Civic theme). - Spawn plots clarified as a distinct system from wilderness claims (predefined regions, individually purchased, slot-limited by tier). - Wilderness claims are now tier-allocated (no per-chunk pricing). - Tier perks JSON-configured for easy tuning. - Phasing updated to include the mod scaffolding pass. Next step: write a separate architecture doc for bnstoolkit itself, then ship Phase 0a mod additions.

Matt added 1 commit 2026-06-06 22:27:07 +00:00

docs: economy v0.3 — custom mod + UI approach + tier ladder + spawn plots locked 121ae4c603

Architectural revisions:

- UI approach: custom companion mod (working name 'bnstoolkit') built
  on FTB Library's UI framework. Polished GUI screens for Quest Log,
  Bounty Board, Tier upgrade, Shop browser, Plot purchase. Quest
  progress as a custom HUD render layer (no stacked vanilla bossbars).
  All player interaction through GUI + NPC dialogue, no chat commands
  to memorise. FTB Library UI chosen for visual consistency with the
  rest of the FTB stack already in the pack.

- Tier ladder locked: 8 tiers, Civic theme, starting at Peasant.
  Peasant -> Citizen -> Patron -> Notable -> Baron -> Noble -> Lord
  -> Sovereign. Replaced Burgess with Baron; reordered ascending.

- Tier perks: full table with chunks claimable, spawn plot slots,
  sethome count, daily bounty slots, shop fee, chat colour, join
  broadcast tier, /back access. JSON-configured at
  config/bnstoolkit/tiers.json, hot-reloadable. Easy to tune any
  column without code changes.

- Spawn plots clarified as distinct from wilderness chunk claims:
  predefined regions at spawn, purchased individually for spurs,
  primary use is shops, slot-limited by tier. Purchase happens
  inside the FTB Chunks map UI via custom mod mixin. Plot data
  lives in the custom mod, not in FTB Chunks.

- Wilderness chunk claims: tier-allocated, free within allowance,
  refused above. NO per-chunk pricing (dropped from v0.2). Powered
  by FTB Ranks -> FTB Chunks permission nodes.

- Phasing updated to add Phase 0c (mod scaffolding) and reorder
  Phases 1-7 to fit the mod-supplied UI work.

- Implementation notes: KubeJS script layout, custom mod package
  layout, state data locations, config file locations all
  documented.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Matt merged commit 4ca2f17d9d into main

2026-06-06 22:27:07 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: minecraft/brass-and-sigil#63