From a0aee440c3f6ce96f8c6239b79a2331e735bcbe6 Mon Sep 17 00:00:00 2001 From: Matt Date: Sat, 6 Jun 2026 23:00:45 +0000 Subject: [PATCH] docs: economy v0.4 -- 13-tier ladder + Sovereign 10M + Founder flag Tier ladder extended from 8 -> 13 tiers, with cleaner historical progression. Replaces the previous Peasant/Citizen/Patron/Notable/ Baron/Noble/Lord/Sovereign ladder which mixed commoner-economic terms with noble terms. New 13-tier ladder (Civic + British peerage): 1 Peasant free 2 Farmer 200 3 Citizen 750 4 Merchant 2,500 5 Knight 6,500 (gentry threshold) 6 Baron 15,000 (lowest noble) 7 Viscount 35,000 8 Earl 75,000 9 Marquess 150,000 10 Duke 300,000 11 Archduke 700,000 12 Grand Duke 1,500,000 13 Sovereign 10,000,000 (apex, "finished the game") Rationale: - Yeoman -> Farmer, Burgher -> Merchant: both replaced with recognizable terms while keeping the period feel. - Earl kept as the British equivalent of Count (Viscount sits below Earl correctly because Viscount = vice-count). - Top tier extended above Duke with Archduke -> Grand Duke -> Sovereign. Avoids singular-feeling Emperor/King/Prince titles. - Sovereign at 10M is intentionally extreme -- months of dedicated play to reach, properly mythical. Full perk table updated to spread cleanly across 13 tiers: - Plot slots: 0/0/1/1/2/2/3/3/4/5/6/7/10 - Sethomes: 1/1/2/3/4/5/6/8/10/12/16/20/unlimited - Daily bounties: 3/3/3/4/4/5/5/6/6/7/7/8/10 - Shop fee: 0% down to -25% at Sovereign - Chat colours: grey -> white -> yellow -> green -> cyan -> blue -> purple -> gold -> orange -> red -> bright red -> rainbow Knight (tier 5) is the gentry threshold -- the first meaningful "I'm somebody" upgrade with colored chat, join broadcast, and /back. Founder cosmetic flag added for matt (server owner). Permanent chat prefix [Founder] alongside the normal rank. No gameplay perks; just identification. Founder still grinds the regular ladder. Co-Authored-By: Claude Opus 4.7 --- docs/economy-system.md | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/docs/economy-system.md b/docs/economy-system.md index 2a80929..e0861e1 100644 --- a/docs/economy-system.md +++ b/docs/economy-system.md @@ -1,6 +1,6 @@ # Brass and Sigil — Economy & Quest System Design -> Status: architecture + UI approach locked (v0.3). Custom companion mod confirmed. +> Status: 13-tier ladder locked (v0.4). Architecture + UI confirmed in v0.3. > Owner: matt > Last updated: 2026-06-06 @@ -81,19 +81,36 @@ Two distinct land/status systems that often get conflated. Keeping them clean: Every player has a Civic rank. Higher rank unlocks perks. Players spend spurs at the Civic Office NPC to upgrade. Powered by FTB Ranks under the hood (permission nodes drive what each rank unlocks). -| # | Title | Cost to reach | Wilderness chunks claimable | Spawn plot slots | Sethomes | Daily bounty slots | Shop fee | Chat colour | Join broadcast | `/back` after death | +The ladder is intentionally long (13 tiers) so endgame ranks feel rare and aspirational. Top tiers represent months of dedicated play; Sovereign is "you've finished the game." + +| # | Title | Cost to reach | Wilderness chunks | Plot slots | Sethomes | Daily bounties | Shop fee | Chat colour | Join broadcast | `/back` | |---|---|---|---|---|---|---|---|---|---|---| -| 1 | **Peasant** | free (starter) | 9 | 0 | 1 | 3 | -0% | grey | no | no | -| 2 | **Citizen** | 500 | 25 | 1 | 2 | 3 | -0% | white | no | no | -| 3 | **Patron** | 2,000 | 60 | 1 | 3 | 4 | -2% | yellow | no | yes | -| 4 | **Notable** | 6,000 | 100 | 2 | 4 | 4 | -5% | green | simple | yes | -| 5 | **Baron** | 15,000 | 160 | 2 | 5 | 5 | -8% | cyan | simple | yes | -| 6 | **Noble** | 35,000 | 240 | 3 | 7 | 5 | -10% | purple | fancy | yes | -| 7 | **Lord** | 80,000 | 350 | 4 | 10 | 6 | -12% | gold | fancy | yes | -| 8 | **Sovereign** | 200,000 | 500 | 5 | unlimited | 6 | -15% | red | epic | yes | +| 1 | **Peasant** | free (starter) | 9 | 0 | 1 | 3 | 0% | grey | — | — | +| 2 | **Farmer** | 200 | 18 | 0 | 1 | 3 | 0% | grey | — | — | +| 3 | **Citizen** | 750 | 35 | 1 | 2 | 3 | 0% | white | — | — | +| 4 | **Merchant** | 2,500 | 60 | 1 | 3 | 4 | -2% | yellow | — | ✓ | +| 5 | **Knight** | 6,500 | 100 | 2 | 4 | 4 | -5% | green | simple | ✓ | +| 6 | **Baron** | 15,000 | 150 | 2 | 5 | 5 | -7% | cyan | simple | ✓ | +| 7 | **Viscount** | 35,000 | 220 | 3 | 6 | 5 | -9% | blue | fancy | ✓ | +| 8 | **Earl** | 75,000 | 300 | 3 | 8 | 6 | -11% | purple | fancy | ✓ | +| 9 | **Marquess** | 150,000 | 400 | 4 | 10 | 6 | -13% | gold | fancy | ✓ | +| 10 | **Duke** | 300,000 | 525 | 5 | 12 | 7 | -15% | orange | epic | ✓ | +| 11 | **Archduke** | 700,000 | 700 | 6 | 16 | 7 | -17% | red | epic | ✓ | +| 12 | **Grand Duke** | 1,500,000 | 900 | 7 | 20 | 8 | -19% | bright red | epic + particles | ✓ | +| 13 | **Sovereign** | 10,000,000 | 1,500 | 10 | unlimited | 10 | -25% | rainbow | epic + spectacular | ✓ | + +**Notable shape choices:** + +- **Knight (tier 5)** is the gentry threshold — first colored chat (green), first join broadcast, first `/back` after a meaningful jump in plot slots +- **Duke → Archduke jump** is the late-game wall (300k → 700k, ~2.3×) — Archduke is the start of "I've really committed to this server" territory +- **Sovereign is dramatic** — 6.7× the Grand Duke cost. Real "finished the game" status. -25% shop fee is a step-change leap; unlimited everything; spectacular join effects. Numbers are first-pass calibration. The full perk table lives in a single JSON (`config/bnstoolkit/tiers.json`) that's hot-reloadable via `/bnstoolkit reload`. Easy to tune any column without code changes. +### 4a.1 Founder flag (admin cosmetic) + +The server owner / admin has a permanent **`[Founder]`** cosmetic prefix in chat that sits alongside their normal rank. It carries no gameplay perks — it's just visible identification so friends know who runs the server. The Founder still grinds the regular tier ladder like everyone else (good for playtesting balance + sharing the experience). Op commands are the actual admin tool; the Founder tag is purely visual. + **Wilderness claims:** at every tier above Peasant, you get a flat allowance of N chunks you can claim anywhere outside spawn via the FTB Chunks map. Claiming is **free** within your allowance, refused above. No per-chunk pricing. Driven by FTB Ranks → FTB Chunks permission nodes (`ftbchunks.max_claimed_chunks`). ### 4b. Spawn plots @@ -411,7 +428,8 @@ Resolved before implementation: | Numismatics access | Direct Java via `Java.loadClass` from KubeJS; via API directly from the mod | | Wilderness chunk allowance | Tier-driven via FTB Ranks permission nodes — no per-chunk pricing | | Spawn plots | Predefined regions, slot-limited by tier, individually purchased with spurs | -| Tier ladder | Civic: Peasant → Citizen → Patron → Notable → Baron → Noble → Lord → Sovereign (8 tiers) | +| Tier ladder | Civic (13 tiers): Peasant → Farmer → Citizen → Merchant → Knight → Baron → Viscount → Earl → Marquess → Duke → Archduke → Grand Duke → Sovereign | +| Founder flag | Admin/owner has `[Founder]` cosmetic prefix in chat, grinds the regular ladder otherwise | | Tier perks | JSON-configured (`config/bnstoolkit/tiers.json`), hot-reloadable | | Custom mod | Confirmed. Built on FTB Library UI framework. Working name `bnstoolkit`. | | Sethomes / warps | Tier-allocated count (not paid per use) | -- 2.52.0