3 Commits

Author SHA1 Message Date
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
4 changed files with 78 additions and 39 deletions

View File

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

View File

@@ -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) 투표) # 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 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"}

View File

@@ -1,7 +1,5 @@
# 버튼 1개에 대한 매 tick 처리. # 버튼 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 점수 상태: # buttons 점수 상태:
# ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단) # ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단)
# -1 : 초기화 단계 (버튼 블록 배치 + interaction entity 보장 후 0 으로) # -1 : 초기화 단계 (버튼 블록 배치 + interaction entity 보장 후 0 으로)
@@ -9,30 +7,69 @@
# #
# interaction entity 는 데이터팩이 직접 summon — /reload 시 commands/stop # interaction entity 는 데이터팩이 직접 summon — /reload 시 commands/stop
# 에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직이 실행됨. # 에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직이 실행됨.
# -1 단계에서 같은 태그 entity 를 모두 kill 후 정확히 1개 summon → dup # -1 단계에서 같은 태그 entity 를 모두 kill 후 정확한 개수만 summon → dup
# 누적 없이 항상 "버튼당 1개, 올바른 좌표" 상태로 수렴 (idempotent). # 누적 없이 항상 "버튼당 정확히 3개, 올바른 좌표" 상태로 수렴 (idempotent).
#
# ---- facing → 소환 오프셋 (이 파일 한 곳에서만 정의) ----
# stone_button[face=wall] 머리 hitbox: 가로 6/16 (0.375), 세로 4/16 (0.25),
# 두께 2/16 (0.125). interaction entity 의 horizontal hitbox 는 width × width
# 정사각형 강제라 단일 entity 로는 "가로 0.375 × 두께 0.125" 직사각형이 불가.
# → 두께(0.125) 만큼만 가지는 width=0.125 interaction 을 가로 방향 3개 타일
# 링하여 버튼 머리에 정확히 정합 (가로 3 × 0.125 = 0.375, 두께 그대로 0.125).
#
# facing 의미: "플레이어가 그 방향을 보면서 누른다" — 버튼 머리는 facing 의
# 반대쪽 면에 붙어 있다. 머리 위치 (블록 상대 좌표):
# south : -z 면 (z=0) → 깊이 z = -0.0625, 가로 x = 0.375 / 0.5 / 0.625
# north : +z 면 (z=1) → 깊이 z = 1.0625, 가로 x = 0.375 / 0.5 / 0.625
# east : -x 면 (x=0) → 깊이 x = -0.0625, 가로 z = 0.375 / 0.5 / 0.625
# west : +x 면 (x=1) → 깊이 x = 1.0625, 가로 z = 0.375 / 0.5 / 0.625
# 세로(y): 머리는 블록의 세로 중앙 (y+0.375 ~ y+0.625, 높이 0.25). interaction
# Y 는 hitbox 바닥(=발 위치) → 소환 y = y+0.375, height=0.25.
# ---- 비활성: 버튼 제거 + interaction 응답 차단 후 종료 ---- # ---- 비활성: 버튼 제거 + interaction 응답 차단 후 종료 ----
$execute if score $(n) buttons matches ..-2 run setblock $(x) $(y) $(z) minecraft: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 data modify entity @e[type=minecraft:interaction,tag=mq,tag=$(n)] response set value 0b
$execute if score $(n) buttons matches ..-2 run return 0 $execute if score $(n) buttons matches ..-2 run return 0
# ---- 초기화: 버튼 블록 배치 + interaction entity 보장 ---- # ---- 초기화: 버튼 블록 배치 + interaction entity 보장 ----
# 기존 mq/$(n) interaction 을 전부 제거 후 정확히 1개 소환. # 기존 mq/$(n) interaction 을 전부 제거 후 정확히 3개 소환.
# 옛 월드 cmd block 으로 누적 소환된 dup 이나 엉뚱한 좌표에 남은 잔존 # 옛 월드 cmd block 으로 누적 소환된 dup 이나 엉뚱한 좌표에 남은 잔존
# entity 까지 정리 → "정상 상태(버튼당 정확히 1개, 올바른 좌표)" 가 보장됨. # entity 까지 정리 → "정상 상태(버튼당 정확히 3개, 올바른 좌표)" 가 보장됨.
$execute unless score $(n) buttons matches -1.. run scoreboard players set $(n) buttons -1 $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 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: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}
# 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}
# north: 깊이축=z(+1.0625), 가로축=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 ~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) $(y) $(z) 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) $(y) $(z) run summon minecraft:interaction ~0.625 ~0.375 ~1.0625 {Tags:["mq","$(n)"],width:0.125f,height:0.25f,response:0b}
# 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}
# west: 깊이축=x(+1.0625), 가로축=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 ~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) $(y) $(z) 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) $(y) $(z) 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 run scoreboard players set $(n) buttons 0 $execute if score $(n) buttons matches -1 run scoreboard players set $(n) buttons 0
# ---- 상시: interaction 클릭/타격 → playsound + 명령/투표 실행 ---- # ---- 상시: interaction 클릭/타격 → playsound + 명령/투표 실행 ----
# init main = 0 (퀴즈 시작 전 설정 단계) : 명령 직접 실행 # init main = 0 (퀴즈 시작 전 설정 단계) : 명령 직접 실행
# 그 외 : trigger 투표 경로 # 그 외 : 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 # 같은 태그를 가진 interaction 이 3개지만 `on target` 은 클릭된 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) # (나머지는 target 부재로 체인 중단). 따라서 selector 에 limit=1 두지 않음
$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) # — limit=1 을 두면 MC 가 임의로 1개를 골라 잘못된 entity 만 검사할 수 있음.
$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 중복 발화 방지) ---- # ---- 처리 후 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 attack

View File

@@ -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