b803a422a3
- btn.mcfunction 의 positioned $(x) $(y) $(z) → $(x).0 $(y).0 $(z).0. 마인크래프트 vec3 인자는 정수만 쓰면 자동으로 +0.5 보정 (블록 중심으로 잡힘) 되기 때문에 positioned 2773 86 5968 이 실제로는 (2773.5, 86, 5968.5) 가 되고, 거기서 ~0.375 ~0.0625 같은 오프셋을 더해 interaction 을 소환하면 박스가 블록 중앙으로 0.5 칸 밀린다. decimal 형태로 강제해 보정 회피. - btn_prep.mcfunction 을 execute-unless-data 방식에서 defaults 컴파운드 + merge 방식으로 재작성. 이전 v1.0.19 의 다중 공백 정규화는 근본 원인이 아니었음 — `execute unless data storage mq:tmp btn.label run ...` 구문 자체를 MC 26.1.2 파서가 거부. data modify ... merge from 으로 source 의 키가 target 을 덮어쓰는 머지를 활용하면 같은 기능을 문제 라인 없이 구현. - temp/ 부분 적용 패키지의 README 와 두 파일을 동기화. 진짜 원인 설명으로 재작성. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
v1.0.18 → v1.0.20 부분 적용 가이드
전체 datapack 을 교체하지 않고, 이 폴더의 두 파일만 덮어쓰면 v1.0.20 과 동일한 상태가 됩니다.
무엇이 바뀌었나 (진짜 원인)
1. repeat/buttons/btn.mcfunction — interaction 박스가 버튼에서 0.5 칸 어긋나던 문제
마인크래프트 명령의 vec3 좌표 인자는 정수만 적으면 자동으로 +0.5 보정 됩니다 (블록 중심으로 잡힘). 즉
positioned 2773 86 5968
는 실제로 (2773.5, 86, 5968.5) 가 됩니다. 그래서 거기서 ~0.375 ~0.375 ~0.0625
를 더해 interaction 을 소환하면 박스 전체가 블록 중앙 쪽으로 0.5 칸 밀려서
버튼과 어긋나 보입니다 (사용자가 보내준 사진의 정확히 그 증상).
수정: positioned $(x) $(y) $(z) → positioned $(x).0 $(y).0 $(z).0.
매크로 expand 결과가 positioned 2773.0 86.0 5968.0 처럼 decimal 형태가
되어 .5 보정이 발생하지 않고 블록의 minimal corner 가 정확히 origin 으로
잡힙니다.
2. repeat/buttons/btn_prep.mcfunction — btn.label <--[HERE] 파싱 에러
이전 구현은
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 값으로 채워집니다.
기능적으로는 이전과 같지만 문제 난 라인 자체가 없어졌습니다.
적용 방법
이 폴더의 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 시 같은 파싱 에러를 일으킵니다).
복사 후 게임 안에서:
/reload
확인
/reload시 콘솔에Failed to load function mq:repeat/buttons/btn_prep같은 파싱 에러가 더 이상 뜨지 않아야 합니다.- 버튼 위치에 interaction 박스가 정확히 버튼 머리를 감싸야 합니다 (이전처럼 옆으로 0.5 칸 어긋나지 않아야 합니다).
- 버튼을 클릭했을 때 정상적으로 동작하면 적용 성공입니다.