플러그인으로 커스텀 아이템 만드는 법

단계별 안내

1. 1.아이템 목록 정리하기

   아이템마다 기본 재료, 표시 이름, 설명 줄, 하는 일을 적으세요. "우클릭하면 화염구를 쏘고 쿨다운이 5초인 Fire Wand라는 블레이즈 막대"면 완전한 아이템 설명이에요.

2. 2.PersistentDataContainer로 태그 붙이기

   fire_wand 같은 ID를 NamespacedKey와 함께 아이템의 PersistentDataContainer에 저장하세요. 플러그인은 이름이 아니라 이 태그로 아이템을 알아보므로, 모루에서 이름을 바꿔도 복제품이 생기지 않아요.

3. 3.능력 작성하기

   능력 하나하나가 이벤트 리스너예요. 우클릭은 PlayerInteractEvent, 타격은 EntityDamageByEntityEvent, 도구는 BlockBreakEvent. 플레이어별, 아이템별 쿨다운을 추가하세요.

4. 4.플레이어가 아이템을 얻는 방법 정하기

   관리자 /give 명령어, 조합법, 상점, 몹 드롭, 상자 보상.

5. 5.모든 걸 설정 가능하게 만들기

   이름, 설명, 피해량, 쿨다운, 조합법을 config.yml에 넣으면 새로 빌드하지 않고도 아이템 밸런스를 조정할 수 있어요.

6. 6.빌드하고 모든 아이템 써 보기

   Codexe가 플러그인을 컴파일하게 하고, 지금 체험하기로 테스트 서버에 접속한 다음, 아이템을 하나씩 받아서 써 보세요.

이름이 아니라 태그를 쓰는 이유

표시 이름이나 설명을 확인하는 건 대표적인 실수예요. 모루만 있으면 어떤 플레이어든 막대기 이름을 "Fire Wand"로 바꿀 수 있거든요. PersistentDataContainer(Minecraft 1.14 이상)는 플레이어가 수정할 수 없는 데이터를 아이템에 저장하고, 아이템의 일부라서 재시작, 상자 보관, 거래 후에도 그대로 남아요.

1.8~1.13에는 PersistentDataContainer가 없어서 플러그인이 라이브러리를 통한 NBT나 숨겨진 설명 표식을 써요. 요청에 버전을 적으면 Codexe가 그 버전에서 지원하는 방식으로 작성해요.

능력과 그 뒤의 이벤트

텍스처와 모델

플러그인은 아이템이 하는 일을 바꾸지, 생김새를 바꾸지는 않아요. 독자적인 모습을 주려면 플레이어가 내려받는 리소스 팩이 필요해요. 예전 버전에서는 아이템에 CustomModelData 번호를 붙이고 팩이 그 번호를 모델에 연결하며, 1.21.2부터는 item_model 컴포넌트로 아이템이 자기 모델을 직접 가리킬 수도 있어요. 팩이 없으면 아이템은 커스텀 이름이 붙은 기본 재료처럼 보이는데, 많은 서버에서는 그걸로 충분해요.

설명 예시

"MagicItems라는 Paper 1.21.4 플러그인. 아이템 세 개, 각각 PersistentDataContainer ID로 태그: Fire Wand(블레이즈 막대, 우클릭하면 화염구 발사, 쿨다운 5초), Frost Blade(철 검, 타격하면 3초간 구속 II), Miner's Pick(다이아몬드 곡괭이, 3x3으로 부수지만 플레이어가 건축할 수 없는 WorldGuard 구역에서는 안 됨). magicitems.admin용 /mi give <player> <item>. 각각 모양 있는 조합법. 이름, 설명, 쿨다운, 조합법은 config.yml에."

질문