LuckPerms
LuckPerms는 마인크래프트: 자바 에디션 서버에서 사용자와 그룹의 권한을 관리하는 플러그인이다. 명령 실행이나 기능 접근에 쓰이는 권한 노드를 저장하고, 그룹 상속·임시 권한·월드와 서버별 조건·접두사와 접미사 같은 메타데이터를 함께 관리한다.[1]
| 최신 버전 | luckperms.net 배포 페이지 참고 |
|---|---|
| 지원 MC | 배포 페이지의 플랫폼별 판 확인 |
| Java | 서버 코어와 동일 |
| 서버 코어 | Bukkit·Spigot·Paper, Velocity·BungeeCord, Fabric·Forge, Sponge |
| 선행 플러그인 | 없음 (경제·채팅 연동은 Vault 필요) |
| 확인일 | 2026-08-06 |
하위 문서
- LuckPerms/명령어 — 명령 전체 목록, 컨텍스트와 기간 인자
- LuckPerms/그룹 설계 — 상속 구조 설계 원칙과 흔한 실수
- LuckPerms/문제 해결 — 권한이 동작하지 않을 때의 조사 절차
- LuckPerms/데이터 이전 — 저장소 선택, 이전 절차, 네트워크 동기화
구조
권한은 사용자나 그룹에 붙는 노드로 저장되며 값은 true 또는 false이다. 사용자를 그룹에 넣으면 그 그룹과 상위 그룹의 노드를 상속받는다. 예를 들어 builder 그룹이 default를 부모로 두면 기본 이용자 권한을 유지하면서 건축 관련 권한만 더할 수 있다.[2]
컨텍스트는 같은 노드를 특정 조건에서만 유효하게 한다. world=build는 건축 월드에서만, server=hub는 프록시 네트워크의 허브 서버에서만 권한을 적용하는 식이다. 컨텍스트를 사용하지 않는 노드와 여러 상속 경로의 값이 겹치면 우선순위와 가중치, false 노드를 함께 살펴야 한다.
LuckPerms는 Bukkit 계열 서버 외에도 Velocity·BungeeCord 같은 프록시와 Fabric·Forge·Sponge 환경을 지원한다. 서버가 여러 대라면 SQL 계열 저장소나 MongoDB를 이용해 데이터를 공유하고 메시징 서비스를 통해 변경 내용을 동기화할 수 있다.[3] 프록시의 명령 별칭은 /lpb 또는 /lpv이므로 백엔드 서버의 /lp와 실행 위치를 구분해야 한다.[4]
설치와 기본 설정
서버 플랫폼에 맞는 JAR 파일을 plugins 또는 mods 폴더에 넣고 서버를 시작한다. 처음 관리 권한을 부여할 때는 권한이 없는 게임 계정에서 시도하지 말고 서버 콘솔에서 명령을 실행한다.
lp user PlayerName permission set luckperms.* true lp creategroup builder lp group builder parent add default lp group builder permission set worldedit.selection.pos true lp user PlayerName parent add builder
/lp group builder permission info는 직접 부여된 노드를, /lp user PlayerName info는 사용자의 상속 그룹과 메타데이터를 확인한다. 노드를 제거할 때는 반대 값을 덧씌우기보다 permission unset을 사용해야 원래 상속 관계로 돌아간다.[4] 일정 시간만 줄 권한은 permission settemp <node> true <duration>으로 설정할 수 있다. 명령 전체 목록은 LuckPerms/명령어 문서를 참고한다.
웹 편집기
/lp editor는 현재 그룹과 사용자를 편집할 수 있는 일회성 웹 세션을 만든다. /lp group builder editor처럼 범위를 좁힐 수도 있다. 화면에서 노드와 컨텍스트를 고친 뒤 저장하면 적용 명령이 생성되며, 그 명령을 서버에서 실행해야 실제 데이터가 바뀐다.[5]
/lp editor groups /lp applyedits <코드>
웹 편집기 주소와 적용 코드는 현재 권한 구성을 바꿀 수 있는 자료이므로 공개 채팅이나 장기간 남는 기록에 올리지 않는 것이 좋다. 대규모 변경 전에는 /lp export <파일명>으로 내보내고, 가져올 때 --replace를 붙이면 기존 데이터를 교체한다는 점을 확인해야 한다.
점검 기능
권한 노드 이름을 모를 때는 /lp tree로 서버에서 관찰된 노드를 탐색할 수 있다. 실제 명령이 어떤 권한을 검사하는지는 verbose 기능으로 추적한다.[6]
/lp verbose record PlayerName /lp verbose upload /lp verbose command PlayerName /검사할명령
record는 채팅에 모든 검사 결과를 쏟지 않고 기록하며, upload로 웹 뷰어를 연다. 필터 없이 장시간 켜면 매우 많은 권한 검사가 모일 수 있으므로 문제를 재현하는 동안만 사용한다. 값이 예상과 다르면 사용자의 직접 노드, 상속 그룹, 컨텍스트, 임시 노드의 만료 여부를 차례로 확인한다. 증상별 조사 절차는 LuckPerms/문제 해결 문서에 정리되어 있다.
메타데이터와 승급
meta setprefix와 meta setsuffix는 채팅 플러그인 등이 표시할 접두사·접미사를 저장한다. LuckPerms 자체가 채팅 형식을 바꾸는 것은 아니므로 이를 읽어 표시하는 별도 플러그인이 필요하다. 여러 그룹의 접두사가 겹치면 숫자로 지정하는 우선순위가 사용된다.
트랙은 여러 그룹을 순서대로 묶어 promote와 demote로 승급·강등할 수 있게 한다. 단순히 부모 그룹을 계속 추가하는 것보다 한 사용자가 같은 계열의 여러 등급에 동시에 남는 실수를 줄일 수 있다.[4]
같이 보기
외부 링크
각주
- ↑ LuckPerms, LuckPerms. 2026년 8월 5일 확인.
- ↑ Usage, LuckPerms. 2026년 8월 5일 확인.
- ↑ Storage types, LuckPerms. 2026년 8월 5일 확인.
- ↑ 4.0 4.1 4.2 Command Usage, LuckPerms. 2026년 8월 5일 확인.
- ↑ Web Editor, LuckPerms. 2026년 8월 5일 확인.
- ↑ Verbose, LuckPerms. 2026년 8월 5일 확인.