LuckPerms
LuckPerms는 마인크래프트 서버를 위한 권한 관리 플러그인으로, 플레이어가 사용할 수 있는 기능을 그룹과 권한을 통해 제어할 수 있게 해준다. lucko가 개발했으며, 성능과 확장성을 염두에 두고 설계되어 수천 개의 서버와 대규모 네트워크에서 신뢰받고 있다. 기존의 오래된 권한 플러그인들과 달리 지속적으로 업데이트되고 있으며, 웹 에디터를 통한 직관적인 관리가 특징이다.
주요 특징
- 뛰어난 성능: 대규모 서버를 위한 최적화
- 웹 에디터: 브라우저에서 권한을 시각적으로 관리
- 다양한 저장소 지원: MySQL, MariaDB, PostgreSQL, SQLite, H2, MongoDB
- 컨텍스트 시스템: 월드, 서버별 권한 설정
- 상속 시스템: 그룹 간 권한 상속
- 임시 권한: 시간 제한이 있는 권한 부여
- 메타데이터: 접두사, 접미사, 기타 데이터 저장
- Vault 호환: 기존 플러그인과의 호환성
지원 플랫폼
- Bukkit/Spigot/Paper: 일반 서버
- BungeeCord/Waterfall: 프록시 서버
- Velocity: 현대적 프록시
- Fabric: 모드 서버
- Forge/NeoForge: 모드 서버
- Sponge: 하이브리드 서버
- Nukkit: 베드락 에디션 서버
설치 방법
- 공식 웹사이트에서 서버 타입에 맞는 버전 다운로드
- plugins (또는 mods) 폴더에 JAR 파일 넣기
- 서버 재시작
- 자동으로 기본 설정 생성
기본 명령어
그룹 관리
| 명령어 | 설명 |
|---|---|
| /lp group <그룹> create | 새 그룹 생성 |
| /lp group <그룹> delete | 그룹 삭제 |
| /lp group <그룹> info | 그룹 정보 확인 |
| /lp group <그룹> permission set <권한> | 권한 추가 |
| /lp group <그룹> parent add <부모> | 부모 그룹 설정 |
| /lp listgroups | 모든 그룹 목록 |
사용자 관리
| 명령어 | 설명 |
|---|---|
| /lp user <플레이어> info | 사용자 정보 확인 |
| /lp user <플레이어> permission set <권한> | 권한 부여 |
| /lp user <플레이어> parent add <그룹> | 그룹에 추가 |
| /lp user <플레이어> parent remove <그룹> | 그룹에서 제거 |
| /lp user <플레이어> clear | 모든 권한 제거 |
웹 에디터
| 명령어 | 설명 |
|---|---|
| /lp editor | 웹 에디터 열기 |
| /lp editor <대상> | 특정 대상 편집 |
권한 형식
기본 권한
- 일반 권한: plugin.command
- 와일드카드: plugin.*
- 부정 권한: -plugin.command (권한 거부)
컨텍스트 권한
# 특정 월드에서만 /lp user Steve permission set worldedit.* true world=creative # 특정 서버에서만 (BungeeCord) /lp user Steve permission set command.fly true server=lobby # 임시 권한 (1시간) /lp user Steve permission settemp fly.use true 1h
그룹 시스템
기본 그룹 구조 예시
default (기본 그룹) ├── member │ ├── vip │ │ └── vip+ │ └── builder ├── helper │ ├── moderator │ │ └── admin │ └── developer
그룹 생성 및 설정
# VIP 그룹 생성 /lp group vip create # 기본 권한 추가 /lp group vip permission set essentials.fly true /lp group vip permission set essentials.nick true # member 그룹 상속 /lp group vip parent add member # 접두사 설정 /lp group vip meta setprefix 100 "&6[VIP] " # 플레이어를 VIP 그룹에 추가 /lp user Steve parent add vip
메타데이터
접두사/접미사
# 접두사 설정 (우선순위 100) /lp group admin meta setprefix 100 "&c[Admin] " # 접미사 설정 /lp group vip meta setsuffix 50 " &7[VIP]" # 개별 사용자 접두사 /lp user Steve meta setprefix 150 "&b[Dev] "
기타 메타데이터
# 커스텀 메타 설정 /lp user Steve meta set home 5 /lp group vip meta set max-homes 3
웹 에디터 사용
1. /lp editor 명령 실행 2. 생성된 링크 클릭 3. 브라우저에서 직관적인 UI로 권한 편집 4. 변경사항 저장 (v5.3+에서는 실시간 저장 가능)
설정 파일
config.yml 주요 설정:
# 서버 이름 (네트워크에서 사용)
server: "lobby"
# 저장소 설정
storage-method: h2
# 기본 그룹
default-group: default
# 권한 체크 옵션
apply-wildcards: true
apply-regex: true
apply-shorthand: true
# 메타데이터 형식
meta-formatting:
prefix:
format: "{prefix}"
start-spacer: ""
middle-spacer: " "
end-spacer: ""
마이그레이션
다른 권한 플러그인에서 이전:
# PermissionsEx에서 이전 /lp migration permissionsex # GroupManager에서 이전 /lp migration groupmanager # 기타 지원 플러그인 # bPermissions, zPermissions, PowerRanks 등
API
개발자를 위한 API 제공:
<dependency>
<groupId>net.luckperms</groupId>
<artifactId>api</artifactId>
<version>5.4</version>
<scope>provided</scope>
</dependency>
성능 최적화 팁
- 캐싱: 기본적으로 활성화되어 있음
- 비동기 처리: 대부분의 작업이 비동기로 실행
- 데이터베이스: 대규모 네트워크에서는 MySQL/MariaDB 권장
- 벌크 편집: 웹 에디터를 통한 대량 수정 권장