music_quiz: 버튼 interaction 0.5칸 어긋남 + btn_prep 파싱 에러 근본 수정

- btn.mcfunction 의 positioned $(x) $(y) $(z) → $(x).0 $(y).0 $(z).0.
  마인크래프트 vec3 인자는 정수만 쓰면 자동으로 +0.5 보정 (블록 중심으로
  잡힘) 되기 때문에 positioned 2773 86 5968 이 실제로는 (2773.5, 86,
  5968.5) 가 되고, 거기서 ~0.375 ~0.0625 같은 오프셋을 더해 interaction
  을 소환하면 박스가 블록 중앙으로 0.5 칸 밀린다. decimal 형태로 강제해
  보정 회피.

- btn_prep.mcfunction 을 execute-unless-data 방식에서 defaults 컴파운드 +
  merge 방식으로 재작성. 이전 v1.0.19 의 다중 공백 정규화는 근본 원인이
  아니었음 — `execute unless data storage mq:tmp btn.label run ...` 구문
  자체를 MC 26.1.2 파서가 거부. data modify ... merge from 으로 source 의
  키가 target 을 덮어쓰는 머지를 활용하면 같은 기능을 문제 라인 없이 구현.

- temp/ 부분 적용 패키지의 README 와 두 파일을 동기화. 진짜 원인 설명으로
  재작성.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

music_quiz/data/mq/function/repeat/buttons/btn.mcfunction

@@ -26,6 +26,12 @@
 # 인접: 중심 0.375 / 0.5 / 0.625, 각 폭 0.125 → 합 [0.3125, 0.6875]).
 # interaction Y 는 hitbox 바닥 → 소환 y = block y + 0.375, height = 0.25.
 #
+# ---- positioned 의 .5 보정 회피 ----
+# MC 의 vec3 인자는 정수만 쓰면 자동으로 +0.5 보정됨 (블록 중심으로 잡힘).
+# positioned 2773 86 5968 → 실제로는 (2773.5, 86, 5968.5).  거기서 ~ 오프셋
+# 을 더하면 박스 전체가 0.5 칸 어긋남.  $(x).0 $(y).0 $(z).0 처럼 decimal
+# 형태로 넘기면 보정 없이 정확한 블록 origin (minimal corner) 이 됨.
+#
 # ---- text_display 위치 (버튼 바로 아래 같은 벽면에 부착) ----
 # 같은 벽 (button 의 머리 normal 반대편 블록) 의 visible 면에 살짝 띄워
 # 부착. 텍스트 entity Y 는 텍스트 baseline 근방 → 아래 블록 바닥에 두면
@@ -35,9 +41,12 @@
 #   east  : ~0.01 ~-1 ~0.5    yaw -90
 #   west  : ~0.99 ~-1 ~0.5    yaw  90
 
-# ---- 비활성: 버튼 제거 + interaction 응답 차단 후 종료 ----
+# ---- 비활성: 블록 + interaction × 3 + text_display 전부 제거 후 종료 ----
+# data modify entity @e[...] 는 대상 1개 강제 → interaction 3개 모드에선
+# 못 쓰므로 그냥 kill. 어차피 버튼 블록도 air 로 바꾸므로 라벨도 같이 제거.
 $execute if score $(n) buttons matches ..-2 run setblock $(x) $(y) $(z) minecraft:air
-$execute if score $(n) buttons matches ..-2 run data modify entity @e[type=minecraft:interaction,tag=mq,tag=$(n)] response set value 0b
+$execute if score $(n) buttons matches ..-2 run kill @e[type=minecraft:interaction,tag=mq,tag=$(n)]
+$execute if score $(n) buttons matches ..-2 run kill @e[type=minecraft:text_display,tag=mq,tag=$(n)]
 $execute if score $(n) buttons matches ..-2 run return 0
 
 # ---- 초기화: 블록 + interaction × 3 + text_display 보장 ----
@@ -47,28 +56,28 @@ $execute if score $(n) buttons matches -1 run kill @e[type=minecraft:interaction
 $execute if score $(n) buttons matches -1 run kill @e[type=minecraft:text_display,tag=mq,tag=$(n)]
 
 # south: 깊이축=z(+0.0625), 가로축=x, 3 타일 + 라벨
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.375 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.5   ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.625 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"south"} positioned $(x) $(y) $(z) run summon minecraft:text_display ~0.5 ~-1 ~0.01 {Tags:["mq","$(n)"],Rotation:[0f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.375 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.5 ~-1 ~0.01 {Tags:["mq","$(n)"],Rotation:[0f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
 
 # north: 깊이축=z(+0.9375), 가로축=x, 3 타일 + 라벨
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.375 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.5   ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.625 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"north"} positioned $(x) $(y) $(z) run summon minecraft:text_display ~0.5 ~-1 ~0.99 {Tags:["mq","$(n)"],Rotation:[180f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.375 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.5 ~-1 ~0.99 {Tags:["mq","$(n)"],Rotation:[180f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
 
 # east: 깊이축=x(+0.0625), 가로축=z, 3 타일 + 라벨
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.0625 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.0625 ~0.375 ~0.5   {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.0625 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"east"} positioned $(x) $(y) $(z) run summon minecraft:text_display ~0.01 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[-90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.5 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.01 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[-90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
 
 # west: 깊이축=x(+0.9375), 가로축=z, 3 타일 + 라벨
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.9375 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.9375 ~0.375 ~0.5   {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x) $(y) $(z) run summon minecraft:interaction ~0.9375 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
-$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"west"} positioned $(x) $(y) $(z) run summon minecraft:text_display ~0.99 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.5 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.99 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
 
 $execute if score $(n) buttons matches -1 run scoreboard players set $(n) buttons 0
 
@@ -78,9 +87,9 @@ $execute if score $(n) buttons matches -1 run scoreboard players set $(n) button
 # 한 버튼에 interaction 3개지만 `on target` 은 클릭된 1개만 통과
 # (나머지는 target 부재로 체인 중단). limit=1 을 두면 MC 가 임의로 1개를
 # 골라 잘못된 entity 만 검사하므로 limit 두지 않음.
-$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x) $(y) $(z) run playsound minecraft:block.stone_button.click_on block @s ~ ~ ~ 1 1
-$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x) $(y) $(z) if score init main matches 0 run $(c)
-$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x) $(y) $(z) unless score init main matches 0 run trigger $(n)
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 run playsound minecraft:block.stone_button.click_on block @s ~ ~ ~ 1 1
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 if score init main matches 0 run $(c)
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 unless score init main matches 0 run trigger $(n)
 
 # ---- 처리 후 attack/interaction NBT 클리어 (다음 tick 중복 발화 방지) ----
 $execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] at @s run data remove entity @s attack

music_quiz/data/mq/function/repeat/buttons/btn_prep.mcfunction

@@ -1,13 +1,21 @@
 # 한 button entry 의 optional 필드 기본값을 채워 macro 호출 시 $(arg) 미존재
 # 에러를 방지한다. handler 에서 entry 복사 직후 호출.
 #
-# label        : 없으면 "" (빈 문자열) → btn 안의 text_display 분기는 label
+# label        : 없으면 "" (빈 문자열) -> btn 안의 text_display 분기는 label
 #                이 "" 이면 스킵.
 # label_color  : 기본 "black"
 # label_font   : 기본 "minecraft:default"
 # label_scale  : 기본 "1.0"  (Vector3f 의 한 축, 3축 동일하게 사용됨)
+#
+# 구현: defaults 컴파운드를 먼저 만들고 entry (mq:tmp.btn) 를 그 위에 merge
+# 한 뒤 다시 mq:tmp.btn 으로 되돌린다.  data modify ... merge from 은 source
+# compound 의 키로 target compound 를 덮어쓰므로 entry 에 있는 값은 보존되고
+# entry 에 없는 키만 default 값으로 채워진다.
+#
+# (이전에 `execute unless data storage mq:tmp btn.label run data modify ...`
+#  방식이었으나 MC 26.1.2 parser 가 해당 라인을 거부했음. merge 방식은 문제
+#  난 execute-unless-data 구문 자체를 제거.)
 
-execute unless data storage mq:tmp btn.label       run data modify storage mq:tmp btn.label       set value ""
-execute unless data storage mq:tmp btn.label_color run data modify storage mq:tmp btn.label_color set value "black"
-execute unless data storage mq:tmp btn.label_font  run data modify storage mq:tmp btn.label_font  set value "minecraft:default"
-execute unless data storage mq:tmp btn.label_scale run data modify storage mq:tmp btn.label_scale set value "1.0"
+data modify storage mq:tmp btn_default set value {label:"",label_color:"black",label_font:"minecraft:default",label_scale:"1.0"}
+data modify storage mq:tmp btn_default merge from storage mq:tmp btn
+data modify storage mq:tmp btn set from storage mq:tmp btn_default

temp/README.md

@@ -0,0 +1,78 @@
+# v1.0.18 → v1.0.20 부분 적용 가이드
+
+전체 datapack 을 교체하지 않고, 이 폴더의 두 파일만 덮어쓰면 v1.0.20 과 동일한 상태가 됩니다.
+
+## 무엇이 바뀌었나 (진짜 원인)
+
+### 1. `repeat/buttons/btn.mcfunction` — interaction 박스가 버튼에서 0.5 칸 어긋나던 문제
+
+마인크래프트 명령의 vec3 좌표 인자는 **정수만 적으면 자동으로 +0.5 보정** 됩니다
+(블록 중심으로 잡힘). 즉
+
+```
+positioned 2773 86 5968
+```
+
+는 실제로 `(2773.5, 86, 5968.5)` 가 됩니다. 그래서 거기서 `~0.375 ~0.375 ~0.0625`
+를 더해 interaction 을 소환하면 박스 전체가 블록 중앙 쪽으로 0.5 칸 밀려서
+버튼과 어긋나 보입니다 (사용자가 보내준 사진의 정확히 그 증상).
+
+수정: `positioned $(x) $(y) $(z)` → `positioned $(x).0 $(y).0 $(z).0`.
+매크로 expand 결과가 `positioned 2773.0 86.0 5968.0` 처럼 decimal 형태가
+되어 .5 보정이 발생하지 않고 블록의 minimal corner 가 정확히 origin 으로
+잡힙니다.
+
+### 2. `repeat/buttons/btn_prep.mcfunction` — `btn.label <--[HERE]` 파싱 에러
+
+이전 구현은
+
+```
+execute unless data storage mq:tmp btn.label run data modify storage mq:tmp btn.label set value ""
+```
+
+같은 식이었는데 MC 26.1.2 의 명령 파서가 이 라인을 거부했습니다. 문제 난
+`execute unless data storage ... <path>` 구문 자체를 제거하고, defaults
+컴파운드 위에 entry 를 merge 하는 방식으로 다시 작성했습니다.
+
+```
+data modify storage mq:tmp btn_default set value {label:"",label_color:"black",label_font:"minecraft:default",label_scale:"1.0"}
+data modify storage mq:tmp btn_default merge from storage mq:tmp btn
+data modify storage mq:tmp btn set from storage mq:tmp btn_default
+```
+
+`data modify ... merge from` 은 source 의 키로 target 을 덮어쓰므로,
+entry 에 있는 값은 보존되고 entry 에 없는 키만 default 값으로 채워집니다.
+기능적으로는 이전과 같지만 문제 난 라인 자체가 없어졌습니다.
+
+## 적용 방법
+
+이 폴더의 `data/` 트리는 datapack 의 `data/` 트리와 같은 구조입니다.
+서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 두 파일을
+**반드시 덮어쓰세요**.
+
+```
+temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
+  -> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction   (덮어쓰기)
+
+temp/data/mq/function/repeat/buttons/btn.mcfunction
+  -> <datapack>/data/mq/function/repeat/buttons/btn.mcfunction        (덮어쓰기)
+```
+
+`btn_prep.mcfunction` 은 v1.0.17 이후에 추가된 파일이라, v1.0.16 이하에서
+바로 v1.0.20 으로 점프한다면 새로 생성되는 것입니다. v1.0.17 / v1.0.18 /
+v1.0.19 이미 설치된 환경이라면 기존 파일을 반드시 덮어써야 합니다 (남아 있는
+구버전 파일이 reload 시 같은 파싱 에러를 일으킵니다).
+
+복사 후 게임 안에서:
+
+```
+/reload
+```
+
+## 확인
+
+- `/reload` 시 콘솔에 `Failed to load function mq:repeat/buttons/btn_prep`
+  같은 파싱 에러가 더 이상 뜨지 않아야 합니다.
+- 버튼 위치에 interaction 박스가 정확히 버튼 머리를 감싸야 합니다
+  (이전처럼 옆으로 0.5 칸 어긋나지 않아야 합니다).
+- 버튼을 클릭했을 때 정상적으로 동작하면 적용 성공입니다.

temp/data/mq/function/repeat/buttons/btn.mcfunction

@@ -0,0 +1,96 @@
+# 버튼 1개에 대한 매 tick 처리.
+# 매크로 인자(mq:tmp.btn): n, x, y, z, f, c, label, label_color, label_font, label_scale
+#   buttons 점수 상태:
+#     ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단)
+#     -1   : 초기화 단계 (버튼 블록 + interaction × 3 + text_display 보장 후 0)
+#     0    : 정상 (interaction 클릭 대기)
+#
+#   interaction/text_display entity 는 데이터팩이 직접 summon — /reload 시
+#   commands/stop 에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직
+#   실행. -1 단계에서 같은 태그 entity 를 모두 kill 후 정확한 개수만 다시
+#   summon → 항상 idempotent (dup 누적 없음, 좌표/라벨 갱신 자동 반영).
+#
+# ---- facing → 머리 hitbox 위치 (이 파일 한 곳에서만 정의) ----
+# stone_button[face=wall, facing=X] AABB (블록 상대 좌표):
+#   facing 의 의미 = "버튼 머리 visible 면의 normal 방향". 머리는 그 방향
+#   쪽 face 에 붙어 있고 hitbox 는 그 face 에서 안쪽(1/8) 만큼 들어감.
+#     south : z ∈ [0,    0.125]   가로 x ∈ [0.3125, 0.6875]
+#     north : z ∈ [0.875, 1]      가로 x ∈ [0.3125, 0.6875]
+#     east  : x ∈ [0,    0.125]   가로 z ∈ [0.3125, 0.6875]
+#     west  : x ∈ [0.875, 1]      가로 z ∈ [0.3125, 0.6875]
+#   세로 y ∈ [0.375, 0.625] 공통.
+#
+# interaction entity 의 horizontal hitbox 는 width × width 정사각형 강제라
+# 단일 entity 로는 "가로 0.375 × 두께 0.125" 직사각형 불가. → 두께(0.125)
+# 와 같은 width=0.125 인 interaction 을 가로축으로 3 개 타일링 (gap 없이
+# 인접: 중심 0.375 / 0.5 / 0.625, 각 폭 0.125 → 합 [0.3125, 0.6875]).
+# interaction Y 는 hitbox 바닥 → 소환 y = block y + 0.375, height = 0.25.
+#
+# ---- positioned 의 .5 보정 회피 ----
+# MC 의 vec3 인자는 정수만 쓰면 자동으로 +0.5 보정됨 (블록 중심으로 잡힘).
+# positioned 2773 86 5968 → 실제로는 (2773.5, 86, 5968.5).  거기서 ~ 오프셋
+# 을 더하면 박스 전체가 0.5 칸 어긋남.  $(x).0 $(y).0 $(z).0 처럼 decimal
+# 형태로 넘기면 보정 없이 정확한 블록 origin (minimal corner) 이 됨.
+#
+# ---- text_display 위치 (버튼 바로 아래 같은 벽면에 부착) ----
+# 같은 벽 (button 의 머리 normal 반대편 블록) 의 visible 면에 살짝 띄워
+# 부착. 텍스트 entity Y 는 텍스트 baseline 근방 → 아래 블록 바닥에 두면
+# 텍스트가 그 블록 안에 위로 솟아남.
+#   south : ~0.5  ~-1 ~0.01   yaw   0   (head 가 +z 방향 → 벽 +z=0.01 살짝 띄움)
+#   north : ~0.5  ~-1 ~0.99   yaw 180
+#   east  : ~0.01 ~-1 ~0.5    yaw -90
+#   west  : ~0.99 ~-1 ~0.5    yaw  90
+
+# ---- 비활성: 블록 + interaction × 3 + text_display 전부 제거 후 종료 ----
+# data modify entity @e[...] 는 대상 1개 강제 → interaction 3개 모드에선
+# 못 쓰므로 그냥 kill. 어차피 버튼 블록도 air 로 바꾸므로 라벨도 같이 제거.
+$execute if score $(n) buttons matches ..-2 run setblock $(x) $(y) $(z) minecraft:air
+$execute if score $(n) buttons matches ..-2 run kill @e[type=minecraft:interaction,tag=mq,tag=$(n)]
+$execute if score $(n) buttons matches ..-2 run kill @e[type=minecraft:text_display,tag=mq,tag=$(n)]
+$execute if score $(n) buttons matches ..-2 run return 0
+
+# ---- 초기화: 블록 + interaction × 3 + text_display 보장 ----
+$execute unless score $(n) buttons matches -1.. run scoreboard players set $(n) buttons -1
+$execute if score $(n) buttons matches -1 run setblock $(x) $(y) $(z) minecraft:stone_button[face=wall,facing=$(f),powered=false]
+$execute if score $(n) buttons matches -1 run kill @e[type=minecraft:interaction,tag=mq,tag=$(n)]
+$execute if score $(n) buttons matches -1 run kill @e[type=minecraft:text_display,tag=mq,tag=$(n)]
+
+# south: 깊이축=z(+0.0625), 가로축=x, 3 타일 + 라벨
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.375 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~0.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"south"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.5 ~-1 ~0.01 {Tags:["mq","$(n)"],Rotation:[0f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+
+# north: 깊이축=z(+0.9375), 가로축=x, 3 타일 + 라벨
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.375 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~0.9375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.5 ~-1 ~0.99 {Tags:["mq","$(n)"],Rotation:[180f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+
+# east: 깊이축=x(+0.0625), 가로축=z, 3 타일 + 라벨
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.5 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.0625 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"east"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.01 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[-90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+
+# west: 깊이축=x(+0.9375), 가로축=z, 3 타일 + 라벨
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.375 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.5 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.9375 ~0.375 ~0.625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
+$execute if score $(n) buttons matches -1 unless data storage mq:tmp btn{label:""} if data storage mq:tmp btn{f:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:text_display ~0.99 ~-1 ~0.5 {Tags:["mq","$(n)"],Rotation:[90f,0f],background:0,text:'{"text":"$(label)","color":"$(label_color)","font":"$(label_font)"}',transformation:{scale:[$(label_scale)f,$(label_scale)f,$(label_scale)f],translation:[0f,0f,0f],left_rotation:[0f,0f,0f,1f],right_rotation:[0f,0f,0f,1f]}}
+
+$execute if score $(n) buttons matches -1 run scoreboard players set $(n) buttons 0
+
+# ---- 상시: interaction 클릭/타격 → playsound + 명령/투표 실행 ----
+# init main = 0 (퀴즈 시작 전 설정 단계) : 명령 직접 실행
+# 그 외                                  : trigger 투표 경로
+# 한 버튼에 interaction 3개지만 `on target` 은 클릭된 1개만 통과
+# (나머지는 target 부재로 체인 중단). limit=1 을 두면 MC 가 임의로 1개를
+# 골라 잘못된 entity 만 검사하므로 limit 두지 않음.
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 run playsound minecraft:block.stone_button.click_on block @s ~ ~ ~ 1 1
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 if score init main matches 0 run $(c)
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] on target as @s positioned $(x).0 $(y).0 $(z).0 unless score init main matches 0 run trigger $(n)
+
+# ---- 처리 후 attack/interaction NBT 클리어 (다음 tick 중복 발화 방지) ----
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] at @s run data remove entity @s attack
+$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] at @s run data remove entity @s interaction

temp/data/mq/function/repeat/buttons/btn_prep.mcfunction

@@ -0,0 +1,21 @@
+# 한 button entry 의 optional 필드 기본값을 채워 macro 호출 시 $(arg) 미존재
+# 에러를 방지한다. handler 에서 entry 복사 직후 호출.
+#
+# label        : 없으면 "" (빈 문자열) -> btn 안의 text_display 분기는 label
+#                이 "" 이면 스킵.
+# label_color  : 기본 "black"
+# label_font   : 기본 "minecraft:default"
+# label_scale  : 기본 "1.0"  (Vector3f 의 한 축, 3축 동일하게 사용됨)
+#
+# 구현: defaults 컴파운드를 먼저 만들고 entry (mq:tmp.btn) 를 그 위에 merge
+# 한 뒤 다시 mq:tmp.btn 으로 되돌린다.  data modify ... merge from 은 source
+# compound 의 키로 target compound 를 덮어쓰므로 entry 에 있는 값은 보존되고
+# entry 에 없는 키만 default 값으로 채워진다.
+#
+# (이전에 `execute unless data storage mq:tmp btn.label run data modify ...`
+#  방식이었으나 MC 26.1.2 parser 가 해당 라인을 거부했음. merge 방식은 문제
+#  난 execute-unless-data 구문 자체를 제거.)
+
+data modify storage mq:tmp btn_default set value {label:"",label_color:"black",label_font:"minecraft:default",label_scale:"1.0"}
+data modify storage mq:tmp btn_default merge from storage mq:tmp btn
+data modify storage mq:tmp btn set from storage mq:tmp btn_default

temp/gif.png.mcmeta

@@ -1,6 +0,0 @@
-{
-  "animation": {
-    "frametime": 1,
-    "interpolate": false
-  }
-}