music_quiz: v1.0.22 게이트 제거 되돌림 — 진짜 fix 는 모드 v1.3.6 에서

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>
This commit is contained in:
Claude (owner)
2026-05-19 00:16:51 +09:00
parent 736ec2a3d1
commit 0d88ac7bbf
5 changed files with 91 additions and 65 deletions

View File

@@ -1,25 +1,33 @@
# v1.0.21 → v1.0.22 부분 적용 가이드
# 부분 적용 가이드 (→ v1.0.23)
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.22 와 동일한 상태가 됩니다.
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.23 와 동일한 상태가 됩니다.
## 무엇이 바뀌었나 (v1.0.22 신규)
## v1.0.23 의 핵심 변경 — 채팅정답 모드 false negative 의 진짜 fix
### `commands/start.mcfunction` + `load.mcfunction` — "채팅정답 모드 미설치" false negative 제거
모드를 설치했는데도 `/start` 가 "채팅정답 모드가 서버에 미설치" 로 차단되던 문제.
증상: 채팅정답 모드를 설치했는데도 `/start` 가 "채팅정답 모드가 서버에 미설치"
로 차단됨.
원인: 검증은 모드가 매 server tick `#server mq_chat_mod` 점수를 1 로 set
하는지 보는 방식인데, 다음 케이스에서 score 가 1 로 안 올라가 false negative:
- 사용자가 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 을 쓰고 있을 때
- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서 ServerTickEvents
안 들어올 때
- 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 사용 중
- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서 `ServerTickEvents`
안 들어
근본 수정: 채팅정답 모드는 입력을 편하게 만들어 주는 **선택적 편의 기능**일
뿐, 모드 없이도 `/trigger input` dialog 경로로 정답 제출 가능. 그래서 채팅
모드 게이트 자체를 제거. 영상재생 모드 (mc_video_player_mod) 게이트는 진짜
필수이므로 유지.
근본 fix: **데이터팩 가드는 그대로 유지하고, 모드 쪽에서 presence pulse
지점을 셋으로 확장 — `SERVER_STARTED` + `PlayerJoin` + `ServerTick`
하나만 firing 돼도 점수가 1 로 올라가게.**
## 이전 버전 fix 도 같이 포함 (v1.0.20, v1.0.21)
→ 그래서 v1.0.23 의 데이터팩 자체는 v1.0.21 과 사실상 같다. 진짜 fix 는
**`mc_chat_answer_mod` v1.3.6** 에 들어 있다.
### v1.0.22 에서 v1.0.23 으로 — 잘못된 방향을 되돌림
v1.0.22 (잠시 릴리스됨) 는 게이트 자체를 제거하는 방향으로 갔다 — 잘못된
선택이었음. 채팅정답 모드 서버 설치 검증을 잃어버려서 모드 없는 서버에서도
시작이 됨. v1.0.23 은 v1.0.22 의 데이터팩 변경을 되돌려 `commands/start.mcfunction`
`load.mcfunction``mq_chat_mod` 게이트와 objective 를 복구.
## 같이 포함된 이전 fix (v1.0.20, v1.0.21)
### `repeat/buttons/btn.mcfunction`
- (v1.0.20) `positioned $(x) $(y) $(z)``$(x).0 $(y).0 $(z).0`.
@@ -38,6 +46,17 @@
## 적용 방법
### 1. `mc_chat_answer_mod` v1.3.6 으로 업그레이드 (false negative 해결의 핵심)
서버의 mods 폴더에서 기존 `chat_answer-*.jar` 를 제거하고
`chat_answer-1.3.6.jar` 를 넣는다.
다운로드: https://git.tkrmagid.kr/tkrmagid/mc_chat_answer_mod/releases/tag/v1.3.6
서버 재시작 필요 (모드 jar 교체이므로).
### 2. 데이터팩 파일 덮어쓰기
서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 이 폴더의
파일을 **같은 경로에 덮어쓰세요**.
@@ -55,9 +74,9 @@ temp/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).
이미 v1.0.21 을 적용한 상태였다면 사실 datapack 파일은 그대로 같다 —
모드 jar 업그레이드만 하면 끝. (v1.0.22 를 한 번 거쳐갔다면 위 두
`start/load` 파일을 덮어써서 게이트를 복구해야 함.)
복사 후 게임 안에서:
@@ -67,8 +86,11 @@ temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
## 확인
- 채팅정답 모드가 설치되어 있든 아니든 `/start` 가 "채팅정답 모드 미설치"
메시지로 차단되지 않아야 합니다. (영상재생 모드는 여전히 필수.)
- 채팅정답 모드가 설치되어 있으면 `/start` 가 "채팅정답 모드 미설치" 메시지
없이 정상 진행.
- 채팅정답 모드가 진짜 서버에 없으면 (또는 모드 v1.3.5 이하 + tick 이벤트
미작동 호스트 조합이면) 여전히 "채팅정답 모드가 서버에 미설치" 로 차단되어
관리자에게 안내 — 이게 의도된 동작 (가드 살아 있음).
- 버튼 클릭 시 stone_button 의 powered 애니메이션 없음.
- 라벨이 `게임시작` 등으로 정상 표시 (JSON 코드 노출 없음).
- 콘솔에 파싱 에러 없음.