Minecraft 플러그인 SkBee

🔌 SkBee 소개

SkBee는 Skript용 애드온으로, Skript 언어에 서버 내부 정보와 최신 Minecraft 기능을 스크립트 작성자에게 제공하는 다양한 요소를 확장해 줍니다. NBT, 고급 텍스트 컴포넌트, 스코어보드, 레시피, 블록 데이터, 구조물, 월드 생성, 간단한 지역/경계 작업을 위한 구문과 유틸리티를 제공하여 서버 관리자가 Java 대신 Skript로 복잡한 메커니즘을 구현할 수 있게 합니다.

🎯 목적

SkBee의 핵심 목적은 Skript 사용자가 Bukkit/Paper 서버 API와 Minecraft 내부 기능에 직접 접근할 수 있게 하는 것입니다. 이는 일반 Skript만으로는 다루기 어렵거나 불가능한 기능입니다. 아이템, 엔티티, 텍스트 서식, 월드 조작, 구조물 처리에 대해 Skript 스크립트 안에서 더 정밀한 제어가 필요한 서버 운영자와 스크립터를 위해 만들어졌습니다.

⚙️ 기능

• NBT 요소: 아이템, 타일 엔티티(blocks), 엔티티의 NBT를 가져오고/설정할 수 있음(지원되는 경우 1.8.8+까지의 구버전도 사용 가능하다고 표기됨).
• FastBoards: 깜빡임을 줄이도록 설계된 스코어보드 구현체(지원되는 경우 최신 Minecraft 버전에서 사용 가능).
• 레시피: 커스텀 레시피를 추가하고 바닐라 레시피를 제거 가능(레시피 API는 예를 들어 1.13+부터 사용 가능하다는 식으로 최신 버전 기준이 표기됨).
• BlockData: 최신 블록 상태에 대해 블록 데이터 가져오기/설정을 단순화(지원 버전에서 사용 가능).
• Structures: 게임의 구조물 시스템을 사용해 바닐라 Minecraft 구조물을 저장하고 붙여넣기.
• TextComponents: hover/click 이벤트와 아이템 호버 지원이 포함된 JSON/TextComponent 스타일 메시지를 만들고 조작.
• WorldCreator: Skript에서 노출되는 설정 옵션으로 커스텀 월드를 생성.
• Bounds: Skript에서 사용할 수 있도록 가벼운 지역 보호와 비슷한 간단한 bounds/regions 생성.
• GameEvents: Minecraft의 GameEvent 시스템과 연동(skulk 센서와 관련 메커니즘에서 사용).

🧩 대상 사용자

• Skript를 사용하며 Java 플러그인을 작성하지 않고도 더 깊은 API 접근이 필요한 서버 관리자.
• 고급 GUI, 커스텀 아이템, 구조화된 메시지, 월드/구조물 도구를 만드는 Skript 개발자.
• Survival, SMP, 커스텀 게임 서버에서 게임플레이 메커니즘을 위해 Skript를 사용하고 기능을 확장하고 싶은 사용자.

🏗️ 사용 예시

• 스크립터가 아이템 NBT를 읽고 수정하여 Skript 안에서 커스텀 아이템 동작과 속성을 구현.
• 관리자가 커스텀 제작 레시피를 만들고 원치 않는 바닐라 레시피를 Skript 문법으로 제거.
• 디자이너가 월드 생성 중이나 인게임 건축 도구에서 미리 만들어 둔 구조물을 저장하고 붙여넣기.
• hover/click 동작과 아이템 미리보기가 필요한 JSON 텍스트 컴포넌트 기반 채팅 또는 GUI 시스템.

⚙️ 설치

📥 설정

• 공식 다운로드 स्रोत에서 SkBee 플러그인 .jar를 받아 Skript와 함께 서버의 plugins/ 디렉터리에 넣습니다.
• Skript와 그 애드온이 정상적으로 로드되도록 서버를 재시작합니다.
• 서버 콘솔 로그를 확인해 SkBee가 성공적으로 로드되었고 설치된 Skript 버전을 감지했는지 확인합니다.

📦 의존성

• Skript (SkBee는 Skript용 애드온입니다. 최신 SkBee 빌드는 최신 Skript 릴리스를 필요로 하며, 정확한 요구 Skript 버전은 플러그인 릴리스 노트를 확인하세요).

🧠 기술 메모

• SkBee는 GPL-3.0 라이선스 아래 유지되는 오픈 소스 프로젝트입니다.
• 기능에 따라 버전 제한이 있을 수 있습니다. 예를 들어 NBT 처리 같은 일부 요소는 오래된 Minecraft 릴리스에 대한 호환성 메모가 있습니다(상위 문서에서는 일부 기능은 1.8.8+부터, 다른 기능은 1.13+부터 가능하다고 안내합니다).
• SkBee는 JavaDocs와 위키로 구문을 제공합니다. SkBee 기능을 사용하는 Skript 파일을 작성할 때 이 자료를 참고하세요.
• SkBee는 최신 Skript 및 Minecraft 릴리스를 지원하는 것을 목표로 합니다. 필요한 Skript 또는 Minecraft 버전은 SkBee 릴리스마다 다르므로, 다운로드하는 빌드의 릴리스 노트를 확인하세요.

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

서버 스크립팅 시스템으로 Skript를 사용하면서 NBT, 구조화된 텍스트 메시지, 커스텀 레시피, 구조물 저장/붙여넣기, 또는 Java를 작성하지 않고도 사용할 수 있는 간단한 지역 및 월드 생성 도구가 필요하다면, SkBee는 Skript만으로 구현할 수 있는 범위를 넓혀 주는 검증된 다양한 구문과 유틸리티를 제공합니다.