pack: economy MVP -- Numismatics + Patchouli + welcome flow, bump to 0.18.0

Adds the currency layer and the first-join experience. Mods: - Create: Numismatics 1.0.20 (currency, vendor blocks, piggy banks) - Patchouli 1.21.1-93 (kept in pack for future rich manual book) KubeJS scripts (server_scripts/): - economy_policy.js remove ALL Waystones recipes; remove coin recipes only (piggy banks etc. stay craftable for now) - welcome.js first-login grant: 1 waystone + vanilla written-book "Brass & Sigil Manual v1" (5 pages: welcome, waystones, money, spawn plots, rules). Per-player flag bnsWelcomeGranted in persistentData gates it. KubeJS scripts (client_scripts/): - jei_hides.js hide all Waystones items + 4 coin denominations from the JEI ingredient list. Combined with the recipe removal players never encounter these items via normal play -- only via the welcome grant or the bank exchange. The written-book manual is the MVP placeholder. When more content lands (plot system, dynamic exchange, etc.) it'll be replaced by a proper Patchouli book authored as a tweak jar -- Patchouli's already in the lockfile so no mod-add will be needed at that point.
2026-05-23 14:16:45 +00:00
parent d60c0176dd
commit 2ac4b2f2cd
4 changed files with 152 additions and 1 deletions
@@ -0,0 +1,53 @@
+// Brass & Sigil — first-join welcome grant
+//
+// Gives each new player exactly 1 Waystone + 1 server manual book on
+// first login. Gated by a per-player persistent flag so it fires once
+// even if the player relogs.
+//
+// Future: replace the vanilla written book with a Patchouli book in a
+// custom tweak jar once we have enough content to warrant the rich
+// formatting. Patchouli is already in the pack so swapping later is
+// purely a content+recipe change, no mod-add needed.
+
+const WELCOME_FLAG = 'bnsWelcomeGranted';
+
+const MANUAL_PAGES = [
+    'Welcome to Brass & Sigil.\n\nThis manual covers the basics. Read it once, then keep it or toss it.',
+    'WAYSTONES\n\nYou have one Waystone item. Place it at your base -- it is the only one you get.\n\nNeed to travel further? Build trains, roads, or Create Aeronautics planes.',
+    'MONEY\n\nCoins cannot be crafted.\n\nTake valuables (diamonds etc.) to the bank at spawn. The exchange will trade them for coins.\n\nDynamic rates are planned.',
+    'SPAWN PLOTS\n\nComing soon: buy a small commercial plot at spawn to set up your shop. One plot per player.\n\nYour home base goes OUT in the world -- claim it with FTB Chunks (free, anywhere).',
+    'RULES\n\n- Be excellent to each other.\n- No griefing.\n- Lost your Waystone? Ask an OP or buy one from the bank (soon).\n- Report bugs to staff.\n\nHave fun.',
+];
+
+function giveManual(player) {
+    // 1.21 components-based written book: pages are filterable text
+    // components, title supports the same. Plain strings are accepted.
+    const book = Item.of('minecraft:written_book');
+    book.set('minecraft:written_book_content', {
+        title: { raw: 'Brass & Sigil Manual' },
+        author: 'Server Staff',
+        pages: MANUAL_PAGES.map(text => ({ raw: text })),
+        resolved: true,
+    });
+    player.give(book);
+}
+
+function giveStarterWaystone(player) {
+    player.give(Item.of('waystones:waystone'));
+}
+
+PlayerEvents.loggedIn(event => {
+    const player = event.player;
+    const data = player.persistentData;
+    if (data.getBoolean(WELCOME_FLAG)) return;
+
+    try {
+        giveStarterWaystone(player);
+        giveManual(player);
+        data.putBoolean(WELCOME_FLAG, true);
+        player.tell(Text.gold('Welcome to Brass & Sigil. Check your inventory for a Waystone and the server manual.'));
+    } catch (e) {
+        // If something goes wrong, don't set the flag -- player gets another chance.
+        console.error(`[bns/welcome] failed for ${player.username}: ${e}`);
+    }
+});