가이드

데이터팩 설치하는 법

2026년 10월 18일 업데이트

데이터팩에는 모드도 서버 소프트웨어도 필요 없어요. 바닐라, 싱글플레이, 어느 서버에서든 작동해요. 데이터팩은 월드 하나에 속해요. 그 월드의 datapacks 폴더에 넣고 다시 불러오면 돼요. 주의할 건 팩이 내 Minecraft 버전용으로 만들어졌는지뿐이에요.

시작하기 좋은 예시예요.

Codexe로 이걸 생성하기

단계별 안내

  1. 1.버전 확인하기

    팩 페이지에 지원하는 Minecraft 버전이 적혀 있어요. 데이터팩 형식은 버전마다 바뀌어서 1.20용 팩이 1.21에서 작동하지 않을 수 있어요.

  2. 2.월드의 datapacks 폴더 찾기

    싱글플레이: .minecraft/saves/<World>/datapacks/. 서버: world/datapacks/(server.properties의 level-name에 적힌 폴더).

  3. 3.팩 복사하기

    .zip을 그대로 넣거나 압축을 푼 폴더를 넣으세요. 어느 쪽이든 pack.mcmeta가 zip이나 폴더의 최상위에 있어야 해요.

  4. 4.새로고침

    게임 안에서 /reload를 실행하거나(관리자 권한이나 치트가 필요해요) 서버를 재시작하세요.

  5. 5.활성화됐는지 확인하기

    /datapack list는 활성화된 팩과 사용 가능한 팩을 보여 줘요. 내 팩이 사용 가능한데 활성화되지 않았다면 /datapack enable "file/<name>"을 실행하세요.

월드를 만들 때 데이터팩 추가하기

싱글플레이에서 새로운 월드 만들기, 그다음 더 보기와 데이터 팩으로 가서 .zip을 창으로 끌어다 놓고 활성화된 쪽으로 옮기세요. 월드 생성(생물 군계, 지형, 구조물)을 바꾸는 팩은 이렇게 하는 게 맞아요. 그런 변경은 팩을 활성화한 뒤에 생성되는 청크에만 적용되거든요.

서버라면 월드 생성 팩을 첫 시작 전에 world/datapacks/에 넣으세요. 그렇지 않으면 기존 지형은 그대로이고 새 청크만 바뀌어요.

자주 생기는 문제

  • 팩이 /datapack list에 없어요: 잘못된 폴더에 있거나, zip 안에 폴더가 한 단계 더 있어서 pack.mcmeta가 최상위에 있지 않아요.
  • "이전/최신 버전용" 경고: pack_format이 게임과 맞지 않아요. 팩이 로드될 수는 있지만, 다른 버전용으로 작성된 조합법이나 함수는 실패할 수 있어요.
  • 로드됐는데 아무 일도 일어나지 않아요: 함수나 조합법에 오류가 있어요. 서버 로그(싱글플레이라면 게임 로그)에 실패한 파일이 나와요.
  • 리소스 팩을 내려받았어요: 텍스처와 소리는 datapacks/가 아니라 resourcepacks/에 넣어요. 일부 콘텐츠는 두 가지로 함께 제공돼요.

호스팅 패널에서

호스팅 패널에서는 파일 관리자를 열고, 월드 폴더로 가서 zip을 datapacks/에 업로드한 다음 재시작하세요. 같은 일을 해 주는 데이터팩 설치 기능이 있는 호스팅도 있어요. 월드 폴더는 서버 루트가 아니라 server.properties에 적힌 폴더예요.

Codexe로 만든 데이터팩

Codexe에서 만든 데이터팩은 준비 완료 전에 실제 Minecraft 서버에 불러오고, 서버 로그에서 조합법, 함수, 발전 과제, JSON의 오류를 확인해요. 최상위에 pack.mcmeta와 data/가 있는 zip으로 다운로드되니 바로 world/datapacks/에 넣을 수 있고, 먼저 비공개 테스트 서버에서 플레이해 볼 수도 있어요.

질문

클라이언트에 뭔가 설치해야 하나요?

아니요. 데이터팩은 서버(싱글플레이에서는 통합 서버)에서 실행돼요. 데이터팩이 텍스처용 리소스 팩을 함께 제공하는 경우에만 플레이어에게 리소스 팩이 필요해요.

데이터팩이 모든 월드에 적용되나요?

아니요, 팩이 들어 있는 폴더의 월드에만 적용돼요. 쓰려는 월드마다 복사해 넣으세요.

데이터팩을 제거할 수 있나요?

/datapack disable "file/<name>"을 실행하고 폴더에서 삭제하세요. 팩이 이미 만든 것(아이템, 스코어보드, 생성된 지형)은 월드에 남을 수 있어요.

내 월드용 데이터팩 만들기

이 프롬프트는 바로 보낼 수 있는 상태로 열려요:

“Minecraft 1.21.4용 데이터팩, 네임스페이스 "camp": 이름이 붙은 흰색 침대를 주는 Bedroll의 모양 없는 조합법(흰색 양털 3개와 실 2개), 썩은 살점 4개를 가죽 1개로 바꾸는 조합법, 사이드바에 "deaths" 스코어보드를 표시하는 load 함수.”

Codexe로 이걸 생성하기
Minecraft 데이터팩 설치하는 법 (월드 또는 서버) | Codexe