안녕하세요!

사망 시 인벤토리/경험치 손실을 세밀하게 제어하고, 아이템 도난까지 막아주는

InvKeeper 플러그인을 소개합니다. 😊

"죽으면 다 잃는 하드코어 서버"와 "아무것도 안 잃는 캐주얼 서버" 사이에서

고민하셨다면, 이 플러그인 하나로 월드별·등급별로 원하는 만큼만 잃게 만들 수 있습니다.

✅ Paper 1.21 이상 지원

✅ Java 21 이상

✅ MMOItems 연동 지원 (선택)

✅ MIT 라이선스 (무료 / 상업 서버 사용 가능)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 1. 이런 분들께 추천합니다

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▶ 죽으면 아이템이 흩어져서 유저들이 스트레스받는 서버

▶ 후원/등급별로 사망 페널티를 다르게 주고 싶은 서버

▶ 지급한 아이템이 되팔이·현금거래로 도는 걸 막고 싶은 서버

▶ 네더/엔드만 페널티를 높여 위험도를 차등하고 싶은 서버

▶ 무덤(Grave) 플러그인과 인벤토리 보호 플러그인을 따로 쓰기 번거로운 서버

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 2. 주요 기능

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▣ 인벤토리 보호권 (2종)

  ● 소모형 보호권

     - 그냥 소지만 하고 있으면 됩니다.

     - 사망하는 순간 자동으로 1개 소모되고 인벤토리 + 경험치를 완전 보호합니다.

  ● 시간형 보호권

     - 우클릭으로 사용하면 설정한 시간(기본 30분) 동안 보호 상태가 됩니다.

     - 5분 전 / 1분 전 자동 알림이 나갑니다.

     - 시간 만료 또는 서버 재시작 시 자동 해제됩니다.

▣ 영혼각인 (Soulbind) - 아이템 도난/현거래 방지

  아이템에 "주인"을 새겨넣는 기능입니다.

  각인된 아이템은 주인 외에는 아예 손댈 수 없습니다.

  ● 타인은 줍기 불가 (안내 메시지 출력)

  ● 타인이 Shift-클릭으로 옮기려 하면 강제 드랍

  ● 호퍼 / 드로퍼 / 광산수레 등 자동 이동도 전부 차단

  ● 시간형 각인 : 설정한 시간이 지나면 자동으로 각인 해제

  ● 스택형 각인 : 사망할 때마다 횟수 1 차감, 0이 되면 해제

     (예: 3스택 = 3번 죽을 때까지 그 아이템은 안 잃습니다)

  ※ 아이템 로어에 각인 주인과 만료시간/남은 횟수가 실시간 표시됩니다.

▣ 각인 도구 (3종)

  ● 시간형 각인기  : 아이템 위에 드래그-드랍 → 시간 기반 각인 적용

  ● 스택형 각인기  : 아이템 위에 드래그-드랍 → 횟수 기반 각인 적용

  ● 각인 해제 도구 : 각인된 아이템의 각인을 해제

  ※ 시간형과 스택형은 한 아이템에 동시에 적용되지 않습니다.

     (다른 타입을 덮어씌우려 하면 거부 메시지가 출력됩니다)

▣ 무덤(Grave) 시스템 ★ v1.4.0 신규

  사망 시 잃는 아이템을 바닥에 흩뿌리지 않고, 사망 지점에 무덤(기본: 통)을 만들어 보관합니다.

  ● 가상 GUI로 열림

     - 실제 통 인벤토리가 아니라 플러그인이 관리하는 가상 GUI입니다.

     - 장비 4칸 / 왼손 1칸 / 인벤토리 36칸이 원래 슬롯 그대로 표시됩니다.

     - 남은 경험치는 경험치병 아이콘으로 표시, 클릭하면 회수됩니다.

     - "모두 회수" 버튼으로 한 번에 전량 회수 (회수 완료 시 GUI 자동 닫힘)

  ● 도굴 시스템

     - 남의 무덤은 기본적으로 열 수 없습니다.

     - 도굴 도구를 들고 우클릭 → 일정 시간(기본 300초) 시전해야 열립니다.

     - 시전 도중 무덤 주인이 무덤을 열면 도굴이 즉시 취소되고,

       도굴꾼과 주인 양쪽에 안내 메시지가 갑니다.

     - 시전 상태는 서버를 재시작해도 남은 시간 그대로 이어집니다.

  ● 홀로그램 내장

     - 무덤 위에 소유자 / 남은 시간 / 도굴 상태가 실시간 표시됩니다.

     - 별도 홀로그램 플러그인이 필요 없습니다. (TextDisplay 사용)

     - 서버 재시작 시에도 중복 없이 자동 재생성됩니다.

  ● 만료 설정

     - 일정 시간이 지나면 무덤이 자동 소멸하도록 설정할 수 있습니다. (기본 1시간)

     - 등급 권한별로 만료 시간을 다르게 줄 수 있습니다. (VIP 2시간, VVIP 무제한 등)

     - 플레이어당 무덤 최대 개수 제한도 가능합니다. (기본 5개)

  ● 무덤 보호

     - 무덤 블록 파괴 / 폭발 / 피스톤 / 호퍼 흡입 전부 방지 옵션 제공

  ● 히스토리 (관리자용)

     - 무덤이 사라질 때(회수/도굴/만료) 사망 시점 원본 스냅샷이 기록됩니다.

     - 관리자는 명령어로 조회 후,

       좌클릭 → 해당 무덤 위치로 텔레포트

       우클릭 → 그 당시 상태 그대로의 가상 GUI를 열어 아이템 회수

     - 회수됨(노랑) / 도굴됨(빨강) / 미회수(연두)로 색유리판 구분 표시

▣ 월드별 / 권한별 드랍율

  ● 월드별로 인벤토리/경험치 드랍 퍼센트를 각각 설정할 수 있습니다.

     예) 일반 월드 50% / 네더 70% / 엔드 100%

  ● 권한별 등급 11단계(invkeeper.drop.1 ~ 11)를 기본 제공합니다.

     등급이 높을수록 잃는 양이 줄어듭니다.

  ● 우선순위(priority) 방식이라 여러 등급을 가진 유저도 꼬이지 않습니다.

  ● 무덤을 켜도 이 드랍율 설정은 그대로 적용됩니다.

     ("얼마나 잃는지"는 그대로, 잃는 몫이 바닥 대신 무덤에 담깁니다)

▣ MMOItems 연동

  ● 보호권과 각인 도구를 MMOItems 아이템으로도 지정할 수 있습니다.

  ● 리플렉션 기반이라 다양한 MMOItems 버전과 호환됩니다.

  ● MMOItems가 없어도 바닐라 아이템만으로 문제없이 동작합니다.

▣ 성능 최적화

  ● 무덤 관련 디스크 저장(생성/회수/도굴/히스토리)은 전부 비동기 처리됩니다.

     → 사망이나 무덤 상호작용이 서버 TPS/MSPT에 영향을 주지 않습니다.

  ● 각인 만료 검사도 접속자를 배치로 나눠 순환 검사합니다.

     → 동접 인원에 맞게 config에서 부하 분산 정도를 조절할 수 있습니다.

        (~20명: 1 / ~100명: 5 / ~500명: 15~20 권장)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 3. 명령어

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

별칭은 /ik 입니다. (예: /ik status)

  /invkeeper status

     → 현재 적용 중인 드랍율과 시간제 보호 상태 확인

     → 권한: invkeeper.status

  /invkeeper reload

     → 설정 파일 다시 불러오기

     → 권한: invkeeper.admin

  /invkeeper give <플레이어> <아이템> [개수]

     → 보호 아이템 지급

     → 권한: invkeeper.admin

  /invkeeper soulbind inspect <플레이어>

     → 대상 플레이어의 각인 아이템 목록 확인

     → 권한: invkeeper.admin

  /invkeeper soulbind unbind <플레이어> [슬롯|all]

     → 특정 슬롯 또는 전체 인벤토리 각인 강제 해제

     → 권한: invkeeper.admin

  /invkeeper grave list

     → 서버 내 활성 무덤 목록 확인 (페이지 지원)

     → 권한: invkeeper.grave.admin

  /invkeeper grave history <플레이어>

     → 대상 플레이어의 무덤 이력 조회

       (좌클릭: 텔레포트 / 우클릭: 당시 상태 가상 GUI)

     → 권한: invkeeper.grave.admin

  /invkeeper grave reload

     → 무덤 설정 재로드 및 홀로그램 재동기화

     → 권한: invkeeper.grave.admin

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 4. 권한 목록

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  invkeeper.status

     - 자신의 보호 상태 확인

  invkeeper.admin

     - 모든 관리자 명령어 사용 및 각인 우회

  invkeeper.soulbind.bypass

     - 타인의 각인 아이템도 자유롭게 취급 가능

  invkeeper.drop.1 ~ invkeeper.drop.11

     - 등급별 사망 드랍 규칙 적용 (숫자가 클수록 우선순위 높음 / 덜 잃음)

  invkeeper.grave.admin

     - 무덤 관리 명령어 사용 (list / history / reload)

  invkeeper.grave.bypass

     - 도굴 도구 없이 타인의 무덤 강제 열람 (진행 중인 도굴은 취소시킴)

  invkeeper.grave.time.vip / invkeeper.grave.time.vvip

     - 무덤 만료 시간 등급

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 5. 설정 파일

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

최초 로드 시 plugins/InvKeeper/ 폴더에 아래 4개 파일이 생성됩니다.

  ● config.yml    - 드랍율(월드/권한), 무덤 시스템, 타임존, 성능 옵션

  ● items.yml     - 보호권 / 각인 도구 / 도굴 도구 아이템 정의

  ● messages.yml  - 모든 안내 메시지 (색코드 & 플레이스홀더 지원)

  ● gui.yml       - 무덤 GUI 제목, 버튼, 아이콘, 회수 상태 문구

모든 항목에 상세한 한글 주석이 달려 있어서 바로 읽고 수정하실 수 있습니다.

▶ 설정 예시 (config.yml - 월드별 드랍율)

rules:

  world:

    default:        { inventory-drop-percent: 0,   exp-drop-percent: 0 }

    world:          { inventory-drop-percent: 50,  exp-drop-percent: 50 }

    world_nether:   { inventory-drop-percent: 70,  exp-drop-percent: 70 }

    world_the_end:  { inventory-drop-percent: 100, exp-drop-percent: 100 }

  (0 = 완전 보호, 100 = 전부 드랍)

▶ 설정 예시 (config.yml - 무덤)

grave:

  enabled: true

  container: { type: VANILLA, vanilla-material: BARREL }

  max-graves-per-player: 5

  expire:

    enabled: true

    default-seconds: 3600

  hologram: { enabled: true, offset-y: 1.0, update-interval-ticks: 20 }

  protection: { prevent-block-break: true, prevent-explosion: true,

                prevent-piston: true, prevent-hopper: true }

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 6. 설치 방법

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1) 아래 릴리스 페이지에서 최신 JAR 파일을 다운로드합니다.

  2) 서버의 plugins 폴더에 넣습니다.

  3) 서버를 재시작하면 plugins/InvKeeper/ 폴더에 설정 파일이 생성됩니다.

  4) items.yml, messages.yml, config.yml을 서버에 맞게 수정합니다.

  5) /invkeeper reload 로 설정을 적용합니다.

  ※ keepInventory 게임룰은 인벤토리 복제 버그 방지를 위해

     기본적으로 false로 강제 고정됩니다. (config에서 끌 수 있습니다)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 7. 다운로드

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ▶ 릴리스(다운로드) : https://github.com/qlqo0001-beep/InvKeeper/releases

  ▶ 현재 버전 : v1.4.2

  ▶ 라이선스 : MIT (무료 사용 / 수정 / 상업 서버 사용 가능)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 8. 업데이트 내역

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ● v1.4.2

     - 사망 / 무덤 열람 / 히스토리 조회 시 TPS·MSPT가 흔들리던 원인

       (메인 스레드 동기 디스크 I/O)을 비동기 처리로 해결

     - 서버 재시작 후 무덤 홀로그램이 겹쳐 보이던 문제 수정

     - 도굴 취소 시 무덤 주인에게 알림이 가지 않던 문제 수정

     - 도굴 도구 로어의 {duration} 이 표시되지 않던 문제 수정

  ● v1.4.1

     - "모두 회수" 클릭 시 GUI가 닫히지 않던 문제 수정

     - 도굴 중 주인이 무덤을 열어도 취소되지 않던 문제 수정

     - 서버 재시작 시 무덤 데이터가 유실되던 문제 수정

     - 어드민 히스토리 GUI의 좌/우클릭이 동작하지 않던 문제 수정

  ● v1.4.0

     - 무덤(Grave) 시스템 최초 추가

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 9. 문의 / 버그 제보

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

사용 중 버그를 발견하시거나 추가되었으면 하는 기능이 있다면

댓글로 남겨주세요. 확인하는 대로 반영하겠습니다. 🙏

읽어주셔서 감사합니다!

#마인크래프트플러그인 #InvKeeper #인벤토리보호 #무덤플러그인 #Grave

#소울바인드 #영혼각인 #Paper1_21 #마크서버 #플러그인배포 #MMOItems