installer: write custom icon into Minecraft launcher profile

Minecraft launcher's "설치 설정" screen reads `profile.icon` from
launcher_profiles.json. We were leaving it unset, so the launcher fell
back to the default Furnace icon. Inline build/icon.png as a base64
data URL at build time (scripts/build-launcher-icon.cjs generates
src/installer/launcherIcon.ts) and set it on the profile we write.

The build/ directory isn't included in the electron-builder asar (it's
only used to point at the .ico for the exe), so a runtime read isn't
possible — the icon ships compiled into the bundle. To refresh after
changing icon.png, run `npm run build:launcher-icon` (it's wired into
`dist:win` so a fresh exe build always regenerates it).

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

locales/installer-rp/ko-kr.json

@@ -75,6 +75,7 @@
     "baseUrl": "  URL: {{url}}",
     "baseReceived": "베이스 리소스팩 받음 ({{kb}} KB)",
     "baseAbsent": "베이스 리소스팩 없음(resourcepackPath 빈 값) — 새 리소스팩으로 생성",
+    "baseRemoved": "베이스 리소스팩 삭제: {{path}}",
     "buildingZip": "리소스팩 zip 빌드 중… ({{name}})",
     "installComplete": "설치 완료: {{path}}",
     "cancelRequested": "취소 요청됨. 실행 중 프로세스 {{count}}개 중단…",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-music-quiz-installer",
-  "version": "0.2.2",
+  "version": "0.2.6",
   "description": "마인크래프트 음악퀴즈 간편설치기 + 관리 사이트",
   "main": "dist/installer/main.js",
   "scripts": {
@@ -10,7 +10,8 @@
     "installer": "tsc -p tsconfig.installer.json && electron .",
     "installer:rp": "tsc -p tsconfig.installer-rp.json && electron dist/installer-rp/main.js",
     "preinstall:sharp-win32": "npm install --no-save --force @img/sharp-win32-x64@0.34.5",
-    "dist:win": "npm run preinstall:sharp-win32 && tsc -p tsconfig.installer.json && electron-builder --win --config electron-builder.yml",
+    "build:launcher-icon": "node scripts/build-launcher-icon.cjs",
+    "dist:win": "npm run preinstall:sharp-win32 && npm run build:launcher-icon && tsc -p tsconfig.installer.json && electron-builder --win --config electron-builder.yml",
     "dist:win:rp": "npm run preinstall:sharp-win32 && tsc -p tsconfig.installer-rp.json && electron-builder --win --config electron-builder-rp.yml"
   },
   "dependencies": {

scripts/build-launcher-icon.cjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// build/icon.png 을 읽어 base64 data URL 로 변환해
+// src/installer/launcherIcon.ts 에 상수로 박는다.
+//
+// 마인크래프트 런처의 "설치 설정" 화면 프로필 아이콘은
+// launcher_profiles.json 의 profile.icon 필드에서 오는데,
+// `data:image/png;base64,...` 형태의 data URL 을 받는다.
+// build/ 폴더는 electron-builder 가 exe 아이콘으로만 쓰고 asar 에
+// 포함되지 않아서, 런타임에 그 파일을 읽을 수 없다. 대신 빌드(개발) 시점에
+// 이 스크립트를 돌려 PNG 를 소스 코드에 인라인한다.
+
+'use strict'
+
+const fs = require('node:fs')
+const path = require('node:path')
+
+const repoRoot = path.resolve(__dirname, '..')
+const pngPath = path.join(repoRoot, 'build', 'icon.png')
+const tsPath = path.join(repoRoot, 'src', 'installer', 'launcherIcon.ts')
+
+const buf = fs.readFileSync(pngPath)
+const b64 = buf.toString('base64')
+
+const ts = `// AUTO-GENERATED by scripts/build-launcher-icon.cjs from build/icon.png.
+// 마인크래프트 런처의 "설치 설정" 화면에서 보이는 프로필 아이콘. exe 와 같은
+// 이미지를 쓰기 위해 빌드 시점에 PNG 를 data URL 로 인라인한다. 변경하려면
+// build/icon.png 교체 후 \`node scripts/build-launcher-icon.cjs\` 재실행.
+export const LAUNCHER_PROFILE_ICON =
+  'data:image/png;base64,${b64}'
+`
+
+fs.writeFileSync(tsPath, ts, 'utf8')
+console.log(`wrote ${tsPath} (${buf.length} bytes PNG → ${b64.length} chars base64)`)

src/installer-rp/main.ts

@@ -421,6 +421,22 @@ ipcMain.handle('rp:install:start', async (): Promise<{ resourcepackPath: string
 
     // 2-6. %appdata%/.mc_custom/resourcepacks/ 에 배치 (위 빌드가 직접 outZipPath 에 저장)
     sendLog(t('log.installComplete', { path: resourcepackPath }))
+
+    // 2-7. 베이스 리소스팩은 우리가 임시폴더에 받아서 빌드에 이미 얹었으므로,
+    //   메인 설치기가 `.mc_custom/resourcepacks/<resourcepackPath>` 에 받아둔
+    //   원본 zip 은 MC 리소스팩 목록에 굳이 남길 필요 없다. 삭제하되, 사용자가
+    //   outputPackName 을 base 파일명과 똑같이 둬서 우리가 방금 쓴 최종 zip 과
+    //   같은 경로면 그대로 둔다(우리 산출물을 지우면 안 되므로).
+    if (pack.resourcepackPath) {
+      const basePackPath = path.join(resourcepackDir, pack.resourcepackPath)
+      if (path.resolve(basePackPath) !== path.resolve(resourcepackPath)) {
+        try {
+          await fsp.rm(basePackPath, { force: true })
+          sendLog(t('log.baseRemoved', { path: basePackPath }))
+        } catch { /* 없으면 무시 */ }
+      }
+    }
+
     sendProgress({ phase: 'package', message: t('progress.installComplete'), done: true })
     return { resourcepackPath }
   } finally {

src/installer/main.ts

@@ -22,6 +22,7 @@ import type { Manifest, PackDefinition } from '../shared/types.js'
 import { normalizePackDefinition } from '../shared/store.js'
 import { loadEnv, getManifestUrl } from '../shared/env.js'
 import { loadComponentI18n } from '../shared/i18n.js'
+import { LAUNCHER_PROFILE_ICON } from './launcherIcon.js'
 
 loadEnv()
 
@@ -1128,46 +1129,49 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
   await fsp.mkdir(path.join(customRoot, 'mods'), { recursive: true })
   await fsp.mkdir(path.join(customRoot, 'resourcepacks'), { recursive: true })
 
-  // 사용자가 기존 .minecraft 에 저장해둔 설정(options.txt, servers.dat 등)을
-  // .mc_custom 으로 가져온다. 이미 있는 파일은 보존.
-  await copyMinecraftUserSettings(customRoot)
+  try {
+    // 사용자가 기존 .minecraft 에 저장해둔 설정(options.txt, servers.dat 등)을
+    // .mc_custom 으로 가져온다. 이미 있는 파일은 보존.
+    await copyMinecraftUserSettings(customRoot)
 
-  if (payload.installPlatform && pack.pack.platform.type === 'fabric') {
-    await installFabricLoader(pack.pack, customRoot)
-  } 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')
-    await fsp.mkdir(cacheDir, { recursive: true })
-    const installerPath = path.join(cacheDir, deriveFileName(platformUrl) || 'platform-installer.jar')
-    sendLog(t('log.platformDownload', { type: pack.pack.platform.type, url: platformUrl }))
-    await downloadFile(platformUrl, installerPath)
-    sendLog(t('log.platformSaved', { path: installerPath }))
-  } else if (!payload.installPlatform) {
-    sendLog(t('log.platformSkipped'))
+    if (payload.installPlatform && pack.pack.platform.type === 'fabric') {
+      await installFabricLoader(pack.pack, customRoot)
+    } 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')
+      await fsp.mkdir(cacheDir, { recursive: true })
+      const installerPath = path.join(cacheDir, deriveFileName(platformUrl) || 'platform-installer.jar')
+      sendLog(t('log.platformDownload', { type: pack.pack.platform.type, url: platformUrl }))
+      await downloadFile(platformUrl, installerPath)
+      sendLog(t('log.platformSaved', { path: installerPath }))
+    } else if (!payload.installPlatform) {
+      sendLog(t('log.platformSkipped'))
+    }
+
+    await downloadModsFolder(pack.pack, customRoot)
+    await downloadResourcepackZip(pack.pack, customRoot)
+
+    if (payload.skipMap) {
+      // 참가자 모드: 이전 설치 흐름에서 설치러가 풀어둔 맵이 있다면 제거한다.
+      // 사용자가 직접 만든 월드는 마커에 포함되지 않으므로 그대로 보존된다.
+      await cleanupInstallerMap(customRoot)
+      sendLog(t('log.skipMapZip'))
+    } else {
+      await downloadMapZip(pack.pack, customRoot)
+    }
+
+    // 런처가 .mc_custom 을 gameDir 로 잡아도 assets/libraries/versions 를
+    // 찾을 수 있도록 .minecraft 의 해당 폴더로 junction 링크.
+    await linkMinecraftRuntimeDirs(customRoot)
+
+    await updateLauncherProfile(pack.pack, customRoot)
+  } finally {
+    // 설치가 끝나면(또는 실패해도) 더 이상 필요 없는 platform-cache(다운받은
+    // fabric/forge/neoforge installer jar 캐시)를 삭제한다. 다음 실행에서 다시
+    // 받으면 되고, 남겨두면 사용자 .mc_custom 폴더만 차지한다. 실패 경로에서도
+    // 정리되도록 finally 에 둔다.
+    await fsp.rm(path.join(customRoot, 'platform-cache'), { recursive: true, force: true }).catch(() => {})
   }
-
-  await downloadModsFolder(pack.pack, customRoot)
-  await downloadResourcepackZip(pack.pack, customRoot)
-
-  if (payload.skipMap) {
-    // 참가자 모드: 이전 설치 흐름에서 설치러가 풀어둔 맵이 있다면 제거한다.
-    // 사용자가 직접 만든 월드는 마커에 포함되지 않으므로 그대로 보존된다.
-    await cleanupInstallerMap(customRoot)
-    sendLog(t('log.skipMapZip'))
-  } else {
-    await downloadMapZip(pack.pack, customRoot)
-  }
-
-  // 런처가 .mc_custom 을 gameDir 로 잡아도 assets/libraries/versions 를
-  // 찾을 수 있도록 .minecraft 의 해당 폴더로 junction 링크.
-  await linkMinecraftRuntimeDirs(customRoot)
-
-  await updateLauncherProfile(pack.pack, customRoot)
-
-  // 설치가 끝나면 더 이상 필요 없는 platform-cache(다운받은 fabric/forge/neoforge
-  // installer jar 캐시)를 삭제한다. 다음 실행에서 다시 받으면 되고, 남겨두면
-  // 사용자 .mc_custom 폴더만 차지한다.
-  await fsp.rm(path.join(customRoot, 'platform-cache'), { recursive: true, force: true }).catch(() => {})
 })
 
 interface FabricInstallerMeta {
@@ -1216,7 +1220,16 @@ async function installFabricLoader(pack: PackDefinition, customRoot: string): Pr
 
   // 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,
@@ -1457,6 +1470,7 @@ async function updateLauncherProfile(pack: PackDefinition, gameDir: string): Pro
     ...existingProfile,
     name: profileKey,
     type: 'custom',
+    icon: LAUNCHER_PROFILE_ICON,
     gameDir,
     lastVersionId,
     javaArgs