From 736ec2a3d1aa62137af10fec42d0aff704cb86a3 Mon Sep 17 00:00:00 2001 From: "Claude (owner)" Date: Tue, 19 May 2026 00:01:07 +0900 Subject: [PATCH] =?UTF-8?q?music=5Fquiz:=20=EC=B1=84=ED=8C=85=EC=A0=95?= =?UTF-8?q?=EB=8B=B5=20=EB=AA=A8=EB=93=9C=20=EA=B2=8C=EC=9D=B4=ED=8A=B8=20?= =?UTF-8?q?=EC=A0=9C=EA=B1=B0=20=E2=80=94=20false=20negative=20=EC=B0=A8?= =?UTF-8?q?=EB=8B=A8=20=ED=95=B4=EA=B2=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 모드를 설치했는데도 /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 --- .../mq/function/commands/start.mcfunction | 32 ++++---- music_quiz/data/mq/function/load.mcfunction | 16 ++-- temp/README.md | 77 +++++++++++-------- .../mq/function/commands/start.mcfunction | 37 +++++++++ temp/data/mq/function/load.mcfunction | 49 ++++++++++++ 5 files changed, 155 insertions(+), 56 deletions(-) create mode 100644 temp/data/mq/function/commands/start.mcfunction create mode 100644 temp/data/mq/function/load.mcfunction diff --git a/music_quiz/data/mq/function/commands/start.mcfunction b/music_quiz/data/mq/function/commands/start.mcfunction index 8e08a05..966a7c8 100644 --- a/music_quiz/data/mq/function/commands/start.mcfunction +++ b/music_quiz/data/mq/function/commands/start.mcfunction @@ -1,26 +1,22 @@ execute if score init main matches 10 run return run function mq:tellraw {"text":"퀴즈가 완전히 종료된후 시작해주세요.","color":"red","msg":""} # ---- 외부 모드 설치 검증 ---- -# 두 모드는 성격이 달라서 검증 방식이 다름: +# mq_video_mod (mc_video_player_mod) 만 게이트. 영상 렌더링은 클라 모드가 +# 필수라 없으면 게임이 의미가 없음. same objective 안에 holder 두 종류: +# - `#server mq_video_mod` : 서버 컴포넌트가 매 tick 1 로 갱신 (server +# presence). 없으면 0 → 서버에 모드 미설치. +# - ` mq_video_mod` : 클라 join 시 payload 가 서버로 오면 서버 +# 컴포넌트가 해당 플레이어 점수를 1 로 set (client presence). 클라 +# 미설치면 0 유지. # -# * mq_chat_mod : mc_chat_answer_mod = 서버 전용 모드 (채팅 가로채기는 -# 서버에서 일어남, 클라 설치 불필요). 따라서 fake player `#server` -# 점수를 모드가 매 server tick 마다 1 로 set. 서버에 모드가 없으면 -# 이 점수가 갱신되지 않음. +# mq_chat_mod (mc_chat_answer_mod) 는 게이트하지 않음 — 채팅 모드는 입력을 +# "편하게" 만들어주는 옵션일 뿐이고, 모드 없는 환경에서도 `/trigger input` +# dialog 경로로 정답 제출이 가능. 과거에 게이트해 두면 모드 presence pulse +# 가 호스트 환경 (banner/mohist 같은 fabric-bukkit 하이브리드) 에서 안 +# 들어오거나, 사용자 모드 버전이 presence tick 이전 (v1.3.4 이하) 일 때 +# false negative 로 시작이 막혔음. # -# * mq_video_mod : mc_video_player_mod = 클라이언트 측 렌더링 + 서버 측 -# 컴포넌트. 같은 objective 안에 holder 두 종류 사용: -# - `#server mq_video_mod` : 서버 컴포넌트가 매 tick 1 로 갱신 (server -# presence). 없으면 0 → 서버에 모드 미설치. -# - ` mq_video_mod` : 클라 join 시 payload 가 서버로 오면 서버 -# 컴포넌트가 해당 플레이어 점수를 1 로 set (client presence). 클라 -# 미설치면 0 유지. -# 이렇게 분리해야 "서버 미설치"와 "특정 플레이어 클라 미설치"가 안내에서 -# 구분된다. -# -# 1) 서버 측 모드 부재 — 전원 차단, 단일 안내. 서버 부재는 클라 검사보다 -# 우선해야 — 클라가 다 설치되어 있어도 서버가 없으면 동작 안 한다. -execute unless score #server mq_chat_mod matches 1 run return run function mq:tellraw {"text":"채팅정답 모드가 서버에 미설치 — 서버 관리자에게 문의해주세요.","color":"red","msg":""} +# 1) 서버 측 영상 모드 부재 — 전원 차단, 단일 안내. execute unless score #server mq_video_mod matches 1 run return run function mq:tellraw {"text":"영상재생 모드가 서버에 미설치 — 서버 관리자에게 문의해주세요.","color":"red","msg":""} # 2) 클라이언트 측 모드 (mc_video_player_mod) 부재 — 본인 누락 안내 + 차단. diff --git a/music_quiz/data/mq/function/load.mcfunction b/music_quiz/data/mq/function/load.mcfunction index 3daef27..60d88ee 100644 --- a/music_quiz/data/mq/function/load.mcfunction +++ b/music_quiz/data/mq/function/load.mcfunction @@ -22,21 +22,23 @@ scoreboard objectives add answer dummy scoreboard objectives add leave_game custom:leave_game # 외부 모드 존재 확인용 점수. -# mq_chat_mod : 서버 전용 모드(mc_chat_answer_mod). 모드가 매 server tick -# 마다 fake player `#server` 점수를 1 로 set. 모드가 서버에 없으면 0 유지. # mq_video_mod : 클라이언트 모드(mc_video_player_mod). 클라 join 시 서버로 # handshake payload 전송 → 서버 측 모드가 해당 플레이어 점수를 1 로 set. # 클라에 모드가 없으면 0 유지. (login.mcfunction 에서 플레이어별 0 초기화.) +# same objective 안에 holder 두 종류 — `#server` 는 서버 컴포넌트 존재 +# (서버 측 모드가 매 tick 1 로 갱신), `` 는 클라 측 존재 (payload +# 수신 시 1 로 갱신). +# +# mq_chat_mod (mc_chat_answer_mod) 는 더 이상 게이트하지 않음 — 모드 없는 +# 환경에서도 `/trigger input` dialog 경로로 정답 제출 가능. presence pulse +# 가 호스트 환경에 따라 안 들어오거나 사용자 모드 버전이 옛날일 때 false +# negative 로 시작이 막히던 문제 회피. (모드 측은 여전히 매 tick objective +# 존재시 1 로 set 시도하지만, objective 가 없으면 silent skip 하므로 무해.) scoreboard objectives remove mq_chat_mod scoreboard objectives remove mq_video_mod -scoreboard objectives add mq_chat_mod dummy scoreboard objectives add mq_video_mod dummy # /reload 후 모드가 한 tick 도 돌기 전에 start 가 호출될 수 있으니 # #server 점수도 0 으로 materialize. 모드가 살아 있으면 다음 tick 에 1 로 갱신. -# mq_video_mod 도 같은 objective 안에서 holder 만 다르게 — `#server` 는 서버 -# 컴포넌트 존재 (서버 측 모드가 매 tick 1 로 갱신), `` 는 클라 측 -# 존재 (payload 수신 시 1 로 갱신). -scoreboard players set #server mq_chat_mod 0 scoreboard players set #server mq_video_mod 0 scoreboard players set two func.temp 2 diff --git a/temp/README.md b/temp/README.md index d2134eb..dfccd3e 100644 --- a/temp/README.md +++ b/temp/README.md @@ -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 + -> /data/mq/function/commands/start.mcfunction + +temp/data/mq/function/load.mcfunction + -> /data/mq/function/load.mcfunction + temp/data/mq/function/repeat/buttons/btn.mcfunction - -> /data/mq/function/repeat/buttons/btn.mcfunction (덮어쓰기) + -> /data/mq/function/repeat/buttons/btn.mcfunction temp/data/mq/function/repeat/buttons/btn_prep.mcfunction - -> /data/mq/function/repeat/buttons/btn_prep.mcfunction (덮어쓰기) + -> /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 코드 노출 없음). - 콘솔에 파싱 에러 없음. diff --git a/temp/data/mq/function/commands/start.mcfunction b/temp/data/mq/function/commands/start.mcfunction new file mode 100644 index 0000000..966a7c8 --- /dev/null +++ b/temp/data/mq/function/commands/start.mcfunction @@ -0,0 +1,37 @@ +execute if score init main matches 10 run return run function mq:tellraw {"text":"퀴즈가 완전히 종료된후 시작해주세요.","color":"red","msg":""} + +# ---- 외부 모드 설치 검증 ---- +# mq_video_mod (mc_video_player_mod) 만 게이트. 영상 렌더링은 클라 모드가 +# 필수라 없으면 게임이 의미가 없음. same objective 안에 holder 두 종류: +# - `#server mq_video_mod` : 서버 컴포넌트가 매 tick 1 로 갱신 (server +# presence). 없으면 0 → 서버에 모드 미설치. +# - ` mq_video_mod` : 클라 join 시 payload 가 서버로 오면 서버 +# 컴포넌트가 해당 플레이어 점수를 1 로 set (client presence). 클라 +# 미설치면 0 유지. +# +# mq_chat_mod (mc_chat_answer_mod) 는 게이트하지 않음 — 채팅 모드는 입력을 +# "편하게" 만들어주는 옵션일 뿐이고, 모드 없는 환경에서도 `/trigger input` +# dialog 경로로 정답 제출이 가능. 과거에 게이트해 두면 모드 presence pulse +# 가 호스트 환경 (banner/mohist 같은 fabric-bukkit 하이브리드) 에서 안 +# 들어오거나, 사용자 모드 버전이 presence tick 이전 (v1.3.4 이하) 일 때 +# false negative 로 시작이 막혔음. +# +# 1) 서버 측 영상 모드 부재 — 전원 차단, 단일 안내. +execute unless score #server mq_video_mod matches 1 run return run function mq:tellraw {"text":"영상재생 모드가 서버에 미설치 — 서버 관리자에게 문의해주세요.","color":"red","msg":""} + +# 2) 클라이언트 측 모드 (mc_video_player_mod) 부재 — 본인 누락 안내 + 차단. +# selector `scores={X=..0}` 는 점수 미존재를 매치하지 않으므로 직전에 +# `add @a ... 0` 으로 materialize. 개인 안내는 tellraw @s 직접 (mq:tellraw +# 는 내부 @a broadcast 라 부적합). +scoreboard players add @a mq_video_mod 0 +execute as @a[scores={mq_video_mod=..0}] run tellraw @s ["",{"text":"영상재생 모드 미설치 — 모드 적용 후 다시 입장해주세요.","color":"red"}] +execute if entity @a[scores={mq_video_mod=..0}] run return run function mq:tellraw {"text":"필수 모드 미설치 플레이어가 있어 시작할 수 없습니다.","color":"red","msg":""} + +setblock ~ ~ ~ minecraft:air + +function mq:quiz/stop_sound + +$scoreboard players set max_index main $(max_index) +scoreboard players set init main 1 + +dialog show @a mq:page1 diff --git a/temp/data/mq/function/load.mcfunction b/temp/data/mq/function/load.mcfunction new file mode 100644 index 0000000..60d88ee --- /dev/null +++ b/temp/data/mq/function/load.mcfunction @@ -0,0 +1,49 @@ +data modify storage mq:main answer set value {title:"", author:"", alias:[]} +data merge storage func:temp {} +data merge storage mq:tmp {} + +function mq:init/config +function mq:init/songs +function mq:init/buttons +function mq:init/triggers + +function mq:tellraw {"text":"서버 리로드 성공!","color":"white","msg":'""'} + +scoreboard objectives remove func.temp +scoreboard objectives remove main +scoreboard objectives remove buttons +scoreboard objectives remove answer +scoreboard objectives remove leave_game + +scoreboard objectives add func.temp dummy +scoreboard objectives add main dummy +scoreboard objectives add buttons dummy +scoreboard objectives add answer dummy +scoreboard objectives add leave_game custom:leave_game + +# 외부 모드 존재 확인용 점수. +# mq_video_mod : 클라이언트 모드(mc_video_player_mod). 클라 join 시 서버로 +# handshake payload 전송 → 서버 측 모드가 해당 플레이어 점수를 1 로 set. +# 클라에 모드가 없으면 0 유지. (login.mcfunction 에서 플레이어별 0 초기화.) +# same objective 안에 holder 두 종류 — `#server` 는 서버 컴포넌트 존재 +# (서버 측 모드가 매 tick 1 로 갱신), `` 는 클라 측 존재 (payload +# 수신 시 1 로 갱신). +# +# mq_chat_mod (mc_chat_answer_mod) 는 더 이상 게이트하지 않음 — 모드 없는 +# 환경에서도 `/trigger input` dialog 경로로 정답 제출 가능. presence pulse +# 가 호스트 환경에 따라 안 들어오거나 사용자 모드 버전이 옛날일 때 false +# negative 로 시작이 막히던 문제 회피. (모드 측은 여전히 매 tick objective +# 존재시 1 로 set 시도하지만, objective 가 없으면 silent skip 하므로 무해.) +scoreboard objectives remove mq_chat_mod +scoreboard objectives remove mq_video_mod +scoreboard objectives add mq_video_mod dummy +# /reload 후 모드가 한 tick 도 돌기 전에 start 가 호출될 수 있으니 +# #server 점수도 0 으로 materialize. 모드가 살아 있으면 다음 tick 에 1 로 갱신. +scoreboard players set #server mq_video_mod 0 + +scoreboard players set two func.temp 2 + +bossbar add mq:process [{"text":"진행도: ","color": "yellow","bold": true},{"text":"0","color": "yellow","bold": true},{"text":"/","color": "yellow","bold": true},{"text":"0","color": "yellow","bold": true}] + +function mq:commands/stop with storage mq:main +function mq:players/login with storage mq:main spawn