tkrmagid/mc_datapack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 26 Wiki Activity

music_quiz: 버튼 동시 눌림 방지 + text_display 텍스트 컴포넌트 형식 수정

Browse Source 
(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>
This commit is contained in:
Claude (owner)
2026-05-18 23:50:04 +09:00
parent b803a422a3
commit da075b60b8
3 changed files with 90 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
temp/README.md
View File

@@ -1,67 +1,48 @@
# v1.0.18 → v1.0.20 부분 적용 가이드
# v1.0.20 → v1.0.21 부분 적용 가이드
전체 datapack 을 교체하지 않고, 이 폴더의 두 파일만 덮어쓰면 v1.0.20 과 동일한 상태가 됩니다.
전체 datapack 을 교체하지 않고, 이 폴더의 파일만 덮어쓰면 v1.0.21 과 동일한 상태가 됩니다.
## 무엇이 바뀌었나 (진짜 원인)
## 무엇이 바뀌었나
### 1. `repeat/buttons/btn.mcfunction` — interaction 박스가 버튼에서 0.5 칸 어긋나던 문제
### 1. `repeat/buttons/btn.mcfunction` — 버튼이 같이 눌러지던 문제 + 라벨이 JSON 코드로 나오던 문제
마인크래프트 명령의 vec3 좌표 인자는 **정수만 적으면 자동으로 +0.5 보정** 됩니다
(블록 중심으로 잡힘). 즉
**(a) 클릭 시 stone_button 도 같이 눌러짐**
```
positioned 2773 86 5968
```
interaction 박스가 stone_button 의 hitbox 와 정확히 겹쳐 있어서, 한 번
클릭에 interaction 도 발화하고 stone_button 도 vanilla 클릭으로 인식해
`powered=true` 애니메이션이 같이 일어났습니다. interaction 박스를 버튼
면 바깥쪽으로 한 두께(0.125) 만큼 빼서, 플레이어 ray 가 stone_button 에
닿기 전에 interaction 에서 멈추도록 했습니다.
는 실제로 `(2773.5, 86, 5968.5)` 가 됩니다. 그래서 거기서 `~0.375 ~0.375 ~0.0625`
를 더해 interaction 을 소환하면 박스 전체가 블록 중앙 쪽으로 0.5 칸 밀려서
버튼과 어긋나 보입니다 (사용자가 보내준 사진의 정확히 그 증상).
- south : 깊이 z 중심 0.0625 → -0.0625
- north : 깊이 z 중심 0.9375 → 1.0625
- east : 깊이 x 중심 0.0625 → -0.0625
- west : 깊이 x 중심 0.9375 → 1.0625
수정: `positioned $(x) $(y) $(z)` → `positioned $(x).0 $(y).0 $(z).0`.
매크로 expand 결과가 `positioned 2773.0 86.0 5968.0` 처럼 decimal 형태가
되어 .5 보정이 발생하지 않고 블록의 minimal corner 가 정확히 origin 으로
잡힙니다.
**(b) 라벨이 `{"text":"게임시작",...}` JSON 텍스트 그대로 보임**
### 2. `repeat/buttons/btn_prep.mcfunction` — `btn.label <--[HERE]` 파싱 에러
MC 1.20.5+ 부터 text_display 의 `text` 필드는 String 이 아니라 직접
TextComponent compound 로 저장됩니다. 이전에는 String 안에 JSON 을 넣어서
(`text:'{...}'`) 그 JSON 자체가 텍스트로 렌더링되었습니다. compound 형태
(`text:{text:"...",color:"...",font:"..."}`) 로 변경.
이전 구현은
### 2. `repeat/buttons/btn_prep.mcfunction`
```
execute unless data storage mq:tmp btn.label run data modify storage mq:tmp btn.label set value ""
```
같은 식이었는데 MC 26.1.2 의 명령 파서가 이 라인을 거부했습니다. 문제 난
`execute unless data storage ... <path>` 구문 자체를 제거하고, defaults
컴파운드 위에 entry 를 merge 하는 방식으로 다시 작성했습니다.
```
data modify storage mq:tmp btn_default set value {label:"",label_color:"black",label_font:"minecraft:default",label_scale:"1.0"}
data modify storage mq:tmp btn_default merge from storage mq:tmp btn
data modify storage mq:tmp btn set from storage mq:tmp btn_default
```
`data modify ... merge from` 은 source 의 키로 target 을 덮어쓰므로,
entry 에 있는 값은 보존되고 entry 에 없는 키만 default 값으로 채워집니다.
기능적으로는 이전과 같지만 문제 난 라인 자체가 없어졌습니다.
v1.0.20 에서 이미 수정됨 (defaults + merge 방식). 변경 없음 — 다만
v1.0.19 이하에서 점프하는 경우 같이 덮어써야 합니다.
## 적용 방법
이 폴더의 `data/` 트리는 datapack 의 `data/` 트리와 같은 구조입니다.
서버의 datapack 폴더 (예: `world/datapacks/music_quiz/`) 기준으로 두 파일을
**반드시 덮어쓰세요**.
```
temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
-> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction (덮어쓰기)
temp/data/mq/function/repeat/buttons/btn.mcfunction
-> <datapack>/data/mq/function/repeat/buttons/btn.mcfunction (덮어쓰기)
```
`btn_prep.mcfunction` 은 v1.0.17 이후에 추가된 파일이라, v1.0.16 이하에서
바로 v1.0.20 으로 점프한다면 새로 생성되는 것입니다. v1.0.17 / v1.0.18 /
v1.0.19 이미 설치된 환경이라면 기존 파일을 반드시 덮어써야 합니다 (남아 있는
구버전 파일이 reload 시 같은 파싱 에러를 일으킵니다).
temp/data/mq/function/repeat/buttons/btn_prep.mcfunction
-> <datapack>/data/mq/function/repeat/buttons/btn_prep.mcfunction (덮어쓰기)
```
복사 후 게임 안에서:
@@ -71,8 +52,8 @@ v1.0.19 이미 설치된 환경이라면 기존 파일을 반드시 덮어써야
## 확인
- `/reload` 시 콘솔에 `Failed to load function mq:repeat/buttons/btn_prep`
같은 파싱 에러가 더 이상 뜨지 않아야 합니다.
- 버튼 위치에 interaction 박스가 정확히 버튼 머리를 감싸야 합니다
(이전처럼 옆으로 0.5 칸 어긋나지 않아야 합니다).
- 버튼을 클릭했을 때 정상적으로 동작하면 적용 성공입니다.
- 버튼을 클릭해도 stone_button 의 `powered=true` 눌림 애니메이션이
발생하지 않아야 합니다 (interaction 만 발화).
- 버튼 아래 라벨이 `게임시작` / `정지` / `소리 테스트` 등으로 정상 표시
(JSON 텍스트 노출 없음).
- 콘솔에 파싱 에러 없음.