LuckPerms 문서 원본 보기

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

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

== 지원 플랫폼 ==
* '''[[버킷(마인크래프트)|Bukkit]]/Spigot/Paper''': 일반 서버
* '''BungeeCord/Waterfall''': 프록시 서버
* '''Velocity''': 현대적 프록시
* '''Fabric''': 모드 서버
* '''Forge/NeoForge''': 모드 서버
* '''Sponge''': 하이브리드 서버
* '''Nukkit''': 베드락 에디션 서버

== 설치 방법 ==
# [https://luckperms.net/ 공식 웹사이트]에서 서버 타입에 맞는 버전 다운로드
# plugins (또는 mods) 폴더에 JAR 파일 넣기
# 서버 재시작
# 자동으로 기본 설정 생성

== 기본 명령어 ==
=== 그룹 관리 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /lp group <그룹> create || 새 그룹 생성
|-
| /lp group <그룹> delete || 그룹 삭제
|-
| /lp group <그룹> info || 그룹 정보 확인
|-
| /lp group <그룹> permission set <권한> || 권한 추가
|-
| /lp group <그룹> parent add <부모> || 부모 그룹 설정
|-
| /lp listgroups || 모든 그룹 목록
|}

=== 사용자 관리 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /lp user <플레이어> info || 사용자 정보 확인
|-
| /lp user <플레이어> permission set <권한> || 권한 부여
|-
| /lp user <플레이어> parent add <그룹> || 그룹에 추가
|-
| /lp user <플레이어> parent remove <그룹> || 그룹에서 제거
|-
| /lp user <플레이어> clear || 모든 권한 제거
|}

=== 웹 에디터 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /lp editor || 웹 에디터 열기
|-
| /lp editor <대상> || 특정 대상 편집
|}

== 권한 형식 ==
=== 기본 권한 ===
* '''일반 권한''': plugin.command
* '''와일드카드''': plugin.*
* '''부정 권한''': -plugin.command (권한 거부)

=== 컨텍스트 권한 ===
<pre>
# 특정 월드에서만
/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
</pre>

== 그룹 시스템 ==
=== 기본 그룹 구조 예시 ===
<pre>
default (기본 그룹)
  ├── member
  │   ├── vip
  │   │   └── vip+
  │   └── builder
  ├── helper
  │   ├── moderator
  │   │   └── admin
  │   └── developer
</pre>

=== 그룹 생성 및 설정 ===
<pre>
# 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
</pre>

== 메타데이터 ==
=== 접두사/접미사 ===
<pre>
# 접두사 설정 (우선순위 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] "
</pre>

=== 기타 메타데이터 ===
<pre>
# 커스텀 메타 설정
/lp user Steve meta set home 5
/lp group vip meta set max-homes 3
</pre>

== 웹 에디터 사용 ==
1. '''/lp editor''' 명령 실행
2. 생성된 링크 클릭
3. 브라우저에서 직관적인 UI로 권한 편집
4. 변경사항 저장 (v5.3+에서는 실시간 저장 가능)

== 설정 파일 ==
config.yml 주요 설정:

<pre>
# 서버 이름 (네트워크에서 사용)
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: ""
</pre>

== 마이그레이션 ==
다른 권한 플러그인에서 이전:

<pre>
# PermissionsEx에서 이전
/lp migration permissionsex

# GroupManager에서 이전
/lp migration groupmanager

# 기타 지원 플러그인
# bPermissions, zPermissions, PowerRanks 등
</pre>

== API ==
개발자를 위한 API 제공:

<pre>
<dependency>
    <groupId>net.luckperms</groupId>
    <artifactId>api</artifactId>
    <version>5.4</version>
    <scope>provided</scope>
</dependency>
</pre>

== 성능 최적화 팁 ==
* '''캐싱''': 기본적으로 활성화되어 있음
* '''비동기 처리''': 대부분의 작업이 비동기로 실행
* '''데이터베이스''': 대규모 네트워크에서는 MySQL/MariaDB 권장
* '''벌크 편집''': 웹 에디터를 통한 대량 수정 권장

== 같이 보기 ==
* [[Vault]]
* [[EssentialsX]]
* [[마인크래프트/플러그인]]

== 외부 링크 ==
* [https://luckperms.net/ 공식 웹사이트]
* [https://luckperms.net/wiki 위키 문서]
* [https://github.com/LuckPerms/LuckPerms GitHub 저장소]
* [https://discord.gg/luckperms 공식 Discord]
* [https://luckperms.net/editor 웹 에디터]

[[분류:마인크래프트]]