Java Edition 리소스팩, Blockbench 모델, GeckoLib, ItemsAdder, ModelEngine 계열 자산을 Minecraft Bedrock RP/BP 초안으로 변환하는 결정적 변환 도구다. 사람과 AI가 같은 검사 결과, 실행 계획, 진단 코드와 결과 파일을 사용하도록 설계했다.
- 폴더, ZIP, MCPACK 입력과 안전한 압축 해제
- Java RP 자산 분류와 참조 그래프 생성
- item/terrain atlas, mcmeta flipbook, Java sound 변환
- LabPBR 보조 맵 분석과 Bedrock MER 후보·texture_set 생성
- Java 모델 parent, texture variable, elements, UV, display, overrides 해석
- 복합 아이템 모델의 geometry·attachable·컨트롤러 자동 생성
- 최신 Java item definition과 blockstate variants/multipart 해석
.bbmodel,.iaentitymodel, GeckoLib geometry·animation 변환- linear, catmullrom, pre/post, Molang, sound·particle timeline 보존
- ItemsAdder·ModelEngine 특수 본과 hitbox·seat·locator 분리
- ItemsAdder·MythicMobs·ModelEngine YAML 런타임 IR 생성
- OptiFine CIT 조건 IR과 Geyser custom item mappings v2 생성
- RP/BP 구조·참조 검증과 결정적 MCPACK·MCADDON 패키징
- Blockbench 진단·피벗 보정 플러그인
- 파일·폴더 선택이 가능한 원클릭 로컬 UI
npm run desktop
열린 화면에서 입력 파일 또는 폴더, 작업 폴더, 팩 이름과 namespace를 선택한다. 입력 분석 계획을 확인한 뒤 변환을 실행할 수 있고, j2b.project.json을 다시 열어 이전 작업을 재개하거나 결과 폴더를 열 수 있다. UI와 CLI는 같은 JobSpec과 입력·계획 해시를 사용한다.
java-to-bedrock inspect <입력> --json
java-to-bedrock plan <입력> --workspace <작업 폴더> --target native-addon --json
java-to-bedrock apply <작업 폴더>/j2b.plan.json --json
java-to-bedrock validate <작업 폴더>/output --json
java-to-bedrock package <작업 폴더>/output --json
직접 변환:
java-to-bedrock convert --input <입력> --output <출력> --name <팩 이름> --namespace <namespace>
단일 모델 변환:
java-to-bedrock model convert --input <model.bbmodel> --output <BedrockRP> --mode pack --kind entity
Blockbench 패치 적용:
java-to-bedrock patch-model --input <model.bbmodel> --patch <patch.json> --output <fixed.bbmodel>
blockbench-plugin/java_to_bedrock.js를 Blockbench 플러그인으로 불러온다. 변환 결과의 analysis/*.model-semantics.json을 열면 경고·오류 본을 선택할 수 있고, 수정한 피벗·회전·display transform을 UUID 기반 패치로 내보낼 수 있다.
| 경로 | 내용 |
|---|---|
<name>_RP |
Bedrock 리소스팩 |
<name>_BP |
Bedrock 행동팩 |
<name>.mcaddon |
검증된 배포 패키지 |
analysis/java-model-ir.json |
Java 모델 상속·UV·display IR |
analysis/plugin-runtime-ir.json |
Java 플러그인 런타임 의미 IR |
analysis/*.model-semantics.json |
특수 본·hitbox·locator 진단 |
manual-report.json |
수동 연결이 필요한 항목 |
j2b.plan.json |
해시가 포함된 결정적 실행 계획 |
j2b.result.json |
구조화된 변환·검증 결과 |
ModelEngine과 ItemsAdder의 hitbox 본은 시각 geometry가 아니다. 변환기는 입력 프로필을 판별해 충돌·좌석·제어·locator 본을 렌더 대상에서 분리하고 역할과 크기를 런타임 IR에 남긴다. 일반 Blockbench 모델에는 플러그인 전용 이름 규칙을 강제로 적용하지 않는다.
반복 애니메이션이 여러 개면 idle을 우선하여 기본 애니메이션 하나만 client entity에서 자동 실행한다. opening, attack 같은 일회성 애니메이션과 Java 플러그인 스킬은 BP, Script API 또는 PMMP에서 트리거해야 하며 필요한 연결 정보가 보고서에 기록된다.
자동 검증은 JavaScript 구문, 통합 변환, Go 스캐너, 공급자 샘플, 출력 참조, 결정적 패키징을 확인한다. 생성 성공은 실제 Bedrock 클라이언트 렌더링의 완전한 동등성을 의미하지 않으며, 런타임 정보가 부족한 항목은 보고서에 남긴다.
프로젝트 코드는 MIT다. data와 vendor의 외부 자료는 각 원저작자의 라이선스가 우선 적용된다.