마인크래프트/팩/데이터 팩
덤프버전 :
상위 문서: 마인크래프트/팩 
1. 개요[편집]
데이터 팩은 마인크래프트의 데이터들을 바꿀 수 있는 시스템이다. 스냅샷 17w43a부터 추가되었다. 별도의 모드로더 필요 없이 발전 과제, 함수, 드롭 아이템, 구조물, 조합법, 태그를 바꾸거나 추가할 수 있다. 맵 폴더 안에다가 data라는 이름의 폴더를 또 추가하여 폴더 형식의 데이터 팩을 넣은 다음 /datapack 명령어로 활성화하면 된다.
2. 제작[편집]
데이터 팩 파일은
.minecraft/saves/(월드)/datapacksdatanamespacemainfunctionsfunction main/함수 이름예를 들어,
world 라는 이름의 월드에 나만의 조합법을 만들어서 플레이하고 싶다면
.minecraft > saves > world > datapacks > (파일이름) > data > crafting > recipes > 원하는 조합법.json
이렇게 넣어야만 데이터 팩을 사용할 수 있다.
2.1. 폴더 구조[편집]
2.2. pack.mcmeta[편집]
데이터 팩 파일 안에는
pack.mcmeta만약에 파일이 열리지 않는다면 연결 프로그램을 메모장 등으로 바꿔주어야 한다.
"description"pack_format2.3. functions 작성법[편집]
말 그대로 함수로 플레이어가 커맨드 리스트를 적은 텍스트 파일을 저장하고 게임내에서 사용할 수 있게 해준다. 저장 확장자는 .mcfunction. UTF-8로 인코딩하여 사용하는 것이 여러 문제를 예방할 수 있다.[1]
기능을 사용하려면 먼저 텍스트 파일을 .minecraft/saves/(월드이름)/datapacks/(데이터팩 이름)/data/(네임 스페이스)/functions 내의 최상위 폴더에 배치해야 한다. 새로운 최상위 폴더의 이름은 내부 함수를 실행할 때 사용되는 네임 스페이스가 된다. 최상위 폴더 내의 하위 폴더에 기능을 배치 할 수도 있다. (데이터팩 이름) 폴더에 pack.mcmeta 파일이 있어야 한다.
예를 들어 custom:example/test라는 함수를 실행하면 data/custom/functions/example/test.mcfunction에서 데이터를 불러오게 된다. 만약 네임스페이스를 쓰지 않았다면 minecraft:라는 기본 설정된 네임 스페이스를 지정받게 된다. 하지만 나중에 기본 네임 스페이스를 추가하였을 때 의도하지 않은 동작을 방지하기 위해선 사용자 지정 네임 스페이스를 사용하는 것을 추천한다.
텍스트 파일로 이루어져 있는 함수는 수정하기 쉽고, 커맨드 블록에서 긴 명령어를 작성하는 것 보다 렉을 더 적게 유발한다.
/reload 명령어를 사용해서 함수 파일을 로딩하면 마인크래프트에 재접속 하지 않고 바뀐 함수를 적용할 수 있다.
/function 명령어를 성공적으로 입력했다면 함수 '<경로>'에 있는 명령어 <개수>개를 실행했습니다라고 출력된다. 내장된 함수는 위 메세지를 출력하지 않는다. 함수 내에서 명령의 성공적인 출력은 비교기로 측정 할 수 없다 (/ execute store 명령을 사용하여 동일한 효과를 얻을 수는 있다.)
싱글 플레이나 LAN서버에서 커맨드 블록이 실행하는 모든 함수는 permission 레벨2를 넘을 수 없다. 하지만 위와 다르게 보통의 멀티플레이 서버 구현 프로그렘에서는 server.properties의 function-permission-level에서 자유롭게 설정할 수 있다.
함수 구문을 작성하려면 아래의 functions 부분 참고.
3. 기능[편집]
3.1. structures / 구조물[편집]
이 구조물이 아니고 구조물 블록에 쓰이는 구조물이다.
3.2. loot_tables / 드롭 아이템[편집]
몹과 블록의 드롭 아이템과 구조물의 상자에 있는 아이템을 바꿀 수 있다. 또한 이것과 loot 명령어를 활용한다면 give 명령어 보다 더 많은 것을 구현 할 수 있다. 단, 일부 블록(기반암, 엔드 차원문 틀 등)의 경우 아이템을 얻을 수 없도록 하드코딩 되어 있으므로 드롭 아이템을 추가하더라도 아이템이 드롭되지 않는다.
- < >
- type <
> - pools < >
- < >
- conditions <
>- <
>- condition <
>
- condition <
- <
- functions <
>- <
>- function <
> - conditions <
>- <
>- condition <
>
- condition <
- <
- function <
- <
- rolls <
> - rolls - <
>- min <
> - max <
>
- min <
- bonus_rolls <
> - bonus_rolls - <
>- min <
> - max <
>
- min <
- entries < >
- < >
- conditions < >
- < >
- condition < >
- < >
- conditions < >
- type < >
- name < >
- children < >
- expand - < >
- functions < >
- < >
- function < >
- conditions < >
- < >
- condition < >
- < >
- < >
- weight < >
- quality < >
- < >
- conditions <
- < >
- type <
3.3. advancements / 발전 과제[편집]
발전과제를 추가하고 이름과 달성 목표, 경험치를 바꿀 수 있다.
이 사이트에서 쉽게 생성할 수 있다.
데이터 팩에는 반복 명령 블록 같은 것이 없어서 사실상 데이터 팩에서 플레이어의 직접적인 명령 없이 특정 플레이어를 감지해 명령을 실행할 수 있는 유일한 수단이다. 업적을 달성하면 보상으로 function을 작동시키는 식으로 가능하다.
3.4. recipes / 조합법[편집]
조합법을 바꿀 수 있다. 키에 아이템을 설정해 놓고 패턴에서 그 키로 조합하는 것이다. 다만 아쉽게도 NBT는 지원 안한다.
NBT를 적용시킬 때에는 얻을 수 없는 아이템을 주고 그 아이템을 삭제한 뒤에 NBT가 적용된 아이템을 주는 방식으로 제작하면 된다.[2][3]
예시를 들면 다이아몬드 곡괭이의 경우 ' '은 빈 공간, X는 다이아몬드, #은 막대기라고 했을 시 패턴에서
{
"type": "minecraft:crafting_shaped",
"pattern": [
"XXX",
" # ",
" # "
],
"key": {
"#": {
"item": "minecraft:stick"
},
"X": {
"item": "minecraft:diamond"
}
},
"result": {
"item": "minecraft:diamond_pickaxe"
}
}
라고 쓰면 다이아몬드 곡괭이의 조합법이 완성되는 것이다.
만약 나무 판자로 만드는 아이템같이[4] 다른 아이템으로도 조합이 가능하게 하고 싶다면 tag 파일을 따로 만들어 tag 파일을 tag 폴에 넣고 조합법에 집어넣을 수 있다.
원하는 조합법을 쉽게 만들 수 있는 외국 사이트가 있다. 사이트
3.5. functions / 함수[편집]
.mcfunction 파일 내부에 유효한 마인크래프트 명령어를 슬래쉬(/)를 제외하고 작성하여야 한다. 또 플레이어는 함수 텍스트 파일 내부에서 줄 맨앞에 #을 붙여서 명령어에 대한 설명을 작성 할 수 있다. 함수를 사용하면 커맨드 블록의 입력 한계값인 32,500보다 길게 쓸 수 있지만 내부에서 실행가능한 커맨드의 총합은 /gamerule maxCommandChainLength의 값으로 결정되고 기본값은 65,536자이다. /gamerule maxCommandChainLength의 설정값을 초과하는 명령어는 무시된다.
함수는 모든 명령을 단일 틱으로 실행하고 다른 함수 내에서 호출 된 함수는 부모함수와 동일한 틱으로 명령을 실행한다. 함수는 다른 함수를 사용하거나 커맨드 블록 환경에서 사용된다.[5] 여기에는 명령 발신자, 위치, 회전 등이 포함된다.
함수 내에서 발생하는 명령어의 문맥을 변경해도 명령 순서에 관계없이 다음 반복까지 동일한 함수 내 (또는 하위 함수 내)의 다른 명령에서 사용하는 명령 환경에 영향을 미치지 않는다. 단 / execute 명령은 예외이며 하위 함수의 명령 환경을 업데이트 한다.
- 사용 예시
execute as @a at @s run function foo:bar
위와 같은 명령어를 플레이어가 사용하면 플레이어는 y좌표가 5칸 위인 위치로 텔레포트 한다. 그리고 플레이어가 원래 밟고 있던 블록은 에매랄드 블록으로 바뀌며 텔레포트한 위치 바로 아래에 다이아몬드 블록이 생성된다. 이러한 특성은 대상 선택인자 매개변수의 영향을 받지 않는다.
@s라는 대상 지정 인자를 이용해서 엔티티가 함수를 사용하도록 할 수 있고, /execute as 로 연출자 엔티티를 수정하는 함수를 전 보다 잘 쓸 수 있는 가능성을 제시해 준다.[6] 이것은 더 간단한 과정으로 대상 선택 인자로 선택한 특정 엔티티를 사용하는 연출을 보다 높은 퀄리티로 구현할 수 있게 해주며 일반적으로 월드의 엔티티 숫자를 줄일 수 있다.
또한, /schedule function 명령어로 일정 시간 후에 Function파일을 작동시킬 수 있어 시간차를 두고 명령어를 사용하고 싶을 때도 유용하다. 명령 블록으로는 레드스톤 중계기나 떨어지는 블록 등을 이용해야 하나, schedule 명령어 덕분에 function을 쓴다면 굳이 명령 블록을 쓸 이유가 없어진다.
이외에 다양항 방법으로 함수를 활용할 수 있으며, 스크립트, 플러그인에서만 지원하던 함수 기능을 마인크래프트로 가져옴으로써 플러그인을 덜 쓰고도 동일한 효과를 낼 수 있게 되었다. 이는 마인크래프트 서버를 더 쾌적한 환경으로 운영할 수 있는 가능성을 제시해 주며, 전에는 시도해 보지 못했던 다양한 연출을 사용함으로써 새로운 미니게임의 탄생을 촉구할 수 있다.
give @s spawner{display:{Name:'{"text":"Speed Husk Spawner","color":"#0B9914","bold":true}'},BlockEntityTag:{SpawnCount:5,SpawnRange:7,Delay:60,MinSpawnDelay:300,MaxSpawnDelay:900,MaxNearbyEntities:10000,RequiredPlayerRange:14,SpawnData:{id:"minecraft:husk",Glowing:1b,CustomNameVisible:1b,Health:30f,CanBreakDoors:0b,Tags:["SpeedHusk"],CustomName:'{"text":"Speed Husk","color":"#0B9C06","bold":true}',ArmorItems:[{},{},{id:"minecraft:golden_chestplate",Count:1b,tag:{Enchantments:[{id:"minecraft:protection",lvl:1s}]}},{}],ActiveEffects:[{Id:1b,Amplifier:3b,Duration:19999980,ShowParticles:1b}],Attributes:[{Name:generic.max_health,Base:30}]},SpawnPotentials:[{Weight:1,Entity:{id:"minecraft:husk",Glowing:1b,CustomNameVisible:1b,Health:30f,CanBreakDoors:0b,Tags:["SpeedHusk"],CustomName:'{"text":"Speed Husk","color":"#0B9C06","bold":true}',ArmorItems:[{},{},{id:"minecraft:golden_chestplate",Count:1b,tag:{Enchantments:[{id:"minecraft:protection",lvl:1s}]}},{}],ActiveEffects:[{Id:1b,Amplifier:3b,Duration:19999980,ShowParticles:1b}],Attributes:[{Name:generic.max_health,Base:30}]}}]}} 1이런 엄청난 길이의 코드를 파일에 저장하는 역할도 같이 할 수 있다. 따라서 서버 내 메모리 최척화와, 긴 명령어의 저장 등 다방면의 기능을 할 수 있기에, 코딩을 해야 한다면 커맨드블록을 최소화하고, 함수를 사용하는 것이 좋다.
3.5.1. 매크로 기능[편집]
1.20.2(23w31a)부터 추가된 기능. 일명 매개변수를 넣는 기능이다.
function <실행 파일> <compound>function <실행 파일> with <data source> [경로]- 사용 예시
execute as @a at @s run function foo:bar {baz:"World!"}
위와 같은 명령어를 사용하면
$(baz)/say Hello World!3.6. predicates / 술어 [편집]
1.15부터 생겼으며 data 폴더에 있는 predicate 폴더에 만들면 된다.
주의사항! 여기있는 예시와 정보는 predicate의 극히 일부만 다루었다. 더욱 정확한 정보를 위해서는 영문위키를 찾아보는 것이 좋다.
시작 - < >
condition < > - condition의 ID 이다.
condition의 다른 부분 (아래에)
alternative
- terms < >
- terms - < >
block_state_property
- block < > - 블록의 ID이다.
- properties - < >
damage_source_properties - 데미지의 속성을 확인한다.
- is_explosion < > - 폭발
- is_projectile < > - 발사체
- is_fire < > - 화염
- is_lightning < > - 번개
- is_magic < > - 마법
- bypasses_magic < > - 배고픔에만 해당.
- bypasses_invulnerability < > - 공허 피해에만 해당.
- bypasses_armor < >
- source_entity - < >
- (모든 엔티티와 같다.)
- direct_entity - < >
- (모든 엔티티와 같다.)
entity_properties
- entity < > - 조건을 확인할 엔티티를 지정한다.
- predicate - < >
- flags - < >
- is_on_fire < > - 화염 여부 테스트.
- is_sneaking < > - 웅크리기 여부 테스트.
- is_sprinting < > - 달리기 여부 테스트.
- is_swimming < > - 수영 여부 테스트.
- is_baby < > - 아기 변형 여부 테스트.
- flags - < >
- (모든 엔티티와 같다.)
- predicate - < >
random_chance
- chance < > - 성공확률를 정한다. 1이 100%이다. 0.5면 50%확률로 성공한다.
weather_check
- raining < > - true이면 비가 올 때 성공한다.
- thundering < > - true이면 천둥이 올 때 성공한다.
예시:
플레이어 웅크리기 감지
파일 경로: .minecraft\saves\<맵 이름>\datapacks\<데이터 팩 이름>\data\<namespace>\predicates\<파일 이름>.json
{
"condition": "minecraft:entity_properties",
"predicate": {
"flags": {
"is_sneaking": true
}
},
"entity":"this"
}
{
"condition": "minecraft:random_chance",
"chance": 0.5
}
3.7. dimension / 차원 [편집]
1.16부터 생겼으며 data 폴더 안에 minecraft 폴더 안에 dimension , dimension_type 폴더 만들면 된다. 그 폴더 안에 영어 소문자 _ 로만 차원 이름을 적고 .json을 만들면 된다.
추가된 차원을 가고 싶다면
/execute in (폴더 이름):(차원 이름) run tp ~ ~ ~완전한 평지 엔드 버전
{
"generator": {
"settings": {
"structures": {
"stronghold": {
"distance": 32,
"spread": 3,
"count": 128
},
"structures": {}
},
"layers": [
{
"height": 1,
"block": "minecraft:bedrock"
},
{
"height": 3,
"block": "minecraft:end_stone"
}
],
"biome": "minecraft:the_end"
},
"type": "minecraft:flat"
},
"type": {
"ultrawarm": false,
"natural": true,
"coordinate_scale": 1.0,
"piglin_safe": false,
"respawn_anchor_works": false,
"bed_works": false,
"has_raids": true,
"has_skylight": false,
"has_ceiling": false,
"ambient_light": 0.0,
"fixed_time": 6000,
"logical_height": 256,
"infiniburn": "minecraft:infiniburn_end"
}
}
3.7.1. dimension_type[편집]
차원 타입을 설정하는 곳 기본값은 차원마다 다르다.
3.8. biome / 생물 군계[편집]
1.16.2부터 추가된 기능.
3.9. 아이템 수정자[편집]
1.17부터 추가된 기능. /Item modifier ... 명령어를 사용할 때 쓰인다.
더 많은 내용은 마인크래프트 영어 위키로 가면 된다.
시작 - < >
function < > - function의 ID 이다.
function의 다른 부분 (아래에)
limit_count
- limit: 사용할 정확한 제한을 지정한다.
looting_enchant
- count: 약탈 레벨당 추가 아이템 수를 지정한다. 숫자는 소수점 일 수 있으며 약탈 레벨을 곱한 후 반올림된다.
- limit: 약탈 계산 후 스택에 있는 최대 아이템 수를 정한다. 값이 0이면 제한이 적용되지 않는다.
set_damage - 도구의 내구도를 수정한다.
- damage: Number provider. 설정할 내구도 비율을 지정한다 (1.0은 손상되지 않음, 0.0은 내구도 없음).
- add(JE 1.17) :선택 사항. 만약 true이면 현재 내구도에 비례하여 변경된다.
set_lore - 아이템에 설명을 추가한다.
- lore
set_name - 아이템의 이름을 설정한다.
- name
아이템 10개로 쌓기
파일 경로: .minecraft\saves\<맵 이름>\datapacks\<데이터 팩 이름>\data\<namespace>\item_modifiers\<파일 이름>.json
[
{
"function": "limit_count",
"limit": 10
}
]
[
{
"function": "set_damage",
"damage": 0.5
},
{
"function": "set_name",
"name": "NamuWiki"
}
]
[
{
"function": "set_name",
"name": "Sword of the Universe"
},
{
"function": "set_lore",
"lore": [
{"text":"Oi you! Yes you."},
{"text":"What are you looking at?"},
{"text":"Yes this sword has ∞ damage."},
{"text":"Kinda overkill? I'm lazy ok. (╯°□°)╯︵ ┻━┻"}
]
},
{
"function": "set_attributes",
"modifiers": [{
"attribute": "minecraft:generic.attack_damage",
"name": "",
"amount": 9e99,
"operation": "addition",
"slot": "mainhand"
}]
}
]
4. 유저 표준[편집]
데이터 팩에 포함된 태그나 명령어 등에 정해진 표준은 없지만, 유저들이 자체적으로 적당한 표준을 만들어 사용하고 있다.
사실 꼭 지키지 않아도 큰 문제는 없으나, 다른 데이터팩과의 충돌 방지나 호환을 위해 지키는 것이 좋다.
리소스팩 충돌 방지, 엔티티 및 태그 표준, 네임스페이스 표준 등 꽤 많은 양의 표준이 정해져 있다.
자세한 내용은 이 사이트를 참고하도록 하자.
5. 목록[편집]
[1] 메모장이나 notepad++ 등으로 여는 것이 가능하다.[2] 위의 발전과제를 응용해 특정 조합법을 해금하면 function을 작동하게 하고, function 파일에 /recipe와 /advancements 명령어를 이용해 조합법과 발전과제를 철회하고 /clear 명령어로 조합으로 나온 얻을 수 없는 아이템 삭제 후, /give 명령어로 NBT가 붙은 아이템을 주면 된다. 만약 이렇게만 하면 조합으로 나온 얻을 수 없는 아이템을 클릭하지 않고 q를 눌러 버리면 아이템도 지급되고 얻을 수 없는 아이템도 남긴 하나, function 파일을 하나 더 만들어 /kill 명령어로 얻을 수 없는 아이템을 제거하는 명령어를 넣고, 기존 function 파일에 /schedule function 명령어를 넣어 아이템을 삭제하면 된다.[3] 서바이벌, 모험 모드에서 제작할 경우 두 모드에서 볼 일이 없는 스폰 알, 명령 블럭 등을 사용하고 리소스팩을 이용해 모습을 자연스럽게 바꾸면 괴리감이 적어진다.크리에이티브 모드는 혼란스러워진다.[4] 참나무 판자 뿐만 아닌 다른 나무의 판자로도 조합이 가능한 경우[5] 즉 함수가 사용하는 명령어는 커맨드 블록이 사용한 것과 같이 취급된다.[6] 예를 들어서 좀비에 옷을 입히고 대사를 넣어서 마치 NPC가 플레이어를 안내하는 연출을 한다고 가정하자 전에는 스코어보드 명령어와 매개변수를 복잡하게 활용하고 밑에 특정 블록을 넣어서 좀비가 이를 따라가게 하는 식으로 연출했어야 했다. 하지만 함수를 사용하면 이 과정을 간단히 할 수 있고 훨씬더 적은 명령어로 이 연출을 가능하게 해준다.[7] /execute in (폴더 이름):(차원 이름) run summon...
/execute in (폴더 이름):(차원 이름) run setblock(혹은 fill) ...[8] 물이 증발하거나 스펀지가 증발
/execute in (폴더 이름):(차원 이름) run setblock(혹은 fill) ...[8] 물이 증발하거나 스펀지가 증발