NBT-API(Item-NBT-API)는 Minecraft 플러그인 라이브러리로, 개발자가 NMS를 사용하지 않고도 아이템, 엔티티, tile entities에 NBT 태그를 읽고 쓰고 추가할 수 있게 해줍니다. 이 프로젝트는 서버 버전 전반에서 NBT를 다룰 수 있는 안정적인 래퍼를 제공하며, NBT 데이터를 직렬화하고 영구 저장하기 위한 유틸리티도 제공합니다.

🎯 목적

Named Binary Tag(NBT) 데이터를 조작할 수 있는 개발자용 API를 제공하여, 플러그인 제작자가 서버 내부 구현에 직접 의존하지 않고도 메타데이터, 커스텀 아이템 데이터, 엔티티 태그 또는 tile entities 데이터를 저장할 수 있게 하는 것입니다.

⚙️ 기능

아이템, 엔티티, tile entities의 NBT를 읽고 쓸 수 있습니다.
중첩된 NBT compound와 기본 태그 타입을 생성하고 수정할 수 있습니다.
NBT를 텍스트나 다른 컨테이너에 저장하는 유틸리티를 제공합니다.
NBT를 파일이나 문자열로 직렬화하여 YAML/JSON/SQL/Redis에 저장할 수 있습니다.
서버 버전 변경 전반에 걸쳐 안정적인 추상화 계층을 제공하는 것을 목표로 합니다.

🧩 대상

NMS를 직접 작성하지 않고도 신뢰할 수 있는 NBT 접근이 필요한 플러그인 개발자.
플러그인이 관리하는 커스텀 아이템 메타데이터나 영구적인 엔티티/tile data가 필요한 서버.

🏗️ 사용 예시

저장 후에도 유지되는 아이템 스택에 커스텀 메타데이터를 추가합니다.
서버 코드를 변경하지 않고 엔티티에 추가 속성(예: 커스텀 식별자)을 저장합니다.
나중에 복원할 수 있도록 아이템이나 블록의 NBT를 데이터베이스나 설정 파일로 직렬화합니다.

⚙️ 설치

📥 설정

공식 플러그인 JAR를 다운로드하고/또는 빌드 시스템에 API를 의존성으로 추가합니다.
플러그인 JAR를 서버의 plugins/ 디렉터리에 넣거나(플러그인 빌드를 사용하는 경우), 플러그인에 API를 compile/runtime 의존성으로 추가합니다.
서버를 재시작하고 서버 콘솔에서 라이브러리/플러그인이 올바르게 로드되었는지 확인합니다.

🧠 기술 노트

이 프로젝트는 GitHub에서 공개 및 유지 관리되며 MIT 라이선스로 배포됩니다.
공식 자료에서는 Bukkit/Spigot/Paper 서버 환경 지원을 안내합니다.
이 라이브러리는 플러그인 프로젝트에서 직접 사용할 수 있는 모듈과 서버용 플러그인 모듈을 포함합니다.

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

NMS를 건드리지 않고 아이템, 엔티티 또는 tile entities의 NBT에 대해 신뢰할 수 있고 버전 변화에 강한 접근이 필요하다면, NBT-API는 플러그인 개발자를 위해 해당 데이터를 읽고 쓰고 영구 저장하는 작업을 단순하게 해주는 집중형 라이브러리를 제공합니다.

NBTAPI 플러그인 서버