music_quiz: v1.0.22 게이트 제거 되돌림 — 진짜 fix 는 모드 v1.3.6 에서

v1.0.22 는 채팅정답 모드 false negative 를 게이트 자체를 삭제해서 회피
했는데, 이건 채팅정답 모드 서버 설치 검증 자체를 잃는 잘못된 방향이었음.
모드 없는 서버에서도 시작이 됨.

진짜 root cause 는 모드 쪽 presence pulse 가 매 server tick 단일 hook
이라 banner/mohist 같은 fabric-bukkit 하이브리드에서 안 firing 되던 것.
mc_chat_answer_mod v1.3.6 에서 SERVER_STARTED / PlayerJoin / ServerTick
셋으로 확장 — 어느 한 이벤트만 firing 돼도 점수 갱신.

이 commit 은 데이터팩 쪽 v1.0.22 변경을 되돌림 (start.mcfunction 의
mq_chat_mod 게이트, load.mcfunction 의 mq_chat_mod objective add/set
복구). 결과적으로 v1.0.21 의 데이터팩 동작과 동일.

temp/README.md 갱신 — v1.0.23 로 가는 절차는 모드 jar 업그레이드 + (만약
v1.0.22 를 거쳐갔다면) start/load 두 파일 덮어쓰기. v1.0.21 에서 곧장
v1.0.23 으로 오면 datapack 파일은 동일하므로 사실상 모드 업그레이드만.

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

music_quiz/data/minecraft/tags/dialog/quick_actions.json

@@ -1,6 +1,6 @@
 {
   "replace": false,
   "values": [
-    "mq:answer"
+    { "id": "mq:answer", "required": false }
   ]
 }

music_quiz/data/mq/function/commands/stop.mcfunction

@@ -66,5 +66,11 @@ data modify storage mq:main answer set value {title:"음악퀴즈", alias:[]}
 # 이전 버전이 남긴 legacy marker 정리 (현재는 marker 사용 안 함)
 kill @e[type=minecraft:marker,tag=mq]
 
+# 이전 버전이 남긴 잔존 text_display 정리.
+# 현재 버튼은 -1 init 단계에서 같은 tag interaction 만 kill 하므로 (n 태그
+# 가 일치할 때만), 옛 버튼 정의에 있던 이름의 text_display 가 남으면 안
+# 지워짐. 여기서 mq 태그 전체를 한 번에 정리해 stale 제거.
+kill @e[type=minecraft:text_display,tag=mq]
+
 function mq:quiz/stop_sound
 function mq:images/clear

music_quiz/data/mq/function/init/buttons.mcfunction

@@ -1,25 +1,23 @@
 # 버튼 정의. 각 항목 의미:
-#   n : 이름 (= 트리거/태그)        x,y,z : 버튼 블록 좌표        f : facing
+#   n : 이름 (= 트리거/태그)
+#   x,y,z : 버튼 블록 좌표
+#   f : facing (south / north / east / west)
 #   c : 클릭 시 실행 명령 (init=0 직접, 그 외 trigger $(n) 투표)
-#   ox,oy,oz : interaction entity 소환 위치 오프셋 (블록 좌표 기준)
-#   w,h      : interaction width / height (float)
 #
-# stone_button[face=wall] hitbox: 가로 6/16 (0.375), 세로 4/16 (0.25),
-# 두께 2/16 (0.125), 벽 반대편으로만 튀어나옴. interaction 의 horizontal
-# hitbox 는 width × width 정사각형 강제 → width 를 가로(0.375) 에 맞추고
-# 위치 보정으로 "튀어나온 쪽 면 = visible face" 가 되게 함. 반대편은
-# 벽 블록 속으로 들어가 invisible.
+# optional 필드 (버튼 아래 y-1 위치에 같은 벽면 라벨 부착):
+#   label        : 표시할 텍스트. 생략하면 라벨 없음.
+#   label_color  : 텍스트 색 (예 "black", "red", "#FFAA00"). 기본 "black".
+#   label_font   : 텍스트 폰트 (예 "minecraft:default"). 기본 "minecraft:default".
+#   label_scale  : 텍스트 크기 (Vector3f 한 축, 3축 동일). 기본 "1.0".
 #
-# facing 별 오프셋:
-#   south : ox=0.5     oy=0.375  oz=-0.0625
-#   north : ox=0.5     oy=0.375  oz=1.0625
-#   east  : ox=-0.0625 oy=0.375  oz=0.5
-#   west  : ox=1.0625  oy=0.375  oz=0.5
+# interaction entity 의 위치/크기와 text_display 의 위치/회전은 facing 만
+# 보면 결정됨 — 매번 손으로 ox/oy/oz 를 적지 않는다. 실제 오프셋 테이블은
+# repeat/buttons/btn 안에서 한 곳에만 정의되어 있다.
 
 data modify storage mq:main button_defs set value []
-data modify storage mq:main button_defs append value {n:"start",  x:140, y:62, z:-225, f:"south", c:"function mq:commands/start with storage mq:main", ox:"0.5", oy:"0.375", oz:"-0.0625", w:"0.375", h:"0.25"}
-data modify storage mq:main button_defs append value {n:"stop",   x:142, y:62, z:-225, f:"south", c:"function mq:commands/stop with storage mq:main",  ox:"0.5", oy:"0.375", oz:"-0.0625", w:"0.375", h:"0.25"}
-data modify storage mq:main button_defs append value {n:"skip",   x:144, y:62, z:-225, f:"south", c:"function mq:commands/skip",                       ox:"0.5", oy:"0.375", oz:"-0.0625", w:"0.375", h:"0.25"}
-data modify storage mq:main button_defs append value {n:"hint",   x:146, y:62, z:-225, f:"south", c:"function mq:commands/hint",                       ox:"0.5", oy:"0.375", oz:"-0.0625", w:"0.375", h:"0.25"}
-data modify storage mq:main button_defs append value {n:"replay", x:148, y:62, z:-225, f:"south", c:"function mq:commands/replay",                     ox:"0.5", oy:"0.375", oz:"-0.0625", w:"0.375", h:"0.25"}
-data modify storage mq:main button_defs append value {n:"test",   x:144, y:62, z:-213, f:"north", c:"function mq:commands/test",                       ox:"0.5", oy:"0.375", oz:"1.0625",  w:"0.375", h:"0.25"}
+data modify storage mq:main button_defs append value {n:"start",  x:364, y:146, z:-263, f:"east", c:"function mq:commands/start with storage mq:main", label:"게임시작"}
+data modify storage mq:main button_defs append value {n:"stop",   x:364, y:146, z:-265, f:"east", c:"function mq:commands/stop with storage mq:main",  label:"정지"}
+data modify storage mq:main button_defs append value {n:"skip",   x:364, y:146, z:-267, f:"east", c:"function mq:commands/skip",                       label:"넘기기"}
+data modify storage mq:main button_defs append value {n:"hint",   x:364, y:146, z:-269, f:"east", c:"function mq:commands/hint",                       label:"힌트"}
+data modify storage mq:main button_defs append value {n:"replay", x:364, y:146, z:-271, f:"east", c:"function mq:commands/replay",                     label:"다시듣기"}
+data modify storage mq:main button_defs append value {n:"test",   x:144, y:62,  z:-213, f:"north", c:"function mq:commands/test",                      label:"소리 테스트"}

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

@@ -1,38 +1,105 @@
 # 버튼 1개에 대한 매 tick 처리.
-# 매크로 인자: n, x, y, z, f, c, ox, oy, oz, w, h
-#   ox/oy/oz : interaction 소환 위치 오프셋 (블록 좌표 기준, facing 별)
-#   w / h    : interaction width / height (float, 버튼 hitbox 정합용)
+# 매크로 인자(mq:tmp.btn): n, x, y, z, f, c, label, label_color, label_font, label_scale
 #   buttons 점수 상태:
 #     ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단)
-#     -1   : 초기화 단계 (버튼 블록 배치 + interaction entity 보장 후 0 으로)
+#     -1   : 초기화 단계 (버튼 블록 + interaction × 3 + text_display 보장 후 0)
 #     0    : 정상 (interaction 클릭 대기)
 #
-#   interaction entity 는 데이터팩이 직접 summon — /reload 시 commands/stop
-#   에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직이 실행됨.
-#   -1 단계에서 같은 태그 entity 를 모두 kill 후 정확히 1개 summon → dup
-#   누적 없이 항상 "버튼당 1개, 올바른 좌표" 상태로 수렴 (idempotent).
+#   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.
+#
+# ---- 깊이축: 블록 면 바로 바깥 (이중 트리거 방지) ----
+# interaction 박스가 stone_button hitbox 와 겹치면 한 번 클릭에 interaction
+# 도 발화하고 stone_button 도 vanilla 클릭으로 인식되어 powered=true 애니
+# 메이션이 같이 일어남. → interaction 박스를 버튼 면 바깥쪽으로 한 두께
+# (0.125) 만큼 빼 ray 가 stone_button 에 닿기 전에 interaction 에서 멈추게.
+#   south : 깊이 z 중심 = -0.0625  (interaction z ∈ [-0.125, 0],   버튼 z ∈ [0, 0.125])
+#   north : 깊이 z 중심 =  1.0625  (interaction z ∈ [1, 1.125],    버튼 z ∈ [0.875, 1])
+#   east  : 깊이 x 중심 = -0.0625
+#   west  : 깊이 x 중심 =  1.0625
+#
+# ---- 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 응답 차단 후 종료 ----
+# ---- 비활성: 블록 + 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),limit=1] 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 entity 보장 ----
-# 기존 mq/$(n) interaction 을 전부 제거 후 정확히 1개 소환.
-# 옛 월드 cmd block 으로 누적 소환된 dup 이나 엉뚱한 좌표에 남은 잔존
-# entity 까지 정리 → "정상 상태(버튼당 정확히 1개, 올바른 좌표)" 가 보장됨.
+# ---- 초기화: 블록 + 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 positioned $(x) $(y) $(z) positioned ~$(ox) ~$(oy) ~$(oz) run summon minecraft:interaction ~ ~ ~ {Tags:["mq","$(n)"],width:$(w)f,height:$(h)f,response:0b}
+$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(+1.0625, 블록 면 바깥), 가로축=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 ~1.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:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~1.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:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~1.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:"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(+1.0625, 블록 면 바깥), 가로축=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 ~1.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:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~1.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:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~1.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:"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 투표 경로
-$execute as @e[type=minecraft:interaction,tag=mq,tag=$(n),limit=1] 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),limit=1] 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),limit=1] on target as @s positioned $(x) $(y) $(z) unless score init main matches 0 run trigger $(n)
+# 한 버튼에 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

music_quiz/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

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

@@ -1,6 +1,27 @@
-function mq:repeat/buttons/btn with storage mq:main button_defs[0]
-function mq:repeat/buttons/btn with storage mq:main button_defs[1]
-function mq:repeat/buttons/btn with storage mq:main button_defs[2]
-function mq:repeat/buttons/btn with storage mq:main button_defs[3]
-function mq:repeat/buttons/btn with storage mq:main button_defs[4]
-function mq:repeat/buttons/btn with storage mq:main button_defs[5]
+# 각 button_defs 항목을 mq:tmp.btn 으로 복사 → optional 필드 기본값 채움
+# → btn 호출. btn 안에서 facing 별 분기 (if data storage mq:tmp btn{f:"..."})
+# 와 macro arg ($(label) 등) 둘 다 사용 가능하게 같은 storage 에 노출시킨다.
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[0]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[1]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[2]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[3]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[4]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn
+
+data modify storage mq:tmp btn set from storage mq:main button_defs[5]
+function mq:repeat/buttons/btn_prep
+function mq:repeat/buttons/btn with storage mq:tmp btn

temp/README.md

@@ -0,0 +1,96 @@
+# 부분 적용 가이드 (→ v1.0.23)
+
+전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.23 와 동일한 상태가 됩니다.
+
+## v1.0.23 의 핵심 변경 — 채팅정답 모드 false negative 의 진짜 fix
+
+증상: 채팅정답 모드를 설치했는데도 `/start` 가 "채팅정답 모드가 서버에 미설치"
+로 차단됨.
+
+원인: 검증은 모드가 매 server tick `#server mq_chat_mod` 점수를 1 로 set
+하는지 보는 방식인데, 다음 케이스에서 score 가 1 로 안 올라가 false negative:
+- 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 사용 중
+- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서 `ServerTickEvents`
+  가 안 들어옴
+
+근본 fix: **데이터팩 가드는 그대로 유지하고, 모드 쪽에서 presence pulse
+지점을 셋으로 확장 — `SERVER_STARTED` + `PlayerJoin` + `ServerTick` 중
+하나만 firing 돼도 점수가 1 로 올라가게.**
+
+→ 그래서 v1.0.23 의 데이터팩 자체는 v1.0.21 과 사실상 같다. 진짜 fix 는
+**`mc_chat_answer_mod` v1.3.6** 에 들어 있다.
+
+### v1.0.22 에서 v1.0.23 으로 — 잘못된 방향을 되돌림
+
+v1.0.22 (잠시 릴리스됨) 는 게이트 자체를 제거하는 방향으로 갔다 — 잘못된
+선택이었음. 채팅정답 모드 서버 설치 검증을 잃어버려서 모드 없는 서버에서도
+시작이 됨. v1.0.23 은 v1.0.22 의 데이터팩 변경을 되돌려 `commands/start.mcfunction`
+과 `load.mcfunction` 의 `mq_chat_mod` 게이트와 objective 를 복구.
+
+## 같이 포함된 이전 fix (v1.0.20, v1.0.21)
+
+### `repeat/buttons/btn.mcfunction`
+- (v1.0.20) `positioned $(x) $(y) $(z)` → `$(x).0 $(y).0 $(z).0`.
+  MC vec3 정수 인자의 +0.5 보정 (블록 중심) 으로 interaction 박스가 0.5 칸
+  어긋나던 문제 회피.
+- (v1.0.21) interaction 깊이축을 stone_button hitbox 바깥쪽으로 한 두께만큼
+  이동. 한 번 클릭에 stone_button 도 같이 눌리던 (powered=true) 문제 회피.
+- (v1.0.21) `text_display.text` 를 String JSON 에서 직접 TextComponent
+  compound 로. MC 1.20.5+ 부터 라벨이 `{"text":"게임시작",...}` 코드 그대로
+  렌더되던 문제 회피.
+
+### `repeat/buttons/btn_prep.mcfunction`
+- (v1.0.20) `execute unless data storage mq:tmp btn.label ...` 가 MC 26.1.2
+  파서에 거부되던 문제. defaults + `data modify ... merge from` 방식으로
+  재작성.
+
+## 적용 방법
+
+### 1. `mc_chat_answer_mod` v1.3.6 으로 업그레이드 (false negative 해결의 핵심)
+
+서버의 mods 폴더에서 기존 `chat_answer-*.jar` 를 제거하고
+`chat_answer-1.3.6.jar` 를 넣는다.
+
+다운로드: https://git.tkrmagid.kr/tkrmagid/mc_chat_answer_mod/releases/tag/v1.3.6
+
+서버 재시작 필요 (모드 jar 교체이므로).
+
+### 2. 데이터팩 파일 덮어쓰기
+
+서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 이 폴더의
+파일을 **같은 경로에 덮어쓰세요**.
+
+```
+temp/data/mq/function/commands/start.mcfunction
+  -> <datapack>/data/mq/function/commands/start.mcfunction
+
+temp/data/mq/function/load.mcfunction
+  -> <datapack>/data/mq/function/load.mcfunction
+
+temp/data/mq/function/repeat/buttons/btn.mcfunction
+  -> <datapack>/data/mq/function/repeat/buttons/btn.mcfunction
+
+temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
+  -> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction
+```
+
+이미 v1.0.21 을 적용한 상태였다면 사실 datapack 파일은 그대로 같다 —
+모드 jar 업그레이드만 하면 끝. (v1.0.22 를 한 번 거쳐갔다면 위 두
+`start/load` 파일을 덮어써서 게이트를 복구해야 함.)
+
+복사 후 게임 안에서:
+
+```
+/reload
+```
+
+## 확인
+
+- 채팅정답 모드가 설치되어 있으면 `/start` 가 "채팅정답 모드 미설치" 메시지
+  없이 정상 진행.
+- 채팅정답 모드가 진짜 서버에 없으면 (또는 모드 v1.3.5 이하 + tick 이벤트
+  미작동 호스트 조합이면) 여전히 "채팅정답 모드가 서버에 미설치" 로 차단되어
+  관리자에게 안내 — 이게 의도된 동작 (가드 살아 있음).
+- 버튼 클릭 시 stone_button 의 powered 애니메이션 없음.
+- 라벨이 `게임시작` 등으로 정상 표시 (JSON 코드 노출 없음).
+- 콘솔에 파싱 에러 없음.

temp/data/mq/function/commands/start.mcfunction

@@ -0,0 +1,41 @@
+execute if score init main matches 10 run return run function mq:tellraw {"text":"퀴즈가 완전히 종료된후 시작해주세요.","color":"red","msg":""}
+
+# ---- 외부 모드 설치 검증 ----
+# 두 모드는 성격이 달라서 검증 방식이 다름:
+#
+#   * mq_chat_mod  : mc_chat_answer_mod = 서버 전용 모드 (채팅 가로채기는
+#     서버에서 일어남, 클라 설치 불필요). 따라서 fake player `#server`
+#     점수를 모드가 매 server tick 마다 1 로 set. 서버에 모드가 없으면
+#     이 점수가 갱신되지 않음.
+#
+#   * mq_video_mod : mc_video_player_mod = 클라이언트 측 렌더링 + 서버 측
+#     컴포넌트. 같은 objective 안에 holder 두 종류 사용:
+#       - `#server mq_video_mod` : 서버 컴포넌트가 매 tick 1 로 갱신 (server
+#         presence). 없으면 0 → 서버에 모드 미설치.
+#       - `<player> mq_video_mod` : 클라 join 시 payload 가 서버로 오면 서버
+#         컴포넌트가 해당 플레이어 점수를 1 로 set (client presence). 클라
+#         미설치면 0 유지.
+#     이렇게 분리해야 "서버 미설치"와 "특정 플레이어 클라 미설치"가 안내에서
+#     구분된다.
+#
+# 1) 서버 측 모드 부재 — 전원 차단, 단일 안내. 서버 부재는 클라 검사보다
+#    우선해야 — 클라가 다 설치되어 있어도 서버가 없으면 동작 안 한다.
+execute unless score #server mq_chat_mod matches 1 run return run function mq:tellraw {"text":"채팅정답 모드가 서버에 미설치 — 서버 관리자에게 문의해주세요.","color":"red","msg":""}
+execute unless score #server mq_video_mod matches 1 run return run function mq:tellraw {"text":"영상재생 모드가 서버에 미설치 — 서버 관리자에게 문의해주세요.","color":"red","msg":""}
+
+# 2) 클라이언트 측 모드 (mc_video_player_mod) 부재 — 본인 누락 안내 + 차단.
+#    selector `scores={X=..0}` 는 점수 미존재를 매치하지 않으므로 직전에
+#    `add @a ... 0` 으로 materialize. 개인 안내는 tellraw @s 직접 (mq:tellraw
+#    는 내부 @a broadcast 라 부적합).
+scoreboard players add @a mq_video_mod 0
+execute as @a[scores={mq_video_mod=..0}] run tellraw @s ["",{"text":"영상재생 모드 미설치 — 모드 적용 후 다시 입장해주세요.","color":"red"}]
+execute if entity @a[scores={mq_video_mod=..0}] run return run function mq:tellraw {"text":"필수 모드 미설치 플레이어가 있어 시작할 수 없습니다.","color":"red","msg":""}
+
+setblock ~ ~ ~ minecraft:air
+
+function mq:quiz/stop_sound
+
+$scoreboard players set max_index main $(max_index)
+scoreboard players set init main 1
+
+dialog show @a mq:page1

temp/data/mq/function/load.mcfunction

@@ -0,0 +1,47 @@
+data modify storage mq:main answer set value {title:"", author:"", alias:[]}
+data merge storage func:temp {}
+data merge storage mq:tmp {}
+
+function mq:init/config
+function mq:init/songs
+function mq:init/buttons
+function mq:init/triggers
+
+function mq:tellraw {"text":"서버 리로드 성공!","color":"white","msg":'""'}
+
+scoreboard objectives remove func.temp
+scoreboard objectives remove main
+scoreboard objectives remove buttons
+scoreboard objectives remove answer
+scoreboard objectives remove leave_game
+
+scoreboard objectives add func.temp dummy
+scoreboard objectives add main dummy
+scoreboard objectives add buttons dummy
+scoreboard objectives add answer dummy
+scoreboard objectives add leave_game custom:leave_game
+
+# 외부 모드 존재 확인용 점수.
+#   mq_chat_mod  : 서버 전용 모드(mc_chat_answer_mod). 모드가 매 server tick
+#     마다 fake player `#server` 점수를 1 로 set. 모드가 서버에 없으면 0 유지.
+#   mq_video_mod : 클라이언트 모드(mc_video_player_mod). 클라 join 시 서버로
+#     handshake payload 전송 → 서버 측 모드가 해당 플레이어 점수를 1 로 set.
+#     클라에 모드가 없으면 0 유지. (login.mcfunction 에서 플레이어별 0 초기화.)
+scoreboard objectives remove mq_chat_mod
+scoreboard objectives remove mq_video_mod
+scoreboard objectives add mq_chat_mod dummy
+scoreboard objectives add mq_video_mod dummy
+# /reload 후 모드가 한 tick 도 돌기 전에 start 가 호출될 수 있으니
+# #server 점수도 0 으로 materialize. 모드가 살아 있으면 다음 tick 에 1 로 갱신.
+# mq_video_mod 도 같은 objective 안에서 holder 만 다르게 — `#server` 는 서버
+# 컴포넌트 존재 (서버 측 모드가 매 tick 1 로 갱신), `<player>` 는 클라 측
+# 존재 (payload 수신 시 1 로 갱신).
+scoreboard players set #server mq_chat_mod 0
+scoreboard players set #server mq_video_mod 0
+
+scoreboard players set two func.temp 2
+
+bossbar add mq:process [{"text":"진행도: ","color": "yellow","bold": true},{"text":"0","color": "yellow","bold": true},{"text":"/","color": "yellow","bold": true},{"text":"0","color": "yellow","bold": true}]
+
+function mq:commands/stop with storage mq:main
+function mq:players/login with storage mq:main spawn

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

@@ -0,0 +1,106 @@
+# 버튼 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.
+#
+# ---- 깊이축: 블록 면 바로 바깥 (이중 트리거 방지) ----
+# interaction 박스가 stone_button hitbox 와 겹치면 한 번 클릭에 interaction
+# 도 발화하고 stone_button 도 vanilla 클릭으로 인식되어 powered=true 애니
+# 메이션이 같이 일어남. → interaction 박스를 버튼 면 바깥쪽으로 한 두께
+# (0.125) 만큼 빼 ray 가 stone_button 에 닿기 전에 interaction 에서 멈추게.
+#   south : 깊이 z 중심 = -0.0625  (interaction z ∈ [-0.125, 0],   버튼 z ∈ [0, 0.125])
+#   north : 깊이 z 중심 =  1.0625  (interaction z ∈ [1, 1.125],    버튼 z ∈ [0.875, 1])
+#   east  : 깊이 x 중심 = -0.0625
+#   west  : 깊이 x 중심 =  1.0625
+#
+# ---- 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(+1.0625, 블록 면 바깥), 가로축=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 ~1.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:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.5 ~0.375 ~1.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:"north"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~0.625 ~0.375 ~1.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:"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(+1.0625, 블록 면 바깥), 가로축=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 ~1.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:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~1.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:"west"} positioned $(x).0 $(y).0 $(z).0 run summon minecraft:interaction ~1.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:"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
-  }
-}