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 에 사용할 수 있게 한다.

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/answer/normalize/step.mcfunction

@@ -5,7 +5,7 @@ execute store result score n.len func.temp run data get storage mq:tmp norm.in
 execute if score n.len func.temp matches 0 run return 0
 
 # 머리글자 추출 → norm.c
-data modify storage mq:tmp norm.c set string from storage mq:tmp norm.in 0 1
+data modify storage mq:tmp norm.c set string storage mq:tmp norm.in 0 1
 
 # 공백 제거 (스킵)
 execute if data storage mq:tmp norm{c:" "} run data modify storage mq:tmp norm.c set value ""
@@ -42,6 +42,6 @@ execute if data storage mq:tmp norm{c:"Z"} run data modify storage mq:tmp norm.c
 function mq:answer/normalize/append with storage mq:tmp norm
 
 # 나머지로 진행
-data modify storage mq:tmp norm.in set string from storage mq:tmp norm.in 1
+data modify storage mq:tmp norm.in set string storage mq:tmp norm.in 1
 
 function mq:answer/normalize/step

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

@@ -60,12 +60,11 @@ 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 "음악퀴즈"
+# 이전 버전이 남긴 legacy marker 정리 (현재는 marker 사용 안 함)
-data modify storage mq:tmp marker_call.alias set value []
+kill @e[type=minecraft:marker,tag=mq]
-function mq:quiz/macro/summon with storage mq:tmp marker_call
 
 function mq:quiz/stop_sound
 function mq:images/clear

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

@@ -1,25 +1,17 @@
 # 버튼 정의. 각 항목 의미:
-#   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),
+# interaction entity 의 위치/크기는 facing 만 보면 결정됨 — 매번 손으로
-# 두께 2/16 (0.125), 벽 반대편으로만 튀어나옴. interaction 의 horizontal
+# ox/oy/oz/w/h 를 적지 않는다. 실제 오프셋 테이블은 repeat/buttons/btn
-# hitbox 는 width × width 정사각형 강제 → width 를 가로(0.375) 에 맞추고
+# 안에서 한 곳에만 정의되어 있다 (stone_button[face=wall] 면 정합용).
-# 위치 보정으로 "튀어나온 쪽 면 = visible face" 가 되게 함. 반대편은
-# 벽 블록 속으로 들어가 invisible.
-#
-# 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
 
 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:"start",  x:364, y:146, z:-263, f:"east", c:"function mq:commands/start with storage mq:main"}
-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:"stop",   x:364, y:146, z:-265, f:"east", c:"function mq:commands/stop with storage mq:main"}
-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:"skip",   x:364, y:146, z:-267, f:"east", c:"function mq:commands/skip"}
-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:"hint",   x:364, y:146, z:-269, f:"east", c:"function mq:commands/hint"}
-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:"replay", x:364, y:146, z:-271, f:"east", c:"function mq:commands/replay"}
-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:"test",   x:144, y:62,  z:-213, f:"north", c:"function mq:commands/test"}

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 의 길이로 자동 계산됨

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:"정답입력종료"}

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

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

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

@@ -1,7 +1,5 @@
 # 버튼 1개에 대한 매 tick 처리.
-# 매크로 인자: n, x, y, z, f, c, ox, oy, oz, w, h
+# 매크로 인자(mq:tmp.btn): n, x, y, z, f, c
-#   ox/oy/oz : interaction 소환 위치 오프셋 (블록 좌표 기준, facing 별)
-#   w / h    : interaction width / height (float, 버튼 hitbox 정합용)
 #   buttons 점수 상태:
 #     ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단)
 #     -1   : 초기화 단계 (버튼 블록 배치 + interaction entity 보장 후 0 으로)
@@ -11,6 +9,21 @@
 #   에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직이 실행됨.
 #   -1 단계에서 같은 태그 entity 를 모두 kill 후 정확히 1개 summon → dup
 #   누적 없이 항상 "버튼당 1개, 올바른 좌표" 상태로 수렴 (idempotent).
+#
+# ---- facing → 소환 오프셋 (이 파일 한 곳에서만 정의) ----
+# 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) 에 맞추고 위치를 튀어나온 쪽 면에 정렬.
+#
+# facing 의미: "플레이어가 그 방향을 보면서 누른다". 즉 button 머리는
+# facing 의 반대쪽 면에 붙어 있다.
+#   south : 머리는 블록의 -z 쪽 면(north face)   → 소환 z = -0.0625
+#   north : 머리는 블록의 +z 쪽 면(south face)   → 소환 z = 1.0625
+#   east  : 머리는 블록의 -x 쪽 면(west face)    → 소환 x = -0.0625
+#   west  : 머리는 블록의 +x 쪽 면(east face)    → 소환 x = 1.0625
+# interaction entity Y 는 hitbox 의 바닥(=발 위치) — 버튼 머리가 블록의
+# 세로 중앙(y+0.5) 에 있고 높이 0.25 라 바닥은 y+0.375.
 
 # ---- 비활성: 버튼 제거 + interaction 응답 차단 후 종료 ----
 $execute if score $(n) buttons matches ..-2 run setblock $(x) $(y) $(z) minecraft:air
@@ -24,7 +37,10 @@ $execute if score $(n) buttons matches ..-2 run return 0
 $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 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.375f,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 ~1.0625 {Tags:["mq","$(n)"],width:0.375f,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.375f,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 ~1.0625 ~0.375 ~0.5 {Tags:["mq","$(n)"],width:0.375f,height:0.25f,response:0b}
 $execute if score $(n) buttons matches -1 run scoreboard players set $(n) buttons 0
 
 # ---- 상시: interaction 클릭/타격 → playsound + 명령/투표 실행 ----

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

@@ -1,6 +1,16 @@
-function mq:repeat/buttons/btn with storage mq:main button_defs[0]
+# 각 button_defs 항목을 mq:tmp.btn 으로 복사 후 btn 호출.
-function mq:repeat/buttons/btn with storage mq:main button_defs[1]
+# btn 안에서 facing 별 분기 (if data storage mq:tmp btn{f:"..."}) 를
-function mq:repeat/buttons/btn with storage mq:main button_defs[2]
+# 사용하기 위해 현재 항목을 같은 storage 에 노출시킨다.
-function mq:repeat/buttons/btn with storage mq:main button_defs[3]
+
-function mq:repeat/buttons/btn with storage mq:main button_defs[4]
+data modify storage mq:tmp btn set from storage mq:main button_defs[0]
-function mq:repeat/buttons/btn with storage mq:main button_defs[5]
+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 with storage mq:tmp btn
+data modify storage mq:tmp btn set from storage mq:main button_defs[2]
+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 with storage mq:tmp btn
+data modify storage mq:tmp btn set from storage mq:main button_defs[4]
+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 with storage mq:tmp btn

music_quiz/pack.mcmeta

@@ -1,8 +1,7 @@
 {
   "pack": {
-    "pack_format": 75,
+    "description": "음악퀴즈용 데이터팩입니다.",
-    "min_format": 75,
+    "min_format": [101, 1],
-    "max_format": 75,
+    "max_format": [101, 1]
-    "description": "음악퀴즈용 데이터팩입니다."
   }
 }