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>
모드를 설치했는데도 /start 가 "채팅정답 모드가 서버에 미설치" 로 막히던
문제. 검증 방식 (모드가 매 server tick #server mq_chat_mod 점수를 1 로
set 하는지 확인) 이 다음 케이스에서 false negative:
- 사용자가 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 을 쓸 때
- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서
ServerTickEvents.END_SERVER_TICK 이 안 들어올 때
채팅정답 모드는 입력을 편하게 만들어 주는 선택적 편의 기능일 뿐이고
모드 없는 환경에서도 /trigger input dialog 경로로 정답 제출이 가능.
게이트 자체를 제거하는 게 근본 해결. 영상재생 모드 (mc_video_player_mod)
는 진짜 필수이므로 게이트 유지.
- commands/start.mcfunction: mq_chat_mod 검사 라인 제거 + 주석 갱신
- load.mcfunction: mq_chat_mod objective add/set 제거 (defensive remove
는 유지)
- temp/: start.mcfunction, load.mcfunction 추가 + README 갱신
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
(a) interaction 박스가 stone_button hitbox 와 겹쳐 있어서 한 번 클릭에
interaction 도 발화하고 stone_button 도 vanilla 클릭으로 인식되어
powered=true 애니메이션이 같이 일어나던 문제. interaction 박스를 버튼
면 바깥쪽으로 한 두께(0.125) 만큼 빼서 ray 가 stone_button 에 닿기
전에 interaction 에서 멈추도록.
south z: 0.0625 → -0.0625, north z: 0.9375 → 1.0625
east x: 0.0625 → -0.0625, west x: 0.9375 → 1.0625
(b) MC 1.20.5+ 부터 text_display.text 는 String 이 아닌 직접 TextComponent
compound. 이전에 String 안에 JSON 을 넣어서 그 JSON 자체가 텍스트로
렌더링되던 문제 (`{"text":"게임시작",...}` 가 그대로 보임). compound
형태 `text:{text:"...",color:"...",font:"..."}` 로 변경.
temp/ 부분 적용 패키지의 btn.mcfunction 과 README 도 동기화.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- btn.mcfunction 의 positioned $(x) $(y) $(z) → $(x).0 $(y).0 $(z).0.
마인크래프트 vec3 인자는 정수만 쓰면 자동으로 +0.5 보정 (블록 중심으로
잡힘) 되기 때문에 positioned 2773 86 5968 이 실제로는 (2773.5, 86,
5968.5) 가 되고, 거기서 ~0.375 ~0.0625 같은 오프셋을 더해 interaction
을 소환하면 박스가 블록 중앙으로 0.5 칸 밀린다. decimal 형태로 강제해
보정 회피.
- btn_prep.mcfunction 을 execute-unless-data 방식에서 defaults 컴파운드 +
merge 방식으로 재작성. 이전 v1.0.19 의 다중 공백 정규화는 근본 원인이
아니었음 — `execute unless data storage mq:tmp btn.label run ...` 구문
자체를 MC 26.1.2 파서가 거부. data modify ... merge from 으로 source 의
키가 target 을 덮어쓰는 머지를 활용하면 같은 기능을 문제 라인 없이 구현.
- temp/ 부분 적용 패키지의 README 와 두 파일을 동기화. 진짜 원인 설명으로
재작성.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
btn_prep.mcfunction line 10 에서 'Incorrect argument at position 45'
파싱 에러 발생. 이유는 보기 좋게 맞추려고 컬럼 정렬용으로 연속 공백을
넣었는데 MC 26.1.2 의 명령 파서가 컬럼 정렬을 토큰 구분으로 처리하지
못해 다음 인자를 못 찾음.
btn.mcfunction 의 가운데 타일 summon 라인 (~0.5 ~0.375 같이 두 칸
띄운 곳들) 도 동일 패턴 → 한 칸 공백으로 정규화.
interaction 이 버튼당 3개가 된 이후 (v1.0.16+) `data modify entity
@e[...] response set value 0b` 가 다중 대상 에러로 실패. 어차피 비활성
시점에 버튼 블록은 air 로 바꾸므로 interaction 과 text_display 도 함께
kill 하는 게 일관적 — 라벨이 stale 로 남는 것도 방지.
오프셋 부호 정정 (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 후에도 지워지지 않는 문제 방지.
단일 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 없이도 단일 발화가 보장됨.
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 에 사용할 수 있게 한다.
## 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 채널 그대로 유지.
- pack.mcmeta: 25w31a 이후 도입된 min_format/max_format 배열 스펙으로 교체. min_format >= 82 이므로 pack_format 키는 생략.
- step.mcfunction L8, L45: `data modify ... set string from <source>` 는 잘못된 문법. 올바른 형태는 `set string <source> [start] [end]` (from 없음). 이로 인해 8행 부근 파싱이 멈추던 문제 해결.
- quiz/setanswer.mcfunction: 클릭형 tellraw 제거. dialog/`/trigger input` 인프라는 유지하여 모드 없는 환경 fallback.
- 외부 모드 검증 (load/login/start):
- mq_chat_mod: 서버 전용 모드 (mc_chat_answer_mod) — `#server mq_chat_mod` fake holder 로 서버 presence 검증.
- mq_video_mod: 클라이언트 렌더링 모드 (mc_video_player_mod) — 같은 objective 안에 `#server` (서버 컴포넌트 매 tick 갱신) + `<player>` (클라 payload 수신 시 갱신) 두 holder 로 server/client 부재 안내 분리.
- start.mcfunction: server presence 우선 검사 → per-player client presence 검사. unset 매치 안 되는 selector 이슈는 `add @a ... 0` 으로 materialize.
- login.mcfunction: 플레이어 join 시 `mq_video_mod=0` 초기화 (stale 1 방지).
- docs/mc_video_player_mod_integration.md: video mod 측 구현 사양 (서버 컴포넌트 매 tick presence pulse + client payload handshake, 주기 재전송 필수 명시).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
interaction entity 의 위치/크기를 facing 별 오프셋 + 버튼 hitbox
치수 (6/16 × 4/16) 에 맞춰 분리.
- button_defs 각 항목에 ox/oy/oz/w/h 추가. facing 별 보정값으로
interaction 의 "튀어나온 쪽 면 = 버튼 visible face" 가 되게 함.
반대편은 벽 블록 속으로 들어가 invisible.
- width=0.375f, height=0.25f → 가로/세로 버튼 face 와 정합.
horizontal hitbox 가 square 강제라 두께는 0.375 까지 가지만,
벽 쪽 0.25 가 wall 블록 안에 묻혀 시각적으로는 버튼 두께 0.125 만 튀어나옴.
- btn.mcfunction 의 summon 라인이 매크로 변수 (~$(ox)/$(oy)/$(oz)) 와
$(w)f / $(h)f 사용으로 변경됨.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
월드 cmd block 의존 (redstone_block/red_wool 펄스) 을 제거하고
btn.mcfunction 이 직접 summon 하도록 변경.
- buttons=-1 초기화 단계에서 기존 mq/<버튼명> interaction 을 모두
kill 후 정확히 1개를 (x+0.5, y, z+0.5) 에 1f×1f 로 재소환.
/reload 마다 dup 누적 없이 "버튼당 1개, 올바른 좌표" 로 수렴.
- /reload → load → commands/stop 이 buttons 점수를 -1 로 재설정 →
다음 tick 에 ensure 로직 실행. /kill @e 후에도 /reload 한 번으로 복구.
- stone_button 직접 감지 fallback 및 잉여 state machine (1→2→0)
제거. 클릭 경로는 interaction 단일화 → trigger 투표 흐름 보존.
- README 의 버튼 본체 설명을 새 구조로 갱신.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- mq:answer/normalize: storage 의 norm.in 을 한 글자씩 떼어내
소문자화 + 공백 제거 후 norm.acc 에 누적. char 단위 반복은
'data modify ... set string from ... <start> <end>' (1.20+) 로,
결합은 매크로 ($(acc)$(c)) 로 수행하는 pure-datapack 구현.
- process: 큐의 text 를 정규화한 결과를 judge.input 으로 사용
- judge: answer.title 정규화 후 judge.answer 로 사용
- iter_aliases: alias 각 항목 정규화 후 비교
원본 songs.mcfunction 의 title/alias 표기는 그대로 유지 (display
및 정규화 입력으로 모두 사용됨). 입력이 'Lose My Mind' / 'lose my mind'
/ 'LOSEMYMIND' / 'losemymind' 어떤 형태든 동일한 정규형으로 떨어져 매치.
- data/musicquiz/painting_variant/* → data/mq/painting_variant/* 로 이동
변종 ID = mq:cover_NN, 텍스처 asset_id = musicquiz:cover_NN (리소스팩)
- title/author 필드 제거 (기본값 사용)
- init/config.mcfunction 의 image.namespace 기본값을 "mq" 로 변경
기존: storage chat_answer:status active 1b/0b 플래그를 모드가 set,
데이터팩이 mq:load 에서 0b 로 reset 하는 구조였는데,
통합 서버에서 mq:load 가 player join 이후에 도는 케이스가 발견되어
모드가 써놓은 1b 를 데이터팩이 직후에 0b 로 덮어쓰는 race 발생.
수정: storage 플래그를 완전히 제거. 모드가 직접 PlayerLoggedInEvent
핸들러에서 mq:players/mod_active_notice 함수를 해당 플레이어로 호출.
데이터팩이 없으면 함수가 없어 silent fail → race 없음.
- mq:load: chat_answer:status 0b 초기화 라인 삭제
- mq:players/login: 조건부 tellraw 제거 (모드가 직접 호출하므로)
- mq:players/mod_active_notice: 새 함수, 그냥 tellraw 만 수행
기존엔 volume 이 선택 필드여서 미지정 시 config.audio.volume 으로 fallback 되었는데,
곡마다 음량 조절을 자주 하기 위해 모든 곡 엔트리에 volume 을 명시 (모두 1.0). 런타임
quiz/play_sound 흐름은 그대로 — songs[i].volume 을 그대로 사용.
mq:load 가 storage chat_answer:status active 를 0b 로 초기화. chat_answer 모드의
PlayerLoggedInEvent / ServerPlayConnectionEvents.JOIN 핸들러가 첫 로그인 직후
1b 로 set 하므로, mq:players/login 에서 1b 인 경우 "[채팅정답] 모드가 활성화되어
있습니다. 정답 입력 시 채팅으로 바로 제출할 수 있습니다." tellraw.
정답 입력 UI 를 dialog 로 제공 (mq:dialog/answer), #minecraft:quick_actions 태그
등록으로 빠른행동키에서 바로 열 수 있게 함. 동시 제출 시 먼저 제출한 사람이 정답으로
인정되도록 mq:answer/ 에 submit_seq 기반 FIFO 큐 + 매크로 기반 제출자 lookup 으로
처리. tick/stop/setanswer 도 새 큐 흐름에 맞춰 업데이트.
minecraft_launcher 가 만드는 musicquiz 리소스팩 (track_NN / cover_NN)
과 한 쌍으로 동작한다.
- 음원 재생: yp playall (명령 블록 + auto 토글) → /playsound musicquiz:track_NN
- 정답 이미지: ts placeloc → /summon painting (musicquiz:cover_NN) +
/kill @e[type=painting,tag=mq_cover]
- stopsound 하드코딩(weather) 4곳을 mq:quiz/stop_sound 매크로 호출로 통일
- check/server, repeat/check_server, status 스코어보드(yp/ts/skript) 등
플러그인 hello 패킷 대기 로직 일괄 삭제
- 스토리지 재구성: command_block 컴파운드 폐기, audio/image/marker 분리
(init/config.mcfunction 한 곳에서 수정)
- 곡 단위 volume override 지원 — songs[i].volume 으로 곡별 음량 지정 가능
(미지정 시 audio.volume fallback)
- 트랙 번호 zero-pad 는 mq:tmp.pad 분기 + 매크로 문자열 조립으로 처리
- max_index 는 songs 배열 길이에서 자동 계산
- 호출 경로 단축: select → setanswer → macro/setanswer → macro/summon →
play_sound
- 주제(title), 곡 개수(max_index), 스폰 위치, 음원 명령 블록 좌표/볼륨,
이미지 표시 영역 좌표를 모두 init/config.mcfunction 에서 관리
- tellraw 접두사([ … ])가 storage 의 title 을 참조하도록 변경 — 주제
변경 시 config 한 줄만 고치면 채팅 접두사까지 일관 적용
- load.mcfunction 의 인라인 data merge 블록을 제거하고 init/config 호출로
대체 (스코어보드/보스바 같은 런타임 인프라는 load 본문에 유지)
- README 의 "곡 목록 수정" 절을 "설정 (한 곳에서 수정)" 으로 재작성
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
