music_quiz: 버튼 라벨 위치 + interaction 깊이 부호 수정
- text_display Y `~-1` → `~-0.25`: entity Y 가 텍스트 윗변이라 ~-1 이면 텍스트 본체가 바닥에 떨어져 표시됐음. ~-0.25 로 두면 버튼 바로 아래 벽면 [Y-1, Y] 의 위쪽 절반에 라벨이 자리잡음. - text 에 bold:true 기본 적용. - interaction 깊이 부호 반전: v1.0.21 에서 "버튼 바깥 한 두께 만큼 밀어 동시 발화 회피" 의도였는데 부호를 반대로 잡아 벽 안쪽으로 들어가 있었음 (south z=-0.0625 등). 플레이어 쪽 (south z=0.1875 등) 으로 수정. 이전엔 raycast tie 로 우연히 동작했지만 호스트/각도에 따라 벽이 먼저 차단되는 케이스 발생. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
110
temp/README.md
110
temp/README.md
@@ -1,67 +1,78 @@
|
||||
# 부분 적용 가이드 (→ v1.0.23)
|
||||
# 부분 적용 가이드 (→ v1.0.24)
|
||||
|
||||
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.23 와 동일한 상태가 됩니다.
|
||||
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.24 와 동일한 상태가 됩니다.
|
||||
|
||||
## v1.0.23 의 핵심 변경 — 채팅정답 모드 false negative 의 진짜 fix
|
||||
## v1.0.24 의 변경 — 버튼 라벨 위치 & 인터랙션 깊이 방향 수정
|
||||
|
||||
증상: 채팅정답 모드를 설치했는데도 `/start` 가 "채팅정답 모드가 서버에 미설치"
|
||||
로 차단됨.
|
||||
증상 두 가지:
|
||||
1. **라벨이 벽에 안 붙고 바닥에 떨어져 표시.** 버튼 바로 아래 벽면 가운데에
|
||||
있어야 할 라벨이 한 칸 아래 바닥 근처에 떠 있음.
|
||||
2. **interaction 박스가 벽 안쪽으로 들어감.** 버튼 머리보다 플레이어 쪽으로
|
||||
튀어나와야 하는데 반대로 벽 속에 박혀 있어 각도에 따라 클릭이 벽에 먼저
|
||||
막힘.
|
||||
|
||||
원인: 검증은 모드가 매 server tick `#server mq_chat_mod` 점수를 1 로 set
|
||||
하는지 보는 방식인데, 다음 케이스에서 score 가 1 로 안 올라가 false negative:
|
||||
- 옛 모드 버전 (v1.3.4 이하, presence tick 추가 전) 사용 중
|
||||
- banner/mohist 같은 fabric-bukkit 하이브리드 호스트에서 `ServerTickEvents`
|
||||
가 안 들어옴
|
||||
원인 두 가지:
|
||||
1. `text_display` 의 entity Y 는 텍스트 윗변이고 text 는 아래로 자란다. Y
|
||||
오프셋을 `~-1` 로 잡았더니 텍스트 윗변이 한 칸 아래로 내려가 결국 바닥에
|
||||
표시됨.
|
||||
2. v1.0.21 에서 "interaction 을 버튼 hitbox 바깥으로 한 두께만큼 밀어 stone
|
||||
button 동시 발화 회피" 의도였는데 부호를 반대로 잡았음. `facing=south`
|
||||
는 버튼 머리가 +z 방향 (= 플레이어 쪽) 인데 interaction 을 -z (= 벽 쪽)
|
||||
로 보내서 벽 안에 박힘. 이전엔 우연히 raycast tie 로 interaction 이
|
||||
이겨서 동작했지만, 호스트/각도에 따라 벽이 먼저 차단되는 케이스가 발생.
|
||||
|
||||
근본 fix: **데이터팩 가드는 그대로 유지하고, 모드 쪽에서 presence pulse
|
||||
지점을 넷으로 확장 — `SERVER_STARTED` + `END_DATA_PACK_RELOAD` +
|
||||
`PlayerJoin` + `ServerTick` 중 하나만 firing 돼도 점수가 1 로 올라가게.**
|
||||
(데이터팩 load 가 매 `/reload` 마다 점수를 0 으로 리셋하므로 reload
|
||||
직후 즉시 다시 1 로 찍어 줄 `END_DATA_PACK_RELOAD` 훅이 필수.)
|
||||
수정:
|
||||
- `text_display` Y: `~-1` → `~-0.25`. 텍스트 윗변이 버튼 바로 아래에 위치,
|
||||
한 줄이 버튼 아래 한 칸 벽면 [Y-1, Y] 의 위쪽 절반에 자리잡음.
|
||||
- `text_display` 텍스트에 `bold:true` 기본 적용.
|
||||
- interaction 깊이 부호 반전:
|
||||
- south: z `~-0.0625` → `~0.1875` (벽 z=0 의 +z 쪽, 플레이어 측)
|
||||
- north: z `~1.0625` → `~0.8125` (벽 z=1 의 -z 쪽, 플레이어 측)
|
||||
- east: x `~-0.0625` → `~0.1875`
|
||||
- west: x `~1.0625` → `~0.8125`
|
||||
|
||||
→ 그래서 v1.0.23 의 데이터팩 자체는 v1.0.21 과 사실상 같다. 진짜 fix 는
|
||||
**`mc_chat_answer_mod` v1.3.7** 에 들어 있다.
|
||||
이 변경은 `repeat/buttons/btn.mcfunction` 한 파일에만 있음. 모드 jar 변경
|
||||
없음 — v1.0.23 와 같은 `mc_chat_answer_mod` v1.3.7 그대로 사용.
|
||||
|
||||
### v1.0.22 에서 v1.0.23 으로 — 잘못된 방향을 되돌림
|
||||
## 같이 포함된 이전 fix (v1.0.20 ~ v1.0.23)
|
||||
|
||||
v1.0.22 (잠시 릴리스됨) 는 게이트 자체를 제거하는 방향으로 갔다 — 잘못된
|
||||
선택이었음. 채팅정답 모드 서버 설치 검증을 잃어버려서 모드 없는 서버에서도
|
||||
시작이 됨. v1.0.23 은 v1.0.22 의 데이터팩 변경을 되돌려 `commands/start.mcfunction`
|
||||
과 `load.mcfunction` 의 `mq_chat_mod` 게이트와 objective 를 복구.
|
||||
### v1.0.23 — 채팅정답 모드 false negative 의 진짜 fix
|
||||
검증 게이트는 유지하고, 모드 쪽 presence pulse 지점을 넷으로 확장
|
||||
(`SERVER_STARTED` + `END_DATA_PACK_RELOAD` + `PlayerJoin` + `ServerTick`).
|
||||
진짜 fix 는 `mc_chat_answer_mod` v1.3.7 에 들어 있음.
|
||||
|
||||
## 같이 포함된 이전 fix (v1.0.20, v1.0.21)
|
||||
### v1.0.21
|
||||
- interaction 깊이축을 stone_button hitbox 바깥쪽으로 이동 (한 번 클릭에
|
||||
stone_button 도 같이 눌리던 powered=true 문제 회피). — **부호는 v1.0.24
|
||||
에서 수정.**
|
||||
- `text_display.text` 를 String JSON 에서 직접 TextComponent compound 로
|
||||
(MC 1.20.5+ 에서 라벨이 코드 그대로 렌더되던 문제 회피).
|
||||
|
||||
### `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":"게임시작",...}` 코드 그대로
|
||||
렌더되던 문제 회피.
|
||||
|
||||
### `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` 방식으로
|
||||
재작성.
|
||||
### v1.0.20
|
||||
- `positioned $(x) $(y) $(z)` → `$(x).0 $(y).0 $(z).0` (MC vec3 정수 인자
|
||||
자동 +0.5 보정 회피).
|
||||
- `btn_prep.mcfunction`: `execute unless data storage ...` 가 MC 26.1.2
|
||||
파서에 거부되던 문제 → defaults + `data modify ... merge from` 으로 재작성.
|
||||
|
||||
## 적용 방법
|
||||
|
||||
### 1. `mc_chat_answer_mod` v1.3.7 으로 업그레이드 (false negative 해결의 핵심)
|
||||
### 1. `mc_chat_answer_mod` v1.3.7 사용 (v1.0.23 와 동일)
|
||||
|
||||
서버의 mods 폴더에서 기존 `chat_answer-*.jar` 를 제거하고
|
||||
`chat_answer-1.3.7.jar` 를 넣는다.
|
||||
이미 v1.3.7 을 쓰고 있으면 그대로 두면 됨. 아직 구버전이면 교체:
|
||||
|
||||
다운로드: https://git.tkrmagid.kr/tkrmagid/mc_chat_answer_mod/releases/tag/v1.3.7
|
||||
|
||||
서버 재시작 필요 (모드 jar 교체이므로).
|
||||
서버 mods 폴더에서 기존 `chat_answer-*.jar` 제거 후 `chat_answer-1.3.7.jar`
|
||||
투입, 서버 재시작.
|
||||
|
||||
### 2. 데이터팩 파일 덮어쓰기
|
||||
|
||||
서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 이 폴더의
|
||||
파일을 **같은 경로에 덮어쓰세요**.
|
||||
|
||||
v1.0.24 에서 실제로 바뀐 파일은 `btn.mcfunction` 하나지만, 이전 단계를
|
||||
건너뛰고 올라오는 경우를 위해 v1.0.23 의 4 파일을 그대로 동봉:
|
||||
|
||||
```
|
||||
temp/data/mq/function/commands/start.mcfunction
|
||||
-> <datapack>/data/mq/function/commands/start.mcfunction
|
||||
@@ -76,10 +87,6 @@ temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
|
||||
-> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction
|
||||
```
|
||||
|
||||
이미 v1.0.21 을 적용한 상태였다면 사실 datapack 파일은 그대로 같다 —
|
||||
모드 jar 업그레이드만 하면 끝. (v1.0.22 를 한 번 거쳐갔다면 위 두
|
||||
`start/load` 파일을 덮어써서 게이트를 복구해야 함.)
|
||||
|
||||
복사 후 게임 안에서:
|
||||
|
||||
```
|
||||
@@ -88,11 +95,10 @@ temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
|
||||
|
||||
## 확인
|
||||
|
||||
- 채팅정답 모드가 설치되어 있으면 `/start` 가 "채팅정답 모드 미설치" 메시지
|
||||
없이 정상 진행.
|
||||
- 채팅정답 모드가 진짜 서버에 없으면 (또는 모드 v1.3.5 이하 + tick 이벤트
|
||||
미작동 호스트 조합이면) 여전히 "채팅정답 모드가 서버에 미설치" 로 차단되어
|
||||
관리자에게 안내 — 이게 의도된 동작 (가드 살아 있음).
|
||||
- 버튼 클릭 시 stone_button 의 powered 애니메이션 없음.
|
||||
- 라벨이 `게임시작` 등으로 정상 표시 (JSON 코드 노출 없음).
|
||||
- 버튼 라벨이 버튼 바로 아래 벽면 가운데에 굵게 (bold) 표시.
|
||||
- 버튼을 클릭할 때 stone_button 의 powered 애니메이션 없음.
|
||||
- 비스듬한 각도에서도 interaction 이 벽에 가려지지 않고 잘 클릭됨
|
||||
(interaction 박스가 버튼 머리보다 플레이어 쪽으로 튀어나와 있음).
|
||||
- 채팅정답 모드가 설치되어 있으면 `/start` 정상 진행. 없으면 "채팅정답
|
||||
모드 미설치" 로 차단 (가드 살아 있음).
|
||||
- 콘솔에 파싱 에러 없음.
|
||||
|
||||
Reference in New Issue
Block a user