claude-bot
0629aa54aa
운영자가 곡별로 /playsound 음량을 빠르게 조정할 수 있도록 launcher 가 생성하는 모든 SNBT 항목에 volume:1.0 기본값을 항상 넣는다. 주석의 예시도 volume:1.0 으로 통일.
58 lines
2.8 KiB
TypeScript
58 lines
2.8 KiB
TypeScript
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'
|
|
}
|