firefrost-operations-manual/docs/guides/holly-luckperms-testing-guide.md

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)