fix(installer): 팩 변경 시 finalRpHandled 리셋

완료 화면에서 뒤로 가 다른 퀴즈팩을 선택하면 finalRpHandled 가 true 로 남아,
새 팩에 최종 리소스팩이 있어도 "설치하시겠습니까?" 페이지가 스킵되던 문제 수정.
팩 선택 키가 바뀌면 finalRpHandled=false 로 초기화. 0.4.16→0.4.17.

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

installer/renderer.js

@@ -136,6 +136,8 @@ function renderStep1() {
         tt('step1.subtitle', { mc: pack.pack.mcVersion, platform: pack.pack.platform.type }) + '</small>'
       if (state.selectedPackKey === pack.key) btn.classList.add('selected')
       btn.addEventListener('click', function () {
+        // 팩이 바뀌면 최종 리소스팩 처리 상태를 초기화(새 팩의 설치 여부를 다시 묻도록).
+        if (state.selectedPackKey !== pack.key) state.finalRpHandled = false
         state.selectedPackKey = pack.key
         nextBtn.disabled = false
         renderList()
@@ -235,7 +237,10 @@ function showAgreementError(message) {
 // 약관을 한 건씩 페이지로 보여준다. 각 약관마다 "해당 약관에 동의합니다" 체크가 있고,
 // 끝까지 스크롤해 읽어야 체크할 수 있으며, [다음] 을 누르면 다음 약관 페이지가 화면
 // 맨 위에서부터 나온다. 마지막 약관까지 동의하면 다음 단계(step2)로 진행한다.
-function renderAgreementWithKinds(KINDS) {
+function renderAgreementWithKinds(KINDS, opts) {
+  opts = opts || {}
+  var onComplete = opts.onComplete || renderStep2 // 마지막 약관 동의 후
+  var onBack = opts.onBack || renderStep1 // 첫 약관에서 뒤로
   var idx = 0
   var accepted = {} // kind -> true (뒤로 갔다 와도 동의 상태 유지)
   var cache = {} // kind -> 렌더된 HTML
@@ -293,11 +298,11 @@ function renderAgreementWithKinds(KINDS) {
         msg.classList.add('error')
         return
       }
-      if (isLast) renderStep2()
+      if (isLast) onComplete()
       else { idx++; renderCurrent() }
     })
     section.querySelector('#back').addEventListener('click', function () {
-      if (idx === 0) renderStep1()
+      if (idx === 0) onBack()
       else { idx--; renderCurrent() }
     })
 
@@ -1056,9 +1061,124 @@ function renderSubStep42(host, back, done) {
   })()
 }
 
+// 최종 리소스팩 설치 여부 질문 (예/아니요).
+function renderResourcepackPrompt() {
+  setActiveStep(5)
+  clearPage()
+  var section = document.createElement('section')
+  section.className = 'page'
+  section.innerHTML =
+    '<h2>' + tt('resourcepack.promptHeading') + '</h2>' +
+    '<p class="formMessage">' + escapeHtml(tt('resourcepack.promptBody')) + '</p>' +
+    '<div class="actionRow">' +
+    '  <button class="secondaryBtn" id="rpNo">' + tt('resourcepack.no') + '</button>' +
+    '  <button class="primaryBtn" id="rpYes">' + tt('resourcepack.yes') + '</button>' +
+    '</div>'
+  pageHost.appendChild(section)
+  section.querySelector('#rpNo').addEventListener('click', function () {
+    state.finalRpHandled = true
+    renderStep5()
+  })
+  section.querySelector('#rpYes').addEventListener('click', renderResourcepackTerms)
+}
+
+// "예" → 최종 리소스팩 다운로드 약관(showInFinalResourcepack) 동의 → 다운로드.
+function renderResourcepackTerms() {
+  setActiveStep(5)
+  clearPage()
+  var loading = document.createElement('section')
+  loading.className = 'page'
+  loading.innerHTML = '<h2>' + tt('agreement.heading') + '</h2><p class="formMessage">' + tt('agreement.loading') + '</p>'
+  pageHost.appendChild(loading)
+  installerApi.getFinalTermsList().then(function (res) {
+    if (!res || !res.ok) {
+      showResourcepackTermsError((res && res.message) || 'unknown')
+      return
+    }
+    var terms = (res.terms || []).map(function (t) { return { id: t.kind, tab: t.label } })
+    if (terms.length === 0) {
+      // 표시할 약관이 없으면 약관 단계를 건너뛰고 바로 다운로드.
+      downloadFinalResourcepack()
+      return
+    }
+    clearPage()
+    renderAgreementWithKinds(terms, { onComplete: downloadFinalResourcepack, onBack: renderResourcepackPrompt })
+  }).catch(function (err) {
+    showResourcepackTermsError(err && err.message ? err.message : 'unknown')
+  })
+}
+
+function showResourcepackTermsError(message) {
+  clearPage()
+  var section = document.createElement('section')
+  section.className = 'page'
+  section.innerHTML =
+    '<h2>' + tt('agreement.heading') + '</h2>' +
+    '<p class="formMessage error">' + escapeHtml(tt('agreement.listLoadFailed', { message: message })) + '</p>' +
+    '<div class="actionRow">' +
+    '  <button class="secondaryBtn" id="back">' + tt('common.back') + '</button>' +
+    '  <button class="primaryBtn" id="retry">' + tt('agreement.retry') + '</button>' +
+    '</div>'
+  pageHost.appendChild(section)
+  section.querySelector('#back').addEventListener('click', renderResourcepackPrompt)
+  section.querySelector('#retry').addEventListener('click', renderResourcepackTerms)
+}
+
+// 약관 동의 후 최종 리소스팩 실제 다운로드 → 완료되면 완료 화면으로.
+function downloadFinalResourcepack() {
+  setActiveStep(5)
+  clearPage()
+  var section = document.createElement('section')
+  section.className = 'page'
+  section.innerHTML =
+    '<h2>' + tt('resourcepack.downloadHeading') + '</h2>' +
+    '<div class="formMessage" id="rpMsg">' + tt('resourcepack.downloading') + '</div>' +
+    '<div class="actionRow" id="rpActions" hidden></div>'
+  pageHost.appendChild(section)
+  var msg = section.querySelector('#rpMsg')
+  var actions = section.querySelector('#rpActions')
+
+  function proceed() { state.finalRpHandled = true; renderStep5() }
+
+  installerApi.installFinalResourcepack().then(function (res) {
+    if (res && res.ok) {
+      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 {
+      msg.textContent = tt('resourcepack.downloadFailed', { message: (res && res.message) || 'unknown' })
+      msg.classList.add('error')
+      actions.innerHTML =
+        '<button class="secondaryBtn" id="rpRetry">' + tt('agreement.retry') + '</button>' +
+        '<button class="primaryBtn" id="rpSkip">' + tt('common.next') + '</button>'
+      actions.querySelector('#rpRetry').addEventListener('click', downloadFinalResourcepack)
+      actions.querySelector('#rpSkip').addEventListener('click', proceed)
+    }
+    actions.hidden = false
+  }).catch(function (err) {
+    msg.textContent = tt('resourcepack.downloadFailed', { message: (err && err.message) ? err.message : String(err) })
+    msg.classList.add('error')
+    actions.innerHTML =
+      '<button class="secondaryBtn" id="rpRetry">' + tt('agreement.retry') + '</button>' +
+      '<button class="primaryBtn" id="rpSkip">' + tt('common.next') + '</button>'
+    actions.querySelector('#rpRetry').addEventListener('click', downloadFinalResourcepack)
+    actions.querySelector('#rpSkip').addEventListener('click', proceed)
+    actions.hidden = false
+  })
+}
+
 function renderStep5() {
   setActiveStep(5)
   clearPage()
+  // 최종 리소스팩(finalResourcepackPath)이 "." 이 아니고 아직 처리하지 않았으면,
+  // 완료 화면 전에 "리소스팩을 설치하시겠습니까?" 를 먼저 묻는다.
+  var selPack = state.packs.find(function (p) { return p.key === state.selectedPackKey })
+  var finalRp = (selPack && selPack.pack && selPack.pack.finalResourcepackPath) ? selPack.pack.finalResourcepackPath : '.'
+  if (finalRp !== '.' && !state.finalRpHandled) {
+    renderResourcepackPrompt()
+    return
+  }
   var section = document.createElement('section')
   section.className = 'page'
   // 서버 마무리 액션 (바로가기/서버 실행) 은 step3 를 거친 호스트 만 노출한다.

locales/installer-rp/ko-kr.json

@@ -94,6 +94,7 @@
     "musicTrackDone": "{{idx}}번 노래 완료: {{name}}",
     "musicTrackSkip": "{{idx}}번 노래는 이전에 받아둠 → 건너뜀(이어받기)",
     "musicRefreshRetry": "{{count}}곡 다운로드 실패 → yt-dlp/ffmpeg 최신 버전으로 재설치 후 실패한 곡만 재시도",
+    "musicTrackRetryWait": "{{idx}}번 노래 재시도 {{attempt}}회차 — 유튜브 속도제한(403) 회피로 {{secs}}초 대기 후 다시 시도",
     "ytdlpReinstall": "yt-dlp.exe 최신 버전으로 강제 재설치 중…",
     "ffmpegReinstall": "ffmpeg.exe 최신 버전으로 강제 재설치 중…",
     "imageStart": "사진 다운로드 시작 ({{total}}장)",

locales/installer/ko-kr.json

@@ -160,6 +160,16 @@
       "failed": "설치 실패: {{message}}"
     }
   },
+  "resourcepack": {
+    "promptHeading": "리소스팩 설치",
+    "promptBody": "이 음악퀴즈의 최종 리소스팩을 설치하시겠습니까? 설치 후에는 마인크래프트 내에서 직접 리소스팩을 적용해야 합니다.",
+    "yes": "예",
+    "no": "아니요",
+    "downloadHeading": "최종 리소스팩 다운로드",
+    "downloading": "최종 리소스팩을 다운로드하는 중…",
+    "downloadDone": "최종 리소스팩 다운로드 완료. 마인크래프트 설정 → 리소스팩에서 직접 적용해 주세요.",
+    "downloadFailed": "최종 리소스팩 다운로드 실패: {{message}}"
+  },
   "step5": {
     "heading": "설치 완료",
     "summary": "",
@@ -205,6 +215,7 @@
   },
   "log": {
     "manifestDownload": "manifest 다운로드: {{url}}",
+    "downloadRetry": "다운로드 일시 오류({{reason}}) — {{attempt}}번째 재시도, {{secs}}초 후",
     "packLoadFail": "pack 로드 실패 ({{file}}): {{message}}",
     "packsLoaded": "로드된 음악퀴즈: {{count}}개",
     "selectedPack": "선택: {{key}}",
@@ -230,6 +241,8 @@
     "modDownload": "모드 다운로드: {{file}}",
     "skipResourcepack": "resourcepackPath가 비어 있어 리소스팩 다운로드를 건너뜁니다.",
     "resourcepackDownload": "리소스팩 다운로드: {{url}}",
+    "finalResourcepackDownload": "최종 리소스팩 다운로드: {{url}}",
+    "finalResourcepackSaved": "최종 리소스팩 저장: {{path}}",
     "serverInstallPath": "서버 설치 경로: {{path}}",
     "runBatJavaPatched": "run.bat 이 설치기가 준비한 자바를 쓰도록 수정했습니다: {{java}}",
     "runBatJavaSkip": "설치기가 준비한 JDK 를 찾지 못해 run.bat 의 자바 경로는 그대로 둡니다(시스템 자바 사용).",

locales/server/ko-kr.json

@@ -140,6 +140,8 @@
     "modsFolderHint": "/file/mods/<폴더이름>/ 안의 모든 .jar을 자동으로 받습니다. 비워두면 모드를 받지 않습니다.",
     "resourcepackPath": "베이스 리소스팩 (.zip)",
     "resourcepackHint": "/file/resourcepacks/ 아래 .zip 파일 이름. 리소스팩 설치기가 이 zip 위에 음악·사진을 얹어 최종 리소스팩을 만듭니다. 비워두면 처음부터 새로 만듭니다.",
+    "finalResourcepackPath": "최종 리소스팩 (.zip)",
+    "finalResourcepackHint": "/file/resourcepacks/outputs/ 아래 .zip 파일 이름. 간편설치기 마지막에 사용자가 선택 설치할 수 있습니다. 없음으로 하려면 \".\" 만 입력하세요.",
     "outputPackName": "생성되는 리소스팩 이름",
     "outputPackNamePlaceholder": "예: 음악퀴즈 테스트팩",
     "outputPackNameHint": "리소스팩 설치기가 만들어 내는 zip 파일 이름이자, 마인크래프트 리소스팩 목록의 제목이 됩니다. 비워두면 파일이름_resourcepack 형태로 자동 지정됩니다. Windows 파일명 금지 문자(\\ / : * ? \" < > |)는 자동으로 _ 로 바뀝니다.",
@@ -176,8 +178,10 @@
     "visibilityHeading": "표시 대상 (중복 선택 가능)",
     "visibilityInstaller": "설치기에 표시",
     "visibilityInstallerRp": "리소스팩 설치기에 표시",
+    "visibilityFinalResourcepack": "최종 리소스팩에 표시",
     "visibilityInstallerShort": "설치기",
     "visibilityInstallerRpShort": "리소스팩",
+    "visibilityFinalResourcepackShort": "최종팩",
     "addHeading": "약관 추가",
     "kindLabel": "식별자",
     "kindPlaceholder": "예: privacy",

package.json

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

public/termsEditor.js

@@ -17,6 +17,7 @@
   var tabBtns = document.querySelectorAll('.tabBar .tabBtn')
   var visInstaller = document.getElementById('visInstaller')
   var visInstallerRp = document.getElementById('visInstallerRp')
+  var visFinalResourcepack = document.getElementById('visFinalResourcepack')
 
   editor.value = INITIAL || ''
   var dirty = false
@@ -28,6 +29,7 @@
   // 토글이 바뀌어도 dirty 표시. 저장 시 함께 전송된다.
   if (visInstaller) visInstaller.addEventListener('change', function () { setDirty(true) })
   if (visInstallerRp) visInstallerRp.addEventListener('change', function () { setDirty(true) })
+  if (visFinalResourcepack) visFinalResourcepack.addEventListener('change', function () { setDirty(true) })
 
   // ─── markdown 미리 보기용 미니 렌더러 ────────────────────────────────
   // 정식 markdown 파서는 아니지만, 본 편집기가 만들어 내는 형태(#, ##, ###,
@@ -171,6 +173,7 @@
     var payload = { content: editor.value }
     if (visInstaller) payload.showInInstaller = !!visInstaller.checked
     if (visInstallerRp) payload.showInInstallerRp = !!visInstallerRp.checked
+    if (visFinalResourcepack) payload.showInFinalResourcepack = !!visFinalResourcepack.checked
     fetch('/op/agreement/' + encodeURIComponent(PACK_KEY) + '/' + encodeURIComponent(TERM_KIND), {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },

src/installer-rp/main.ts

@@ -77,10 +77,10 @@ function pickMusicConcurrency(): number {
  */
 const MUSIC_START_STAGGER_MS = 2000
 
-/** 사진(썸네일) 다운로드 사이 최소 간격(ms). i.ytimg.com 429(rate limit) 를 유발하지 않도록 순차 요청을 살짝 벌린다. */
-const IMAGE_REQUEST_INTERVAL_MS = 800
-/** 음악(yt-dlp) 단계 직후엔 유튜브가 IP 를 일시 throttle 할 수 있어, 사진 단계 전 잠깐 쉬어 429 를 피한다. */
-const IMAGE_PHASE_COOLDOWN_MS = 4000
+/** 사진(썸네일) 동시 다운로드 상한. 순차 대신 병렬로 받아 속도를 높인다. 429 는 images.ts 의 지수 백오프 재시도가 흡수한다. */
+const IMAGE_CONCURRENCY_CAP = 8
+/** 음악(yt-dlp) 단계 직후 유튜브 IP throttle 이 남아 있을 수 있어, 사진 단계 전 아주 잠깐만 쉰다. */
+const IMAGE_PHASE_COOLDOWN_MS = 1000
 
 const sleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms))
 
@@ -493,11 +493,25 @@ ipcMain.handle('rp:install:start', async (): Promise<{ resourcepackPath: string
       await refreshBinariesOnce()
       throwIfCancelled()
       nextMusicStartAt = Date.now()
+      // 403(Forbidden)은 대개 유튜브의 일시적 rate-limit 이라, 곡마다 점점 더 오래
+      // 쉬면서 여러 번 다시 시도한다(마지막 시도에서만 에러 진행률 표시).
+      const MAX_TRACK_RETRIES = 3
       for (const i of failed) {
         throwIfCancelled()
+        let ok = false
+        for (let attempt = 1; attempt <= MAX_TRACK_RETRIES; attempt++) {
+          throwIfCancelled()
+          if (attempt > 1) {
+            const waitMs = Math.min(20000, 3000 * attempt)
+            sendLog(t('log.musicTrackRetryWait', { idx: i + 1, attempt, secs: Math.round(waitMs / 1000) }))
+            await sleep(waitMs)
+            throwIfCancelled()
+          }
           await acquireMusicStartSlot()
           throwIfCancelled()
-        const ok = await tryDownloadTrack(i, true)
+          ok = await tryDownloadTrack(i, attempt === MAX_TRACK_RETRIES)
+          if (ok) break
+        }
         if (!ok) {
           throwIfCancelled()
           const idx = i + 1
@@ -516,21 +530,26 @@ ipcMain.handle('rp:install:start', async (): Promise<{ resourcepackPath: string
       sendLog(t('log.imageCooldown', { secs: Math.round(IMAGE_PHASE_COOLDOWN_MS / 1000) }))
       await sleep(IMAGE_PHASE_COOLDOWN_MS)
     }
-    let imageRequests = 0
-    for (let i = 0; i < imageTotal; i++) {
-      throwIfCancelled()
-      const entry = pack.list.images[i]
+    // 여러 장을 동시에 받아 속도를 높인다(순차+딜레이 대신 워커 풀). 유튜브 429 는
+    // 각 다운로드의 지수 백오프 재시도(images.ts)가 흡수하고, 첫 하드 실패를 만나면
+    // 새 작업 배정을 멈춘 뒤 워커가 모두 끝나면 그 오류를 던진다.
+    const images = pack.list.images
+    let imageNext = 0
+    let imageError: Error | null = null
+    async function imageWorker(): Promise<void> {
+      while (true) {
+        if (state.cancelRequested || imageError) return
+        const i = imageNext++
+        if (i >= imageTotal) return
         const idx = i + 1
-      // 이전 시도에서 이미 정규화해둔 사진은 건너뛴다(이어받기).
+        const entry = images[i]
         const coverPath = path.join(paintingDir, coverFileName(idx))
+        // 이전 시도에서 이미 정규화해둔 사진은 건너뛴다(이어받기).
         if (await fileExists(coverPath)) {
           sendLog(t('log.imageSkip', { idx }))
           sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 100, status: 'done' })
           continue
         }
-      // 실제 네트워크 요청을 하는 사진들 사이에만 간격을 둔다(건너뛴 것 사이엔 대기 없음).
-      if (imageRequests > 0) await sleep(IMAGE_REQUEST_INTERVAL_MS + Math.floor(Math.random() * 300))
-      imageRequests++
         sendLog(t('log.imageDownloading', { idx }))
         sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 10, status: 'running' })
         let buf: Buffer
@@ -551,22 +570,31 @@ ipcMain.handle('rp:install:start', async (): Promise<{ resourcepackPath: string
           // 이미 받은 사진은 건너뛰고 이어받는다는 안내를 덧붙인다.
           const msg = /429/.test(rawMsg) ? `${rawMsg} — ${t('errors.imageRateLimitHint')}` : rawMsg
           sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 0, status: 'error', message: msg })
-        throw new Error(t('errors.imageDownloadFailed', { idx, message: msg }))
+          if (!imageError) imageError = new Error(t('errors.imageDownloadFailed', { idx, message: msg }))
+          return
         }
-      throwIfCancelled()
+        if (state.cancelRequested || imageError) return
         sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 60, status: 'running' })
-      const outPath = coverPath
         try {
-        await normalizeToCover(buf, outPath)
+          await normalizeToCover(buf, coverPath)
         } catch (err) {
           // 변환 중 부분 생성된 PNG 제거(이어받기 시 완성본 오인 방지).
           await fsp.rm(coverPath, { force: true }).catch(() => {})
           sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 0, status: 'error', message: (err as Error).message })
-        throw new Error(t('errors.imageNormalizeFailed', { idx, message: (err as Error).message }))
+          if (!imageError) imageError = new Error(t('errors.imageNormalizeFailed', { idx, message: (err as Error).message }))
+          return
         }
-      sendLog(t('log.imageDone', { idx, name: path.basename(outPath) }))
+        sendLog(t('log.imageDone', { idx, name: path.basename(coverPath) }))
         sendProgress({ phase: 'item', kind: 'image', index: idx, total: imageTotal, percent: 100, status: 'done' })
       }
+    }
+
+    const imageWorkerCount = Math.min(IMAGE_CONCURRENCY_CAP, Math.max(1, imageTotal), Math.max(concurrency, 4))
+    const imageWorkers: Promise<void>[] = []
+    for (let w = 0; w < imageWorkerCount; w++) imageWorkers.push(imageWorker())
+    await Promise.all(imageWorkers)
+    throwIfCancelled()
+    if (imageError) throw imageError
 
     // 2-4. 베이스 리소스팩 다운로드 (있을 때만)
     throwIfCancelled()
@@ -688,8 +716,37 @@ app.whenReady().then(() => {
   })
 })
 
+// 종료 시 임시 파일(.temp) 정리. 예전엔 window-all-closed 에서 fsp.rm 을 fire-and-forget
+// 으로 호출하고 곧바로 app.quit() 해서, 삭제가 끝나기 전에 프로세스가 죽어 미리 받아둔
+// 내용이 남곤 했다. 또 '재시도 중' 이면 yt-dlp/ffmpeg 자식이 파일을 잠가 삭제가 실패한다.
+// → 자식을 먼저 죽여 잠금을 풀고, 삭제가 끝날 때까지 종료를 미룬 뒤 실제로 종료한다.
+let rpExitCleanupDone = false
+async function cleanupTempOnExit(): Promise<void> {
+  state.cancelRequested = true
+  for (const child of state.activeChildren) {
+    try { if (!child.killed) child.kill() } catch { /* noop */ }
+  }
+  const tempDir = path.join(getMcCustomDir(), '.temp')
+  // 자식 종료로 파일 잠금이 풀릴 시간을 주며 몇 번 재시도.
+  for (let attempt = 0; attempt < 3; attempt++) {
+    await new Promise((r) => setTimeout(r, attempt === 0 ? 200 : 400))
+    try {
+      await fsp.rm(tempDir, { recursive: true, force: true })
+      if (!fs.existsSync(tempDir)) return
+    } catch { /* 잠금 등 — 다음 시도 */ }
+  }
+}
+
+app.on('before-quit', (event) => {
+  if (rpExitCleanupDone) return
+  event.preventDefault()
+  void cleanupTempOnExit().finally(() => {
+    rpExitCleanupDone = true
+    app.quit()
+  })
+})
+
 app.on('window-all-closed', () => {
-  // 강제 종료 시에도 임시 파일은 정리.
-  fsp.rm(path.join(getMcCustomDir(), '.temp'), { recursive: true, force: true }).catch(() => {})
+  // app.quit() → before-quit 에서 임시 파일을 정리한 뒤 실제 종료.
   if (process.platform !== 'darwin') app.quit()
 })

src/installer-rp/music.ts

@@ -38,6 +38,17 @@ export function downloadMusicTrack(opts: DownloadMusicOptions): Promise<string>
       // 단일 파일이 아니라 HLS/DASH fragmented 스트림일 때 청크를 병렬로.
       // 일반 progressive 다운로드에는 영향 없음.
       '--concurrent-fragments', '5',
+      // 유튜브가 미디어 스트림에 간헐적으로 403(Forbidden) 을 준다(특히 두 번째 곡부터
+      // throttle/클라이언트 이슈). yt-dlp 가 스스로 재시도·재추출하도록 해서 한 번의
+      // 403 으로 곡 전체가 실패하지 않게 한다.
+      '--retries', '10',
+      '--fragment-retries', '10',
+      '--extractor-retries', '3',
+      '--retry-sleep', 'http:exp=1:30',
+      '--socket-timeout', '30',
+      // 특정 플레이어 클라이언트(예: android_vr)의 스트림 URL 이 403 되는 경우가 있어
+      // 여러 클라이언트를 함께 시도한다. 하나가 막혀도 다른 클라이언트 포맷으로 받는다.
+      '--extractor-args', 'youtube:player_client=default,web_safari,tv,ios',
       // 진행률 표시 안정화 (yt-dlp 가 \r 대신 새 줄로 출력).
       '--newline',
       '--extract-audio',

src/installer/main.ts

@@ -109,29 +109,61 @@ process.on('unhandledRejection', (reason) => {
   try { sendLog(t('log.internalError', { message: reason instanceof Error ? reason.message : String(reason) })) } catch {}
 })
 
-function fetchBuffer(url: string): Promise<Buffer> {
+// 너무 빠르게/자주 요청해 생기는 일시적 오류(429 Too Many Requests, 5xx, 네트워크
+// 끊김/타임아웃 등)는 잠깐 쉬고 몇 번 다시 시도한다. 403 도 일부 CDN 이 rate-limit 에
+// 쓰므로 포함. 그 외 4xx(404 등)나 재시도 소진 시에는 그대로 실패.
+const DOWNLOAD_TRANSIENT_CODES = new Set([403, 408, 425, 429, 500, 502, 503, 504])
+const DOWNLOAD_MAX_RETRIES = 3
+const DOWNLOAD_MAX_BACKOFF_MS = 30000
+
+/** Retry-After 헤더(초 또는 HTTP-date) → 대기 ms. 못 읽으면 null. */
+function parseRetryAfterMs(h: string | string[] | undefined): number | null {
+  if (!h) return null
+  const v = Array.isArray(h) ? h[0] : h
+  const secs = Number(v)
+  if (Number.isFinite(secs)) return Math.min(DOWNLOAD_MAX_BACKOFF_MS, Math.max(0, secs * 1000))
+  const date = Date.parse(v)
+  if (!Number.isNaN(date)) return Math.min(DOWNLOAD_MAX_BACKOFF_MS, Math.max(0, date - Date.now()))
+  return null
+}
+
+function fetchBuffer(url: string, redirects = 0, attempt = 0): Promise<Buffer> {
   return new Promise((resolve, reject) => {
     const target = new URL(url)
     const transport = target.protocol === 'https:' ? https : http
+    const retryLater = (headerDelay: number | null, reason: string): void => {
+      const backoff = Math.min(DOWNLOAD_MAX_BACKOFF_MS, 1000 * 2 ** attempt) + Math.floor(Math.random() * 500)
+      const delay = headerDelay ?? backoff
+      sendLog(t('log.downloadRetry', { reason, attempt: attempt + 1, secs: Math.ceil(delay / 1000) }))
+      sleep(delay).then(() => fetchBuffer(url, redirects, attempt + 1).then(resolve, reject))
+    }
     const request = transport.get(target, { timeout: 30000 }, (response) => {
-      if (response.statusCode === 301 || response.statusCode === 302) {
-        const redirect = response.headers.location
-        if (redirect) {
+      const code = response.statusCode ?? 0
+      if ((code === 301 || code === 302 || code === 303 || code === 307 || code === 308) && response.headers.location) {
         response.resume()
-          fetchBuffer(new URL(redirect, target).toString()).then(resolve, reject)
+        if (redirects > 8) { reject(new Error(`HTTP ${code} (too many redirects)`)); return }
+        fetchBuffer(new URL(response.headers.location, target).toString(), redirects + 1, attempt).then(resolve, reject)
         return
       }
-      }
-      if ((response.statusCode ?? 0) >= 400) {
+      if (DOWNLOAD_TRANSIENT_CODES.has(code) && attempt < DOWNLOAD_MAX_RETRIES) {
         response.resume()
-        reject(new Error(`HTTP ${response.statusCode}`))
+        retryLater(parseRetryAfterMs(response.headers['retry-after']), `HTTP ${code}`)
+        return
+      }
+      if (code >= 400) {
+        response.resume()
+        reject(new Error(`HTTP ${code}`))
         return
       }
       const chunks: Buffer[] = []
       response.on('data', (chunk: Buffer) => chunks.push(chunk))
       response.on('end', () => resolve(Buffer.concat(chunks)))
     })
-    request.on('error', reject)
+    request.on('error', (err) => {
+      // 연결 끊김/리셋 등 네트워크 오류도 몇 번은 재시도.
+      if (attempt < DOWNLOAD_MAX_RETRIES) { retryLater(null, (err as Error).message); return }
+      reject(err)
+    })
     request.on('timeout', () => request.destroy(new Error(t('errors.requestTimeout'))))
   })
 }
@@ -223,6 +255,50 @@ ipcMain.handle('terms:list', async (): Promise<{ ok: boolean; terms?: Array<{ ki
   }
 })
 
+// 최종 리소스팩 다운로드용 약관 목록. index.json 에서 showInFinalResourcepack=true 만 추린다.
+ipcMain.handle('terms:listFinal', async (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> => {
+  if (!state.selectedKey) return { ok: false, message: 'pack not selected' }
+  try {
+    const url = `${state.baseUrl}/manifest/terms/${encodeURIComponent(state.selectedKey)}/index.json`
+    const buf = await fetchBuffer(url)
+    const parsed = JSON.parse(buf.toString('utf8')) as { terms?: unknown }
+    const items = Array.isArray(parsed.terms) ? parsed.terms : []
+    const terms: Array<{ kind: string; label: string }> = []
+    for (const it of items) {
+      if (!it || typeof it !== 'object') continue
+      const entry = it as Record<string, unknown>
+      if (entry.showInFinalResourcepack !== true) continue
+      const kind = typeof entry.kind === 'string' ? entry.kind : ''
+      const label = typeof entry.label === 'string' ? entry.label : ''
+      if (!TERM_KIND_RE.test(kind) || label.length === 0) continue
+      terms.push({ kind, label })
+    }
+    return { ok: true, terms }
+  } catch (error) {
+    return { ok: false, message: (error as Error).message }
+  }
+})
+
+// 최종 리소스팩(zip)을 /file/resourcepacks/outputs/ 에서 받아 .mc_custom/resourcepacks/ 에 저장.
+ipcMain.handle('finalResourcepack:install', async (): Promise<{ ok: boolean; path?: string; message?: 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
+  if (!finalName || finalName === '.') return { ok: false, message: 'no final resourcepack' }
+  try {
+    const cleaned = path.basename(finalName.replace(/^\/+/, ''))
+    const url = `${state.baseUrl}/file/resourcepacks/outputs/${encodeURIComponent(cleaned)}`
+    const destDir = path.join(getAppDataDir(), getMcCustomDirName(), 'resourcepacks')
+    const dest = path.join(destDir, cleaned)
+    sendLog(t('log.finalResourcepackDownload', { url }))
+    await downloadFile(url, dest)
+    sendLog(t('log.finalResourcepackSaved', { path: dest }))
+    return { ok: true, path: dest }
+  } catch (error) {
+    return { ok: false, message: (error as Error).message }
+  }
+})
+
 ipcMain.handle('packs:select', async (_event, packKey: string) => {
   if (!state.packs.has(packKey)) {
     throw new Error(t('errors.packNotFound'))

src/installer/preload.ts

@@ -17,6 +17,12 @@ const api = {
   // 메인 인스톨러용 약관 목록 (사이트의 visibility 토글에 따라 필터링됨)
   getTermsList: (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> =>
     ipcRenderer.invoke('terms:list'),
+  // 최종 리소스팩 다운로드용 약관 목록 (showInFinalResourcepack 필터)
+  getFinalTermsList: (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> =>
+    ipcRenderer.invoke('terms:listFinal'),
+  // 최종 리소스팩 다운로드 실행
+  installFinalResourcepack: (): Promise<{ ok: boolean; path?: string; message?: string }> =>
+    ipcRenderer.invoke('finalResourcepack:install'),
 
   // 3-1
   pickFolder: (): Promise<string | null> => ipcRenderer.invoke('dialog:pickFolder'),

src/server/routes/op.ts

@@ -535,6 +535,7 @@ opRouter.get('/op/agreement/:packName/:kind', requireAuth, async (req, res, next
       label: entry.label,
       showInInstaller: entry.showInInstaller,
       showInInstallerRp: entry.showInInstallerRp,
+      showInFinalResourcepack: entry.showInFinalResourcepack,
       content
     })
   } catch (error) {
@@ -562,10 +563,12 @@ opRouter.post('/op/agreement/:packName/:kind', requireAuth, async (req, res, nex
     if (
       typeof req.body?.showInInstaller === 'boolean'
       || typeof req.body?.showInInstallerRp === 'boolean'
+      || typeof req.body?.showInFinalResourcepack === 'boolean'
     ) {
       await setTermVisibility(packKey, kind, {
         showInInstaller: req.body.showInInstaller === true,
-        showInInstallerRp: req.body.showInInstallerRp === true
+        showInInstallerRp: req.body.showInInstallerRp === true,
+        showInFinalResourcepack: req.body.showInFinalResourcepack === true
       })
     }
     res.json({ ok: true })
@@ -593,6 +596,7 @@ opRouter.post('/op/dashboard/:packName', requireAuth, async (req, res, next) =>
       } as PackDefinition['platform'] & { loaderVersion?: string },
       modsFolder: pickFirstValue(req.body.modsFolder),
       resourcepackPath: pickFirstValue(req.body.resourcepackPath),
+      finalResourcepackPath: pickFirstValue(req.body.finalResourcepackPath),
       outputPackName: pickFirstValue(req.body.outputPackName),
       serverMinRam: Number(pickFirstValue(req.body.serverMinRam)),
       serverMaxRam: Number(pickFirstValue(req.body.serverMaxRam)),

src/shared/store.ts

@@ -47,6 +47,7 @@ export function defaultPackDefinition(name: string): PackDefinition {
     platform: { type: 'vanilla' },
     modsFolder: '',
     resourcepackPath: '',
+    finalResourcepackPath: '.',
     outputPackName: '',
     serverMinRam: 2048,
     serverMaxRam: 4096,
@@ -97,6 +98,13 @@ export function normalizeRecommendedJdk(input: unknown): number {
   return Number.isFinite(n) && n >= 8 && n <= 99 ? n : DEFAULT_JDK_MAJOR
 }
 
+/** "최종 리소스팩" 값 보정. 빈 값/`.` 은 "없음"을 뜻하는 `.` 으로, 그 외는 zip 파일명으로. */
+export function normalizeFinalResourcepack(input: unknown): string {
+  const raw = typeof input === 'string' ? input.trim() : ''
+  if (raw === '' || raw === '.') return '.'
+  return sanitizeZipFileName(raw)
+}
+
 export function normalizePackDefinition(input: Partial<PackDefinition> & Record<string, unknown>): PackDefinition {
   const fallback = defaultPackDefinition(typeof input.name === 'string' ? input.name : 'new')
   const platform = (input.platform ?? {}) as Partial<PackDefinition['platform']>
@@ -125,6 +133,7 @@ export function normalizePackDefinition(input: Partial<PackDefinition> & Record<
     },
     modsFolder: sanitizeFolderName(input.modsFolder),
     resourcepackPath: sanitizeZipFileName(input.resourcepackPath),
+    finalResourcepackPath: normalizeFinalResourcepack(input.finalResourcepackPath),
     // 표시명은 사용자 입력을 보존(공백/마침표 trim 만). 파일명 안전 처리는 설치기 측에서.
     outputPackName: typeof input.outputPackName === 'string' ? input.outputPackName.trim() : '',
     serverMinRam: clampNumber(input.serverMinRam, fallback.serverMinRam),
@@ -393,12 +402,13 @@ const DEFAULT_TERM_SEEDS: Array<{
   label: string
   showInInstaller: boolean
   showInInstallerRp: boolean
+  showInFinalResourcepack: boolean
 }> = [
-  { kind: 'map',          label: '맵 약관',           showInInstaller: true,  showInInstallerRp: false },
-  { kind: 'mod',          label: '모드 약관',         showInInstaller: true,  showInInstallerRp: false },
-  { kind: 'installer',    label: '설치기 약관',       showInInstaller: true,  showInInstallerRp: false },
-  { kind: 'resourcepack', label: '리소스팩 약관',     showInInstaller: false, showInInstallerRp: true  },
-  { kind: 'installer-rp', label: '리소스팩 설치기 약관', showInInstaller: false, showInInstallerRp: true  }
+  { kind: 'map',          label: '맵 약관',           showInInstaller: true,  showInInstallerRp: false, showInFinalResourcepack: false },
+  { kind: 'mod',          label: '모드 약관',         showInInstaller: true,  showInInstallerRp: false, showInFinalResourcepack: false },
+  { kind: 'installer',    label: '설치기 약관',       showInInstaller: true,  showInInstallerRp: false, showInFinalResourcepack: false },
+  { kind: 'resourcepack', label: '리소스팩 약관',     showInInstaller: false, showInInstallerRp: true,  showInFinalResourcepack: true  },
+  { kind: 'installer-rp', label: '리소스팩 설치기 약관', showInInstaller: false, showInInstallerRp: true,  showInFinalResourcepack: false }
 ]
 
 const TERM_KIND_RE = /^[a-z0-9][a-z0-9-]{0,31}$/
@@ -411,6 +421,7 @@ export interface TermEntry {
   label: string
   showInInstaller: boolean
   showInInstallerRp: boolean
+  showInFinalResourcepack: boolean
 }
 
 interface TermsMeta {
@@ -502,7 +513,8 @@ async function ensureMetaInitialized(dir: string, dirWasJustCreated: boolean): P
       meta.terms[seed.kind] = {
         label: seed.label,
         showInInstaller: seed.showInInstaller,
-        showInInstallerRp: seed.showInInstallerRp
+        showInInstallerRp: seed.showInInstallerRp,
+        showInFinalResourcepack: seed.showInFinalResourcepack
       }
       changed = true
     }
@@ -543,10 +555,11 @@ async function ensureMetaInitialized(dir: string, dirWasJustCreated: boolean): P
     terms[seed.kind] = {
       label: seed.label,
       showInInstaller: seed.showInInstaller,
-      showInInstallerRp: seed.showInInstallerRp
+      showInInstallerRp: seed.showInInstallerRp,
+      showInFinalResourcepack: seed.showInFinalResourcepack
     }
   }
-  // 구 스키마의 사용자 정의 약관은 양쪽 인스톨러에 보이도록 기본값으로.
+  // 구 스키마의 사용자 정의 약관은 양쪽 인스톨러에 보이도록 기본값으로(최종 리소스팩은 기본 off).
   for (const [k, label] of Object.entries(oldCustomLabels)) {
     if (terms[k]) continue
     try {
@@ -554,7 +567,7 @@ async function ensureMetaInitialized(dir: string, dirWasJustCreated: boolean): P
     } catch {
       continue
     }
-    terms[k] = { label, showInInstaller: true, showInInstallerRp: true }
+    terms[k] = { label, showInInstaller: true, showInInstallerRp: true, showInFinalResourcepack: false }
   }
   await fsp.writeFile(metaPath, `${JSON.stringify({ terms }, null, 2)}\n`, 'utf8')
 }
@@ -575,7 +588,8 @@ async function loadTermsMeta(packKey: string): Promise<TermsMeta> {
         result.terms[k] = {
           label,
           showInInstaller: entry.showInInstaller === true,
-          showInInstallerRp: entry.showInInstallerRp === true
+          showInInstallerRp: entry.showInInstallerRp === true,
+          showInFinalResourcepack: entry.showInFinalResourcepack === true
         }
       }
     }
@@ -600,6 +614,7 @@ export interface TermItem {
   label: string
   showInInstaller: boolean
   showInInstallerRp: boolean
+  showInFinalResourcepack: boolean
 }
 
 /**
@@ -633,7 +648,8 @@ export async function listTermsWithLabels(packKey: string): Promise<TermItem[]>
       kind: seed.kind,
       label: entry.label,
       showInInstaller: entry.showInInstaller,
-      showInInstallerRp: entry.showInInstallerRp
+      showInInstallerRp: entry.showInInstallerRp,
+      showInFinalResourcepack: entry.showInFinalResourcepack
     })
     seen.add(seed.kind)
   }
@@ -647,7 +663,8 @@ export async function listTermsWithLabels(packKey: string): Promise<TermItem[]>
       kind,
       label: entry.label,
       showInInstaller: entry.showInInstaller,
-      showInInstallerRp: entry.showInInstallerRp
+      showInInstallerRp: entry.showInInstallerRp,
+      showInFinalResourcepack: entry.showInFinalResourcepack
     })
   }
   return items
@@ -666,7 +683,7 @@ export async function getTermEntry(packKey: string, kind: string): Promise<TermE
 export async function setTermVisibility(
   packKey: string,
   kind: string,
-  visibility: { showInInstaller: boolean; showInInstallerRp: boolean }
+  visibility: { showInInstaller: boolean; showInInstallerRp: boolean; showInFinalResourcepack: boolean }
 ): Promise<void> {
   if (!isTermKind(kind)) throw new Error('invalid term kind')
   const meta = await loadTermsMeta(packKey)
@@ -674,6 +691,7 @@ export async function setTermVisibility(
   if (!entry) throw new Error('term not found')
   entry.showInInstaller = !!visibility.showInInstaller
   entry.showInInstallerRp = !!visibility.showInInstallerRp
+  entry.showInFinalResourcepack = !!visibility.showInFinalResourcepack
   await saveTermsMeta(packKey, meta)
 }
 
@@ -723,7 +741,8 @@ export async function createTerm(packKey: string, kind: string, label: string):
   meta.terms[kind] = {
     label: cleanLabel,
     showInInstaller: seed ? seed.showInInstaller : true,
-    showInInstallerRp: seed ? seed.showInInstallerRp : true
+    showInInstallerRp: seed ? seed.showInInstallerRp : true,
+    showInFinalResourcepack: seed ? seed.showInFinalResourcepack : false
   }
   await saveTermsMeta(packKey, meta)
 }

src/shared/types.ts

@@ -14,8 +14,14 @@ export interface PackDefinition {
   platform: PackPlatform
   /** /file/mods/<modsFolder>/ 폴더 안의 모든 .jar을 자동 다운로드. */
   modsFolder: string
-  /** /file/resourcepacks/<resourcepackPath> 의 단일 .zip을 그대로 다운로드. */
+  /** /file/resourcepacks/<resourcepackPath> 의 단일 .zip을 그대로 다운로드(리소스팩 설치기의 베이스). */
   resourcepackPath: string
+  /**
+   * 간편설치기 마지막에 선택 설치하는 "최종 리소스팩" zip 파일 이름.
+   * /file/resourcepacks/outputs/<finalResourcepackPath> 에서 받는다.
+   * `"."` 이면 없음(설치 여부 질문 자체를 건너뜀). 기본값은 `"."`.
+   */
+  finalResourcepackPath: string
   /**
    * 리소스팩 설치기가 만들어 내는 최종 zip 파일의 이름(확장자 제외).
    * 빈 문자열이면 설치기가 `<packKey>_resourcepack` 형식으로 기본 이름을 만든다.

views/op/editor.ejs

@@ -119,6 +119,11 @@
           <input name="outputPackName" value="<%= pack.outputPackName %>" placeholder="<%= t('editor.outputPackNamePlaceholder') %>" />
           <small class="muted"><%= t('editor.outputPackNameHint') %></small>
         </label>
+        <label class="fullSpan">
+          <span><%= t('editor.finalResourcepackPath') %></span>
+          <input name="finalResourcepackPath" value="<%= pack.finalResourcepackPath %>" placeholder="my-pack.zip  ( . = 없음 )" />
+          <small class="muted"><%= t('editor.finalResourcepackHint') %></small>
+        </label>
       </div>
 
       <button class="primaryButton" type="submit"><%= t('common.save') %></button>

views/op/terms-pack.ejs

@@ -87,6 +87,7 @@
               <span class="visibilityBadges">
                 <span class="visibilityBadge <%= item.showInInstaller ? '' : 'off' %>"><%= t('terms.visibilityInstallerShort') %></span>
                 <span class="visibilityBadge <%= item.showInInstallerRp ? '' : 'off' %>"><%= t('terms.visibilityInstallerRpShort') %></span>
+                <span class="visibilityBadge <%= item.showInFinalResourcepack ? '' : 'off' %>"><%= t('terms.visibilityFinalResourcepackShort') %></span>
               </span>
             </div>
             <div class="termsRowSub"><%= item.kind %>.md</div>

views/op/termsEditor.ejs

@@ -36,10 +36,14 @@
         <input type="checkbox" id="visInstaller" <%= showInInstaller ? 'checked' : '' %> />
         <span><%= t('terms.visibilityInstaller') %></span>
       </label>
-      <label style="display:inline-flex; align-items:center; gap:6px;">
+      <label style="display:inline-flex; align-items:center; gap:6px; margin-right:18px;">
         <input type="checkbox" id="visInstallerRp" <%= showInInstallerRp ? 'checked' : '' %> />
         <span><%= t('terms.visibilityInstallerRp') %></span>
       </label>
+      <label style="display:inline-flex; align-items:center; gap:6px;">
+        <input type="checkbox" id="visFinalResourcepack" <%= showInFinalResourcepack ? 'checked' : '' %> />
+        <span><%= t('terms.visibilityFinalResourcepack') %></span>
+      </label>
     </fieldset>
 
     <p class="muted" style="font-size:12px;"><%= t('terms.slashHint') %></p>