# 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
