docs: Add LuckPerms testing guide for Holly
WHAT WAS DONE: Created comprehensive testing guide for Holly to verify LuckPerms configuration GUIDE CONTENTS: - Quick checks (5 minutes) - verify groups exist, check permissions - Full 9-step testing procedure (30-45 minutes total) - Testing checklist with 10 validation items - Troubleshooting section for common issues - Quick command reference for LuckPerms TESTING STEPS COVERED: 1. Create test player (alt account or ask Meg) 2. Test Awakened rank (1 home, no /rtp, no chunks) 3. Test Fire Elemental (5 homes, /rtp 60min, 25 chunks) 4. Test Frost Elemental (verify cyan vs orange colors) 5. Test Knight tier (10 homes, 49 chunks, 30min /rtp) 6. Test Sovereign (50 homes, 225 chunks, no cooldown) 7. Test Mod rank (kick/ban commands) 8. Test chat prefixes (colors and display) 9. Test inheritance (perks remain after upgrade) KEY VALIDATIONS: - Verify all 13 groups exist - Check prefix colors (Fire=#FF3D00, Frost=#00E5FF) - Confirm permissions work (homes, chunks, /rtp) - Validate inheritance chain - Test moderation commands TROUBLESHOOTING INCLUDED: - Prefix not showing (chat plugin issues) - Permissions not working (permission checks) - Chunks not claiming (FTB config needed) - Homes not working (FTB Essentials config) AUDIENCE: Holly (unicorn20089) ESTIMATED TIME: 30-45 minutes PURPOSE: Validate LuckPerms setup before rolling out to all 13 servers WHY THIS MATTERS: Holly figured out LuckPerms configuration and needs systematic testing before deploying across entire server network. This guide ensures nothing breaks in production. FRIENDLY URL: git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/src/branch/master/docs/guides/holly-luckperms-testing-guide.md FILE: docs/guides/holly-luckperms-testing-guide.md Signed-off-by: Claude (Chronicler #49) <claude@firefrostgaming.com>
This commit is contained in:
Claude (Chronicler #49)
392
docs/guides/holly-luckperms-testing-guide.md
Normal file
392
docs/guides/holly-luckperms-testing-guide.md
Normal file
@@ -0,0 +1,392 @@
|
||||
# LuckPerms Testing Guide for Holly
|
||||
|
||||
**Date:** March 30, 2026
|
||||
**For:** Holly (unicorn20089)
|
||||
**From:** Claude (Chronicler #49)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 What You're Testing
|
||||
|
||||
You've configured LuckPerms! Now you need to verify that:
|
||||
1. Groups exist correctly
|
||||
2. Prefixes show up in chat
|
||||
3. Permissions work (homes, chunks, /rtp)
|
||||
4. Inheritance works (higher ranks get lower rank perks)
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Quick Checks (In-Game Commands)
|
||||
|
||||
### 1. Check If Groups Exist
|
||||
|
||||
```
|
||||
/lp listgroups
|
||||
```
|
||||
|
||||
**Should show:**
|
||||
- `default`
|
||||
- `awakened`
|
||||
- `fire_elemental`, `frost_elemental`
|
||||
- `fire_knight`, `frost_knight`
|
||||
- `fire_master`, `frost_master`
|
||||
- `fire_legend`, `frost_legend`
|
||||
- `sovereign`
|
||||
- `mod`, `admin`
|
||||
|
||||
---
|
||||
|
||||
### 2. Check Your Own Permissions
|
||||
|
||||
```
|
||||
/lp user unicorn20089 info
|
||||
```
|
||||
|
||||
**Should show:**
|
||||
- You're in the `admin` group
|
||||
- You have permission `*` (all permissions)
|
||||
|
||||
---
|
||||
|
||||
### 3. Check a Specific Group
|
||||
|
||||
```
|
||||
/lp group fire_elemental info
|
||||
```
|
||||
|
||||
**Should show:**
|
||||
- Parent groups (inherits from `awakened`)
|
||||
- Prefix: `[Elemental]` in `#FF3D00` color
|
||||
- Permissions: homes, rtp, chunks
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Full Testing Procedure
|
||||
|
||||
### Test 1: Create a Test Player
|
||||
|
||||
**Option A: Use an Alt Account**
|
||||
- Log in with alt Minecraft account
|
||||
- This is the cleanest way to test
|
||||
|
||||
**Option B: Test on Another Player**
|
||||
- Ask Meg or someone else to help
|
||||
- You'll assign them test ranks
|
||||
|
||||
**For this guide, we'll call the test player `TestPlayer`**
|
||||
|
||||
---
|
||||
|
||||
### Test 2: Assign Test Rank
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set awakened
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- TestPlayer gets `[The Awakened]` prefix in white
|
||||
- TestPlayer can access servers (no longer default)
|
||||
|
||||
---
|
||||
|
||||
### Test 3: Test Awakened Permissions
|
||||
|
||||
**Have TestPlayer try:**
|
||||
|
||||
1. **Set a home:**
|
||||
```
|
||||
/sethome test1
|
||||
```
|
||||
✅ Should work (1 home allowed)
|
||||
|
||||
2. **Try to set a second home:**
|
||||
```
|
||||
/sethome test2
|
||||
```
|
||||
❌ Should fail with "You've reached your home limit"
|
||||
|
||||
3. **Try /rtp:**
|
||||
```
|
||||
/rtp
|
||||
```
|
||||
❌ Should fail (Awakened has no /rtp access)
|
||||
|
||||
4. **Try claiming chunks:**
|
||||
Right-click with map → Claim chunks
|
||||
❌ Should fail (Awakened gets 0 chunks)
|
||||
|
||||
---
|
||||
|
||||
### Test 4: Upgrade to Elemental
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set fire_elemental
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- Prefix changes to `[Elemental]` in orange/red
|
||||
- Still has the 1 home from before (inheritance!)
|
||||
|
||||
**Have TestPlayer try:**
|
||||
|
||||
1. **Set more homes:**
|
||||
```
|
||||
/sethome test2
|
||||
/sethome test3
|
||||
/sethome test4
|
||||
/sethome test5
|
||||
```
|
||||
✅ Should work (5 homes total for Elemental)
|
||||
|
||||
2. **Try a 6th home:**
|
||||
```
|
||||
/sethome test6
|
||||
```
|
||||
❌ Should fail
|
||||
|
||||
3. **Use /rtp:**
|
||||
```
|
||||
/rtp
|
||||
```
|
||||
✅ Should work! (60-minute cooldown)
|
||||
|
||||
4. **Claim chunks:**
|
||||
Right-click with map → Claim
|
||||
✅ Should work! (25 chunks max)
|
||||
|
||||
5. **Try claiming 26th chunk:**
|
||||
❌ Should fail with "chunk limit reached"
|
||||
|
||||
---
|
||||
|
||||
### Test 5: Test Inheritance (Knight)
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set fire_knight
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- Prefix changes to `[Knight]` in orange/red
|
||||
- Still has previous homes (inheritance works!)
|
||||
- Can now set up to 10 homes total
|
||||
- Can claim up to 49 chunks
|
||||
- /rtp cooldown reduced to 30 minutes
|
||||
|
||||
**Quick check:**
|
||||
```
|
||||
/sethome test6
|
||||
/sethome test7
|
||||
```
|
||||
✅ Should work (now 10 homes allowed)
|
||||
|
||||
---
|
||||
|
||||
### Test 6: Test Sovereign (Top Tier)
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set sovereign
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- Prefix changes to `[Sovereign]` in gold
|
||||
- Can set up to 50 homes
|
||||
- Can claim 225 chunks
|
||||
- /rtp has NO cooldown (bypass)
|
||||
|
||||
**Quick check:**
|
||||
```
|
||||
/rtp
|
||||
```
|
||||
✅ Should work immediately (no cooldown)
|
||||
|
||||
---
|
||||
|
||||
### Test 7: Test Frost Path (Different Color)
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set frost_elemental
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- Prefix shows `[Elemental]` in **cyan** (not orange!)
|
||||
- Same permissions as fire_elemental
|
||||
- Just different color
|
||||
|
||||
This confirms the path colors work correctly.
|
||||
|
||||
---
|
||||
|
||||
### Test 8: Test Mod Rank
|
||||
|
||||
```
|
||||
/lp user TestPlayer parent set mod
|
||||
```
|
||||
|
||||
**Expected result:**
|
||||
- Prefix changes to `[Mod]` in gray
|
||||
- Has moderation commands available:
|
||||
- `/kick`
|
||||
- `/ban`
|
||||
- `/unban`
|
||||
- `/mute`
|
||||
|
||||
**Have TestPlayer try:**
|
||||
```
|
||||
/kick SomePlayer
|
||||
```
|
||||
✅ Should have permission (but probably no players to actually kick)
|
||||
|
||||
---
|
||||
|
||||
### Test 9: Clean Up
|
||||
|
||||
**Remove test rank:**
|
||||
```
|
||||
/lp user TestPlayer parent set default
|
||||
```
|
||||
|
||||
Or if testing on someone else, set them back to their real rank.
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Testing Chat Prefixes
|
||||
|
||||
### Visual Prefix Check
|
||||
|
||||
1. Have TestPlayer send a chat message
|
||||
2. Their prefix should show before their name
|
||||
|
||||
**Example:**
|
||||
```
|
||||
[Elemental] TestPlayer: Hello!
|
||||
```
|
||||
|
||||
If prefix doesn't show:
|
||||
- Check if you have a chat formatting plugin installed
|
||||
- Hex colors require special plugin support
|
||||
- Ask Michael to check chat plugin config
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Testing Inheritance
|
||||
|
||||
### Inheritance Test Flow
|
||||
|
||||
```
|
||||
awakened (1 home)
|
||||
└─> fire_elemental (5 homes) — still has access to awakened perks!
|
||||
└─> fire_knight (10 homes) — still has elemental + awakened perks!
|
||||
└─> fire_master (20 homes) — gets everything below!
|
||||
```
|
||||
|
||||
**How to verify:**
|
||||
1. Assign TestPlayer to `awakened`
|
||||
2. Have them set `/sethome base`
|
||||
3. Upgrade them to `fire_elemental`
|
||||
4. Check if they still have `/home base` ✅
|
||||
5. This confirms inheritance works!
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Prefix Not Showing
|
||||
- Check chat plugin installed and configured
|
||||
- Hex colors need special plugin (like MiniMessage)
|
||||
- Verify prefix command was run correctly
|
||||
|
||||
### Permissions Not Working
|
||||
- Check `/lp user TestPlayer permission check <permission>`
|
||||
- Example: `/lp user TestPlayer permission check ftbessentials.home.limit.5`
|
||||
- Should return "true" if working
|
||||
|
||||
### Chunks Not Claiming
|
||||
- FTB Chunks config files need updating (separate from LuckPerms)
|
||||
- Located in each server's config folder
|
||||
- Ask Michael to check `ftbchunks.snbt`
|
||||
|
||||
### Homes Not Working
|
||||
- FTB Essentials config needs updating
|
||||
- Located in each server's config folder
|
||||
- Ask Michael to check `ftbessentials.snbt`
|
||||
|
||||
---
|
||||
|
||||
## ✅ Testing Checklist
|
||||
|
||||
Mark off as you complete:
|
||||
|
||||
- [ ] Verified all groups exist (`/lp listgroups`)
|
||||
- [ ] Tested Awakened rank (1 home, no /rtp, no chunks)
|
||||
- [ ] Tested Fire Elemental (5 homes, /rtp works, 25 chunks)
|
||||
- [ ] Tested Frost Elemental (cyan color, not orange)
|
||||
- [ ] Tested Knight tier (10 homes, 49 chunks)
|
||||
- [ ] Tested Sovereign (50 homes, 225 chunks, no /rtp cooldown)
|
||||
- [ ] Tested Mod rank (kick/ban commands)
|
||||
- [ ] Verified chat prefixes show correctly
|
||||
- [ ] Verified inheritance works (old perks remain after upgrade)
|
||||
- [ ] Cleaned up test player
|
||||
|
||||
---
|
||||
|
||||
## 💡 Quick Commands Reference
|
||||
|
||||
**View all groups:**
|
||||
```
|
||||
/lp listgroups
|
||||
```
|
||||
|
||||
**Check specific group:**
|
||||
```
|
||||
/lp group <groupname> info
|
||||
```
|
||||
|
||||
**Assign rank to player:**
|
||||
```
|
||||
/lp user <player> parent set <group>
|
||||
```
|
||||
|
||||
**Check what permissions a player has:**
|
||||
```
|
||||
/lp user <player> permission check <permission>
|
||||
```
|
||||
|
||||
**Check your own info:**
|
||||
```
|
||||
/lp user unicorn20089 info
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 When Testing is Complete
|
||||
|
||||
Let Michael know:
|
||||
1. Which tests passed ✅
|
||||
2. Which tests failed ❌
|
||||
3. Any weird behavior you noticed
|
||||
4. Whether chat prefixes displayed correctly
|
||||
5. Whether colors showed right (Fire = orange, Frost = cyan)
|
||||
|
||||
**If everything works:** You're ready to sync across all 13 servers!
|
||||
|
||||
**If issues found:** Document them and work with Michael to fix before rolling out.
|
||||
|
||||
---
|
||||
|
||||
## 📞 Need Help?
|
||||
|
||||
**Ask Michael about:**
|
||||
- MySQL sync issues
|
||||
- FTB config files (chunks/essentials)
|
||||
- Chat plugin configuration
|
||||
- Permission node questions
|
||||
|
||||
**Reference docs:**
|
||||
- `docs/tasks/rank-system-deployment/rank-structure.md` - Full permission list
|
||||
- `docs/services/luckperms-mysql-database.md` - MySQL backend info
|
||||
|
||||
---
|
||||
|
||||
**Good luck testing! You've got this! 🔥❄️**
|
||||
|
||||
— Claude (Chronicler #49)
|
||||
Reference in New Issue
Block a user