release: v1.0.0 정식 배포

기능 변경 없이 버전만 1.0.0 으로 승격(config 파일 지원, fabric meta 설치,
다운로드 오류 URL 표시 등 0.4.x 누적 기능 포함).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

docs/installer.md

@@ -78,9 +78,9 @@
 2. `.minecraft` 최상위 설정 파일(`options.txt`, `optionsof.txt`, `servers.dat`, `usercache.json`, …) 을 `.mc_custom` 으로 복사. 이미 같은 이름이 있으면 보존.
 3. 플랫폼 설치:
    - `vanilla` → 건너뜀.
-   - `fabric` → Adoptium 자동 설치 → 최신 fabric-installer.jar 다운로드 → `java -jar fabric-installer.jar client -mcversion X -loader Y -dir .minecraft -noprofile` 자동 실행. (fabric 버전/라이브러리는 런처 폴더 `.minecraft` 에 바닐라와 함께 설치해야 런처가 찾을 수 있다. `.mc_custom` 에 설치하면 바닐라 버전·라이브러리가 빠져 "Unable to prepare assets for download" 로 실패한다.)
+   - `fabric` → fabric-installer(자바 필요) 를 돌리지 않고, fabric meta 에서 버전 프로필 JSON 을 직접 받아 `.minecraft\versions\fabric-loader-Y-X\fabric-loader-Y-X.json` 으로 저장한다(`https://meta.fabricmc.net/v2/versions/loader/<mc>/<loader>/profile/json`). 자바가 없어도 되므로 "spawn java ENOENT" 나 바닐라 선행 실행이 필요 없다. 라이브러리는 프로필 JSON 에 적힌 maven url 을 보고 런처가 실행 시 자동으로 받는다. (fabric 버전/라이브러리는 런처 폴더 `.minecraft` 에 있어야 런처가 찾으며, `.mc_custom` 에 두면 "Unable to prepare assets for download" 로 실패한다.)
    - `forge` / `neoforge` → `platform.downloadUrl` 의 설치 jar 다운로드(사용자가 직접 실행하거나 마인크래프트 런처가 인식).
-4. `modsFolder` 의 모든 `.jar` 와 `resourcepackPath` zip, `mapPath` zip 을 자동 다운로드.
+4. `modsFolder` 의 모든 `.jar` 와 `resourcepackPath` zip, `mapPath` zip, `configPath` zip 을 자동 다운로드. (`configPath` zip 은 `.mc_custom` 루트에 그대로 풀려 `config/` 등이 배치됨)
 5. `.minecraft\{assets,libraries,versions}` 를 `.mc_custom\{assets,libraries,versions}` 로 junction 링크. (없으면 "Unable to prepare assets for download" 오류로 마인크래프트가 실패하기 때문)
 6. `.minecraft\launcher_profiles.json` 에 해당 음악퀴즈 이름의 프로필을 추가/갱신:
    - `gameDir` = `%APPDATA%\.mc_custom`

installer/renderer.js

@@ -1167,8 +1167,14 @@ function downloadFinalResourcepack() {
     if (res && res.ok) {
       bar.style.width = '100%'
       percentEl.textContent = '100%'
+      if (res.applied === false) {
+        // 다운로드는 됐지만 자동 적용(options.txt) 실패 → 직접 켜라고 경고.
+        msg.textContent = tt('resourcepack.downloadDoneNotApplied', { message: res.applyMessage || '' })
+        msg.classList.add('error')
+      } else {
         msg.textContent = tt('resourcepack.downloadDone')
         msg.classList.add('success')
+      }
       actions.innerHTML = '<button class="primaryBtn" id="rpNext">' + tt('common.next') + '</button>'
       actions.querySelector('#rpNext').addEventListener('click', proceed)
     } else {

locales/installer/ko-kr.json

@@ -168,6 +168,7 @@
     "downloadHeading": "최종 리소스팩 다운로드",
     "downloading": "최종 리소스팩을 다운로드하는 중…",
     "downloadDone": "최종 리소스팩 다운로드 완료. 마인크래프트를 켜면 자동으로 적용됩니다.",
+    "downloadDoneNotApplied": "최종 리소스팩은 받았지만 자동 적용에 실패했습니다({{message}}). 마인크래프트 설정 → 리소스팩에서 직접 켜주세요.",
     "downloadFailed": "최종 리소스팩 다운로드 실패: {{message}}"
   },
   "step5": {
@@ -207,9 +208,11 @@
     "jdkBusy": "이미 JDK 설치가 진행 중입니다.",
     "javaExeMissing": "설치 후 java 실행 파일을 찾지 못했습니다: {{path}}",
     "javaSpawnFailed": "Java 실행 실패: {{message}}",
+    "javaNotFoundRunVanilla": "자바를 찾지 못해 설치를 진행할 수 없습니다. 먼저 마인크래프트 런처에서 [{{version}}] 바닐라를 한 번 실행해 자바 런타임을 받은 다음, 이 설치기를 다시 시도해 주세요.",
     "fabricInstallerExit": "fabric-installer 종료 코드 {{code}}{{detail}}",
     "fabricLoaderRequired": "Fabric 로더 버전이 음악퀴즈에 지정되지 않았습니다. 관리 사이트에서 platform.loaderVersion 을 설정해 주세요.",
     "fabricInstallerListEmpty": "Fabric installer 목록을 받지 못했습니다.",
+    "fabricProfileInvalid": "Fabric 버전 프로필을 읽지 못했습니다: {{message}}",
     "portAllocFail": "포트를 할당할 수 없습니다.",
     "parseResponseFailed": "응답 파싱 실패: {{snippet}}"
   },
@@ -230,8 +233,10 @@
     "labelExtract": "{{label}} 압축 해제: {{dir}}",
     "labelServerFile": "서버 파일",
     "labelMap": "맵",
+    "labelConfigFile": "config 파일",
     "skipServerZip": "서버 파일(serverPath)이 비어 있어 서버 zip 다운로드를 건너뜁니다.",
     "skipMapZip": "맵 다운로드를 건너뜁니다 (mapPath 비어 있음 또는 참가자 모드).",
+    "skipConfigZip": "config 파일(configPath)이 비어 있어 config zip 다운로드를 건너뜁니다.",
     "cleanupInstallerMap": "이전 설치에서 풀어둔 맵 {{count}}개를 정리합니다.",
     "mapInstalledAs": "맵을 saves/{{name}} 으로 설치했습니다.",
     "clearMods": "기존 mods 폴더({{dir}})를 비우고 새로 받습니다.",
@@ -278,6 +283,7 @@
     "platformSaved": "플랫폼 설치파일 저장: {{path}} (사용자가 직접 실행하거나 마인크래프트 런처에서 인식할 수 있습니다.)",
     "platformSkipped": "플랫폼 설치 건너뜀. 바닐라로 진행합니다.",
     "fabricFetchInstallerList": "Fabric installer 최신 버전 조회 중...",
+    "fabricProfileFetch": "Fabric 버전 프로필 다운로드: {{url}}",
     "fabricInstallerDownload": "Fabric installer {{version}} 다운로드: {{url}}",
     "javaUsed": "Java 사용: {{path}}",
     "fabricInstallStart": "Fabric 자동 설치 시작: {{mc}} / loader {{loader}} → {{dir}}",

locales/server/ko-kr.json

@@ -117,7 +117,7 @@
     "platformDownloadUrl": "플랫폼 설치파일 URL",
     "platformDownloadHint": "도메인 없이 입력하면 manifest.json 도메인의 <code>/file/platforms/&lt;파일명&gt;</code>으로 해석됩니다.",
     "platformLoaderVersion": "Fabric Loader 버전",
-    "platformLoaderHint": "선택한 마인크래프트 버전 기준 Fabric Loader 목록입니다. 설치기는 최신 fabric-installer 를 받아 자동으로 CLI 설치합니다.",
+    "platformLoaderHint": "선택한 마인크래프트 버전 기준 Fabric Loader 목록입니다. 설치기는 자바 없이 Fabric Meta 의 프로필 JSON 을 받아 .minecraft/versions 에 직접 저장합니다.",
     "platformLoaderEmpty": "호환 로더 없음",
     "platformLoaderPickMc": "마인크래프트 버전을 먼저 선택하세요",
     "platformLoaderLoadFailed": "로더 목록 로드 실패: {{message}}",
@@ -134,6 +134,8 @@
     "jdkLtsSuffix": " (LTS)",
     "mapPath": "맵 파일 (.zip)",
     "mapPathHint": "/file/maps/ 아래 zip 파일 이름.",
+    "configPath": "config 파일 (.zip)",
+    "configPathHint": "/file/configs/ 아래 zip 파일 이름. 게임 폴더 루트에 그대로 풀립니다(보통 zip 안에 config/ 폴더).",
     "serverPath": "서버 파일 (.zip)",
     "serverPathHint": "/file/servers/ 아래 zip 파일 이름. 멀티 모드 전용.",
     "modsFolder": "모드 폴더 이름",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-music-quiz-installer",
-  "version": "0.4.23",
+  "version": "1.0.0",
   "description": "마인크래프트 음악퀴즈 간편설치기 + 관리 사이트",
   "main": "dist/installer/main.js",
   "scripts": {

src/installer/main.ts

@@ -152,7 +152,7 @@ function fetchBuffer(url: string, redirects = 0, attempt = 0): Promise<Buffer> {
       }
       if (code >= 400) {
         response.resume()
-        reject(new Error(`HTTP ${code}`))
+        reject(new Error(`HTTP ${code}: ${url}`))
         return
       }
       const chunks: Buffer[] = []
@@ -280,7 +280,7 @@ ipcMain.handle('terms:listFinal', async (): Promise<{ ok: boolean; terms?: Array
 })
 
 // 최종 리소스팩(zip)을 /file/resourcepacks/outputs/ 에서 받아 .mc_custom/resourcepacks/ 에 저장.
-ipcMain.handle('finalResourcepack:install', async (): Promise<{ ok: boolean; path?: string; message?: string }> => {
+ipcMain.handle('finalResourcepack:install', async (): Promise<{ ok: boolean; path?: string; message?: string; applied?: boolean; applyMessage?: string }> => {
   const pack = state.selectedKey ? state.packs.get(state.selectedKey) : undefined
   if (!pack) return { ok: false, message: t('errors.packNotFound2') }
   const finalName = pack.pack.finalResourcepackPath
@@ -311,10 +311,14 @@ ipcMain.handle('finalResourcepack:install', async (): Promise<{ ok: boolean; pat
     try {
       await enableResourcePackInOptions(gameDir, cleaned)
       sendLog(t('log.finalResourcepackApplied', { name: cleaned }))
+      return { ok: true, path: dest, applied: true }
     } catch (err) {
-      sendLog(t('log.finalResourcepackApplyFail', { message: (err as Error).message }))
+      // 다운로드는 됐지만 자동 적용(options.txt)에 실패 → 성공으로 숨기지 말고 렌더러가
+      // 경고를 띄우도록 applied=false 로 알린다(사용자가 직접 켤 수 있게).
+      const msg = (err as Error).message
+      sendLog(t('log.finalResourcepackApplyFail', { message: msg }))
+      return { ok: true, path: dest, applied: false, applyMessage: msg }
     }
-    return { ok: true, path: dest }
   } catch (error) {
     // 실패 시 부분/0바이트 zip 이 마인크래프트 리소스팩 목록에 깨진 채로 남지 않도록 삭제.
     if (dest) await fsp.rm(dest, { force: true }).catch(() => {})
@@ -623,7 +627,7 @@ function downloadStream(
         res.resume()
         fileStream.close(() => {
           signal.removeEventListener('abort', onAbort)
-          if (!settled) { settled = true; reject(new Error(`HTTP ${sc}`)) }
+          if (!settled) { settled = true; reject(new Error(`HTTP ${sc}: ${url}`)) }
         })
         return
       }
@@ -761,6 +765,20 @@ async function downloadServerZip(pack: PackDefinition, targetDir: string): Promi
   await downloadAndExtractZip(url, t('log.labelServerFile'), targetDir)
 }
 
+/**
+ * config zip 을 게임 폴더(.mc_custom) 루트에 그대로 풀어 넣는다.
+ * zip 안에 `config/` 폴더가 들어 있으면 `.mc_custom/config/` 로 배치된다.
+ * configPath 가 비어 있으면 건너뛴다.
+ */
+async function downloadConfigZip(pack: PackDefinition, customRoot: string): Promise<void> {
+  if (!pack.configPath) {
+    sendLog(t('log.skipConfigZip'))
+    return
+  }
+  const url = resolveManifestRelative(pack.configPath, 'configs')
+  await downloadAndExtractZip(url, t('log.labelConfigFile'), customRoot)
+}
+
 /**
  * 설치러가 saves/ 에 풀어놓은 최상위 폴더(또는 파일) 목록을 기록하는 마커 파일.
  * 재설치 시 잔여물을 안전하게 정리하고, 싱글→참가자 전환 시에도
@@ -1397,7 +1415,7 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
     await copyMinecraftUserSettings(customRoot)
 
     if (payload.installPlatform && pack.pack.platform.type === 'fabric') {
-      await installFabricLoader(pack.pack, customRoot)
+      await installFabricLoader(pack.pack)
     } else if (payload.installPlatform && pack.pack.platform.type !== 'vanilla' && pack.pack.platform.downloadUrl) {
       const platformUrl = resolveManifestRelative(pack.pack.platform.downloadUrl, 'platforms')
       const cacheDir = path.join(customRoot, 'platform-cache')
@@ -1428,6 +1446,9 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
       await downloadMapZip(pack.pack, customRoot)
     }
 
+    // config zip 은 게임 폴더(.mc_custom) 루트에 그대로 풀어 config/ 등을 배치한다.
+    await downloadConfigZip(pack.pack, customRoot)
+
     // 런처가 .mc_custom 을 gameDir 로 잡아도 assets/libraries/versions 를
     // 찾을 수 있도록 .minecraft 의 해당 폴더로 junction 링크.
     await linkMinecraftRuntimeDirs(customRoot)
@@ -1442,163 +1463,47 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
   }
 })
 
-interface FabricInstallerMeta {
+async function installFabricLoader(pack: PackDefinition): Promise<void> {
-  url: string
-  version: string
-  stable: boolean
-}
-
-async function installFabricLoader(pack: PackDefinition, customRoot: string): Promise<void> {
   const loaderVersion = pack.platform.loaderVersion
   if (!loaderVersion) {
     throw new Error(t('errors.fabricLoaderRequired'))
   }
 
-  // 0) 이미 설치돼 있으면 건너뛴다. fabric-installer 는 매번 jar 를 지우고
+  // fabric 은 .minecraft(런처 폴더)에 설치한다. gameDir(.mc_custom)에 설치하면 바닐라 버전/
-  //    다시 쓰려고 시도해서, 마인크래프트나 다른 프로세스가 그 파일을 잡고
+  // 라이브러리가 빠져 런처가 "Unable to prepare assets for download" 로 실패한다.
-  //    있으면 FileSystemException 으로 실패한다. 결과 파일이 그대로 있으면
-  //    재실행할 필요가 없으므로 그냥 통과.
-  // fabric 은 .minecraft(런처 폴더)에 설치한다. gameDir(.mc_custom)에 설치하면 fabric 이
-  // versions/ 와 libraries/ 를 거기에 실제 폴더로 만드는데, 이 폴더에는 fabric 자체 것만
-  // 들어가고 바닐라 마인크래프트의 버전 JSON·라이브러리는 빠져 있다. 그러면 .minecraft 로의
-  // 링크가 "이미 폴더 있음" 으로 건너뛰어져, 런처가 바닐라 데이터를 찾지 못하고
-  // "Unable to prepare assets for download" 로 실패한다. 그래서 .minecraft 에 설치해
-  // 바닐라와 같은 위치에 두고, 링크는 뒤(linkMinecraftRuntimeDirs)에서 성공하게 한다.
   const mcRoot = path.join(getAppDataDir(), '.minecraft')
-  await fsp.mkdir(mcRoot, { recursive: true })
   const versionId = `fabric-loader-${loaderVersion}-${pack.mcVersion}`
   const versionDir = path.join(mcRoot, 'versions', versionId)
   const versionJson = path.join(versionDir, `${versionId}.json`)
-  // 최신 fabric 은 버전 폴더에 .json 만 만든다(.jar 없음). json 존재를 설치 완료 기준으로 본다.
   if (fs.existsSync(versionJson)) {
     sendLog(t('log.fabricAlreadyInstalled', { id: versionId, dir: versionDir }))
     return
   }
 
-  // 1) 최신 fabric-installer 메타데이터 조회.
+  // fabric-installer(자바 필요) 를 돌리는 대신, fabric meta 에서 버전 프로필 JSON 을 직접
-  sendLog(t('log.fabricFetchInstallerList'))
+  // 받아 versions/<id>/<id>.json 에 쓴다. 자바가 없어도 되므로 "spawn java ENOENT" 가
-  const installerList = await fetchJson<FabricInstallerMeta[]>('https://meta.fabricmc.net/v2/versions/installer')
+  // 사라지고, 바닐라를 미리 실행할 필요도 없다. 라이브러리는 프로필 JSON 의 각 library 에
-  if (!installerList || installerList.length === 0) {
+  // 적힌 maven url 을 보고 런처가 실행 시 자동으로 받는다.
-    throw new Error(t('errors.fabricInstallerListEmpty'))
+  const profileUrl =
+    `https://meta.fabricmc.net/v2/versions/loader/${encodeURIComponent(pack.mcVersion)}/${encodeURIComponent(loaderVersion)}/profile/json`
+  sendLog(t('log.fabricProfileFetch', { url: profileUrl }))
+  const buf = await fetchBuffer(profileUrl)
+  let profileId = ''
+  try {
+    const parsed = JSON.parse(buf.toString('utf8')) as { id?: unknown }
+    if (typeof parsed.id === 'string') profileId = parsed.id
+  } catch (err) {
+    throw new Error(t('errors.fabricProfileInvalid', { message: (err as Error).message }))
   }
-  const latest = installerList.find((item) => item.stable) || installerList[0]
+  if (!profileId) {
-  sendLog(t('log.fabricInstallerDownload', { version: latest.version, url: latest.url }))
+    throw new Error(t('errors.fabricProfileInvalid', { message: 'missing id' }))
-
+  }
-  // 2) installer jar 캐시.
+  await fsp.mkdir(versionDir, { recursive: true })
-  const cacheDir = path.join(customRoot, 'platform-cache')
+  // 받은 바이트를 그대로 저장(무손실). 프로필의 id 는 versionId 와 동일하다.
-  await fsp.mkdir(cacheDir, { recursive: true })
+  await fsp.writeFile(versionJson, buf)
-  const installerJar = path.join(cacheDir, `fabric-installer-${latest.version}.jar`)
-  await downloadFile(latest.url, installerJar)
-
-  // 3) Java 실행파일 확보.
-  const javaCmd = await findJavaExecutable()
-  sendLog(t('log.javaUsed', { path: javaCmd }))
-
-  // 4) fabric-installer CLI 자동 실행.
-  //    client 모드 + -noprofile: launcher_profiles.json 은 우리 코드가 직접 갱신하므로 fabric-installer 가 덮어쓰지 않게 한다.
-  //    JVM stdout 인코딩 강제 UTF-8:
-  //      한국 윈도우의 시스템 codepage 는 cp949(MS949) 라서 fabric-installer 가
-  //      한글을 cp949 로 stdout 에 쓰면 우리가 utf-8 로 디코드해서 깨져 보인다.
-  //      `file.encoding` 은 default Charset, `stdout/stderr.encoding` 은
-  //      System.out/err 의 PrintStream 인코딩(Java 18+). 둘 다 지정하면
-  //      구버전·신버전 JDK 모두에서 안전.
-  const args = [
-    '-Dfile.encoding=UTF-8',
-    '-Dstdout.encoding=UTF-8',
-    '-Dstderr.encoding=UTF-8',
-    '-jar', installerJar,
-    'client',
-    '-mcversion', pack.mcVersion,
-    '-loader', loaderVersion,
-    '-dir', mcRoot,
-    '-noprofile'
-  ]
-  sendLog(t('log.fabricInstallStart', { mc: pack.mcVersion, loader: loaderVersion, dir: mcRoot }))
-  await runJavaProcess(javaCmd, args)
   sendLog(t('log.fabricInstallDone'))
 }
 
-async function findJavaExecutable(): Promise<string> {
-  const javaName = process.platform === 'win32' ? 'java.exe' : 'java'
-
-  // 1) JAVA_HOME 우선.
-  const javaHome = process.env.JAVA_HOME
-  if (javaHome) {
-    const exe = path.join(javaHome, 'bin', javaName)
-    if (fs.existsSync(exe)) return exe
-  }
-
-  // 2) 마인크래프트 런처가 번들한 자바 런타임. .minecraft\runtime\<name>\<os>\<name>\bin\java.exe 구조.
-  try {
-    const runtimeBase = path.join(getAppDataDir(), '.minecraft', 'runtime')
-    if (fs.existsSync(runtimeBase)) {
-      const priority = [
-        'java-runtime-delta',
-        'java-runtime-gamma',
-        'java-runtime-beta',
-        'java-runtime-alpha',
-        'java-runtime-legacy',
-        'jre-legacy'
-      ]
-      const names = await fsp.readdir(runtimeBase)
-      const sorted = names.slice().sort((a, b) => {
-        const ia = priority.indexOf(a)
-        const ib = priority.indexOf(b)
-        if (ia === -1 && ib === -1) return 0
-        if (ia === -1) return 1
-        if (ib === -1) return -1
-        return ia - ib
-      })
-      for (const name of sorted) {
-        const dir = path.join(runtimeBase, name)
-        try {
-          const osDirs = await fsp.readdir(dir)
-          for (const osDir of osDirs) {
-            const exe = path.join(dir, osDir, name, 'bin', javaName)
-            if (fs.existsSync(exe)) return exe
-          }
-        } catch {
-          // skip
-        }
-      }
-    }
-  } catch {
-    // skip
-  }
-
-  // 3) PATH 폴백.
-  return javaName
-}
-
-function runJavaProcess(cmd: string, args: string[]): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true })
-    let stderrTail = ''
-    const emitLines = (chunk: Buffer, prefix: string) => {
-      const text = chunk.toString('utf8')
-      text.split(/\r?\n/).forEach((line) => {
-        if (line.trim().length === 0) return
-        sendLog(`  ${prefix} ${line}`)
-      })
-    }
-    child.stdout?.on('data', (chunk: Buffer) => emitLines(chunk, '[fabric]'))
-    child.stderr?.on('data', (chunk: Buffer) => {
-      stderrTail += chunk.toString('utf8')
-      if (stderrTail.length > 4000) stderrTail = stderrTail.slice(-4000)
-      emitLines(chunk, '[fabric-err]')
-    })
-    child.on('error', (err) => reject(new Error(t('errors.javaSpawnFailed', { message: err.message }))))
-    child.on('close', (code) => {
-      if (code === 0) {
-        resolve()
-      } else {
-        const detail = stderrTail.trim().split(/\r?\n/).slice(-3).join(' | ')
-        reject(new Error(t('errors.fabricInstallerExit', { code: code ?? '', detail: detail ? ' — ' + detail : '' })))
-      }
-    })
-  })
-}
-
 function deriveFileName(url: string): string {
   try {
     const parsed = new URL(url)

src/installer/preload.ts

@@ -20,8 +20,8 @@ const api = {
   // 최종 리소스팩 다운로드용 약관 목록 (showInFinalResourcepack 필터)
   getFinalTermsList: (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> =>
     ipcRenderer.invoke('terms:listFinal'),
-  // 최종 리소스팩 다운로드 실행
+  // 최종 리소스팩 다운로드 실행. applied=false 면 다운로드는 됐지만 자동 적용 실패.
-  installFinalResourcepack: (): Promise<{ ok: boolean; path?: string; message?: string }> =>
+  installFinalResourcepack: (): Promise<{ ok: boolean; path?: string; message?: string; applied?: boolean; applyMessage?: string }> =>
     ipcRenderer.invoke('finalResourcepack:install'),
 
   // 3-1

src/server/routes/op.ts

@@ -604,6 +604,7 @@ opRouter.post('/op/dashboard/:packName', requireAuth, async (req, res, next) =>
       clientRecommendedRam: Number(pickFirstValue(req.body.clientRecommendedRam)),
       recommendedJdk: Number(pickFirstValue(req.body.recommendedJdk)),
       mapPath: pickFirstValue(req.body.mapPath),
+      configPath: pickFirstValue(req.body.configPath),
       serverPath: pickFirstValue(req.body.serverPath)
     }
 

src/shared/store.ts

@@ -55,6 +55,7 @@ export function defaultPackDefinition(name: string): PackDefinition {
     clientRecommendedRam: 4096,
     recommendedJdk: DEFAULT_JDK_MAJOR,
     mapPath: '',
+    configPath: '',
     serverPath: ''
   }
 }
@@ -142,6 +143,7 @@ export function normalizePackDefinition(input: Partial<PackDefinition> & Record<
     clientRecommendedRam: clampNumber(input.clientRecommendedRam, fallback.clientRecommendedRam),
     recommendedJdk: normalizeRecommendedJdk(input.recommendedJdk),
     mapPath: sanitizeZipFileName(input.mapPath),
+    configPath: sanitizeZipFileName(input.configPath),
     serverPath: sanitizeZipFileName(input.serverPath)
   }
 }

src/shared/types.ts

@@ -41,6 +41,11 @@ export interface PackDefinition {
   recommendedJdk: number
   /** /file/maps/<mapPath> 에서 받아 .mc_custom/saves 로 풀 zip 파일 이름. */
   mapPath: string
+  /**
+   * /file/configs/<configPath> 에서 받아 게임 폴더(.mc_custom) 루트에 그대로 푸는 zip
+   * 파일 이름. 보통 zip 안에 `config/` 폴더를 담는다. 빈 문자열이면 받지 않는다.
+   */
+  configPath: string
   /** /file/servers/<serverPath> 에서 받아 서버 설치 경로로 풀 zip 파일 이름. */
   serverPath: string
 }

views/op/editor.ejs

@@ -96,6 +96,11 @@
           <input name="mapPath" value="<%= pack.mapPath %>" placeholder="my-map.zip" pattern=".+\.zip" />
           <small class="muted"><%= t('editor.mapPathHint') %></small>
         </label>
+        <label>
+          <span><%= t('editor.configPath') %></span>
+          <input name="configPath" value="<%= pack.configPath %>" placeholder="my-config.zip" pattern=".+\.zip" />
+          <small class="muted"><%= t('editor.configPathHint') %></small>
+        </label>
         <label>
           <span><%= t('editor.serverPath') %></span>
           <input name="serverPath" value="<%= pack.serverPath %>" placeholder="my-server.zip" pattern=".+\.zip" />