# 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)