본문으로 건너뛰기
플랫폼

데이터팩

Codexe로 만드는 바닐라 데이터팩이에요. 버전과 pack_format, 폴더 구조, Codexe가 실제 Minecraft 서버에서 팩을 테스트 로드하는 방식, 자주 생기는 문제를 다뤄요.

업데이트됨

이 페이지에서
  1. 요청에 넣을 내용
  2. Codexe가 데이터팩을 검증하는 방법
  3. 설치
  4. 한계

데이터팩은 게임이 이미 읽는 데이터를 바꿔요. 레시피, 전리품 테이블, 발전 과제, 조건(predicate), 태그, 함수(.mcfunction) 같은 것들이에요. 플러그인이나 모드 없이 바닐라 서버와 싱글플레이 월드에서 동작해요.

게임에서 데이터팩을 플레이해 보려면 지금 체험하기로 비공개 테스트 서버를 시작하세요.

#요청에 넣을 내용

  • Minecraft 버전. pack_format과 폴더 이름이 이것으로 정해져요(예: 1.21+에서는 function/, 그 이전에는 functions/).
  • 하는 일: 레시피(모양 있음/모양 없음), 전리품 변경, 발전 과제 트리, 스코어보드 메커니즘, tick 또는 load 함수.
  • 네임스페이스: 이름이 중요하다면 적으세요.
Text
A datapack for Minecraft 1.21.1, namespace "extras".
- Shaped recipe: 8 cobblestone around a coal block = 16 torches.
- Shapeless recipe: 4 rotten flesh = 1 leather.
- A load function that creates a "deaths" scoreboard and shows it in the sidebar.

#Codexe가 데이터팩을 검증하는 방법

데이터팩은 컴파일할 것이 없으므로, Codexe는 빌드 샌드박스 안에서 오프라인으로 실제 바닐라 Minecraft 서버에 팩을 로드하고 레시피, 함수, 발전 과제, JSON 오류가 있는지 서버 로그를 읽어요. 서버 버전은 팩의 pack_format으로 정해져요. 팩이 대상으로 하는 버전 중 설치된 가장 최신 버전이에요.

테스트 서버는 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11, 26.1.2, 26.2, 26.3을 지원해요. 폴더 구조가 버전에 맞지 않으면(예: 1.21에서 functions/) Codexe가 폴더 이름을 바로잡아요.

오류가 있는 팩은 코드처럼 수정돼요. 준비됨은 팩이 깨끗하게 로드됐다는 뜻이에요.

#설치

ZIP을 내려받아 world/datapacks/(싱글플레이에서는 해당 월드의 datapacks 폴더)에 넣은 다음 /reload를 실행하거나 재시작하세요. /datapack list로 확인할 수 있어요.

#한계

데이터팩으로는 새로운 동작을 가진 진짜 새 블록이나 아이템을 추가할 수 없고, 바닐라가 제공하는 것(발전 과제, 조건, 스코어보드)에만 반응할 수 있어요. 이벤트가 많은 로직에는 Skript나 플러그인을 쓰세요.

데이터팩 | Codexe Docs