mc_datapack/README.md

# mc_datapack

마인크래프트 자작 데이터팩 모음 저장소.

현재 포함된 데이터팩:

- `music_quiz/` — 음악퀴즈 데이터팩

---

## music_quiz — 음악퀴즈 데이터팩

플레이어가 노래를 듣고 정답을 맞히는 멀티플레이 음악 퀴즈.
관리자가 버튼/대화창으로 라운드를 진행하고, 참가자는 트리거 명령으로
정답·스킵·힌트·다시듣기 투표에 참여한다.

### 호환 버전

- **Minecraft 26.1.2** (`pack.mcmeta` 의 `min_format`/`max_format` 모두
  `[101, 1]`).
- 1.21.6에서 도입된 `dialog` 시스템, 1.21+의 단수형 `function/` 태그 폴더,
  매크로 함수(`function ... with storage`) 기능을 사용한다.
- 텍스트 컴포넌트는 JSON 표기로 작성돼 있으며, 1.21.5 이후의 SNBT 파서와도
  호환된다 (JSON은 SNBT의 부분집합).

### 외부 모드 의존성 (서버/클라)

모드는 **필수 1 + 선택 1** 구성이다.

- **`mc_chat_answer_mod` v1.3.7+ (필수)** — 서버 전용. 채팅으로 정답 입력을
  받는다. 정답 판정의 핵심이라 없으면 `/start` 가 차단된다. presence 는
  `#server mq_chat_mod` 점수로 매 tick 표시되며, `SERVER_STARTED` /
  `END_DATA_PACK_RELOAD` / `PlayerJoin` / `ServerTick` 네 지점에서 갱신된다.
  https://git.tkrmagid.kr/tkrmagid/mc_chat_answer_mod/releases/tag/v1.3.7
- **`mc_video_player_mod` (선택)** — 정답 영상 재생용. **없어도 게임은
  정상 진행되며 영상만 표시되지 않는다.** `/start` 는 차단하지 않고 노란
  경고만 출력한다 (서버 부재 시 전체 안내, 특정 플레이어 클라 부재 시 본인
  에게만 안내). presence 는 `#server mq_video_mod` (서버 컴포넌트가 매 tick
  1 로 갱신) + `<player> mq_video_mod` (클라 join handshake 수신 시 1 로 set)
  로 나눠 표시한다. 모드 측 연동 사양(presence handshake)은
  [docs/mc_video_player_mod_integration.md](docs/mc_video_player_mod_integration.md) 참고.
  https://git.tkrmagid.kr/tkrmagid/mc_video_player_mod

> 데이터팩은 모드 명령(`videoCache`/`videoPlace`/`videoDelete`)을 mcfunction
> 안에서 직접 실행하지 않고 **NBT 문자열 큐 → 커맨드블럭** 으로만 내보낸다.
> 덕분에 영상 모드가 없어도 데이터팩 로드 시 미등록 명령 파싱 에러가 나지
> 않는다 (자세한 건 아래 "정답 영상" 절).

### 100% 바닐라 — 의존 플러그인 없음 (모드 외)

음원 재생과 정답 이미지 표시는 모두 바닐라 명령으로 처리한다. 음원과
페인팅 텍스처는 [minecraft_launcher](https://git.tkrmagid.kr/tkrmagid/minecraft_launcher)
가 만들어주는 리소스팩(`musicquiz` 네임스페이스)에서 가져온다.

- 음원: `/playsound musicquiz:track_NN <source> @s ~ ~ ~ <volume> <pitch>`
  (예: `musicquiz:track_01`). `init/config.mcfunction` 의 `audio.source` 가
  채널을 결정하며, **곡 재생은 기본 `player` 채널** (음성/플레이어 볼륨
  슬라이더로 음량 제어). `stopsound` 도 같은 채널로 묶여 있다. 카운트다운
  비프와 종료 클릭 같은 UI 사운드는 별도로 `weather` 채널을 사용한다.
- 정답 이미지: `painting_variant musicquiz:cover_NN` 을 `/summon painting` 으로
  벽에 띄우고, 다음 곡 직전 `kill @e[type=painting,tag=mq_cover]` 로 제거.
- gif 페인팅: `images/gif.mcfunction` 을 실행하면 실행한 플레이어에게
  `mq:gif` variant 페인팅 아이템을 지급한다. 벽에 설치하면 랜덤 선택 없이
  `mq:gif` 로 고정 배치되고, 리소스팩의 애니메이션 텍스처
  (`musicquiz:gif` `.png` + `.png.mcmeta`) 덕분에 gif 처럼 움직인다.
  variant 정의는 `painting_variant/gif.json` (`asset_id: musicquiz:gif`).

리소스팩 트랙 번호와 `mq:init/songs` 리스트의 순서가 1:1로 일치해야 한다.
1번째 곡 → `track_01` / `cover_01`, … (2자리 zero-pad).

### 정답 영상 (선택)

`mc_video_player_mod` 가 설치돼 있으면 정답 공개 시 곡별 영상을 벽면에
띄운다. 모드가 없어도 게임은 정상 진행되며 영상만 표시되지 않는다.

핵심은 **모드 명령을 mcfunction 안에서 직접 실행하지 않는다**는 점이다.
모드 명령(`videoCache add/remove/clear`, `videoPlace`, `videoDelete`)은
미설치 시 데이터팩 로드 단계에서 미등록 명령 파싱 에러를 일으키므로,
NBT 문자열로만 만들어 큐에 적재하고 **커맨드블럭**으로 실행한다.

- **큐 적재** — `mq:videos/macro/cmd` 가 명령을 문자열로 조립해
  `mq:main video.cmdq` 리스트(`{c:"<명령 문자열>"}`)에 push 한다.
  문자열은 mcfunction 파서를 거치지 않으므로 모드가 없어도 로드된다.
- **드레인** — `mq:videos/drain` (매 tick, `mq:tick` 에서 호출) 이 큐를
  한 tick 에 한 개씩 꺼내 `cmd_x/cmd_y/cmd_z` 좌표에 커맨드블럭을
  setblock 하고 `auto` 를 켜 1회 실행한다. 커맨드블럭은 `auto:1b` 면 매
  tick 재실행되므로, `video.armed` 플래그로 실행한 다음 tick 에
  `mq:videos/macro/drain_off` 가 `auto:0b` 로 꺼 **정확히 1회만** 실행되게
  한다 (모드의 `videoCache add` 가 중복 이름을 실패 처리해 스팸나는 것 방지).
- **캐시(preload / FIFO keep)** — 게임 시작 시 `videos/cache/preload` 가
  1..`preload` 번 영상을 미리 받아두고, 라운드마다 `videos/cache/add` 가
  N개 앞까지 캐시를 채운다. 캐시 개수가 `keep` 을 넘으면
  `videos/cache/evict` 가 가장 먼저 받은 것부터 FIFO 로 축출한다
  (`keep<=0` 이면 무제한). 데이터팩이 `mq:main video.cached`
  (`{i:N}` 리스트) 로 캐시 상태를 1:1 추적해 중복 등록을 막고 src 를 고른다.
- **동적 src** — 재생 시 해당 번호가 캐시에 있으면 등록 이름 `video_N` 으로,
  없으면 전체 URL `$(namespace)/N` 으로 `videoPlace` 한다.
  `videos/normalize` 가 `namespace` 끝의 `/` 를 떼어 경로 중복 `//` 를 막는다.

모드 측이 구현해야 하는 presence handshake(서버 tick + 클라 payload) 사양은
[docs/mc_video_player_mod_integration.md](docs/mc_video_player_mod_integration.md)
참고.

### 게임 흐름과 상태 (`init` 스코어보드)

게임 전체 상태는 `main` 스코어보드의 가상 플레이어 `init` 값으로 관리한다.

| `init` | 단계 |
|--------|------|
| `0`    | 정지/대기 (기본 상태) |
| `1`    | 게임 시작 — page1 대화창에서 `ready` 트리거 대기 |
| `2`    | 카운트다운 (3·2·1) |
| `5`    | 곡 재생 + 정답 입력 단계 |
| `6`    | 정답 공개·점수 부여 |
| `10`   | 엔딩 시퀀스 |

`main` 스코어보드의 `timer`는 활성 상태에서만 증가하는 카운터로,
`mq:repeat/timer`가 이를 보고 상태 전이를 처리한다. 매 틱 디스패치는
`init` 값에 따라 게이팅된다.

### 트리거 명령

다음 명령은 `trigger` 타입 스코어보드로 등록돼 있어 어드벤처 모드의
일반 플레이어도 사용할 수 있다.

- `trigger ready` — 시작 안내 대화창에서 시작 확정
- `trigger cancel` — 시작 취소
- `trigger stop` — 다수결 종료
- `trigger skip` — 다수결 스킵 (현재 곡 패스)
- `trigger hint` — 다수결 힌트 요청 (자음 절반 가리기 — `func:hint`)
- `trigger replay` — 다수결 다시 듣기

스킵/힌트/리플레이는 `mq:repeat/triggers/trigger` 매크로 안에서
`max_player = ceil(전체/2)` 다수결 계산을 거친 뒤 실행된다. 트리거
정의 자체는 `mq:init/triggers`에서 storage 리스트로 관리된다.

### 입력 버튼

관리자가 사용하는 6개의 물리 스톤 버튼. 좌표·표면 방향·실행 명령·라벨은
`mq:init/buttons`에서 storage 리스트(`mq:main button_defs`)로 관리되며,
`mq:repeat/buttons/handler`가 매 틱 storage 인덱스로 `btn_prep` →
`btn` 매크로 체인을 호출한다.

- `start` / `stop` / `skip` / `hint` / `replay` / `test`

버튼 본체는 보이는 `stone_button` 블록 + 클릭을 받는 `interaction` 엔티티
3 타일 (블록 면 바깥, 플레이어 쪽으로 살짝 튀어나오게) + 버튼 바로 아래
벽면에 부착되는 `text_display` 라벨 1 개로 구성된다. interaction 폭이
`width × width` 정사각형으로 강제되기 때문에 stone_button hitbox 의 가로
0.375 를 0.125 폭 × 3 타일로 덮고, 깊이는 두께(0.125) 만큼 밖으로 밀어
vanilla stone_button 클릭이 동시에 발화되지 않도록 한다. 라벨은 `bold`
적용 text component 로 직접 렌더링된다.

각 `button_defs` 항목의 필드:

- 필수: `n` (이름·태그), `x,y,z`, `f` (facing), `c` (실행 명령)
- 옵션: `label`, `label_color` (기본 `black`), `label_font` (기본
  `minecraft:default`), `label_scale` (기본 `1.0`). `btn_prep` 에서
  defaults + `merge from` 패턴으로 기본값이 자동 채워진다.

클릭 처리는 항상 `interaction` 경로로 흐르므로 `on target as @s` 로 누른
플레이어가 식별되고, 다수결(`trigger $(n)`) 투표가 성립한다.

`interaction` / `text_display` 는 데이터팩이 직접 소환·관리한다 —
`buttons` 점수가 `-1` (초기화) 일 때마다 같은 태그의 기존 entity 를
정리하고 정확한 개수만 (재)소환한다. `/reload` 가 `commands/stop` 을
호출해 `buttons` 점수를 `-1` 로 재설정하므로 리로드 시 자동 보장된다.
`/kill @e` 로 지워졌어도 다음 `/reload` 한 번으로 복구. 월드 회로
(커맨드블럭) 의존은 없다.

### 파일 구조

```
music_quiz/
├── pack.mcmeta                  # min_format/max_format [101, 1]
├── pack.png
└── data/
    ├── minecraft/tags/function/
    │   ├── load.json            # → mq:load
    │   └── tick.json            # → mq:tick
    ├── func/function/           # 공용 헬퍼 (length/half/shuffle/text_list/join…)
    │                              ─ mq:commands/hint에서 사용
    └── mq/
        ├── function/
        │   ├── load.mcfunction        # 스코어보드·storage 초기화, init/* 호출
        │   ├── tick.mcfunction        # 매 틱 서브함수 디스패치 (init 게이팅)
        │   ├── tellraw.mcfunction     # 매크로 prefix 메시지 헬퍼
        │   ├── init/                  # 사용자 설정·정적 데이터 (수정 포인트)
        │   │   ├── config.mcfunction    # 주제·스폰·오디오·페인팅 설정
        │   │   ├── songs.mcfunction     # 곡 목록 + max_index 자동계산
        │   │   ├── buttons.mcfunction   # 버튼 좌표·실행 명령·라벨
        │   │   └── triggers.mcfunction  # 다수결 트리거 정의
        │   ├── commands/               # start·stop·skip·hint·replay·test
        │   ├── quiz/                   # 게임 진행 로직
        │   │   ├── start·select·setanswer·correct·end.mcfunction
        │   │   ├── play_sound·stop_sound.mcfunction  # /playsound · /stopsound 래퍼
        │   │   └── macro/              # 매크로 진입점
        │   │     ├── setanswer.mcfunction   # songs[$(idx)] → answer + track/cover id
        │   │     ├── play_sound.mcfunction  # $playsound 매크로
        │   │     └── stop_sound.mcfunction  # $stopsound 매크로
        │   ├── images/                 # 정답 페인팅 표시·제거
        │   │   ├── show.mcfunction          # cover painting 소환
        │   │   ├── clear.mcfunction         # cover painting 일괄 제거
        │   │   ├── gif.mcfunction           # 실행 플레이어에게 mq:gif 페인팅 아이템 지급
        │   │   └── macro/show.mcfunction    # $summon painting 매크로
        │   ├── videos/                 # 정답 영상 (선택 모드, 커맨드블럭 큐 경로)
        │   │   ├── show.mcfunction          # "play" 큐 적재
        │   │   ├── clear.mcfunction         # "delete" 큐 적재
        │   │   ├── normalize.mcfunction     # namespace 끝 / 제거 + 캐시 상태 초기화
        │   │   ├── drain.mcfunction         # 매 tick 큐 1개씩 커맨드블럭 실행 (mq:tick)
        │   │   ├── cache/{fill,add,preload,evict,clear}.mcfunction  # preload/FIFO 캐시 관리
        │   │   └── macro/               # 매크로 진입점
        │   │     ├── cmd.mcfunction         # 모드 명령 문자열 조립 → cmdq push
        │   │     ├── drain.mcfunction       # $setblock command_block + auto 1b
        │   │     └── drain_off.mcfunction   # $auto 0b (다음 tick 재실행 방지)
        │   ├── repeat/                 # tick에서 호출되는 매 틱 처리
        │   │   ├── players·check_answer·timer.mcfunction
        │   │   ├── timers/{init2,init6,init10}.mcfunction  # init 단계별 timer 디스패치 분할
        │   │   ├── buttons/{handler,btn_prep,btn}.mcfunction
        │   │   └── triggers/{handler,trigger}.mcfunction
        │   ├── answer/                 # 채팅 정답 입력 정규화/판정 (chat_answer 모드 경로)
        │   └── players/{login,mod_active_notice}.mcfunction
        ├── dialog/page{1,2,3}.json
        ├── painting_variant/{cover_01..50,gif}.json
        └── advancement/player/login.json
```

### 사용 스코어보드 / 스토리지

스코어보드:

- `main` — 게임 핵심 상태 (`init`, `index`, `max_index`, `timer`, `score`, `song_idx`)
- `buttons` — 물리 버튼 상태 머신
- `answer` — 플레이어별 정답 입력값 (`1`=정답, `2`=오답)
- `func.temp` — 산술용 임시 상수 (`two=2` 등)
- `leave_game` — `custom:leave_game` 통계 (재접속 감지)
- `score` — 사이드바 표시용 점수
- `mq_chat_mod` — `mc_chat_answer_mod` presence. `#server` 점수 1 이면 설치됨
  (없으면 `/start` 차단)
- `mq_video_mod` — `mc_video_player_mod` presence. `#server` = 서버 측 모드
  존재, `<player>` = 클라 측 모드 존재 (없으면 경고만, 차단 X)
- `ready` / `cancel` / `stop` / `skip` / `hint` / `replay` — 플레이어 트리거

스토리지:

- `mq:main` — 게임 전역 데이터
  - `title`, `max_index`, `spawn` — 설정
  - `audio` = `{namespace, source, volume, pitch}` — `/playsound` 파라미터
  - `image` = `{namespace, x, y, z, facing}` — 정답 페인팅 좌표
  - `video` = `{namespace, cmd_x/y/z, x/y/z, facing, w, h, sound, preload, keep}`
    — 정답 영상 설정 + 런타임 캐시 상태. `cmd_*` 는 큐 실행용 커맨드블럭
    좌표, `x/y/z`·`facing`·`w/h` 는 영상 표시 위치/크기. 런타임에
    `cached`(`{i:N}` 리스트), `cmdq`(명령 큐), `armed`(커맨드블럭 1회 실행
    플래그) 가 이 컴파운드에 추가된다
  - `answer` = `{title, author, alias, track, cover}` — 현재 곡 정답
  - `songs` — 곡 목록 (`mq:init/songs` 가 채움)
  - `button_defs` / `trigger_defs` — 버튼·트리거 정의
- `mq:tmp` — setanswer·play_sound·페인팅·버튼 호출용 임시 페이로드 (idx, pad, num, playsound, painting, btn, btn_default)
- `mq:input` — 채팅 정답 입력 큐 (chat_answer 모드 경로)
- `func:temp` — `func:` 헬퍼 함수용 임시 NBT

> 참고: 과거 `marker` 스토리지와 `minecraft:marker` 정답 입력 엔티티는
> 폐기됨. `commands/stop` 의 `kill @e[type=marker,tag=mq]` 한 줄만 이전
> 월드에 남아 있을 수 있는 legacy entity 청소 목적으로 유지된다.

### 설정 (한 곳에서 수정)

세계마다 다른 값은 모두 `data/mq/function/init/` 폴더에서 편집한다.
`/reload` 후 반영된다.

- **`init/config.mcfunction`** — 주제, 스폰 위치, 오디오 설정(`audio`),
  정답 페인팅 좌표(`image`), 정답 영상 설정(`video`). `title` 은 `[ … ]`
  채팅 접두사로도 사용된다. `video` 의 `namespace` 는 영상 URL 베이스,
  `cmd_x/y/z` 는 모드 명령 실행용 커맨드블럭 좌표, `x/y/z`·`facing`·`w/h`
  는 영상 표시 위치/크기, `sound` 는 음량(-1 음소거), `preload` 는 미리
  받아둘 캐시 개수(0 이면 끔), `keep` 은 FIFO 유지 개수(0 이하 무제한).
- **`init/songs.mcfunction`** — 곡 목록 (한 줄에 한 곡씩 append). `alias`
  배열의 문자열은 정답 판정 시 동의어로 인정된다. **곡의 순서가 리소스팩
  트랙 번호와 1:1 매칭** 되므로 순서 변경 시 리소스팩도 함께 재생성해야
  한다. `max_index` 는 리스트 길이로 자동 계산된다.
- **`init/buttons.mcfunction`** — 6개 물리 버튼의 좌표·표면 방향·실행 명령.
- **`init/triggers.mcfunction`** — 다수결 트리거(`stop`/`skip`/`hint`/`replay`)
  표시 이름·실행 명령.

`load.mcfunction` 은 위 4개를 호출해 `mq:main` 스토리지를 적재한다.
스코어보드·보스바 같은 런타임 인프라는 `load.mcfunction` 본문에 남아 있다.

다이얼로그 페이지(`data/mq/dialog/page{1,2,3}.json`) 의 타이틀과 설명문구는
JSON 텍스트 컴포넌트가 storage 참조를 일관되게 지원하지 않으므로 직접
편집해야 한다.

### 설치

1. 서버 월드 폴더 `datapacks/`에 `music_quiz/` 디렉터리째 복사.
2. 서버 mods 폴더에 `mc_chat_answer_mod` v1.3.7+ (필수) 설치.
   `mc_video_player_mod` (선택) 는 정답 영상을 쓸 때만 서버 + 클라이언트
   양쪽에 설치한다. 없어도 게임은 정상 동작하며 영상만 표시되지 않는다.
3. minecraft_launcher 에서 생성한 `musicquiz` 리소스팩을 클라이언트에 적용
   (런처가 자동 처리).
4. 서버 `/reload` — 리로드 성공 메시지가 채팅에 표시되면 정상.
5. `mq:init/buttons` 에 정의된 좌표 부근에 6개 버튼이 자동 배치된다.
6. `start` 버튼을 눌러 게임 시작 — `mc_chat_answer_mod` (필수) 미설치 시
   사유와 함께 차단된다. `mc_video_player_mod` (선택) 미설치 시에는 노란
   경고만 출력하고 영상 없이 진행된다.

### 좌표 의존성 (주의)

다음 좌표는 데이터팩 안에 박혀 있어 다른 월드에서 쓰려면 직접 바꿔야
한다. 현재 박혀 있는 좌표는 본인 월드 기준이므로 그대로 옮겨가면 동작
안 한다.

- 정답 페인팅 / 플레이어 스폰 — `init/config.mcfunction` (`image`, `spawn`)
- 버튼 좌표·facing — `init/buttons.mcfunction` (`button_defs` 의 `x,y,z,f`)

---

## 변경 이력

### 2026-06-05 — 정답 영상 시스템 + 영상 모드 선택화 + gif 페인팅

- **정답 영상 추가** — `mc_video_player_mod` 연동으로 정답 공개 시 곡별
  영상을 벽면에 표시. `videos/` 트리 신설 (show/clear/normalize/drain +
  cache/{fill,add,preload,evict,clear} + macro/{cmd,drain,drain_off}).
- **모드 명령 커맨드블럭 큐 경로** — 모드 명령(`videoCache`/`videoPlace`/
  `videoDelete`)을 mcfunction 에서 직접 실행하지 않고 NBT 문자열로 큐
  (`mq:main video.cmdq`) 에 적재 → `videos/drain` 이 매 tick 한 개씩
  커맨드블럭으로 실행. 미설치 모드여도 데이터팩 로드 시 파싱 에러 없음.
  `video.armed` 플래그 + `drain_off` (auto:0b) 로 정확히 1회 실행 보장.
- **영상 모드 선택화** — `mc_video_player_mod` 없어도 `/start` 차단 안 함
  (노란 경고만, 영상 없이 진행). 채팅 모드(`mc_chat_answer_mod`) 만 필수.
- **캐시 (preload / FIFO keep)** — `config.video` 의 `preload`/`keep` 으로
  미리받기 개수와 FIFO 유지 개수 제어. `video.cached` 로 캐시 상태 자체
  추적, 동적 src (`video_N` vs 전체 URL), `normalize` 가 namespace 끝 `/`
  제거.
- **gif 페인팅** — `images/gif.mcfunction`: 실행 플레이어에게 `mq:gif`
  variant 페인팅 아이템 지급. 벽 설치 시 리소스팩 애니메이션 텍스처로
  움직임. `painting_variant/gif.json` (`asset_id: musicquiz:gif`) 신설.
- `init/config.mcfunction` 에 `video` 컴파운드 추가, `load.mcfunction` 에
  `mq_chat_mod`/`mq_video_mod` objective 추가.

### 2026-05-19 — v1.0.25: 버튼 hitbox/라벨 미세조정 + 곡목록·좌표 갱신

- `repeat/buttons/btn.mcfunction`: interaction hitbox 미세조정 (`width`
  0.13 가운데 타일로 micro-gap 보정, `height` 0.26, 깊이 오프셋
  0.07/0.93, text_display Y `~-0.5` 로 라벨 위치 조정).
- 셀렉터 정렬 `[type=...,tag=mq,tag=$(n)]` → `[distance=0..,tag=mq,
  tag=$(n),type=...]`.
- `init/songs.mcfunction`: 아이유 17 곡 셋으로 교체 (alias 빈 배열).
- `init/buttons.mcfunction`: 버튼 좌표 본인 월드 기준으로 갱신,
  `label` 필드 추가 ("게임시작" / "정지" / "넘기기" / "힌트" /
  "다시듣기" / "소리 테스트").
- `repeat/timer.mcfunction` 분할 → `repeat/timers/{init2,init6,init10}`.
- `commands/start.mcfunction` 에 `mq_video_mod` 게이트 추가 (서버 부재
  단일 차단 + 플레이어별 부재 안내). `load.mcfunction` 에 `mq_video_mod`
  objective + `#server` 0 materialize 추가.

### 2026-05-18 ~ 19 — v1.0.19 ~ v1.0.24: 버튼 인프라 안정화

- v1.0.19/20/21: `btn_prep` defaults+merge 패턴, `positioned $(x).0`
  로 +0.5 보정 회피, interaction 3 타일 분할, `text_display` 도입.
- v1.0.23: 채팅정답 모드 false negative 의 진짜 fix — 데이터팩 게이트는
  유지하고 모드 (`mc_chat_answer_mod` v1.3.7) 의 presence pulse 를
  4 지점으로 확장.
- v1.0.24: `text_display` Y 보정 (`~-1` → `~-0.25`) + 라벨 bold + v1.0.21
  의 interaction 깊이 부호 반전 수정.

### 2026-05-13 — 26.1.2 호환 + 1차 정리 (`b1babad`)

이전 푸시본(`6841b7a 이전퀴즈 데이터팩`)을 26.1.2 기준으로 정비.

- `pack_format` 69 → 75 (MC 26.1.2 / 1.21.11). 이후 `min_format`/
  `max_format` 가 `[101, 1]` 로 갱신됨 (현재).
- `mq:load`, `mq:players/login`, `mq:commands/start`, `mq:commands/stop`,
  `mq:quiz/start`, `mq:quiz/end`, `mq:repeat/buttons/btn` 등에 남아 있던
  `# say ...` / `# stopsound` 사문화 디버그 주석 제거

### 2026-05-13 — 무대 의존 제거 + 최적화 (`2b61af2`)

특정 맵 좌표에만 동작하던 장식 로직을 들어내고, 매 틱 부하와 정적
데이터 관리를 정비했다.

- `repeat/map/` (무대 트리/조명 애니메이션) 삭제
- `images/image_custom.mcfunction` (호출자 없는 사문화 코드) 삭제
- `tick.mcfunction` 디스패치를 `init` 상태로 게이팅 (idle 틱 함수 호출 8→4)
- 곡 데이터를 `mq:init/songs` 의 `mq:main.songs` 리스트로 한 번 적재.
  매크로 룩업 한 줄로 50× → O(1) 복사
- 버튼/트리거 정의를 `mq:init/buttons` / `mq:init/triggers` 의 storage
  리스트로 분리. handler 는 인덱스로 매크로 호출만 한다.
- 다수결 산술 dedup (트리거당 5 라인 절감 × 4 트리거)

### 2026-05-13 — 설정 통합 (`b236118`)

세계별 수정 포인트를 한 파일로 모았다.

- `init/config.mcfunction` 신설 — 주제·곡 개수·스폰·명령 블록 좌표를 한곳에
- `mq:tellraw` 가 `mq:main.title` 을 읽도록 변경 ([ 주제 ] 접두사 동기화)

### 2026-05-13 — 바닐라 마이그레이션 (이번 커밋)

YP / TS Bukkit 플러그인 의존을 제거하고, 음원과 정답 이미지를 바닐라
명령으로 재구현했다. [minecraft_launcher](https://git.tkrmagid.kr/tkrmagid/minecraft_launcher)
가 생성하는 `musicquiz` 리소스팩과 한 쌍으로 동작한다.

#### 삭제

- `mq:check/server` + `mq:repeat/check_server` — 플러그인 설치 확인 로직
- `mq:quiz/macro/command_block` — `data modify block … Command` + `auto`
  토글 패턴 (YP `playall` 호출용)
- `mq:quiz/play` — 명령 블록 강제 재발화 함수
- `mq:images/image{,_set,_delete}` — TS `placeloc` / `removeall` 호출
- `status` 스코어보드 (`yp`, `ts`, `skript`, `timer`) — 플러그인 hello 패킷
  대기에만 쓰이던 객체

#### 신설

- **음원** — `mq:quiz/play_sound` → `mq:quiz/macro/play_sound`:
  `$execute as @a at @s run playsound $(namespace):$(track) $(source) @s ~ ~ ~ $(volume) $(pitch)`
- **음원 정지** — `mq:quiz/stop_sound` → `mq:quiz/macro/stop_sound`:
  `$stopsound @a $(source)` (모든 stopsound 호출 합쳐서 매크로화)
- **정답 페인팅** — `mq:images/show` → `mq:images/macro/show`:
  `$summon minecraft:painting $(x) $(y) $(z) {variant:"$(namespace):$(cover)",facing:$(facing)b,Tags:["mq","mq_cover"]}`
- **정답 페인팅 제거** — `mq:images/clear`: `kill @e[type=painting,tag=mq_cover]`

#### 스토리지 재구성

- `command_block` 컴파운드(좌표·볼륨·이미지 영역·alias 사본을 한데 묶었던
  것) 폐기
- `audio` = `{namespace, source, volume, pitch}` 신설 — `/playsound` 인자
- `image` = `{namespace, x, y, z, facing}` 신설 — `/summon painting` 좌표
- `marker` = `{x, y, z}` 신설 — 정답 입력 marker 위치
- `answer.track` / `answer.cover` 필드 추가 — 라운드별 리소스팩 ID
  (`track_NN` / `cover_NN`)
- `max_index` 는 `mq:init/songs` 끝에서 `songs` 배열 길이로 자동 계산
  (수동 동기화 필요 없음)

#### 트랙 번호 padding

mcfunction 은 문자열 zero-pad 가 없으므로, `quiz/select` 에서
`index ∈ 1..9` 일 때만 `mq:tmp.pad="0"` 로 분기시키고, 매크로 안에서
`"track_$(pad)$(num)"` 로 조립한다.

#### 기타

- `tick.mcfunction` 에서 `mq:repeat/check_server` 제거 (매 틱 함수 호출
  4→3 으로 추가 감소)
- `commands/start` / `commands/stop` / `commands/replay` 의 하드코딩된
  `stopsound @a weather` 를 모두 `function mq:quiz/stop_sound` 로 교체
  — 채널 변경 시 `audio.source` 한 곳만 수정하면 됨
- `setanswer` 호출 경로 단축: 기존 `select → macro/command_block →
  play(auto-toggle) → setanswer → macro/setanswer + macro/summon` →
  현재 `select → setanswer → macro/setanswer → macro/summon → play_sound`

---

## 원격 저장소

- `https://git.tkrmagid.kr/tkrmagid/mc_datapack.git`