InvKeeper.jar 

# ✨ InvKeeper - 서버 인벤토리 보호의 완벽한 솔루션

안녕하세요! 사망 시 인벤토리와 경험치를 세밀하게 제어할 수 있는 Paper 1.21 플러그인 **InvKeeper**를 소개합니다.

---

## 📌 주요 기능

### 1. 맞춤형 드랍 보호 시스템

- **월드별 설정**: 각 월드마다 인벤토리/경험치 손실률을 다르게 설정 가능

  - 예: 평화로운 마을 월드는 0%, 위험한 던전은 50% 드랍

- **권한별 등급 시스템**: `invkeeper.1` ~ `invkeeper.11`까지 11단계 권한으로 서버 등급별 차등 적용

  - 일반 유저 → `invkeeper.1` (기본 드랍률)

  - VIP → `invkeeper.5` (50% 감소)

  - 관리자 → `invkeeper.11` (완전 보호)

- **보호 아이템**: 소모성 아이템으로 인벤토리 100% 보호

- **시간제 보호권**: 일정 시간 동안 자동으로 인벤토리 보호

### 2. 영혼 각인 (Soulbind) 시스템

- **아이템 귀속**: 플레이어만 아이템을 사용할 수 있도록 귀속

- **3가지 각인 타입**:

  - ⏰ **시간형 각인**: 일정 시간 후 자동 해제

  - 🔢 **횟수형 각인**: 사용 횟수만큼만 유지 (사망 시 차감)

  - ♾️ **무한 각인**: 영구적으로 귀속

- **각인 해제 도구**: 관리자가 각인을 제거할 수 있는 도구 제공

- **자동 보호**: 귀속된 아이템은 타인이 줍거나 이동할 수 없음

- **로어 표시**: 아이템에 각인 정보가 자동으로 표시됨

### 3. MMOItems 완벽 연동

- MMOItems 아이템도 보호 및 각인 가능

- 커스텀 아이템을 보호 아이템으로 등록 가능

- 각인 도구도 MMOItems로 제작 가능

### 4. 편의 기능

- **bStats 통합**: 서버 사용량 통계 자동 수집

- **탭 자동완성**: 명령어 권한별로 필터링된 탭 완성 지원

- **실시간 알림**: 사망 시 실제 손실 비율 표시

- **한글화**: 완전 한글 지원

---

## 🎯 이런 서버에 추천합니다!

✅ **야생/RPG 서버** - 사망 패널티를 유연하게 조절하고 싶은 경우  

✅ **PVP 서버** - 전리품 보호와 귀속 시스템이 필요한 경우  

✅ **MMOItems 서버** - MMOItems와 연동되는 보호 시스템이 필요한 경우  

✅ **경제 서버** - 각인 도구를 경제 아이템으로 활용하고 싶은 경우  

✅ **하드코어 서버** - 사망 시 인벤토리 손실을 세밀하게 조절하고 싶은 경우

---

## 📋 명령어

```

/invkeeper status     - 내 보호 상태 확인

/invkeeper reload     - 설정 리로드 (관리자)

/invkeeper give       - 아이템 지급 (관리자)

/invkeeper soulbind   - 각인 관리 (관리자)

```

**별칭**: `/ik` (예: `/ik status`)

---

## 🔐 권한 시스템

### 기본 권한

- `invkeeper.status` - 자신의 보호 상태 확인 (기본: true)

- `invkeeper.admin` - 관리자 권한 (기본: op)

### 드랍 규칙 등급 (11단계)

- `invkeeper.drop.1` ~ `invkeeper.drop.11` - 서버 등급별 드랍 규칙 적용

  - 숫자가 높을수록 더 많은 보호 (11 = 완전 보호)

  - config.yml에서 각 등급별 드랍률 설정 가능

### 각인 권한

- `invkeeper.soulbind.bypass` - 각인 아이템 무시하고 획득 가능 (기본: false)

---

## ⚙️ 설정 예시

### config.yml

```yaml

rules:

  world:

    default:

      inventory-drop-percent: 50

      exp-drop-percent: 50

    spawn:

      inventory-drop-percent: 0

      exp-drop-percent: 0

  permissions:

    - permission: invkeeper.11

      priority: 100

      inventory-drop-percent: 0

      exp-drop-percent: 0

    - permission: invkeeper.5

      priority: 50

      inventory-drop-percent: 20

      exp-drop-percent: 20

```

### 권한 부여 예시

```

# 일반 유저

/ lp user <player> permission set invkeeper.1

# VIP

/ lp user <player> permission set invkeeper.5

# 관리자

/ lp user <player> permission set invkeeper.11

```

---

## 📦 설치 방법

1. Paper 1.21.x 서버 준비

2. `InvKeeper-1.3.5-shaded.jar` 다운로드

3. 서버의 `plugins` 폴더에 넣기

4. 서버 재시작

5. `plugins/InvKeeper/` 폴더에 생성된 설정 파일 수정

6. `/invkeeper reload`로 설정 적용

---

## 🔗 다운로드

- **현재 버전**: v1.3.5

- **호환 버전**: Paper 1.21.x

- **Java 버전**: Java 21

- **필수 의존성**: Paper API

- **선택 의존성**: MMOItems 6.9.5+, MythicLib 1.6.2+

---

## 📊 버전 정보

- **v1.3.5** (2026-07-26) - 탭 자동완성 권한 필터링

- **v1.3.4** (2026-07-26) - bStats 통합, 리로드 요약 로그, 아이템 이름 표시

- **v1.3.3** (2026-07-25) - 스택형 각인 사망 시 보호 버그 수정

- **v1.3.1** (2026-07-25) - 스택형 각인 보호 로직 개선

---

## 💡 문의 및 지원

- **GitHub**: https://github.com/qlqo0001-beep/InvKeeper

- **Issues**: 버그 리포트 및 기능 제안

- **License**: MIT License

---

## 🌟 특징 요약

✓ Paper 1.21.x 최신 버전 지원  

✓ 완전 한글화  

✓ MMOItems 연동  

✓ 11단계 권한 등급 시스템  

✓ 시간형/횟수형/무한 각인 지원  

✓ 월드별/권한별 세밀한 설정  

✓ bStats 메트릭스  

✓ 활발한 유지보수 및 버그 수정  

---

**InvKeeper로 당신의 서버를 더욱 특별하게 만들어보세요!** 🚀

---

*이 플러그인은 Paper API를 사용하며, MMOItems와의 연동을 지원합니다.*