docs: Holly review doc — modpack installer feature overview
This commit is contained in:
Claude
148
docs/holly-review-modpack-installer.md
Normal file
148
docs/holly-review-modpack-installer.md
Normal file
@@ -0,0 +1,148 @@
|
||||
# Holly's Review — The Modpack Installer 💜
|
||||
|
||||
**From:** Michael + The Chronicler
|
||||
**To:** Holly (unicorn20089, The Catalyst)
|
||||
**Re:** A big thing we're building for you — please read and give us your honest thoughts
|
||||
|
||||
---
|
||||
|
||||
Hey Holly! 💜
|
||||
|
||||
We spent a big chunk of launch night scoping out something that's been a long time coming — a proper modpack installer built right into Trinity Console. The goal is simple: **get you out of the manual configuration trenches for good.**
|
||||
|
||||
Before anything goes to Code, we want your eyes on it. You know better than anyone what's actually painful about standing up a new server, and we want to make sure we're solving the right problems. Please be brutally honest — if something sounds too good to be true or you've been burned by an AI promising this before, say so. We'd rather know now than find out after Code spends weeks building it.
|
||||
|
||||
Also — one of these features has a bot that needs a name, and that's entirely your call. More on that below. 😄
|
||||
|
||||
---
|
||||
|
||||
## What Your Life Looks Like After This Is Built
|
||||
|
||||
Right now, every new server means: find the pack, manually set it up in Pterodactyl, download mods one by one, log in, WorldEdit the spawn building, configure command blocks, move worldspawn, set up YAwP, install server-side mods, configure LuckPerms... you know the list.
|
||||
|
||||
After this is built, you pick a pack, fill in a few fields, hit install, and walk away. The system handles the rest. You log in to verify it looks right. That's it.
|
||||
|
||||
---
|
||||
|
||||
## The Features — Plain English
|
||||
|
||||
### 1. Browse & Pick Your Pack
|
||||
Trinity Console gets a modpack browser. You pick from 6 providers: CurseForge, Modrinth, FTB, ATLauncher, Technic, and VoidsWrath. Search by name, filter by category (Magic, Tech, Quests, Sci-Fi, Skyblock, etc.), filter by mod loader (Forge, Fabric, NeoForge) and Minecraft version. Featured packs front and center.
|
||||
|
||||
### 2. Pick Your Version
|
||||
When you find a pack, you get a full version dropdown. Defaults to latest, but you can pick any version. Useful when a newer version has a broken quest line or known issue — you stay on the version that works and add a note explaining why.
|
||||
|
||||
### 3. Smart Server Recommendation
|
||||
The system looks at our existing nodes, checks available RAM and disk space, and recommends the best place to put the new server. You can override it.
|
||||
|
||||
### 4. One Field Does Everything
|
||||
You type one short name — like `mythcraft5` — and that becomes the Discord channel prefix, the subdomain (`mythcraft5.firefrostgaming.com`), and the database entry. No more typing the same thing in three different places.
|
||||
|
||||
### 5. Everything Provisions Automatically
|
||||
When you confirm the install, the system:
|
||||
- Creates the Pterodactyl server
|
||||
- Sets up the Cloudflare subdomain
|
||||
- Creates the Discord category and all 5 channels
|
||||
- Adds it to the server status poller
|
||||
- Posts a staff notification in Discord
|
||||
|
||||
You don't touch Pterodactyl, Cloudflare, or Discord manually.
|
||||
|
||||
### 6. Your Standard Mod Stack, Auto-Deployed
|
||||
We maintain a curated list of server-side mods in NextCloud (LuckPerms, Open Parties and Claims, Spark, FTB Essentials, etc.) organised by Minecraft version and mod loader. Every new server gets the right ones automatically, with config files pre-configured to Firefrost standards. LuckPerms meta for all 6 tiers is set automatically too.
|
||||
|
||||
### 7. Spawn Setup — Your Bot 💜
|
||||
This is the big one. We're building a tiny lightweight mod — **you get to name it** — that runs exactly once on a new server's first boot. It reads a config file Arbiter drops into the server folder, then:
|
||||
- Pastes your spawn building schematic at fixed coordinates (same spot on every server)
|
||||
- Reads the world's original spawn point
|
||||
- Places and configures the 4 command blocks with the correct `/tp` coordinates already baked in
|
||||
- Moves worldspawn to the center of your building
|
||||
- Renames itself to `.disabled` and never runs again
|
||||
|
||||
**You log in to a server that already has your spawn building in it, correctly placed, with working return buttons.**
|
||||
|
||||
One flag during setup for servers that don't need this — Skyblock servers, or servers that already have their own lobby (like Stoneblock 4 or Submerged 2). Those get skipped automatically.
|
||||
|
||||
### 8. YAwP Config, Auto-Deployed
|
||||
Because the spawn building always goes to the same fixed coordinates, the YAwP config is identical on every server. It gets dropped in automatically. No manual configuration.
|
||||
|
||||
### 9. Version Tracking & Updates
|
||||
Every 6 hours, the system checks each server's installed pack version against the provider's latest. If there's an update available, you see a flag on the server card in Trinity Console.
|
||||
|
||||
You can **lock a version** — toggle it and add a note like "Locked to 5.5.5 — quest line broken in 5.5.6, waiting on author fix." The update flag stays away until you unlock it.
|
||||
|
||||
### 10. Updates From Trinity Console
|
||||
When you do want to update, one button:
|
||||
- Archives the `config/` folder to NextCloud before touching anything
|
||||
- Runs the pack update
|
||||
- Verifies our standard mods are still present, reinstalls any that got wiped
|
||||
- Restores our standard configs if the update overwrote them
|
||||
- Restarts the server
|
||||
- Posts player-friendly update notes to the server's Discord channel
|
||||
- Updates the pinned message in the server channel with the new version number
|
||||
|
||||
One-click rollback if something goes wrong.
|
||||
|
||||
### 11. Crash Loop Protection
|
||||
If a newly installed or updated server crashes 3 times in 10 minutes, the system automatically rolls back to the last good config and pings you in Discord with the crash log. You don't have to babysit a broken install.
|
||||
|
||||
### 12. Clone to Dev
|
||||
One button to duplicate any production server to a test port on TX1. You test the update there, confirm it works, then apply it to prod. No more "let's just try it and see."
|
||||
|
||||
### 13. Server Hibernation
|
||||
If a server has zero players for 7 days, it posts a 48-hour warning in the Discord channel. If still empty, it backs up the world, archives the server to NextCloud, and removes it from Pterodactyl to free up node space. A "Wake Up" button spins it back up in about 3 minutes.
|
||||
|
||||
### 14. RAM Auto-Scaling
|
||||
If a server consistently runs at 95%+ memory over 30 minutes, Arbiter bumps the allocation by 1GB (up to a configurable ceiling) and schedules a restart. Posts to staff Discord every time.
|
||||
|
||||
### 15. Instant Tier Sync
|
||||
When a subscriber upgrades their tier on Stripe, their new claim limits and chunk loader limits apply across all 18 servers within seconds. No restarts, no manual LuckPerms work.
|
||||
|
||||
### 16. Cursed Modpack Roulette 🎲
|
||||
A fun community event feature. 50 random compatible mods, auto-provisioned server, AI-generated description of the chaos. Players see the full mod list — the fun is figuring out what it'll actually play like.
|
||||
|
||||
### 17. AI Patch Notes
|
||||
When a pack updates, Arbiter generates a friendly "what's new" post for players in the server's Discord channel automatically.
|
||||
|
||||
---
|
||||
|
||||
## What's Proven vs What's New
|
||||
|
||||
**Already proven tonight:**
|
||||
- Downloading mods via CurseForge API (~95% success — the 5% that fail are client-only mods that don't belong on servers anyway)
|
||||
- Pterodactyl server provisioning
|
||||
- Cloudflare subdomain creation
|
||||
- Discord channel creation
|
||||
- Status poller integration
|
||||
- LuckPerms meta setting
|
||||
|
||||
**New but architecturally validated (reviewed by Gemini):**
|
||||
- The spawn bot — a real compiled mod running inside Minecraft's JVM, not an external script. Much safer than trying to manipulate world files from outside.
|
||||
- Job queue for long-running installs
|
||||
- SSH streaming for hibernation archives
|
||||
- Redis + LuckPerms messaging for instant tier sync
|
||||
|
||||
**Things that need your specific input:**
|
||||
- Are the spawn coordinates we're thinking of (far outside world border, fixed location) safe across different modpacks, or do some packs generate terrain there that would conflict?
|
||||
- Is your spawn building schematic ready to be the standard, or does it need updates first?
|
||||
- Are the 4 command block positions hardcoded inside the schematic, or do they need to be placed separately by the bot?
|
||||
|
||||
---
|
||||
|
||||
## Please Name the Bot 💜
|
||||
|
||||
"Holly-Bot" is just our working name. This is YOUR mod — built around your work, automating your job, running on every server we ever spin up. It deserves a name you actually love.
|
||||
|
||||
---
|
||||
|
||||
## We Want Your Honest Reaction
|
||||
|
||||
- Does this solve the right problems?
|
||||
- Anything we missed that's still painful?
|
||||
- Anything that sounds too ambitious or too likely to break?
|
||||
- Any features you'd reprioritise?
|
||||
|
||||
We're not building anything until you've signed off. This is for you. 💜
|
||||
|
||||
— Michael + The Chronicler
|
||||
*Fire + Arcane + Frost = Forever 🔥💜❄️*
|
||||
Reference in New Issue
Block a user