firefrost-operations-manual/docs/tasks/rank-system-deployment

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 — Phase-by-phase build guide
• Rank Structure Reference — 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