가이드
문제 해결ImportOutputDiff

Minecraft 명령이 작동하지 않는 이유

9 분 읽기

대부분의 손상된 명령은 네 가지 이유 중 하나로 인해 실패합니다. 명령이 잘못된 Minecraft 버전을 대상으로 하거나 선택기가 일치하는 아이템이 없거나 JSON 또는 NBT의 형식이 잘못되었거나 명령이 Bedrock에서 Java 전용 데이터를 사용합니다. NBTForge는 지원되는 명령을 입력된 필드로 다시 작성하고, 경고를 표시하고, 편집하는 동안 Output을 표시하는 데 도움이 됩니다.

언어ENRUDEESPT中文日本語VIFR한국어IDPLTR
실패 유형을 식별하여 시작한 다음 명령을 다시 시도하기 전에 체크리스트를 따르십시오.
손상된 명령을 먼저 Import에 붙여넣은 다음 Java 버전 및 버전 대상을 확인하세요.
명령을 수정하는 동안 Output을 계속 표시하고 각 변경 후에 Diff를 사용하여 실제 편집 내용을 명확하게 확인하세요.

가이드 결과

다시 붙여넣기 전에 구문, 대상, 버전 및 버전 문제를 격리하는 반복 가능한 명령 디버깅 단계입니다.

관련 workflow 열기Import, Output, Diff깨진 명령 디버깅

권장 경로

  1. 명령을 가져오기 표시줄에 붙여넣고 NBTForge가 이를 시각적 모듈로 라우팅할 수 있는지 확인합니다.
  2. 명령을 실행할 세계와 일치하도록 Edition 및 Version를 설정합니다.
  3. 특히 Java와 Bedrock 사이를 이동할 때 필드를 변경하기 전에 Output 경고를 읽으십시오.
  4. NBT 페이로드를 비난하기 전에 간단한 테스트 명령으로 대상 선택기를 별도로 확인하세요.
  5. 각 수정 후에 Diff를 사용하면 명령의 어느 부분이 실제로 변경되었는지 알 수 있습니다.

버전 불일치로 시작

현재 Java 월드에서 Copy된 명령은 아이템 구성 요소 구문이 아직 존재하지 않기 때문에 Java 1.20.4 이전 버전에서 실패할 수 있습니다. 그 반대도 일반적입니다. 이전 아이템 NBT는 이전 세계에서 허용될 수 있지만 1.20.5 아이템 구성 요소가 변경된 후에는 실패하거나 다르게 동작합니다.

먼저 NBTForge 버전을 설정한 후 Output을 다시 생성합니다. 버전 전환 후 명령의 모양이 변경되면 이를 외관상의 재작성이 아닌 실제 구문 차이로 처리하십시오.

  • 레거시 아이템 NBT 예시에는 Java 1.20.4 이하를 사용하세요.
  • 구성 요소 스타일 아이템 Output에는 Java 1.20.5+를 사용합니다.
  • Bedrock 구문에서 명령군을 지원하는 경우에만 Bedrock Stable을 사용하세요.

페이로드 버그와 선택기 버그 분리

선택기가 엔터티와 일치하지 않거나 잘못된 플레이어와 일치하면 유효한 명령이 손상된 것처럼 나타날 수 있습니다. 긴 소환을 디버깅하거나 페이로드를 제공하기 전에 제목, 텔로우 또는 효과와 같은 간단한 명령으로 선택기를 테스트하세요.

선택기에 거리, 점수, 태그, 팀 또는 NBT 필터가 포함된 경우 명령이 다시 일치를 시작할 때까지 필터를 한 번에 하나씩 제거하십시오. 그런 다음 가능한 가장 작은 단계로 필터를 다시 추가하세요.

따옴표 및 중첩된 데이터 확인

긴 명령은 일반적으로 중첩된 JSON 텍스트 구성 요소, 이스케이프된 따옴표, 아이템 이름, lore 줄 또는 손으로 쓴 NBT를 중단합니다. 명령에 표시되는 플레이어 텍스트가 포함된 경우 인용 문자를 직접 편집하는 대신 시각적 편집기에서 해당 텍스트를 다시 작성하세요.

NBTForge는 큰 문자열을 더 작은 유형의 필드로 변환하므로 가져온 후 가장 유용합니다. 하나의 필드를 편집하고, Output을 확인하고, 여러 중첩 섹션을 한 번에 변경하지 마십시오.

  • JSON 텍스트가 이중 이스케이프되기 때문에 이름과 lore가 실패하는 경우가 많습니다.
  • 페이지 텍스트에 이스케이프 처리되지 않은 인용문이 포함되어 있으면 책이 실패할 수 있습니다.
  • 중괄호 또는 대괄호가 올바른 순서로 닫히지 않으면 맞춤 데이터가 실패할 수 있습니다.

Copy된 아티팩트 배송

이 가이드를 사용하여 플레이어나 지도 제작자가 실제로 실행할 아티팩트(Copy된 명령, 주문된 Project 팩 또는 데이터팩 리소스)를 생성하세요. 편집 가능한 빌더 상태뿐만 아니라 Copy된 Output에 대해서도 최종 검토가 이루어져야 합니다.

워크플로가 버전을 구분하는 경우 명령 옆에 대상 버전 레이블을 지정합니다. 선택기, 점수판, boss bar, 태그, loot table 또는 Project 순서를 사용하는 경우 설정을 게시하기 전에 깨끗한 환경에서 해당 종속성을 테스트하세요.

디버깅할 라이브 예제를 보려면 좀비 라이딩 스파이더 명령 프리셋, spider jockey 소환 명령 프리셋 및 블레이즈 황제 파이어 Boss loot preset을 비교하세요.

  • 단일 명령의 경우 Output의 Copy, 주문된 팩의 경우 Project의 Copy입니다.
  • Java, Bedrock 및 스냅샷 변형을 별도로 유지하세요.
  • 먼저 무해한 Output으로 파괴적인 선택기를 테스트하세요.
  • 가이드가 표준 워크플로가 되면 관련 preset을 업데이트합니다.

관련 가이드 및 preset

Java NBT 대 아이템 구성요소Bedrock 명령 제한 사항Command Pack 검토 체크리스트

FAQ

명령이 한 세계에서는 작동하지만 다른 세계에서는 작동하지 않는 이유는 무엇입니까?

가장 일반적인 원인은 Minecraft 버전 또는 에디션 불일치입니다. Java 아이템 구문, 스냅샷 기능 및 Bedrock 명령 지원은 명령이 비슷하더라도 다를 수 있습니다.

긴 명령을 직접 수정해야 하나요?

작은 편집에만 해당됩니다. 긴 아이템, 소환, 텍스트 또는 데이터팩 명령의 경우 명령을 가져오고 필드를 시각적으로 편집하여 인용 이스케이프 및 중첩 데이터를 더 쉽게 검토할 수 있습니다.

이 가이드는 언제 Project 팩이 되어야 합니까?

워크플로에 두 개 이상의 명령이 필요하거나, 설정 및 정리 순서가 있거나, 테스트 후 다시 편집해야 하는 경우 Project를 사용하세요. 일회성 명령은 Output에 유지될 수 있습니다.