LuckPerms: 두 판 사이의 차이

2026년 6월 1일 (월) 14:42 기준 최신판

LuckPerms는 마인크래프트: 자바 에디션 서버에서 권한과 그룹을 관리하는 마인크래프트 플러그인이다. 서버 운영자는 LuckPerms를 이용해 플레이어, 그룹, 권한 노드, 접두사, 접미사, 월드별 권한을 관리할 수 있다. 공개 서버에서는 건축 권한, 관리자 권한, 명령어 사용 범위를 구분하기 위해 거의 필수적으로 사용된다.

주요 특징

LuckPerms의 특징은 다음과 같다.

사용자별 권한 관리
그룹 기반 권한 상속
웹 에디터 제공
월드, 서버, 시간 등 컨텍스트 기반 권한
접두사와 접미사 같은 메타데이터 관리
여러 서버 플랫폼 지원
데이터베이스 기반 저장 지원

권한 플러그인은 단순히 명령어 사용 가능 여부만 정하는 도구가 아니다. 서버의 운영 구조와 이용자 역할을 정의하는 기반이므로, 처음부터 그룹 구조를 정리해 두는 것이 좋다.

지원 플랫폼

LuckPerms는 여러 서버 플랫폼을 지원한다.

Bukkit / Spigot / Paper
BungeeCord
Velocity
Sponge
Fabric
Forge 계열 일부 환경

Java Edition 서버에서는 Paper와 함께 사용하는 경우가 많다.

설치 방법

Paper 서버 기준 설치 절차는 다음과 같다.

LuckPerms jar 파일을 다운로드한다.
서버의 `plugins` 폴더에 넣는다.
서버를 재시작한다.
생성된 `plugins/LuckPerms` 폴더와 설정 파일을 확인한다.
기본 그룹과 관리자 권한을 설정한다.

권한 설정을 마치기 전에는 일반 이용자에게 불필요한 명령어 권한이 열려 있지 않은지 확인해야 한다.

기본 명령어

LuckPerms의 기본 명령어는 `/lp`이다.

그룹 관리

/lp creategroup builder
/lp group builder permission set worldedit.selection.pos true
/lp group builder parent add default
/lp group builder meta setprefix 10 "&7[Builder] "

사용자 관리

/lp user PlayerName parent add builder
/lp user PlayerName permission set minecraft.command.teleport true
/lp user PlayerName info

웹 에디터

/lp editor
/lp applyedits <코드>

웹 에디터는 복잡한 그룹 구조를 한눈에 확인하고 수정할 수 있어 권한을 처음 구성할 때 유용하다. 다만 편집 결과를 적용하기 전에는 변경 내용을 확인해야 한다.

권한 형식

마인크래프트 서버 권한은 보통 점으로 구분된 노드 형식이다.

worldedit.selection.pos
worldguard.region.define
coreprotect.lookup

권한 값은 일반적으로 `true` 또는 `false`로 설정한다. 와일드카드 권한을 사용할 수도 있지만, 범위가 너무 넓으면 예상하지 못한 명령어가 열릴 수 있다.

/lp group admin permission set worldedit.* true

와일드카드는 관리자 그룹처럼 신뢰할 수 있는 그룹에만 제한적으로 사용하는 것이 좋다.

그룹 구조 예시

공개 서버에서는 다음과 같은 그룹 구조를 사용할 수 있다.

그룹	용도
default	신규 접속자 또는 기본 이용자
member	등록된 일반 이용자
builder	건축 권한을 가진 이용자
manager	도시 운영 또는 일부 관리 권한을 가진 이용자
admin	서버 관리자

그룹은 상속 구조를 통해 관리하는 것이 좋다. 예를 들어 `builder`가 `member`를 상속하면, `member` 권한을 다시 설정하지 않아도 된다.

컨텍스트 권한

LuckPerms는 월드, 서버, 시간 등 조건에 따라 권한을 다르게 적용할 수 있다.

예시:

/lp group builder permission set worldedit.region.set true world=build

컨텍스트 권한은 여러 월드를 운영하는 서버에서 유용하다. 예를 들어 건축 월드에서는 WorldEdit을 허용하고, 로비 월드에서는 제한하는 식으로 구성할 수 있다.

플레이시티 블록에서의 활용

플레이시티 블록 같은 도시건축 서버에서는 권한 구조가 특히 중요하다. 일반 이용자, 건축 권한 보유자, 도시 운영자, 서버 관리자 사이의 권한 범위가 분명해야 월드 편집, 지역 보호, 지도 관리, 공지 관리가 안정적으로 이루어진다.

연결되는 플러그인은 다음과 같다.

문제 해결

권한이 적용되지 않을 때는 다음을 확인한다.

사용자가 올바른 그룹에 속해 있는지
권한 노드 철자가 맞는지
`false`로 설정된 권한이 상위 그룹에서 상속되고 있지 않은지
월드 컨텍스트가 현재 월드와 맞는지
플러그인이 실제로 LuckPerms 권한을 사용하는지
서버를 재시작하거나 명령어로 설정을 다시 불러와야 하는지

권한 문제를 해결할 때는 `/lp verbose` 기능을 사용하면 어떤 권한이 검사되는지 확인할 수 있다.

같이 보기

외부 링크