From f54a98c2c4e9d62221861c345a7b3704aec030e3 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 10 Mar 2026 23:29:39 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20add=20Task=20#40=20+=20#41=20=E2=80=94?= =?UTF-8?q?=20builder=20rank/Holly=20setup=20+=20full=20rank=20system?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Task #40 (TOP PRIORITY): Builder rank on all 12 servers for Holly. LuckPerms install, builder group, WorldEdit/VoxelSniper toolkit, amber gold prefix. Unblocks Holly immediately. Task #41 (TOP PRIORITY): Full rank system automation. Awakened → Founder subscriber hierarchy + staff ranks on MySQL backend. Paymenter → Discord → LuckPerms automation. Rank structure sourced from luckperms-structure.md (Feb 2026). Created by Chronicler #29 --- docs/core/tasks.md | 50 ++++++ docs/tasks/builder-rank-holly-setup/README.md | 55 +++++++ .../builder-toolkit.md | 154 ++++++++++++++++++ docs/tasks/rank-system-deployment/README.md | 121 ++++++++++++++ 4 files changed, 380 insertions(+) create mode 100644 docs/tasks/builder-rank-holly-setup/README.md create mode 100644 docs/tasks/builder-rank-holly-setup/builder-toolkit.md create mode 100644 docs/tasks/rank-system-deployment/README.md diff --git a/docs/core/tasks.md b/docs/core/tasks.md index afde661..9812bd5 100644 --- a/docs/core/tasks.md +++ b/docs/core/tasks.md @@ -32,6 +32,56 @@ Quick wins that unlock other work or provide immediate value. --- +### 40. Builder Rank & Holly Tool Setup +**Time:** 1-2 hours +**Status:** TOP PRIORITY — unblocks Holly immediately +**Priority:** Tier 0 — Immediate Win +**Documentation:** `docs/tasks/builder-rank-holly-setup/` + +Install LuckPerms, create the Builder staff rank, assign it to Holly (unicorn20089) on all 12 servers, and ensure her full builder toolkit is available (WorldEdit, VoxelSniper, builder permissions). + +**Key Deliverables:** +- LuckPerms installed on all 12 servers +- Builder rank created with full permissions (WorldEdit, gamemode, chunk bypass, generous homes) +- Holly assigned Builder rank on all 12 servers +- Builder toolkit verified per server (WorldEdit/Axiom, VoxelSniper) +- Builder chat prefix configured (🔨 Builder — Amber Gold) + +**Dependencies:** +- Requires SSH to TX1 and NC1 game servers +- Ideally paired with Task #41 (MySQL backend) but can run per-server if urgent + +**See task directory for complete deployment plan and builder toolkit reference.** + +--- + +### 41. Rank System Deployment — Full Network Automation +**Time:** 6-8 hours (1-2 sessions) +**Status:** TOP PRIORITY +**Priority:** Tier 1 — Critical Infrastructure +**Documentation:** `docs/tasks/rank-system-deployment/` + +Deploy the complete LuckPerms rank system across all 12 servers — subscriber tiers (Awakened through Founder), staff ranks, MySQL backend for network-wide sync, and full Paymenter → Discord → LuckPerms automation. Rank structure is fully designed and ready to execute. + +**Key Deliverables:** +- LuckPerms on MySQL backend (all 12 servers, single source of truth) +- All subscriber ranks (awakened → founder) with correct permissions, prefixes, FTB integration +- Staff ranks (builder, moderator, admin, owner) +- Discord role → LuckPerms group sync automated +- Paymenter webhook → Discord → in-game rank flow end-to-end + +**Dependencies:** +- Task #40 (Builder rank) can run ahead of this +- Task #6 (Vaultwarden) for secure DB credential storage +- Paymenter webhook config +- Discord bot token + +**Source:** Full rank structure documented in `docs/archive/2026-02-09-consolidation/luckperms-structure.md` + +**See task directory for complete deployment plan.** + +--- + ### 38. Ghost CMS Security Update — ⚠️ URGENT **Time:** 15-30 minutes **Status:** PATCH IMMEDIATELY — 8 days exposed diff --git a/docs/tasks/builder-rank-holly-setup/README.md b/docs/tasks/builder-rank-holly-setup/README.md new file mode 100644 index 0000000..081c8c1 --- /dev/null +++ b/docs/tasks/builder-rank-holly-setup/README.md @@ -0,0 +1,55 @@ +# Builder Rank & Holly's Tool Setup + +**Status:** READY — top priority +**Owner:** Michael "Frostystyle" Krause +**Priority:** Tier 0 — Immediate (unblocks Holly's work) +**Created:** 2026-03-10 +**Created By:** Chronicler #29 + +--- + +## Overview + +Define and deploy the Builder staff rank on all 12 servers, assign it to Holly (unicorn20089), and ensure she has the full builder toolkit available. This is separate from the subscriber rank system — staff ranks are a parallel track. + +This task is intentionally scoped small so Holly can start building as soon as possible. + +--- + +## Quick Links + +- [Deployment Plan](deployment-plan.md) — Step-by-step setup +- [Builder Toolkit](builder-toolkit.md) — Full list of tools and permissions + +--- + +## Staff Rank Structure (Parallel to Subscriber Ranks) + +``` +staff ranks (separate from subscriber hierarchy) +├── builder ← Holly's rank +├── moderator (future) +├── admin (future) +└── owner (Michael/frostystyle) +``` + +Staff ranks sit outside the subscriber tier tree. A builder has staff-level build permissions regardless of their subscription status. + +--- + +## Holly's Current Access After This Task + +- LuckPerms `builder` group on all 12 servers +- WorldEdit (or equivalent per modpack) +- Replay Mod / Replay Reforged (where applicable) +- Builder-appropriate chat prefix +- Bypass for chunk claim limits in build areas +- Creative mode or gamemode switching (build servers only) + +--- + +## Dependencies + +- Requires SSH access to all game servers (TX1 + NC1) +- LuckPerms must be installed first (part of this task if not present) +- See Task #25 (LuckPerms MySQL Backend) — ideally done first, but can do per-server if urgent diff --git a/docs/tasks/builder-rank-holly-setup/builder-toolkit.md b/docs/tasks/builder-rank-holly-setup/builder-toolkit.md new file mode 100644 index 0000000..4b6f29b --- /dev/null +++ b/docs/tasks/builder-rank-holly-setup/builder-toolkit.md @@ -0,0 +1,154 @@ +# Builder Toolkit — Holly (unicorn20089) + +**Task:** Builder Rank & Holly Setup +**Document Type:** builder-toolkit +**Status:** ACTIVE +**Last Updated:** 2026-03-10 + +--- + +## Core Build Tools + +### WorldEdit / WorldEdit Forge / Axiom + +The essential builder tool. Check what's available per modpack: + +| Modpack Type | Recommended Tool | +|--------------|-----------------| +| Fabric modpacks | WorldEdit for Fabric | +| Forge modpacks | WorldEdit for Forge | +| Modern Forge (1.20+) | Axiom (more powerful, preferred if available) | +| Vanilla server | WorldEdit | + +**Key permissions to grant:** +``` +worldedit.* (full WorldEdit access) +``` +or scoped: +``` +worldedit.selection.* +worldedit.region.* +worldedit.clipboard.* +worldedit.generation.* +worldedit.history.* +worldedit.schematic.* +``` + +--- + +### Replay Mod / Replay Reforged + +For recording builds as timelapses and reviewing build sessions. + +- **Replay Mod** — Fabric/Forge, client-side (Holly installs on her own client) +- **Replay Reforged** — Forge port, same concept + +**Note:** Replay Mod is client-side only — no server-side installation needed. Holly just needs it on her own Minecraft client. No permissions required on the server. + +--- + +### VoxelSniper / FastAsyncVoxelSniper + +For terrain sculpting and large organic builds. Useful for spawn areas and landscape work. + +**Key permissions:** +``` +voxelsniper.sniper +voxelsniper.brush.* +``` + +--- + +### Litematica (Client-Side) + +For loading schematic templates while building. Client-side only — no server install needed. + +--- + +### Carpet Mod (Fabric servers only) + +Useful for technical builds and redstone. Check if applicable per server. + +--- + +## Builder-Specific Permissions (LuckPerms) + +```yaml +# Builder group permissions +group.builder: + permissions: + # Gamemode + - minecraft.command.gamemode # /gamemode switch + - essentials.gamemode # If EssentialsX installed + + # Teleport (for build coordination) + - essentials.tp # Teleport to players + - essentials.tphere # Bring players to you + - ftbessentials.home.limit.50 # Generous home limit for build markers + + # WorldEdit + - worldedit.* # Full WorldEdit access + + # VoxelSniper (if installed) + - voxelsniper.sniper + - voxelsniper.brush.* + + # Chunk management (builders need uncapped chunks for build areas) + - ftbchunks.max_claimed.500 # High limit for build zones + - ftbchunks.max_force_loaded.50 # Force load build chunks + + # Time/weather (useful while building) + - essentials.time # /time set + - essentials.weather # /weather clear + + # Staff bypass + - ftbchunks.admin # Bypass chunk protection in build areas +``` + +**Chat prefix:** +```yaml +meta: + prefix: "&#FFD600[🔨 Builder] " # Amber Gold — distinct from subscriber tiers +``` + +--- + +## Per-Server Tool Availability Notes + +Some modpacks may conflict with or already include build tools. During deployment, verify per server: + +| Server | Modpack | WorldEdit Available | Notes | +|--------|---------|--------------------|----| +| Stoneblock 4 | Forge | Check | May have Create integration | +| Reclamation | Forge | Check | | +| Society: Sunlit Valley | Forge | Check | | +| Vanilla 1.21.11 | Vanilla | Yes | Standard WorldEdit | +| All The Mons | Forge/Fabric | Check | Cobblemon | +| FoundryVTT | — | N/A | Not a Minecraft server | +| The Ember Project | Forge | Check | | +| Minecolonies: Create and Conquer | Forge | Check | | +| All The Mods 10 | Forge | Check | ATM usually includes WE | +| EMC Subterra Tech | Forge | Check | | +| Homestead | Forge | Check | | +| Hytale | Placeholder | N/A | Not live yet | + +**Note:** FoundryVTT is a tabletop RPG platform, not Minecraft — skip for builder tools. + +--- + +## What Holly Installs on Her Client + +These are client-side mods Holly manages herself — no server action needed: + +- **Replay Mod or Replay Reforged** — timelapse recording +- **Litematica** — schematic loading +- **MiniHUD** (optional) — build overlay info +- **Axiom** (if server has it) — advanced build client + +--- + +## Future Builder Tools to Consider + +- **CoreProtect** — block logging and rollback (useful if a build goes wrong) +- **BuildPaste** — schematic sharing +- **Chunky** — pre-generate chunks before building (performance) diff --git a/docs/tasks/rank-system-deployment/README.md b/docs/tasks/rank-system-deployment/README.md new file mode 100644 index 0000000..6f46998 --- /dev/null +++ b/docs/tasks/rank-system-deployment/README.md @@ -0,0 +1,121 @@ +# Rank System Deployment — Full Network + +**Status:** TOP PRIORITY +**Owner:** Michael "Frostystyle" Krause +**Priority:** Tier 1 — Critical Infrastructure +**Created:** 2026-03-10 +**Created By:** Chronicler #29 + +--- + +## Overview + +Deploy the full LuckPerms rank system across all 12 game servers — subscriber tiers (Awakened through Founder), staff ranks (Builder, Moderator, Admin), MySQL backend for network-wide sync, and Discord role → LuckPerms automation. + +The rank structure is fully designed and ready to implement. This task is about execution. + +--- + +## Quick Links + +- [Deployment Plan](deployment-plan.md) — Phase-by-phase build guide +- [Rank Structure Reference](rank-structure.md) — Full hierarchy (sourced from archive) +- **Source document:** `docs/archive/2026-02-09-consolidation/luckperms-structure.md` + +--- + +## Subscriber Rank Hierarchy + +``` +default (no subscription) + └── awakened ($1 one-time) + ├── fire_elemental ($5/mo) + │ └── fire_knight ($10/mo) + │ └── fire_master ($15/mo) + │ └── fire_legend ($20/mo) + │ └── founder ($499 lifetime) + └── frost_elemental ($5/mo) + └── frost_knight ($10/mo) + └── frost_master ($15/mo) + └── frost_legend ($20/mo) + └── founder ($499 lifetime) +``` + +## Staff Rank Hierarchy (Parallel Track) + +``` +builder ← Holly (unicorn20089) — current +moderator ← future hires +admin ← future +owner ← frostystyle, gingerfury +``` + +--- + +## Automation Flow (The Goal) + +``` +Player subscribes via Paymenter + ↓ +Stripe webhook fires + ↓ +Discord role assigned automatically + ↓ +LuckPerms sync detects Discord role change + ↓ +In-game rank assigned on all 12 servers instantly + ↓ +Player logs in → correct permissions, prefix, perks active +``` + +No manual steps. No waiting. Fully automated. + +--- + +## Phases + +**Phase 1 — LuckPerms MySQL Backend (~1 hour)** +- MySQL database setup (Command Center) +- LuckPerms installed on all 12 servers +- All servers pointing to same database + +**Phase 2 — Rank Configuration (~2 hours)** +- All subscriber groups created with correct permissions +- Staff ranks created (builder, moderator, admin, owner) +- Inheritance hierarchy set +- Chat prefixes and colors configured +- FTB Chunks + FTB Essentials integrated + +**Phase 3 — Discord Sync (~2 hours)** +- Discord bot configured with LuckPerms API +- Role → group mapping table set up +- Paymenter webhook → Discord role automation +- Test full subscribe → rank flow end-to-end + +**Phase 4 — Testing (~1 hour)** +- Test account at each tier +- Verify permissions on multiple servers (MySQL sync working) +- Test tier upgrade flow +- Verify Founder dual-inheritance + +**Total estimate:** 6-8 hours across 1-2 sessions + +--- + +## Dependencies + +- Task #25 (LuckPerms MySQL Backend) — absorbed into this task +- Task #6 (Vaultwarden) — for storing DB credentials securely +- Paymenter webhook configuration — needed for Phase 3 +- Discord bot token — needed for Phase 3 + +--- + +## Success Criteria + +- [ ] All 12 servers running LuckPerms on MySQL backend +- [ ] All subscriber ranks configured with correct permissions +- [ ] Staff ranks (builder through owner) configured +- [ ] Holly has builder rank on all servers +- [ ] Discord role change → in-game rank change is fully automated +- [ ] Zero manual rank management required for new subscribers