LuckPerms 權限管理

學習使用 LuckPerms 設定伺服器權限系統，管理玩家群組與權限

什麼是權限系統？

權限系統讓您可以控制玩家能做什麼、不能做什麼。例如：只有 VIP 玩家可以飛行、只有管理員可以踢人。LuckPerms 是目前最流行且功能最強大的權限插件！

為什麼需要權限管理？

在預設情況下，所有玩家的權限都是一樣的。透過權限系統，您可以：

功能	範例
🎮 區分玩家等級	一般玩家、VIP、管理員
🛡️ 保護伺服器安全	只有管理員能使用危險指令
💰 創造付費價值	VIP 可以享有更多功能
👥 分工管理	不同管理員負責不同事務

基本概念

在開始之前，先了解 LuckPerms 的四個核心概念：

術語	說明	比喻
🔑 Permission（權限）	控制玩家能做什麼的節點	一把鑰匙
👥 Group（群組）	一組權限的集合	一串鑰匙
👤 User（使用者）	個別玩家	拿鑰匙的人
🔗 Inheritance（繼承）	群組可以繼承其他群組的權限	繼承家族的鑰匙

權限節點格式

權限節點通常的格式為：插件名稱.功能.細項

essentials.fly          → EssentialsX 的飛行功能
essentials.home.set     → EssentialsX 的設定家功能
worldguard.region.claim → WorldGuard 的領地宣告功能

萬用字元

使用 * 可以代表所有子權限：

essentials.* = EssentialsX 的所有權限
essentials.home.* = EssentialsX 所有家相關權限

安裝 LuckPerms

下載 LuckPerms

前往 LuckPerms 官網下載適合您伺服器的版本：

伺服器類型	下載版本
Paper / Spigot / Purpur	Bukkit
BungeeCord / Waterfall	BungeeCord
Velocity	Velocity
Forge	Forge
Fabric	Fabric

下載 LuckPerms

安裝插件

將下載的 .jar 檔案上傳至 plugins 資料夾
重新啟動伺服器

確認安裝成功

在控制台輸入 lp 指令，如果顯示 LuckPerms 的幫助訊息，表示安裝成功。

> lp
[LuckPerms] Running LuckPerms v5.4.xxx
[LuckPerms] Usage: /lp ...

確認安裝

建立權限群組

典型的群組架構

大多數伺服器會建立這樣的群組階層：

admin（管理員）
  ↓ 繼承
mod（版主）
  ↓ 繼承
vip（VIP）
  ↓ 繼承
default（預設玩家）

這樣的好處是：admin 自動擁有 mod + vip + default 的所有權限。

建立群組步驟

建立群組

/lp creategroup vip
/lp creategroup mod
/lp creategroup admin

建立群組

設定群組繼承

讓高級群組繼承低級群組的權限：

/lp group vip parent add default
/lp group mod parent add vip
/lp group admin parent add mod

為群組添加權限

# 預設玩家 - 基本功能
/lp group default permission set essentials.home true
/lp group default permission set essentials.tpa true

# VIP - 額外功能
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.sethome.multiple.vip true

# 版主 - 管理功能
/lp group mod permission set essentials.kick true
/lp group mod permission set essentials.mute true

# 管理員 - 所有權限
/lp group admin permission set * true

設定聊天前綴

為群組設定聊天時顯示的標籤（需要搭配聊天插件）：

/lp group default meta addprefix 10 "&7[玩家] "
/lp group vip meta addprefix 20 "&6[VIP] "
/lp group mod meta addprefix 50 "&9[版主] "
/lp group admin meta addprefix 100 "&c[管理員] "

數字代表優先順序，數字越大優先顯示。如果玩家同時是 VIP 和 MOD，會顯示數字較大的 [版主]。

顏色代碼參考：

代碼	顏色	代碼	顏色
`&0`	黑色	`&8`	深灰
`&1`	深藍	`&9`	藍色
`&2`	深綠	`&a`	綠色
`&3`	深青	`&b`	青色
`&4`	深紅	`&c`	紅色
`&5`	紫色	`&d`	粉紅
`&6`	金色	`&e`	黃色
`&7`	灰色	`&f`	白色

管理玩家權限

將玩家加入群組

# 將玩家設為 VIP（取代原有群組）
/lp user Steve parent set vip

# 將玩家加入 Admin 群組（保留原有群組）
/lp user Alex parent add admin

set 與 add 的區別

parent set → 取代玩家原有的群組
parent add → 在原有群組之外再加入新群組

設定臨時權限/群組

讓 VIP 權限在一週後自動過期：

# 臨時加入群組（7 天）
/lp user Steve parent addtemp vip 7d

# 臨時權限（30 天）
/lp user Steve permission settemp essentials.fly true 30d

時間單位：

s = 秒、m = 分、h = 小時、d = 天、w = 週、mo = 月、y = 年

查看玩家資訊

# 查看玩家基本資訊
/lp user Steve info

# 查看玩家所有權限
/lp user Steve permission info

使用網頁編輯器 ⭐

LuckPerms 最強大的功能之一就是網頁編輯器，可以用圖形介面管理所有權限！

開啟編輯器

在控制台輸入：

/lp editor

系統會生成一個網址，點擊即可開啟編輯器。

開啟編輯器

編輯器連結會在幾分鐘後過期，請儘快完成編輯。

編輯權限

在網頁編輯器中，您可以直覺地：

✅ 建立/刪除群組
✅ 添加/移除權限
✅ 設定前綴和後綴
✅ 管理群組繼承關係
✅ 編輯個別玩家權限

網頁編輯器

儲存變更

編輯完成後：

點擊右上角的「Save」按鈕
複製產生的指令
在遊戲中或控制台貼上執行

儲存變更

常用權限節點

CMI 權限

權限節點	功能說明
`cmi.command.home`	使用 /home 指令
`cmi.command.sethome`	使用 /sethome 指令
`cmi.command.tpa`	使用 /tpa 指令
`cmi.command.fly`	使用 /fly 指令
`cmi.command`	所有 CMI 指令權限

EssentialsX 權限

權限節點	功能說明
`essentials.home`	使用 /home 指令
`essentials.sethome`	使用 /sethome 指令
`essentials.tpa`	使用 /tpa 指令
`essentials.fly`	使用 /fly 指令
`essentials.*`	所有 EssentialsX 權限

WorldEdit / WorldGuard 權限

權限節點	功能說明
`worldedit.wand`	使用選取工具
`worldedit.selection.*`	所有選取相關指令
`worldguard.region.claim`	宣告領地

如何找到權限節點？

查閱插件官方文件
在控制台觀察玩家執行指令時缺少的權限訊息
使用 /lp verbose on 追蹤權限檢查

常見問題排解

權限設好了但沒有生效？

可能原因	解決方法
玩家需要重新登入	讓玩家重新加入伺服器
權限節點打錯	檢查拼寫，使用網頁編輯器
OP 權限覆蓋	OP 預設擁有所有權限，移除 OP 測試
權限被否定	檢查是否有 `false` 的權限覆蓋

如何查看玩家為什麼沒有權限？

使用詳細模式追蹤權限檢查：

/lp verbose on

然後讓玩家嘗試使用指令，控制台會顯示詳細的權限檢查過程。

如何備份權限資料？

權限資料存放在 plugins/LuckPerms/ 資料夾，可以直接複製整個資料夾備份。

進階功能

LuckPerms 還支援 MySQL/MariaDB 資料庫儲存，適合跨伺服器同步權限。詳細設定請參考 LuckPerms 官方文件。

LuckPerms 權限管理

目錄