f54a98c2c4
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
122 lines
3.4 KiB
Markdown
122 lines
3.4 KiB
Markdown
# 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
|