music_quiz: 채팅정답 모드 게이트 제거 — false negative 차단 해결

모드를 설치했는데도 /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>
This commit is contained in:
Claude (owner)
2026-05-19 00:01:07 +09:00
parent da075b60b8
commit 736ec2a3d1
5 changed files with 155 additions and 56 deletions

View File

@@ -1,49 +1,64 @@
# v1.0.20 → v1.0.21 부분 적용 가이드
# v1.0.21 → v1.0.22 부분 적용 가이드
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.21 과 동일한 상태가 됩니다.
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.22 와 동일한 상태가 됩니다.
## 무엇이 바뀌었나
## 무엇이 바뀌었나 (v1.0.22 신규)
### 1. `repeat/buttons/btn.mcfunction` — 버튼이 같이 눌러지던 문제 + 라벨이 JSON 코드로 나오던 문제
### `commands/start.mcfunction` + `load.mcfunction` — "채팅정답 모드 미설치" false negative 제거
**(a) 클릭 시 stone_button 도 같이 눌러짐**
모드를 설치했는데도 `/start` 가 "채팅정답 모드가 서버에 미설치" 로 차단되던 문제.
interaction 박스가 stone_button 의 hitbox 와 정확히 겹쳐 있어서, 한 번
클릭에 interaction 도 발화하고 stone_button 도 vanilla 클릭으로 인식해
`powered=true` 애니메이션이 같이 일어났습니다. interaction 박스를 버튼
면 바깥쪽으로 한 두께(0.125) 만큼 빼서, 플레이어 ray 가 stone_button 에
닿기 전에 interaction 에서 멈추도록 했습니다.
원인: 검증은 모드가 매 server tick `#server mq_chat_mod` 점수를 1 로 set
하는지 보는 방식인데, 다음 케이스에서 score 가 1 로 안 올라가 false negative:
- 사용자가 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 을 쓰고 있을 때
- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서 ServerTickEvents 가
안 들어올 때
- south : 깊이 z 중심 0.0625 → -0.0625
- north : 깊이 z 중심 0.9375 → 1.0625
- east : 깊이 x 중심 0.0625 → -0.0625
- west : 깊이 x 중심 0.9375 → 1.0625
근본 수정: 채팅정답 모드는 입력을 편하게 만들어 주는 **선택적 편의 기능**일
뿐, 모드 없이도 `/trigger input` dialog 경로로 정답 제출 가능. 그래서 채팅
모드 게이트 자체를 제거. 영상재생 모드 (mc_video_player_mod) 게이트는 진짜
필수이므로 유지.
**(b) 라벨이 `{"text":"게임시작",...}` JSON 텍스트 그대로 보임**
## 이전 버전 fix 도 같이 포함 (v1.0.20, v1.0.21)
MC 1.20.5+ 부터 text_display 의 `text` 필드는 String 이 아니라 직접
TextComponent compound 로 저장됩니다. 이전에는 String 안에 JSON 을 넣어서
(`text:'{...}'`) 그 JSON 자체가 텍스트로 렌더링되었습니다. compound 형태
(`text:{text:"...",color:"...",font:"..."}`) 로 변경.
### `repeat/buttons/btn.mcfunction`
- (v1.0.20) `positioned $(x) $(y) $(z)``$(x).0 $(y).0 $(z).0`.
MC vec3 정수 인자의 +0.5 보정 (블록 중심) 으로 interaction 박스가 0.5 칸
어긋나던 문제 회피.
- (v1.0.21) interaction 깊이축을 stone_button hitbox 바깥쪽으로 한 두께만큼
이동. 한 번 클릭에 stone_button 도 같이 눌리던 (powered=true) 문제 회피.
- (v1.0.21) `text_display.text` 를 String JSON 에서 직접 TextComponent
compound 로. MC 1.20.5+ 부터 라벨이 `{"text":"게임시작",...}` 코드 그대로
렌더되던 문제 회피.
### 2. `repeat/buttons/btn_prep.mcfunction`
v1.0.20 에서 이미 수정됨 (defaults + merge 방식). 변경 없음 — 다만
v1.0.19 이하에서 점프하는 경우 같이 덮어써야 합니다.
### `repeat/buttons/btn_prep.mcfunction`
- (v1.0.20) `execute unless data storage mq:tmp btn.label ...` 가 MC 26.1.2
파서에 거부되던 문제. defaults + `data modify ... merge from` 방식으로
재작성.
## 적용 방법
서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 두 파일을
**반드시 덮어쓰세요**.
서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 이 폴더의
파일을 **같은 경로에 덮어쓰세요**.
```
temp/data/mq/function/commands/start.mcfunction
-> <datapack>/data/mq/function/commands/start.mcfunction
temp/data/mq/function/load.mcfunction
-> <datapack>/data/mq/function/load.mcfunction
temp/data/mq/function/repeat/buttons/btn.mcfunction
-> <datapack>/data/mq/function/repeat/buttons/btn.mcfunction (덮어쓰기)
-> <datapack>/data/mq/function/repeat/buttons/btn.mcfunction
temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
-> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction (덮어쓰기)
-> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction
```
이미 v1.0.21 을 적용한 상태라면 위 두 `repeat/buttons/*` 파일은 동일하므로
사실상 `start.mcfunction``load.mcfunction` 두 개만 새로 바뀝니다.
그래도 4 개 모두 덮어쓰는 게 안전합니다 (idempotent).
복사 후 게임 안에서:
```
@@ -52,8 +67,8 @@ temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
## 확인
- 버튼을 클릭해도 stone_button 의 `powered=true` 눌림 애니메이션이
발생하지 않아야 합니다 (interaction 만 발화).
- 버튼 아래 라벨이 `게임시작` / `정지` / `소리 테스트` 등으로 정상 표시
(JSON 텍스트 노출 없음).
- 채팅정답 모드가 설치되어 있든 아니든 `/start` 가 "채팅정답 모드 미설치"
메시지로 차단되지 않아야 합니다. (영상재생 모드는 여전히 필수.)
- 버튼 클릭 시 stone_button 의 powered 애니메이션 없음.
- 라벨이 `게임시작` 등으로 정상 표시 (JSON 코드 노출 없음).
- 콘솔에 파싱 에러 없음.