diff --git a/README.md b/README.md index a6cf272..d4863b8 100644 --- a/README.md +++ b/README.md @@ -77,8 +77,17 @@ - `start` / `stop` / `skip` / `hint` / `replay` / `test` -버튼 본체는 `interaction` 엔티티 + `redstone_block`-`red_wool` 토글 -패턴으로 디바운스를 처리한다. +버튼 본체는 보이는 `stone_button` 블록 + 그 좌표에 덮인 `interaction` +엔티티로 구성된다. 클릭 처리는 항상 `interaction` 경로로 흐르므로 +`on target as @s` 로 누른 플레이어가 식별되고, 다수결(`trigger $(n)`) +투표가 성립한다. + +`interaction` 은 데이터팩이 직접 소환·관리한다 — `buttons` 점수가 +`-1` (초기화) 일 때마다 같은 태그의 기존 entity 를 정리하고 정확히 +1개를 (재)소환한다. `/reload` 가 `commands/stop` 을 호출해 `buttons` +점수를 `-1` 로 재설정하므로, 리로드 시 자동 보장된다. `/kill @e` 로 +지워졌어도 다음 `/reload` 한 번으로 복구. 월드 회로(커맨드블럭) 의존은 +없다. ### 파일 구조 diff --git a/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction b/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction index 695e14b..7a7b542 100644 --- a/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction +++ b/music_quiz/data/mq/function/repeat/buttons/btn.mcfunction @@ -1,28 +1,36 @@ +# 버튼 1개에 대한 매 tick 처리. 매크로 인자: n, x, y, z, f, c +# buttons 점수 상태: +# ..-2 : 비활성 (버튼 블록 제거, interaction 응답 차단) +# -1 : 초기화 단계 (버튼 블록 배치 + interaction entity 보장 후 0 으로) +# 0 : 정상 (interaction 클릭 대기) +# +# interaction entity 는 데이터팩이 직접 summon — /reload 시 commands/stop +# 에서 buttons 가 -1 로 재설정되어 다음 tick 에 ensure 로직이 실행됨. +# -1 단계에서 같은 태그 entity 를 모두 kill 후 정확히 1개 summon → dup +# 누적 없이 항상 "버튼당 1개, 올바른 좌표" 상태로 수렴 (idempotent). + +# ---- 비활성: 버튼 제거 + interaction 응답 차단 후 종료 ---- $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 return 0 + +# ---- 초기화: 버튼 블록 배치 + interaction entity 보장 ---- +# 기존 mq/$(n) interaction 을 전부 제거 후 정확히 1개 소환. +# 옛 월드 cmd block 으로 누적 소환된 dup 이나 엉뚱한 좌표에 남은 잔존 +# entity 까지 정리 → "정상 상태(버튼당 정확히 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 positioned $(x) $(y) $(z) run setblock ~ ~-3 ~ minecraft:redstone_block -$execute if score $(n) buttons matches -1 positioned $(x) $(y) $(z) run setblock ~ ~-3 ~ minecraft:red_wool +$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 ~0.5 ~ ~0.5 run summon minecraft:interaction ~ ~ ~ {Tags:["mq","$(n)"],width:1f,height:1f,response:0b} $execute if score $(n) buttons matches -1 run scoreboard players set $(n) buttons 0 -$execute if block $(x) $(y) $(z) minecraft:stone_button[face=wall,facing=$(f),powered=true] \ - if score $(n) buttons matches 0 \ - run scoreboard players set $(n) buttons 1 - -$execute if score $(n) buttons matches 1 unless entity @e[type=minecraft:interaction,tag=mq,tag=$(n),limit=1] positioned $(x) $(y) $(z) run $(c) - -$execute if score $(n) buttons matches 1 \ - run scoreboard players set $(n) buttons 2 - -$execute if block $(x) $(y) $(z) minecraft:stone_button[face=wall,facing=$(f),powered=false] \ - 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) +# ---- 처리 후 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