diff --git a/docs/tasks/steam-and-state-server/README.md b/docs/tasks/steam-and-state-server/README.md new file mode 100644 index 0000000..013be2f --- /dev/null +++ b/docs/tasks/steam-and-state-server/README.md @@ -0,0 +1,159 @@ +# Task: Firefrost "Steam & State" — Flagship Modpack Server + +**Status:** PLANNING +**Priority:** Tier 2 — Major Infrastructure +**Created:** March 18, 2026 +**Created By:** Chronicler #32 +**Planned Lifespan:** 2 Years (2026–2028) +**Target Node:** TBD (pending Task #45 Server Sunset Evaluation) + +--- + +## Vision + +A long-term flagship Minecraft server built around physical industry, +player-run nations, and a living economy. Unlike standard servers that +players "finish" in weeks, Steam & State is designed to sustain a +community for two full years through layered content depth. + +The three pillars: +- **Industry** — Create mod factories, machines, and automation +- **Logistics** — Physical train networks connecting player towns +- **Society** — Towny nations with land claims, taxes, and diplomacy + +--- + +## Why This Server + +Most Minecraft servers die in 3–6 months because players run out of +things to do. Steam & State addresses this with: + +- Physical economy (coins, vaults, vending machines — not virtual /pay) +- MineColonies NPCs that keep towns feeling alive at off-peak hours +- Progressive content eras: Industrial Age → Era of Nations → Legacy Era +- CoreProtect logging so 2 years of builds are protected + +--- + +## Technical Stack + +| Component | Choice | Reason | +|---|---|---| +| Modpack | All of Create (NeoForge 1.21.1) | Best brand recognition, deepest content | +| Server Loader | Arclight 1.21 | Hybrid — runs mods AND Towny plugin simultaneously | +| Java Version | Java 21 (LTS) | Required for NeoForge 1.21, best GC performance | +| Economy Mod | Lightman's Currency | Physical coins, integrates with Create | +| Land Management | Towny Advanced (Plugin) | Land claims, nations, taxes, upkeep | +| Colony Mod | MineColonies | NPC workers, living towns | +| Anti-Grief | CoreProtect (Plugin) | Block logging + rollback for 2 years | +| World Map | BlueMap | Browser-based 3D map, players see empires grow | +| Performance | FerriteCore + ModernFix | RAM reduction, memory leak prevention | + +--- + +## JVM Startup Flags (16GB Allocation) + +``` +-Xms14G -Xmx14G -XX:+UseZGC -XX:+ZGenerational -XX:+AlwaysPreTouch +-XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC +-XX:SoftMaxHeapSize=12G -XX:ParallelGCThreads=4 -XX:ConcGCThreads=2 +``` + +**Why ZGC over G1GC:** Generational ZGC (Java 21 native) handles +Create mod's constant object churn (gears, belts, trains) with near-zero +pause time. Critical for a 2-year server that will grow increasingly complex. + +**Memory math:** 14GB heap + 2GB OS/Wings overhead = 16GB total. Never +set heap to full allocation — OOM killer will crash the container. + +--- + +## Core Mods List (Confirmed) + +- Create (base mod) +- Create: Steam 'n' Rails (train network) +- Create: New Age (electricity end-game) +- Create: Enchantment Industry (late-game content) +- FerriteCore (RAM optimization) +- ModernFix (memory leak prevention) +- MineColonies (NPC colonies) +- Lightman's Currency (physical economy) +- BlueMap (world map) + +--- + +## Plugin List (via Arclight Bridge) + +- Towny Advanced (land claims + nations) +- Vault (economy bridge) +- CoreProtect (block logging + rollback) +- EssentialsX (basic commands) + +--- + +## Open Questions (Resolve Before Deployment) + +1. **Arclight stability** — Gemini flagged Magma concerns and recommended + Arclight 1.21. Needs community verification before committing to a + 2-year server. Check Arclight GitHub issues for NeoForge 1.21 stability. + +2. **Node assignment** — Pending Task #45 Server Sunset Evaluation. + Which existing server comes off the roster to make room? NC1 preferred + (high entity count performance) but TX1 has more headroom currently. + +3. **Database backend** — Towny and MineColonies should use MySQL not + flat files for a 2-year server. Needs MariaDB database provisioned on + the target node. + +4. **World pre-generation** — Pre-generate the map before launch to + eliminate chunk loading lag. Chunky mod recommended. + +--- + +## 2-Year Roadmap + +**Phase 1 — Foundation (Month 1)** +- Deploy Arclight 1.21 + All of Create +- Build "Firefrost Grand Central" spawn station +- Configure Towny, CoreProtect, economy +- Invite founding players to seed first towns + +**Phase 2 — The Industrial Age (Months 2–6)** +- Staff-built rail lines connect first three towns +- Economy balancing based on player behavior +- First community event: "The Great Railway Race" + +**Phase 3 — Era of Nations (Months 6–18)** +- Large player empires emerge +- Nation wars and trade treaties +- Seasonal server events for prizes + +**Phase 4 — The Legacy Era (Months 18–24)** +- World becomes a "digital museum" +- Grand finale event +- Planning for Season 2 + +--- + +## Proposal for Meg and Holly + +A full non-technical proposal document has been drafted for presenting +to Meg and Holly. See: `proposal-meg-holly.md` in this directory. + +Key selling points for the team: +- "The Firefrost Express" — central rail hub at spawn +- NPC citizens make towns feel alive even at 3am +- Physical coins and player-owned vending machines +- A world designed to last — players build legacies, not just houses + +--- + +## Dependencies + +- Task #45 (Server Sunset Evaluation) — must complete first +- Task #6 (Vaultwarden) — for storing database credentials +- MySQL database provisioned on target node + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ diff --git a/docs/tasks/steam-and-state-server/proposal-meg-holly.md b/docs/tasks/steam-and-state-server/proposal-meg-holly.md new file mode 100644 index 0000000..4f68a71 --- /dev/null +++ b/docs/tasks/steam-and-state-server/proposal-meg-holly.md @@ -0,0 +1,125 @@ +# 🧊🔥 Firefrost "Steam & State" — Community Proposal + +**Prepared for:** Meg (The Emissary) and Holly (Lead Builder) +**Date:** March 18, 2026 +**Project Duration:** 2026–2028 (2 Years) + +--- + +## The Big Idea + +Most Minecraft servers die after a few months because players run out +of things to do. Firefrost: Steam & State is designed differently — it's +a world built to last two full years, where players aren't just surviving +or building houses. They're building civilization. + +Think of it as Minecraft meets the Industrial Revolution meets a living +political map. + +--- + +## What Makes This Different + +**The Economy is Physical** + +Forget typing /pay to send money to someone. In Steam & State, money is +real. Players mine resources, smelt them into coins at a Create press, +and carry those coins in their inventory. To buy something, you walk up +to a player-owned vending machine and make a transaction. Wealth feels +earned because it is. + +**Trains Connect the World** + +The centerpiece of the server is the rail network. Players don't just +teleport between locations — they build actual train lines. A town that +mines coal deep in the mountains needs to ship it to the industrial +towns that need it for their factories. The "Firefrost Express" starts +at spawn and connects to every major player settlement on the map. + +**Towns Become Nations** + +Using the Towny system, players claim land, invite friends, pay taxes, +and form alliances. Small towns eventually grow into powerful nations +with their own laws, borders, and trade agreements. Or rivalries. The +politics are player-driven — we just provide the foundation. + +**The World Stays Alive** + +One of the biggest problems with multiplayer servers is that they feel +empty when only a handful of people are online. We're solving this with +MineColonies — players can build NPC citizens into their towns. Little +workers who actually mine, farm, and guard the walls while the player +is offline. The world feels busy even at 3am. + +--- + +## The Three Eras (Content That Lasts Two Years) + +**Year One: The Industrial Age** + +Players arrive in a fresh world and begin staking their claims. The +first months are about exploration, resource gathering, and building +the first towns. The staff-built Grand Central station at spawn becomes +the heart of the world. The first rail lines go in. The first nations +form. The first trade wars begin. + +**Year One to Two: The Era of Nations** + +The map fills in. Massive industrial empires emerge. Players who've been +here since the beginning become legendary figures. New players arrive and +find an already-thriving world to join. We host events — The Great +Railway Race, Industrial Exhibitions, diplomatic summits between nations. + +**Year Two: The Legacy Era** + +The world becomes a monument to what the community built together. Long- +term players are celebrated. We document the history of the server — the +wars, the alliances, the great factories. And we begin planning Season 2, +carrying the best parts of the story forward. + +--- + +## What We Need From the Team + +**From Meg (The Emissary):** +- Help shape the "vibe" — what does Firefrost civilization feel like? +- Community announcements and Discord hype as we approach launch +- Moderation philosophy for a political, economy-driven server + (trade disputes and nation wars need clear rules) +- Ideas for community events during each era + +**From Holly (Lead Builder):** +- Design and build "Firefrost Grand Central" — the spawn station +- The first staff-built rail line connecting Grand Central to the + first three starter towns +- Art direction for the spawn area aesthetic (steampunk? fantasy-industrial?) +- Building guidelines so player towns feel cohesive with the world + +--- + +## What Players Will Experience + +On day one, a new player spawns at Firefrost Grand Central — a massive +steam-powered station with trains coming and going, player shops lining +the concourse, and a board showing the current map of player nations. + +They can hop on a train to explore. They can stake a claim and start +a homestead. They can join an existing town and work their way up. Or +they can gather a few friends and found something new. + +Two years from now, that player might be the leader of a nation that +controls the coal trade on an entire continent, with a city that Holly +helped design and Meg helped populate. + +That's the Firefrost dream. + +--- + +## Questions? Ideas? + +This proposal is a starting point, not a finished plan. Meg and Holly's +input will shape what this world actually becomes. The tech is Michael's +job — the soul of it is ours together. + +💙🔥❄️ +**Fire + Frost + Foundation = Where Love Builds Legacy**