music_quiz: 버튼 비활성 분기에서 data modify entity 단일 대상 제약 회피

interaction 이 버튼당 3개가 된 이후 (v1.0.16+) `data modify entity @e[...] response set value 0b` 가 다중 대상 에러로 실패. 어차피 비활성 시점에 버튼 블록은 air 로 바꾸므로 interaction 과 text_display 도 함께 kill 하는 게 일관적 — 라벨이 stale 로 남는 것도 방지.
music_quiz: 버튼 머리 hitbox 정확한 면 정합 + 라벨 text_display 자동 부착
2026-05-17 04:17:58 +09:00 · 2026-05-17 04:14:39 +09:00 · 2026-05-17 04:05:01 +09:00 · 2026-05-17 03:56:41 +09:00 · 2026-05-17 00:10:51 +09:00 · 2026-05-16 23:44:00 +09:00
10 changed files with 141 additions and 75 deletions
--- a/music_quiz/data/minecraft/tags/dialog/quick_actions.json
+++ b/music_quiz/data/minecraft/tags/dialog/quick_actions.json
@@ -1,6 +1,6 @@
 {
  "replace": false,
  "values": [
-    "mq:answer"
+    { "id": "mq:answer", "required": false }
  ]
 }
--- a/music_quiz/data/mq/function/commands/stop.mcfunction
+++ b/music_quiz/data/mq/function/commands/stop.mcfunction
@@ -60,12 +60,17 @@ bossbar set mq:process visible false
 bossbar set mq:process style notched_10
 bossbar set mq:process players @a

-# 대기 상태 marker 1개만 소환 (answer.title="음악퀴즈" 가 sentinel)
+# 대기 상태로 answer 초기화
 data modify storage mq:main answer set value {title:"음악퀴즈", alias:[]}
-data modify storage mq:tmp marker_call set from storage mq:main marker
-data modify storage mq:tmp marker_call.name set value "음악퀴즈"
-data modify storage mq:tmp marker_call.alias set value []
-function mq:quiz/macro/summon with storage mq:tmp marker_call
+
+# 이전 버전이 남긴 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
--- a/music_quiz/data/mq/function/init/buttons.mcfunction
+++ b/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:"소리 테스트"}
--- a/music_quiz/data/mq/function/init/config.mcfunction
+++ b/music_quiz/data/mq/function/init/config.mcfunction
@@ -6,10 +6,12 @@ data modify storage mq:main spawn set value {x: 144, y: 61, z: -219, r: 180, f:

 # 음원 재생 — minecraft_launcher 리소스팩의 musicquiz:track_NN 사운드 이벤트
 # namespace  — 리소스팩 네임스페이스 (기본 "musicquiz")
-# source     — /playsound 채널. stopsound 와 동일해야 함 (기본 "weather")
+# source     — /playsound 채널. stopsound 와 동일해야 함. 노래는 "player" 채널로
+#              재생 (음성/플레이어 채널 슬라이더로 음량 제어). 타이머/UI 비프는
+#              별도로 weather 채널 사용.
 # volume     — 기본 음량. 곡별 override 는 init/songs.mcfunction 의 volume 필드 사용
 # pitch      — 1.0 = 원본 속도
-data modify storage mq:main audio set value {namespace: "musicquiz", source: "weather", volume: 1.0, pitch: 1.0}
+data modify storage mq:main audio set value {namespace: "musicquiz", source: "player", volume: 1.0, pitch: 1.0}

 # 정답 페인팅 — 데이터팩의 mq:cover_NN painting_variant (텍스처는 리소스팩 musicquiz:cover_NN)
 # namespace        — painting_variant 네임스페이스 (기본 "mq")
@@ -17,7 +19,4 @@ data modify storage mq:main audio set value {namespace: "musicquiz", source: "we
 # facing           — 페인팅이 바라보는 방향: south=0 / west=1 / north=2 / east=3
 data modify storage mq:main image set value {namespace: "mq", x: 144, y: 84, z: -261, facing: 0b}

-# 정답 입력용 marker entity 소환 좌표
-data modify storage mq:main marker set value {x: 144, y: 59, z: -219}
-
 # 곡 개수 max_index 는 init/songs.mcfunction 의 길이로 자동 계산됨
--- a/music_quiz/data/mq/function/quiz/macro/summon.mcfunction
+++ b/music_quiz/data/mq/function/quiz/macro/summon.mcfunction
@@ -1,9 +0,0 @@
-$execute unless data storage mq:main {answer:{title:"음악퀴즈"}} run summon minecraft:marker $(x) $(y) $(z) {Tags:["mq","default"],CustomName:"정답입력시작"}
-$summon minecraft:marker $(x) $(y) $(z) {Tags:["mq","default"],CustomName:"$(name)"}
-
-execute store result score length func.temp run data get storage mq:tmp marker_call.alias
-execute if score length func.temp matches 1.. run data modify storage mq:tmp marker_call.name set from storage mq:tmp marker_call.alias[0]
-execute if score length func.temp matches 1.. run data remove storage mq:tmp marker_call.alias[0]
-execute if score length func.temp matches 1.. run function mq:quiz/macro/summon2 with storage mq:tmp marker_call
-
-$execute unless data storage mq:main {answer:{title:"음악퀴즈"}} run summon minecraft:marker $(x) $(y) $(z) {Tags:["mq","default"],CustomName:"정답입력종료"}
--- a/music_quiz/data/mq/function/quiz/macro/summon2.mcfunction
+++ b/music_quiz/data/mq/function/quiz/macro/summon2.mcfunction
@@ -1,6 +0,0 @@
-$summon minecraft:marker $(x) $(y) $(z) {Tags:["mq","default"],CustomName:"$(name)"}
-
-execute store result score length func.temp run data get storage mq:tmp marker_call.alias
-execute if score length func.temp matches 1.. run data modify storage mq:tmp marker_call.name set from storage mq:tmp marker_call.alias[0]
-execute if score length func.temp matches 1.. run data remove storage mq:tmp marker_call.alias[0]
-execute if score length func.temp matches 1.. run function mq:quiz/macro/summon2 with storage mq:tmp marker_call
--- a/music_quiz/data/mq/function/quiz/setanswer.mcfunction
+++ b/music_quiz/data/mq/function/quiz/setanswer.mcfunction
@@ -1,12 +1,6 @@
 # songs[$(idx)] → answer 로 복사하고, 트랙/커버 id 부여
 function mq:quiz/macro/setanswer with storage mq:tmp

-# 정답 marker entity 소환 (좌표 + name/alias 합쳐서 macro 호출)
-data modify storage mq:tmp marker_call set from storage mq:main marker
-data modify storage mq:tmp marker_call.name set from storage mq:main answer.title
-data modify storage mq:tmp marker_call.alias set from storage mq:main answer.alias
-function mq:quiz/macro/summon with storage mq:tmp marker_call
-
 scoreboard players set stop buttons -1
 scoreboard players set skip buttons -1
 scoreboard players set hint buttons -1
--- a/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction
+++ b/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction
@@ -1,38 +1,89 @@
 # 버튼 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.
+#
+# ---- 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) $(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]}}
+
+# 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]}}
+
+# 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]}}
+
+# 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 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) $(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)

 # ---- 처리 후 attack/interaction NBT 클리어 (다음 tick 중복 발화 방지) ----
 $execute as @e[type=minecraft:interaction,tag=mq,tag=$(n)] at @s run data remove entity @s attack
--- a/music_quiz/data/mq/function/repeat/buttons/btn_prep.mcfunction
+++ b/music_quiz/data/mq/function/repeat/buttons/btn_prep.mcfunction
@@ -0,0 +1,13 @@
+# 한 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축 동일하게 사용됨)
+
+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"
--- a/music_quiz/data/mq/function/repeat/buttons/handler.mcfunction
+++ b/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
Author	SHA1	Message	Date
Claude (owner)	75daf5bab9	music_quiz: 버튼 비활성 분기에서 data modify entity 단일 대상 제약 회피 interaction 이 버튼당 3개가 된 이후 (v1.0.16+) `data modify entity @e[...] response set value 0b` 가 다중 대상 에러로 실패. 어차피 비활성 시점에 버튼 블록은 air 로 바꾸므로 interaction 과 text_display 도 함께 kill 하는 게 일관적 — 라벨이 stale 로 남는 것도 방지.	2026-05-17 04:17:58 +09:00
Claude (owner)	ba7089e7b2	music_quiz: 버튼 머리 hitbox 정확한 면 정합 + 라벨 text_display 자동 부착 오프셋 부호 정정 (v1.0.16 까지 모든 버전이 잘못된 convention 사용): stone_button[face=wall, facing=X] AABB 는 facing X 쪽 face 에 붙어 안쪽 1/8 만 채움. 따라서 머리 hitbox center 는: south z = 0.0625 (이전 -0.0625) north z = 0.9375 (이전 1.0625) east x = 0.0625 (이전 -0.0625) west x = 0.9375 (이전 1.0625) 이전 부호는 머리 face 의 normal 방향 쪽으로 머리가 "튀어나온다" 라 가정했는데 실제로는 face 의 안쪽 1/8 로 들어가는 구조였음. 그 결과 v1.0.16 의 width=0.125 interaction 은 머리와 겹치지 않고 옆에 떠 있어 (touch only at edge) 클릭이 안 됨. 라벨 text_display 추가 (사용자 요청): - button_defs 항목에 optional label, label_color, label_font, label_scale 추가. 색 기본 black, 폰트 기본 minecraft:default, 크기 기본 1.0. - handler 가 btn_prep 로 기본값 채운 뒤 btn 호출 — 매크로 인자 미존재 에러 회피. - btn 안에서 facing 별 위치/yaw 로 text_display 1개 summon. 같은 벽 (button 머리 반대편 블록) 의 visible 면에 ~0.01 띄워 부착, y-1. - background:0 (투명) 으로 벽에 직접 새긴 느낌. - label 이 빈 문자열이면 summon 스킵. commands/stop 에 stale text_display 정리도 추가 — 옛 정의 이름으로 남은 라벨이 reload 후에도 지워지지 않는 문제 방지.	2026-05-17 04:14:39 +09:00
Claude (owner)	55ab7fc04b	music_quiz: 버튼 interaction hitbox 를 3 타일 분할로 정확히 정합 단일 interaction 의 horizontal hitbox 는 width × width 정사각형 강제라 "가로 0.375 × 두께 0.125" 직사각형이 불가능 → 두께 방향만 잡으면 가로 방향이 짧아지고, 가로를 잡으면 두께가 0.375 가 되어 벽 안쪽으로 0.25 묻혀 F3+B 디버그에서 wireframe 이 벽 안과 머리 앞쪽으로 튀어나옴. 해결: width=0.125 interaction 3개를 가로축으로 타일링. - 각 타일 깊이 0.125 = 버튼 머리 두께와 정확히 일치 - 3 × 0.125 = 0.375 = 버튼 머리 가로와 정확히 일치 (gap 없이 인접) - facing 별 가로축이 다름: south/north 는 x, east/west 는 z selector limit=1 제거 — 한 버튼에 interaction 이 3개라 limit=1 두면 MC 가 임의로 1개만 골라 잘못된 entity 만 검사할 수 있음. `on target` 은 클릭된 1개만 통과하므로 limit 없이도 단일 발화가 보장됨.	2026-05-17 04:05:01 +09:00
Claude (owner)	28f1012294	music_quiz: 버튼 interaction 오프셋을 facing 으로부터 자동 계산 button_defs 항목은 이제 {n, x, y, z, f, c} 만 가진다 (ox/oy/oz/w/h 제거). 사용자가 facing 을 바꿀 때마다 손으로 오프셋 표를 옮겨 적을 필요가 없도록 repeat/buttons/btn.mcfunction 한 곳에 facing → 소환 오프셋을 고정해두고 mq:tmp.btn{f:"..."} 분기로 디스패치한다. width/height 도 stone_button hitbox 에 맞춰 0.375/0.25 로 박제. handler 는 각 entry 를 mq:tmp.btn 으로 복사한 뒤 btn 을 호출해 분기 predicate 에 사용할 수 있게 한다.	2026-05-17 03:56:41 +09:00
Claude (owner)	4349fddc25	music_quiz: dialog tag entry 에 required:false 추가 — /reload 시 datapack 깨짐 방지 증상: - /reload 후 다음 에러: - Couldn't load tag minecraft:quick_actions as it is missing following references: mq:answer - Failed to load function mq:commands/start (Can't find element 'mq:page1' in registry 'minecraft:dialog') - Failed to load function mq:answer/open (Can't find element 'mq:answer' ...) 원인: - MC 의 minecraft:dialog 레지스트리는 hot-reload 불가. /reload 로는 dialog 파일이 registry 에 등록되지 않음 — 서버 완전 재시작이 필요. - 그 상태에서 tag 가 `["mq:answer"]` 같은 짧은 형식으로 dialog 를 참조하면 MC 는 누락된 reference 로 보고 태그 로드 실패 → 같은 reload 의 function 들이 dialog registry 를 못 찾아 연쇄 실패. 수정: - quick_actions.json: `"mq:answer"` → `{ "id": "mq:answer", "required": false }`. required:false 는 reference 가 없을 때 silently 무시하라는 지시. /reload 직후 잠시 dialog registry 가 비어있어도 datapack 자체가 깨지지 않음. 주의 (운영): - 데이터팩 업데이트 후에는 반드시 서버를 완전 재시작 해야 dialog show 호출이 정상 동작함. /reload 만으로는 dialog 파일이 registry 에 들어가지 않음 — 이건 MC 26.1 시점의 dialog 시스템 자체 제약 (Smithed/Mojang 문서 기준).	2026-05-17 00:10:51 +09:00
Claude (owner)	a8d09ece02	music_quiz: marker 엔티티 제거 + 노래 재생 채널을 player 로 변경 ## marker 제거 모든 marker 소환 코드는 write-only — 어디에서도 @e[type=marker] / tag=default selector 로 읽거나 죽이지 않았음. interaction 엔티티가 클릭 UI 를 대체한 이후 완전히 쓸모없는 잔존물. - 삭제: quiz/macro/summon.mcfunction, quiz/macro/summon2.mcfunction (소비처 없음) - commands/stop.mcfunction: marker_call 빌드 + macro 호출 제거. 기존 월드에 누적된 legacy marker 청소를 위해 `kill @e[type=minecraft:marker,tag=mq]` 한 줄 추가 (tag=mq 스코프라 외부 마커는 건드리지 않음). - quiz/setanswer.mcfunction: 정답 marker 소환 블록 제거. - init/config.mcfunction: marker 좌표 템플릿 (mq:main marker) 제거. `answer.title="음악퀴즈"` 대기상태 sentinel 은 marker 외에 reader 가 없지만 다른 reset 의미를 가질 가능성을 고려해 보수적으로 유지. ## 노래 재생 채널을 player 로 init/config.mcfunction: mq:main audio.source 를 "weather" → "player". play_sound / stop_sound 매크로 모두 동일 source 값을 읽으므로 한 곳 변경으로 모든 노래 재생/정지 채널이 player 채널로 이동. 음악/마스터/플레이어 슬라이더 중 "player" (음성) 슬라이더로 노래 음량 제어 가능. 타이머 비프 / UI 클릭음 등은 "노래 재생" 이 아니므로 weather 채널 그대로 유지.	2026-05-16 23:44:00 +09:00