마인크래프트/명령어/execute

1. 개요

2. execute 문법

2.1. 실행 설정

• as <대상> <다음 명령>
• 명령어의 실행 주체를 <대상>으로 바꾸고 다음 명령을 실행한다. 명령어의 실행 위치를 바꾸진 않는다.
• 예: 모든 주민 죽이기: execute as @e[type=villager] run kill @s
• at <대상> <다음 명령>
• 명령어의 실행 위치를 <대상>의 위치, 시점, 차원으로 바꾸고 다음 명령을 실행한다.
• 예: 모든 주민을 1칸 위로 올리기: execute as @e[type=villager] at @s run tp @s ~ ~1 ~
• 만약 tp @e[type=villager] ~ ~1 ~를 실행하면, 주민 각각이 1칸 위로 올라가는 것이 아닌 모든 주민이 실행자의 1칸 위로 순간이동한다.]
• 실행 주체를 변경하지 않기에 다음 명령어를 쓰면 실행자가 죽는다. execute at @e[type=villager] run kill @s
• positioned <좌표> <다음 명령>
• 명령어의 실행 위치를 <좌표>로 바꾸고 다음 명령을 실행한다.
• positioned as <대상> <다음 명령>
• 명령어의 실행 위치를 <대상>의 좌표로 바꾸고 다음 명령을 실행한다. at과 달리 위치만 바꿀 뿐 시점, 차원을 바꾸지는 않는다.
• positioned over <하이트맵> <다음 명령>^(JE)
• 지정된 실행 위치를 x와 z 좌표값을 유지한 채 y 좌표값을 <하이트맵>에 따른 가장 높은 위치로 바꾸고 다음 명령을 실행한다. <하이트맵>에 넣을 문구는 다음과 같다.
• world_surface: 가장 높은 곳.
• motion_blocking: 충돌 판정이 없는 블록(꽃, 키 작은/키 큰 잔디, 양탄자[2] 등)을 제외한 가장 높은 곳.
• motion_blocking_no_leaves: 충돌 판정이 없는 블록(꽃, 키 작은/키 큰 잔디, 양탄자 등) + 잎을 제외한 가장 높은 곳.
• ocean_floor: 유체^{(물, 용암)}를 제외한 가장 높은 곳.
• align <기준> <다음 명령>
• 명령어의 실행 위치의 좌표의 소수부를 <기준>에 따라 버림하여 정수로 만든 뒤 그 위치에서 다음 명령을 실행한다. x, y, z를 조합해 x, xz, zyx, yz와 같은 형식으로 쓰고, 쓴 좌표축에 해당하는 좌표의 값의 소수 부분을 버림한다. 버림이 아니라 올림을 하고 싶다면 align xyz positioned ~1 ~1 ~1과 같이 쓰면 된다.
• 예: 좌표가 (2.9, -13.2, 6.24)일 때 기준이 yz면 (2.9, -14.0, 6.0)이 된다. 음수에서 버림이 일어날 때 -13.0이 아님에 주의하자.
• facing <좌표> <다음 명령>
• 명령어 실행 위치에서 <좌표>를 바라보는 시점으로 다음 명령을 실행한다.
• facing entity <개체> <eyes|feet> <다음 명령>
• 명령어 실행 위치에서 <개체>의 눈(eyes)이나 발(feet)을 바라보는 시점으로 다음 명령을 실행한다.
• rotated <시점 좌표> <다음 명령>
• <시점 좌표>의 방향의 시점으로 다음 명령을 실행한다.
• rotated as <개체> <다음 명령>
• <개체>가 바라보는 방향과 동일한 방향의 시점으로 다음 명령을 실행한다.
• in <차원> <다음 명령>
• 명령어의 실행 위치를 해당 차원으로 바꾸고 다음 명령을 실행한다. 차원은 기본적으로 minecraft:overworld, minecraft:the_end, minecraft:the_nether가 있는데, 모드, 플러그인, 데이터 팩, 만우절 버전 등으로 차원을 추가된 차원도 지원된다.
• anchored <eyes|feet> <다음 명령>
• 명령어 실행 위치를 명령어 실행 주체의 눈(eyes) 또는 발(feet)로 바꾸고 다음 명령을 실행한다. 기본값은 feet이다.
• summon <개체> <다음 명령>^(JE)
• <개체>를 소환하고 명령어의 실행 주체, 위치, 시점, 차원을 소환된 개체를 기준으로 하여 다음 명령을 실행한다.
• on <관계> <다음 명령>^(JE)
• 앞의 명령구의 주체와의 특정한 <관계>에 있는 개체가 새로운 주체가 되어 다음 명령을 실행한다.
• <관계>에 넣을 문구는 다음과 같다.[3]
• attacker: 최근 5초 동안 대상에게 마지막으로 피해를 입힌 개체를 주체로 설정한다. interaction 개체는 5초 이전의 기록들도 기억한다.
• controller: 대상을 타며 조종하는 개체를 주체로 설정한다. (예시: 배 앞자리에 탄 플레이어)
• leasher: 대상을 끈으로 묶은 개체를 주체로 설정한다. 울타리에 묶어둔 경우에는 minecraft:leash_knot 개체로 설정한다.
• origin: 대상을 소환한 개체를 주체로 설정한다. (예시: 화살을 발사한 개체, tnt를 점화시킨 개체)
• owner: 대상이 길들여질 수 있는 개체일 경우(고양이, 늑대, 앵무새같은), 대상의 주인을 주체로 설정한다.
• passengers: 대상에 직접적으로 타고 있는 개체를 주체로 설정한다. 대상을 타고 있는 개체를 타고 있는 개체는 포함되지 않는다.
• target: 대상이 공격 목표로 삼은 개체를 주체로 설정한다.[4] interaction 개체는 대상을 우클릭한 개체를 주체로 설정한다.
• vehicle: 대상이 타고 있는 개체를 주체로 설정한다.

2.2. 조건 설정

• <if|unless>
• if ...: 다음 조건과 일치할 때 <다음 명령>을 실행한다.
• unless ...: 다음 조건과 일치하지 않을 때 <다음 명령>을 실행한다.
• <if|unless> block <좌표> <블록> <다음 명령>
• 해당 좌표에 맞는 블록이 있거나 있지 않을 때만 다음 명령을 실행한다.
• <if|unless> blocks <시작 좌표> <끝 좌표> <지점> <all|masked> <다음 명령>
• 시작과 끝으로 설정된 지역의 블록이 지점 지역의 블록과 정확히 일치하거나 일치하지 않은 경우에만 다음 명령을 실행한다. /clone과 비슷한 문법이다.
• ... <all|masked> ...
• all: 모든 블록이 일치
• masked: 공기 블록을 제외하고 일치
• <if|unless> entity <개체> <다음 명령>
• 개체가 존재하거나 존재하지 않을 때에만 다음 명령을 실행한다.
• <if|unless> score <대상> <스코어보드1> 〈<|<=|=|>=|>〉 <기준> <스코어보드2> <다음 명령>
• 스코어보드1에 있는 대상의 점수와 스코어보드2에 있는 기준의 점수가 (부)등호에 맞거나 맞지 않을 때만 다음 명령을 실행한다.
• <if|unless> score <대상> <스코어보드1> matches <범위> <다음 명령>
• 스코어보드1에 있는 대상의 점수가 범위에 들어갔거나 들어가지 않았을 때만 다음 명령을 실행한다.
• <범위>부분은 1^{(정확히 1)}, 1..5^{(1 이상 5 이하)}, ..6^{(6 이하)}, 3..^{(3 이상)}와 같이 지정한다.
• <if|unless> biome <좌표> <생물 군계> <다음 명령>^(JE)
• 해당 좌표에 있는 생물 군계가 있거나 있지 않을 때만 다음 명령을 실행한다.
• <if|unless> dimension <차원> <다음 명령>^(JE)
• 현재 차원이 맞거나 맞지 않을 때 다음 명령을 실행한다.
• <if|unless> function <함수> <다음 명령>^(JE)
• 함수를 실행해서 실행된 함수가 반환한 값이 1 이상이면 다음 명령을 실행한다. 만약 함수가 반환한 값이 없거나 0이라면 다음 명령을 실행하지 않는다.
• <if|unless> loaded <좌표> <다음 명령>^(JE)
• 해당 위치에 있는 청크가 완전히 로딩되어있거나 로딩되지 않을 때 다음 명령을 실행한다.
• <if|unless> predicate <술어> <다음 명령>^(JE)
• 사용자 정의 술어가 맞거나 맞지 않을 때 다음 명령을 실행한다. 술어에 대한 내용은 마인크래프트/데이터팩 참조
• <if|unless> items <entity 대상|block 좌표> <슬롯> <아이템> <다음 명령>
• 대상 및 블록의 슬롯에 있는 아이템이 일치하거나 일치하지 않을 때 다음 명령을 실행한다.

2.3. 저장 설정(JE)

• store success 다음 명령어가 성공하거나 실패하면 1^(성공) 혹은 0^(실패)이 반환된다.
• store result 다음 명령어가 성공하면 반환값은 아래의 출력 문단에 따라 다르며, 실패하면 0이 반환된다.
• store <result|success> ...
• ... score <대상> <스코어보드> <다음 명령>
• 다음 명령의 결과를 스코어보드에 있는 대상의 점수로 저장한다. 스코어보드는 무조건 존재해야 한다
• ... block <위치> <경로> <byte|short|int|long|float|double> <크기> <다음 명령>
• 블록의 NBT 데이터를 수정하고 결과를 저장한다.
• ... entity <대상> <경로> <byte|short|int|long|float|double> <크기> <다음 명령>
• 대상의 NBT 데이터를 수정하고 결과를 저장한다.
• 플레이어의 NBT는 그 어떠한 경우에도 수정이 불가능하다.
• ... bossbar <ID> <value|max> <다음 명령>
• 결과값을 해당 ID를 가진 보스바의 값(value)이나 최대값(max)으로 저장한다.

2.3.1. 출력

3. 설명

• execute as @e at @s run tp ^ ^ ^1 - 모든 개체는 1블록 앞으로 이동한다.
• execute at @s as @e run tp ^ ^ ^1 - 모든 개체는 실행자의 앞의 1블록으로 순간 이동한다.

• execute as @e at @s if score $namu wiki matches 1 run say hello world!
• execute if score $namu wiki matches 1 as @e at @s run say hello world!

• execute as @e[type=minecraft:armor_stand] as @e[type=minecraft:armor_stand] run summon minecraft:armor_stand
• execute as @e[type=minecraft:armor_stand] run execute as @e[type=minecraft:armor_stand] run execute run execute run summon minecraft:armor_stand

4. 예시

• 모든 좀비의 위치에 번개를 소환한다.
• execute at @e[type=zombie] run summon lightning_bolt ~ ~ ~

• 모래 위에 있는 모든 좀비의 위치에 번개를 소환한다.
• execute at @e[type=zombie] if block ~ ~-1 ~ minecraft:sand run summon lightning_bolt ~ ~ ~

• 모든 플레이어에게서 5블록 반경에 있는 플레이어하고 떨어지는 번개와 아이템을 제외한 모든 개체에게 번개를 소환한다.
• JE: execute as @a at @e[distance=..5,type=!player,type=!lightning_bolt,type=!item] run summon lightning_bolt ~ ~ ~
• BE: execute as @a at @e[r=5,type=!player,type=!lightning_bolt,type=!item] run summon lightning_bolt ~ ~ ~

• 플레이어의 아래에 흑요석이 감지될 경우 x y z로 tp한다. (점프맵 등에 사용됨)
• execute as @a at @s if block ~ ~-0.001 ~ minecraft:obsidian run tp @s x y z

• 플레이어의 아래에 금 블럭이 감지될 경우 플레이어에게 다이아몬드 검을 주고 그 블럭을 없앤다. (점프맵 등에 사용됨)
• 첫번째 명령어 : execute as @a at @s if block ~ ~-1 ~ minecraft:gold_block run give @s minecraft:diamond_sword
• 두번째 명령어(연쇄형) : execute as @a at @s if block ~ ~-1 ~ minecraft:gold_block run setblock ~ ~-1 ~ minecraft:air

• 가장 가까운 플레이어의 체력을 보스바로 나타낼 때^(JE)
• execute store result bossbar minecraft:1 value run data get entity @p Health

• Pos라는 태그를 가진 blue라는 팀에 속한 갑옷 거치대를 기준으로 가장가까에 있는 team이 red인 플레이어를 100, 100, 100으로 텔레포트 시킨다.^(JE)
• execute at @e[ team=blue, tag=Pos, type=armor_stand ] run tp @p[ team=red ] 100 100 100

• 아머스탠드의 오른팔이 분당 10번 돌아간다.^(JE)
• 준비 : /scoreboard objectives add test dummy, /summon x y z armor_stand{ShowArms:1,Pose:{RightArm:[0.0f,0.0f,0.0f]},Tags:[test]}
• execute as @e[tag=test,limit=1] store result @s Pose.RightArm[0] float 1 run scoreboard players add @s test 3

• 모든 양의 양털 색깔이 스코어보드 숫자번호대로 바뀐다.(0 = 흰색, 1 = 주황색)^(JE)
• 준비 : /scoreboard objectives add color dummy, /summon sheep X Y Z {Tags:[color],NoAI:1b}
• 반복 첫번째 : scoreboard players add $color color 1
• 연쇄 두번째(무조건) : execute if score $color color matches 16.. run scoreboard players set $color color 0
• 연쇄 세번째(무조건) : execute as @e[tag=color] store result entity @s Color int 1 run scoreboard players get $color color

• 플레이어의 특정 아이템 수 스코어보드로 나타내기.^(JE)
• 준비 : /scoreboard objectives add i.c dummy, /tag @s add i.c
• 반복 첫번째 : execute as @a[tag=i.c] store result score @s i.c run clear @s <특정 아이템> 0

• 플레이어가 밟고 있는 공급기에 조합법(부싯돌, 종이, 다이아몬드 검)이 충족되면 자동으로 날카로움 2 책으로 조합
• execute at @a positioned ~ ~-0.001 ~ if block ~ ~ ~ minecraft:dropper if items block ~ ~ ~ container.0 minecraft:flint if items block ~ ~ ~ container.1 minecraft:paper if items block ~ ~ ~ container.5 minecraft:paper if items block ~ ~ ~ container.7 minecraft:paper if items block ~ ~ ~ container.8 minecraft:diamond_sword run item replace block ~ ~ ~ container.4 with minecraft:enchanted_book[minecraft:stored_enchantments={"minecraft:sharpness":2}]