고급 프리셋
레거시 Java 명령 프리셋 마이그레이션
레거시 Java 명령 프리셋 마이그레이션은 이제 단순한 템플릿 기반 명령 메모가 아니라 완전한 형태의 고급 워크플로입니다. 예전부터 운영해 온 Command Pack을 레거시 Java 예제에서 현재의 NBTForge Output으로 옮겨야 한다면 이 프리셋을 사용하십시오. 이 마이그레이션은 단순한 문자열 치환이 아니라 아이템 또는 엔터티의 의도에서 출발하므로 완성된 명령을 검토하기가 한결 수월합니다. 이 문서는 설정 필드, Output 검토, Project 배치, 결과 캡처를 하나의 흐름으로 묶어, 명령이 맵 설정이나 이벤트 트리거, 재사용 가능한 Command Pack의 일부가 되기 전에 손쉽게 감사할 수 있도록 도와줍니다. 검토 화면에는 가져온 레거시 명령, 새로 구성한 최신 Output, 그리고 둘 사이의 차이가 함께 표시되어야 합니다. 바로 이 지점에서 위험한 한 줄 수정이 아니라 통제된 워크플로 형태의 문법 마이그레이션이 가능해집니다.
preset 결과
기존 Java 아이템 의도를 검토 메모와 함께 최신 컴포넌트 Output으로 옮기는 마이그레이션 워크플로입니다.
출력
레거시에서 최신 버전으로의 마이그레이션 메모
Legacy command intent: named sword with lore, sharpness, unbreakable, and custom marker.
Modern rebuild: /give @p minecraft:diamond_sword[custom_name={text:"Legacy Blade",color:"gold",italic:false},lore=[{text:"Migrated component item",color:"gray",italic:false}],enchantments={"minecraft:sharpness":5},unbreakable={},custom_data={legacy_item:1}] 1
Review: compare old NBT fields to current components before replacing the saved Project entry.The longest command line is 259 characters, 3 over the 256-character chat input limit. Pasting it into chat can truncate the line and make Minecraft report a syntax error even when the generated command is valid.
- Use a Command Block: run
/give @s command_block, place it, then paste this command into the block command field. - Use a
.mcfunctionfor a reusable datapack: save the line without the leading slash atsaves/<world>/datapacks/<pack>/data/<ns>/function/<name>.mcfunctionwith a minimalpack.mcmeta, run/reload, then run/function <ns>:<name>. Do not paste.mcfunctioncontent into chat.
preset 스크린샷
preset 만들기
- 기존 구버전 명령의 의도를 붙여넣거나 문서로 기록하십시오.
- 해당 명령 계열에 부합하는 현재의 NBTForge 모듈을 선택하십시오.
- 구조화된 필드 안에서 아이템, 엔터티 또는 데이터팩 리소스를 다시 구성하십시오.
- 레거시 NBT와 최신 Output을 Diff 도구로 나란히 비교하십시오.
- 마이그레이션이 끝난 명령을 별도의 Project 아이템으로 저장하십시오.
- 새로운 Output을 검증한 뒤에만 기존 명령을 교체하십시오.
이 고급 프리셋이 Project에 어울리는 이유
예전부터 사용해 온 Command Pack을 레거시 Java 예제에서 현재의 NBTForge Output으로 옮겨야 하는 경우 이 프리셋을 사용하십시오. 이 마이그레이션은 단순한 문자열 치환이 아니라 아이템 또는 엔터티의 의도에서 출발하므로 완성된 명령을 검토하기가 한결 수월합니다.
검토 화면에는 가져온 레거시 명령, 새로 구성한 최신 Output, 그리고 둘 사이의 차이가 함께 표시되어야 합니다. 바로 이 지점에서 위험한 한 줄 수정이 아니라 통제된 워크플로 형태의 문법 마이그레이션이 가능해집니다. 복사된 명령은 선택기 범위, 월드 상태, 팩 내부 실행 순서, Minecraft에 붙여넣을 정확한 Output 등 주변 가정이 함께 드러날 때에만 유용합니다. 이 프리셋을 명령이 NBTForge를 떠나기 전 해당 세부 사항을 검토할 수 있는 체크포인트로 활용하십시오.
갤러리도 이 검토 흐름을 중심으로 구성되어 있습니다. 첫 번째 스크린샷은 Workbench 상태를 보여주고, 두 번째 스크린샷은 플레이어를 대상으로 한 동작을 바꾸는 필드 또는 동반 모듈을 강조하며, Output 스크린샷은 최종 명령이나 명령 쌍을 그대로 보여줍니다. 프리셋이 월드 안에서 눈에 보이는 결과를 만들어 내는 경우에는, 게임 내 캡처가 일반적인 오버레이에 의존하지 않고 깨끗하게 복원된 테스트 월드에서 동일한 의도를 다시 확인하도록 합니다.
테스트와 범위 검토
일부 레거시 NBT 개념은 최신 컴포넌트로 자연스럽게 매핑되지만, 일부는 `custom_data` 쪽으로 옮겨야 하고, 또 일부는 완전히 새로운 설계가 필요합니다. 전체 텍스트를 한 번에 치환하는 대신, 명령 계열을 하나씩 다시 구성하고 개별적으로 검증하십시오.
좁은 선택기와 깨끗한 월드 상태에서 첫 스모크 테스트를 실행하십시오. 환경, 유틸리티, 라우팅, 피드백 명령은 겉보기에 무해해 보여도 모든 플레이어나 월드 전체에 영향을 줄 수 있습니다. 명령이 의도한 상태만 변경하는지 확인한 뒤, 해당 Output이 존재하는 이유를 설명하는 설정 행 또는 후속 행과 함께 정확한 Output을 저장하십시오.
명령이 함수 파일이나 command block 체인에 포함되기 시작하면, 라이브 Workbench 상태뿐 아니라 복사된 결과물 그 자체도 함께 테스트하십시오. 이 과정에서 오래된 선택기, 잘못된 실행 순서, 누락된 설정 행, 그리고 이전 테스트의 잔류 상태 덕분에 작동하는 것처럼 보였던 효과 등을 잡아낼 수 있습니다.
- 팩 전체 검토가 끝나기 전까지 선택기는 좁은 범위로 유지하십시오.
- 특정 인카운터보다 먼저 실행되도록 월드 설정 명령을 앞쪽에 배치하십시오.
- 피드백 명령은 이를 유발하는 상태 변경 옆에 함께 저장하십시오.
다음에 살펴볼 자료
한 번에 저장된 Project 아이템 하나씩 옮기고, 새로운 명령이 모든 테스트를 통과할 때까지 기존 Output을 함께 보관하십시오.
아이템 단위 마이그레이션의 경우 Java 1.20.4 아이템 NBT 프리셋 가이드와 Java 1.21 아이템 컴포넌트 프리셋 가이드를 비교해 보십시오.
FAQ
이 고급 명령을 채팅에 직접 붙여넣어도 괜찮습니까?
선택기가 안전하고 명령이 짧은 경우에는 단일 명령 스모크 테스트 용도로 보통 가능합니다. 다만 반복 가능한 맵 동작을 위해서는 Project에 저장한 뒤, 순서가 보장된 팩 또는 함수 스타일 Output을 Copy하여 사용하십시오.
이 갤러리가 UI 화면만 보여주는 이유는 무엇입니까?
이 프리셋은 월드에서 눈에 보이는 오브젝트가 아니라 JSON, Project 구성, 검토 워크플로를 산출하기 때문입니다. 따라서 가장 유용한 증거는 Workbench 상태, Output, 그리고 Project 배치 화면입니다.
이 프리셋을 공유하기 전에 어떤 점을 확인해야 합니까?
선택기 범위, 명령 순서, 대상 버전, 그리고 명령이 설정 단계인지 로직 실행 단계인지 피드백 또는 정리 단계인지 분류를 확인하십시오. 이 분류가 Project 팩 내에서의 배치 위치를 결정합니다.
이 작업 흐름 열기
관련 Advanced 작업대에서 시작한 뒤 월드에 맞게 preset 필드를 조정합니다.