LuckPerms

LuckPerms는 마인크래프트 서버를 위한 권한 관리 플러그인으로, 플레이어가 사용할 수 있는 기능을 그룹과 권한을 통해 제어할 수 있게 해준다. lucko가 개발했으며, 성능과 확장성을 염두에 두고 설계되어 수천 개의 서버와 대규모 네트워크에서 신뢰받고 있다. 기존의 오래된 권한 플러그인들과 달리 지속적으로 업데이트되고 있으며, 웹 에디터를 통한 직관적인 관리가 특징이다.

주요 특징

• 뛰어난 성능: 대규모 서버를 위한 최적화
• 웹 에디터: 브라우저에서 권한을 시각적으로 관리
• 다양한 저장소 지원: MySQL, MariaDB, PostgreSQL, SQLite, H2, MongoDB
• 컨텍스트 시스템: 월드, 서버별 권한 설정
• 상속 시스템: 그룹 간 권한 상속
• 임시 권한: 시간 제한이 있는 권한 부여
• 메타데이터: 접두사, 접미사, 기타 데이터 저장
• Vault 호환: 기존 플러그인과의 호환성

지원 플랫폼

• Bukkit/Spigot/Paper: 일반 서버
• BungeeCord/Waterfall: 프록시 서버
• Velocity: 현대적 프록시
• Fabric: 모드 서버
• Forge/NeoForge: 모드 서버
• Sponge: 하이브리드 서버
• Nukkit: 베드락 에디션 서버

설치 방법

1. 공식 웹사이트에서 서버 타입에 맞는 버전 다운로드
2. plugins (또는 mods) 폴더에 JAR 파일 넣기
3. 서버 재시작
4. 자동으로 기본 설정 생성

기본 명령어

그룹 관리

명령어	설명
/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 권장
• 벌크 편집: 웹 에디터를 통한 대량 수정 권장

같이 보기

• Vault
• EssentialsX
• 마인크래프트/플러그인

외부 링크

• 공식 웹사이트
• 위키 문서
• GitHub 저장소
• 공식 Discord
• 웹 에디터