Minecraft 플러그인 ItemJoin

🔌 ItemJoin 소개

ItemJoin은 플레이어에게 고도로 설정 가능한 커스텀 아이템을 자동으로 지급해 주는 Minecraft 플러그인입니다. 아이템은 join, first-join, respawn, world-switch, region-enter, region-leave 같은 이벤트에서 지급할 수 있습니다. 이 플러그인은 유연한 아이템 정의(itemflags), 트리거 이벤트, 아이템에 연결된 명령에 중점을 두어, 서버가 클라이언트용 커스텀 모드 없이도 로비 메뉴, 스타터 키트, 상황에 맞는 도구를 제공할 수 있게 합니다.

🎯 목적

ItemJoin은 서버 이벤트와 월드에 연결된 커스텀 또는 인터랙티브 아이템을 플레이어에게 안정적으로 지급하는 문제를 해결합니다. 허브/로비 서버, 미니게임 서버, 월드별로 아이템 제한이 필요한 서바이벌 네트워크, 아이템 기반 메뉴나 명령 실행 아이템이 필요한 네트워크에 유용합니다.

⚙️ 기능

• join, first-join, respawn, world-switch, region-enter/exit 등 설정 가능한 트리거로 아이템 지급.
• 아이템별 itemflags로 동작 변경 가능(slot, overwrite, 스택 규칙, 이동/획득 차단, gamemode 제한, 받을 확률, 쿨다운).
• ItemCommands: 아이템에 명령을 연결하고 실행 컨텍스트(console, player, server, message)와 액션 유형(좌/우클릭, 인벤토리 클릭, 물리, 다중 클릭)을 설정 가능.
• PlaceholderAPI 연동으로 동적인 아이템 이름/lore 및 placeholder 지원.
• 커스텀 플레이어 머리(커스텀 텍스처와 소유자), 지도 이미지, tipped arrows, 책, 배너, 불꽃놀이, 가죽 갑옷 커스터마이징, 커스텀 인챈트 레벨 지원.
• 특정 월드에서 아이템 이동 또는 획득을 선택적으로 차단하고, IP 주소 또는 first-join 상태로 아이템을 제한 가능.
• 게임 내 GUI 제작기로 아이템 세트를 만들 수 있으며, 기본 import/creator 워크플로도 제공.
• 다른 플러그인을 위한 API: me.RockinChaos.itemjoin.api.ItemJoinAPI에서 제공.

🧩 대상

• 로비/허브용 자동 아이템이나 스타터 키트가 필요한 서버 운영자.
• 월드별 아이템이나 메뉴용 나침반이 필요한 미니게임 및 네트워크 운영자.
• API를 통해 연동 가능한 아이템 시스템을 원하는 개발자.

🏗️ 사용 예시

• 접속 시 메뉴 나침반을 지급하고, 클릭하면 서로 다른 명령을 실행하게 하기.
• first-join 때만 제공되는 스타터 키트를 지급하면서 지정된 월드 간 아이템 이동을 막기.
• 쿨다운과 비용이 있는 경제/상점 명령을 실행하는 인터랙티브 아이템 만들기.

⌨️ 명령어

참고: 이 명령어와 하위 명령어는 플러그인의 문서화된 명령 세트에서 가져온 것입니다. 플러그인은 위키와 생성된 도움말 출력에서 추가 하위 명령어를 제공합니다.

🔐 권한

아이템별 권한 동작은 설정할 수 있습니다. 아이템 권한 검사는 기본적으로 비활성화되어 있으며, 실제로 적용하려면 플러그인 설정에서 활성화해야 합니다.

⚙️ 설치

📥 설정

• 공식 ItemJoin jar를 다운로드하여 서버의 plugins/ 폴더에 넣으세요.
• plugins/에 ItemJoin jar 파일이 중복으로 존재하지 않는지 확인하세요(예: ItemJoin(1).jar).
• 플러그인이 설정을 생성하고 서버 버전에 맞는 기능을 등록할 수 있도록 서버를 재시작하세요.
• 플러그인 로드 확인을 위해 서버 콘솔 로그를 확인하고, 자세한 설정은 플러그인 위키를 참고하세요.

📦 의존성

이 플러그인에는 필수 런타임 요구사항은 없지만, 일반적인 소프트 의존성과 연동 기능이 여러 가지 있습니다(존재할 때 선택적으로 활성화됨):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

필요에 따라 연동을 활성화하거나 설정하세요. 플러그인은 이것들이 없어도 동작하지만, placeholders, 커스텀 머리/스킨, 경제 훅 같은 기능은 해당 플러그인에 의존합니다.

🧠 기술 노트

• 플랫폼: Spigot 계열 서버에서 확인됨(Spigot, Bukkit, Paper, Purpur, Folia).
• 지원/테스트된 Minecraft 범위: 1.8부터 1.21까지.
• 소스 코드와 릴리스가 공개되어 있으며, 프로젝트는 다른 플러그인이 연동할 수 있도록 me.RockinChaos.itemjoin.api.ItemJoinAPI API를 제공합니다.
• 라이선스: LGPL-3.0.

🤝 이 플러그인이 유용한 경우

플레이어에게 상황에 맞는 인터랙티브 아이템(메뉴, 스타터 키트, 월드별 도구)을 유연하고 설정 가능하게 제공하는 시스템이 필요하고, 연동용 API도 원한다면 ItemJoin이 일반적인 placeholder 및 스킨 플러그인을 지원하면서 그 기능을 제공합니다.