import type { MusicListEntry, PackList } from '../shared/types.js' /** * SNBT 문자열 리터럴 안에 들어갈 문자열을 escape. * 백슬래시·따옴표 외에도 줄바꿈·탭을 이스케이프해서 `data modify` 한 줄 명령이 * description 같은 멀티라인 입력 때문에 깨지지 않게 한다. */ function escapeSnbtString(input: string): string { return input .replace(/\\/g, '\\\\') .replace(/"/g, '\\"') .replace(/\r/g, '\\r') .replace(/\n/g, '\\n') .replace(/\t/g, '\\t') } /** alias 배열을 SNBT 리스트 리터럴로 변환. 빈 배열도 `[]` 로 출력. */ function aliasListSnbt(aliases: string[]): string { if (!Array.isArray(aliases) || aliases.length === 0) return '[]' const parts = aliases.map((a) => `"${escapeSnbtString(a)}"`) return `[${parts.join(',')}]` } /** 한 곡(MusicListEntry) → `{title:"...", author:"...", alias:[...], description:"...", volume:1.0}` SNBT. */ function entrySnbt(entry: MusicListEntry): string { const title = escapeSnbtString(entry.title ?? '') // launcher 의 artist → 데이터팩 SNBT 의 author. 빈 값은 빈 문자열로 그대로 둔다. const author = escapeSnbtString(entry.artist ?? '') const alias = aliasListSnbt(entry.aliases ?? []) const description = escapeSnbtString(entry.description ?? '') // launcher 가 생성하는 항목에는 volume 기본값 1.0 을 항상 넣는다. // 운영자는 생성된 mcfunction 에서 곡별로 직접 값을 바꿔 사용한다. return `{title:"${title}", author:"${author}", alias:${alias}, description:"${description}", volume:1.0}` } /** * list.music 으로부터 `data/mq/function/init/songs.mcfunction` 본문을 생성. * 운영자는 mc_datapack 의 music_quiz 데이터팩에서 이 파일만 이 내용으로 * 덮어쓰면 된다 — 나머지 파일은 launcher 가 관여하지 않는다. */ export function buildSongsMcfunction(list: PackList): string { const lines: string[] = [] lines.push('# 곡 한 개 = 한 줄.') lines.push('# 필수 — title, author, alias, description') lines.push('# 선택 — volume (이 곡만의 /playsound 음량. 미지정시 init/config.mcfunction') lines.push('# 의 audio.volume 사용)') lines.push('# 곡 순서가 리소스팩의 track_NN / cover_NN 인덱스와 1:1 매칭된다.') lines.push('# 예) {title:"Quiet Song", author:"...", alias:[...], description:"...", volume:1.0}') lines.push('data modify storage mq:main songs set value []') for (const entry of list.music) { lines.push(`data modify storage mq:main songs append value ${entrySnbt(entry)}`) } lines.push('') lines.push('# 곡 개수는 songs 배열 길이에서 자동 계산됨') lines.push('execute store result storage mq:main max_index int 1 run data get storage mq:main songs') return lines.join('\n') + '\n' }