From 404454b24e57c7b806c09071f5dc558bd4baecb1 Mon Sep 17 00:00:00 2001 From: "Claude (Chronicler #49)" Date: Mon, 30 Mar 2026 15:27:00 +0000 Subject: [PATCH] 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) --- docs/guides/holly-luckperms-testing-guide.md | 392 +++++++++++++++++++ 1 file changed, 392 insertions(+) create mode 100644 docs/guides/holly-luckperms-testing-guide.md diff --git a/docs/guides/holly-luckperms-testing-guide.md b/docs/guides/holly-luckperms-testing-guide.md new file mode 100644 index 0000000..5070d13 --- /dev/null +++ b/docs/guides/holly-luckperms-testing-guide.md @@ -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 ` +- 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 info +``` + +**Assign rank to player:** +``` +/lp user parent set +``` + +**Check what permissions a player has:** +``` +/lp user permission check +``` + +**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)