데이터팩 프리셋
Datapack 네임스페이스 프리셋 가이드
Datapack 네임스페이스 프리셋 가이드는 이제 템플릿 형태의 명령어 메모가 아니라 완성된 Data Pack 워크플로로 다루어집니다. 데이터팩이 흩어진 폴더로 비대해지기 전에 이 프리셋을 사용하십시오. 네임스페이스는 파일, 명령어, 리소스 참조 사이의 계약이므로 초기에 한 번 설계해 두면 loot table, 함수, 발전, 조건자, 레시피가 서로 다른 ID로 흩어지는 문제를 막을 수 있습니다. 이 글은 설정 필드, Output 검토, Project 배치, 결과 캡처를 한 흐름으로 묶어 두므로 명령어가 맵 설정, 이벤트 트리거, 재사용 가능한 Command Pack의 일부가 되기 전에 손쉽게 감사할 수 있습니다. Data Pack Workbench는 네임스페이스와 리소스 경로 필드를 위한 눈에 보이는 체크포인트이며, 스크린샷 흐름은 각 글이 제각각 다른 ID 체계를 만들지 않고 동일한 `nbtforge` 네임스페이스가 팩 메타데이터 파일, 함수 경로, loot 리소스를 어떻게 일관되게 묶어 주는지를 보여 줍니다.
preset 결과
함수, loot table, 레시피, 조건자, 아이템 모디파이어를 하나의 Project ID 아래에 모아 두는 네임스페이스 설계안입니다.
출력
네임스페이스 설계 팩 파일
pack.mcmeta
{"pack":{"pack_format":81,"description":"NBTForge adventure pack"}}
data/nbtforge/function/setup.mcfunction
gamerule doMobSpawning false
weather clear 6000
data/nbtforge/loot_table/chests/crypt_reward.jsonpreset 스크린샷
preset 만들기
- Data Pack을 열고 먼저 설계할 리소스 유형을 선택합니다.
- 네임스페이스는 `nbtforge`처럼 안정적인 Project ID로 잡습니다.
- 기능 폴더를 포함하는 리소스 경로를 선택합니다.
- 생성된 파일 경로를 Copy하고 Project에 기록해 둡니다.
- 관련 함수, loot table, 조건자에 동일한 네임스페이스를 반복 적용합니다.
- 바닐라 데이터를 의도적으로 덮어쓰는 경우가 아니라면 사용자 정의 파일을 `minecraft` 네임스페이스에 섞지 마십시오.
- 폴더 구조가 조립되면 `/reload`로 팩을 테스트합니다.
이 Data Pack 프리셋을 Project에 두는 이유
데이터팩이 흩어진 폴더로 비대해지기 전에 이 프리셋을 사용하십시오. 네임스페이스는 파일, 명령어, 리소스 참조 사이의 계약이므로 초기에 한 번 설계해 두면 loot table, 함수, 발전, 조건자, 레시피가 서로 다른 ID로 흩어지는 문제를 막을 수 있습니다.
Data Pack Workbench는 네임스페이스와 리소스 경로 필드를 위한 눈에 보이는 체크포인트입니다. 스크린샷 흐름은 각 글이 제각각 다른 ID 체계를 만들지 않고 동일한 `nbtforge` 네임스페이스가 팩 메타데이터 파일, 함수 경로, loot 리소스를 어떻게 일관되게 묶어 주는지를 보여 줍니다. Copy한 명령어는 셀렉터 범위, 월드 상태, 팩 내부 실행 순서, 마인크래프트에 그대로 붙여 넣을 정확한 Output 등 주변 가정이 함께 정리되어 있을 때에만 진짜 유용합니다. 이 프리셋을 명령어가 NBTForge를 떠나기 전 그러한 세부 사항을 점검하는 체크포인트로 삼으십시오.
갤러리도 이 검토 흐름을 중심으로 구성되어 있습니다. 첫 번째 캡처는 Workbench 상태를 보여 주고, 두 번째 캡처는 플레이어 대상 동작을 변경하는 필드나 동반 모듈을 강조하며, Output 캡처는 최종 명령어 또는 명령어 쌍을 그대로 드러냅니다. 프리셋이 게임 안에서 눈에 보이는 결과를 만들어 낸다면 인게임 캡처는 일반 오버레이에 의존하지 않고, 깨끗이 되돌린 테스트 월드에서 같은 의도가 재현되는지를 확인합니다.
테스트와 범위 점검
바닐라 데이터를 의도적으로 덮어쓰는 경우가 아니라면 사용자 정의 팩 리소스에 `minecraft` 네임스페이스를 쓰지 마십시오. 파일이 격리된 상태로 유지되도록 `nbtforge`, 맵 ID, 스튜디오 ID 같은 Project 네임스페이스를 사용하십시오.
최초 스모크 테스트는 좁은 셀렉터와 깔끔한 월드 상태에서 진행합니다. 환경, 유틸리티, 라우팅, 피드백 명령어는 무해해 보이지만 자칫 모든 플레이어나 월드 전체에 영향을 줄 수 있습니다. 명령어가 의도한 상태만 바꾸는지 먼저 확인한 다음, 그 Output이 왜 존재하는지 설명하는 설정 행이나 후속 행 옆에 정확한 Output을 보관하십시오.
명령어가 함수 파일이나 command block 체인의 일부가 되는 순간부터는 라이브 Workbench 상태뿐 아니라 복사된 산출물 자체도 검증해야 합니다. 그래야 낡은 셀렉터, 잘못된 명령어 순서, 빠진 설정 줄, 이전 테스트 잔여 상태 때문에 우연히 작동하던 효과까지 모두 잡아낼 수 있습니다.
- 팩 전체 검토가 끝날 때까지 셀렉터는 좁게 유지하십시오.
- 특정 만남보다 먼저 월드 설정 명령어를 배치하십시오.
- 피드백 명령어는 이를 작동시키는 상태 변화 명령어 바로 옆에 저장하십시오.
다음으로 갈 곳
레시피, 조건자, loot table, 함수를 추가하기 전에 Project에 네임스페이스 규칙을 먼저 적어 두십시오.
같은 네임스페이스를 따라야 할 리소스로는 명령어 체인을 위한 Function Pack 프리셋과 맞춤형 제작을 위한 Recipe 프리셋을 비교해 보십시오.
FAQ
이 Data Pack 명령어를 채팅 창에 그대로 붙여 넣어도 됩니까?
셀렉터가 안전하고 한 줄짜리 단일 명령어 스모크 테스트라면 대체로 가능합니다. 반복 가능한 맵 동작이라면 Project에 보관하고, 순서가 잡힌 팩이나 함수 형태의 Output을 Copy해서 사용하십시오.
이 갤러리는 왜 UI 화면 위주입니까?
이 프리셋은 월드 안에서 눈에 보이는 오브젝트가 아니라 JSON, Project 구성, 검토 워크플로를 만들어 냅니다. 따라서 의미 있는 증거는 Workbench 상태, Output, Project 배치입니다.
이 프리셋을 공유하기 전에 무엇을 확인해야 합니까?
셀렉터 범위, 명령어 순서, 대상 버전, 설정/논리/피드백/정리 가운데 어디에 속하는지를 점검하십시오. 그 카테고리가 Project 안에서 팩의 위치를 결정합니다.
이 작업 흐름 열기
관련 Data Pack 작업대에서 시작한 뒤 월드에 맞게 preset 필드를 조정합니다.