Compare commits

...

9 Commits

Author SHA1 Message Date
d4e4378602 revert(installer): config zip 경로를 /file/configs (복수)로 되돌림 (v0.4.30)
사용자가 서버 폴더를 configs(복수)로 정리하기로 해, 단수 config 로 바꿨던
것을 원복. resolveManifestRelative subDir 'configs', 타입 주석/로케일 힌트/
리포지토리 폴더(file/configs)/버전(0.4.30) 모두 복수로 통일.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-11 17:47:43 +09:00
9e9eae0920 fix(installer): config zip 경로 단수화 소스 반영 (v0.4.29)
이전 커밋(082dae5)은 file/configs→config 폴더 rename 만 담기고 실제 소스
변경이 누락됐다. resolveManifestRelative subDir 를 'config' 로, 관련
타입 주석/로케일 힌트/버전(0.4.29)까지 반영.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-11 00:23:48 +09:00
082dae5a90 fix(installer): config zip 다운로드 경로를 /file/config (단수)로 정정 (v0.4.29)
설치기가 /file/configs (복수)에서 받으려 해 서버의 file/config (단수)에
올린 zip 을 못 찾아 HTTP 404 로 실패했다. 마인크래프트 config 폴더 및
운영 서버 디렉터리 규칙에 맞춰 단수 config 로 통일.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-11 00:23:18 +09:00
7508f3b11b fix(installer): 다운로드 HTTP 오류에 실패한 URL 표시 (v0.4.28)
fetchBuffer/downloadStream 이 4xx/5xx 에 "HTTP 404" 처럼 상태코드만 던져,
어떤 파일(mods/resourcepack/map/config/server)이 없는지 알 수 없었다.
에러 메시지에 실패 URL 을 붙여 config 미업로드 등 원인을 바로 식별 가능하게 함.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-11 00:08:59 +09:00
bed47e88a0 docs: Fabric 로더 힌트를 meta 프로필 JSON 방식으로 정정
관리자 편집기 platformLoaderHint 가 아직 "fabric-installer CLI 설치"라고
설명하고 있었으나, 실제 설치기는 자바 없이 Fabric Meta profile JSON 을 받아
.minecraft/versions 에 직접 저장한다. UI 설명을 실제 동작에 맞춤.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-10 23:47:48 +09:00
ab928b13e0 feat: config 파일(.zip) 입력/다운로드 지원 (v0.4.27)
관리자 편집기에서 맵 파일과 서버 파일 사이에 "config 파일 (.zip)" 필드를
추가하고, 간편설치기가 /file/configs/<name> zip 을 받아 게임 폴더(.mc_custom)
루트에 그대로 풀도록 했다(zip 안의 config/ 가 .mc_custom/config/ 로 배치).

- PackDefinition.configPath 추가 + store 정규화/기본값
- 설치기 downloadConfigZip 헬퍼 + client:install 흐름 반영
- 편집기 필드, op 저장 파싱, 로케일 키(server/installer)
- docs/installer.md 다운로드 단계 갱신, file/configs/ 폴더 생성

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-10 23:43:54 +09:00
57e85e0352 fix(installer): fabric 설치를 자바 없이 meta 프로필 JSON 직접 저장으로
근본 해결: fabric-installer(jar) 를 java 로 실행하던 것을 없애고, fabric meta
(/v2/versions/loader/<mc>/<loader>/profile/json)에서 버전 프로필 JSON 을 그대로
받아 .minecraft/versions/<id>/<id>.json 에 저장한다. 라이브러리는 프로필의 maven url
로 런처가 실행 시 자동 다운로드. 자바가 없어도 되어 "spawn java.exe ENOENT" 가
원천 제거되고, 바닐라 선행 실행/자바 설치 없이도 fabric 설치가 된다.
findJavaExecutable/runJavaProcess/FabricInstallerMeta(자바 실행 경로) 제거. 0.4.25→0.4.26.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-10 23:25:17 +09:00
a8698ef394 fix(installer): 자바 못 찾을 때(ENOENT) "바닐라 먼저 실행" 안내 + JDK 추가 탐색
원인: findJavaExecutable 이 JAVA_HOME → .minecraft/runtime(런처 번들 JRE, 바닐라를
한 번 실행해야 생김) → 폴백 "java.exe" 순이라, 바닐라 미실행 + 시스템 java 없음이면
fabric-installer 실행에서 spawn java.exe ENOENT 로 실패.

- findJavaExecutable 에 설치기 자동설치 JDK(.mc_custom/jdk) 와 C:\Program Files\Java
  탐색을 추가해 불필요한 실패를 줄인다(fabric 실행엔 아무 자바나 됨).
- 그래도 자바가 전혀 없어 ENOENT 면, "먼저 [버전] 바닐라를 한 번 실행해 자바 런타임을
  받은 뒤 다시 시도" 안내 메시지로 바꿔 던진다. 0.4.24→0.4.25.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-10 23:08:13 +09:00
80059d6696 fix(installer): 최종 리소스팩 자동 적용 실패를 UI 에 경고
options.txt 자동 적용이 실패하면(권한/잠금/손상 등) 예전엔 성공처럼 "자동 적용됩니다"
로 보였다. 이제 finalResourcepack:install 이 applied=false 를 반환하고, 렌더러가
"받았지만 자동 적용 실패 — 직접 켜주세요" 경고를 표시한다(다운로드 자체는 성공). 0.4.23→0.4.24.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-07-28 22:36:57 +09:00
12 changed files with 85 additions and 153 deletions

View File

@@ -78,9 +78,9 @@
2. `.minecraft` 최상위 설정 파일(`options.txt`, `optionsof.txt`, `servers.dat`, `usercache.json`, …) 을 `.mc_custom` 으로 복사. 이미 같은 이름이 있으면 보존. 2. `.minecraft` 최상위 설정 파일(`options.txt`, `optionsof.txt`, `servers.dat`, `usercache.json`, …) 을 `.mc_custom` 으로 복사. 이미 같은 이름이 있으면 보존.
3. 플랫폼 설치: 3. 플랫폼 설치:
- `vanilla` → 건너뜀. - `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 다운로드(사용자가 직접 실행하거나 마인크래프트 런처가 인식). - `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" 오류로 마인크래프트가 실패하기 때문) 5. `.minecraft\{assets,libraries,versions}``.mc_custom\{assets,libraries,versions}` 로 junction 링크. (없으면 "Unable to prepare assets for download" 오류로 마인크래프트가 실패하기 때문)
6. `.minecraft\launcher_profiles.json` 에 해당 음악퀴즈 이름의 프로필을 추가/갱신: 6. `.minecraft\launcher_profiles.json` 에 해당 음악퀴즈 이름의 프로필을 추가/갱신:
- `gameDir` = `%APPDATA%\.mc_custom` - `gameDir` = `%APPDATA%\.mc_custom`

0
file/configs/.gitkeep Normal file
View File

View File

@@ -1167,8 +1167,14 @@ function downloadFinalResourcepack() {
if (res && res.ok) { if (res && res.ok) {
bar.style.width = '100%' bar.style.width = '100%'
percentEl.textContent = '100%' percentEl.textContent = '100%'
msg.textContent = tt('resourcepack.downloadDone') if (res.applied === false) {
msg.classList.add('success') // 다운로드는 됐지만 자동 적용(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.innerHTML = '<button class="primaryBtn" id="rpNext">' + tt('common.next') + '</button>'
actions.querySelector('#rpNext').addEventListener('click', proceed) actions.querySelector('#rpNext').addEventListener('click', proceed)
} else { } else {

View File

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

View File

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

View File

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

View File

@@ -152,7 +152,7 @@ function fetchBuffer(url: string, redirects = 0, attempt = 0): Promise<Buffer> {
} }
if (code >= 400) { if (code >= 400) {
response.resume() response.resume()
reject(new Error(`HTTP ${code}`)) reject(new Error(`HTTP ${code}: ${url}`))
return return
} }
const chunks: Buffer[] = [] const chunks: Buffer[] = []
@@ -280,7 +280,7 @@ ipcMain.handle('terms:listFinal', async (): Promise<{ ok: boolean; terms?: Array
}) })
// 최종 리소스팩(zip)을 /file/resourcepacks/outputs/ 에서 받아 .mc_custom/resourcepacks/ 에 저장. // 최종 리소스팩(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 const pack = state.selectedKey ? state.packs.get(state.selectedKey) : undefined
if (!pack) return { ok: false, message: t('errors.packNotFound2') } if (!pack) return { ok: false, message: t('errors.packNotFound2') }
const finalName = pack.pack.finalResourcepackPath const finalName = pack.pack.finalResourcepackPath
@@ -311,10 +311,14 @@ ipcMain.handle('finalResourcepack:install', async (): Promise<{ ok: boolean; pat
try { try {
await enableResourcePackInOptions(gameDir, cleaned) await enableResourcePackInOptions(gameDir, cleaned)
sendLog(t('log.finalResourcepackApplied', { name: cleaned })) sendLog(t('log.finalResourcepackApplied', { name: cleaned }))
return { ok: true, path: dest, applied: true }
} catch (err) { } 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) { } catch (error) {
// 실패 시 부분/0바이트 zip 이 마인크래프트 리소스팩 목록에 깨진 채로 남지 않도록 삭제. // 실패 시 부분/0바이트 zip 이 마인크래프트 리소스팩 목록에 깨진 채로 남지 않도록 삭제.
if (dest) await fsp.rm(dest, { force: true }).catch(() => {}) if (dest) await fsp.rm(dest, { force: true }).catch(() => {})
@@ -623,7 +627,7 @@ function downloadStream(
res.resume() res.resume()
fileStream.close(() => { fileStream.close(() => {
signal.removeEventListener('abort', onAbort) signal.removeEventListener('abort', onAbort)
if (!settled) { settled = true; reject(new Error(`HTTP ${sc}`)) } if (!settled) { settled = true; reject(new Error(`HTTP ${sc}: ${url}`)) }
}) })
return return
} }
@@ -761,6 +765,20 @@ async function downloadServerZip(pack: PackDefinition, targetDir: string): Promi
await downloadAndExtractZip(url, t('log.labelServerFile'), targetDir) 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/ 에 풀어놓은 최상위 폴더(또는 파일) 목록을 기록하는 마커 파일. * 설치러가 saves/ 에 풀어놓은 최상위 폴더(또는 파일) 목록을 기록하는 마커 파일.
* 재설치 시 잔여물을 안전하게 정리하고, 싱글→참가자 전환 시에도 * 재설치 시 잔여물을 안전하게 정리하고, 싱글→참가자 전환 시에도
@@ -1397,7 +1415,7 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
await copyMinecraftUserSettings(customRoot) await copyMinecraftUserSettings(customRoot)
if (payload.installPlatform && pack.pack.platform.type === 'fabric') { 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) { } else if (payload.installPlatform && pack.pack.platform.type !== 'vanilla' && pack.pack.platform.downloadUrl) {
const platformUrl = resolveManifestRelative(pack.pack.platform.downloadUrl, 'platforms') const platformUrl = resolveManifestRelative(pack.pack.platform.downloadUrl, 'platforms')
const cacheDir = path.join(customRoot, 'platform-cache') const cacheDir = path.join(customRoot, 'platform-cache')
@@ -1428,6 +1446,9 @@ ipcMain.handle('client:install', async (_event, payload: ClientInstallPayload) =
await downloadMapZip(pack.pack, customRoot) await downloadMapZip(pack.pack, customRoot)
} }
// config zip 은 게임 폴더(.mc_custom) 루트에 그대로 풀어 config/ 등을 배치한다.
await downloadConfigZip(pack.pack, customRoot)
// 런처가 .mc_custom 을 gameDir 로 잡아도 assets/libraries/versions 를 // 런처가 .mc_custom 을 gameDir 로 잡아도 assets/libraries/versions 를
// 찾을 수 있도록 .minecraft 의 해당 폴더로 junction 링크. // 찾을 수 있도록 .minecraft 의 해당 폴더로 junction 링크.
await linkMinecraftRuntimeDirs(customRoot) await linkMinecraftRuntimeDirs(customRoot)
@@ -1442,161 +1463,45 @@ 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 const loaderVersion = pack.platform.loaderVersion
if (!loaderVersion) { if (!loaderVersion) {
throw new Error(t('errors.fabricLoaderRequired')) 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') const mcRoot = path.join(getAppDataDir(), '.minecraft')
await fsp.mkdir(mcRoot, { recursive: true })
const versionId = `fabric-loader-${loaderVersion}-${pack.mcVersion}` const versionId = `fabric-loader-${loaderVersion}-${pack.mcVersion}`
const versionDir = path.join(mcRoot, 'versions', versionId) const versionDir = path.join(mcRoot, 'versions', versionId)
const versionJson = path.join(versionDir, `${versionId}.json`) const versionJson = path.join(versionDir, `${versionId}.json`)
// 최신 fabric 은 버전 폴더에 .json 만 만든다(.jar 없음). json 존재를 설치 완료 기준으로 본다.
if (fs.existsSync(versionJson)) { if (fs.existsSync(versionJson)) {
sendLog(t('log.fabricAlreadyInstalled', { id: versionId, dir: versionDir })) sendLog(t('log.fabricAlreadyInstalled', { id: versionId, dir: versionDir }))
return 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`
const latest = installerList.find((item) => item.stable) || installerList[0] sendLog(t('log.fabricProfileFetch', { url: profileUrl }))
sendLog(t('log.fabricInstallerDownload', { version: latest.version, url: latest.url })) const buf = await fetchBuffer(profileUrl)
let profileId = ''
// 2) installer jar 캐시.
const cacheDir = path.join(customRoot, 'platform-cache')
await fsp.mkdir(cacheDir, { recursive: true })
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 { try {
const runtimeBase = path.join(getAppDataDir(), '.minecraft', 'runtime') const parsed = JSON.parse(buf.toString('utf8')) as { id?: unknown }
if (fs.existsSync(runtimeBase)) { if (typeof parsed.id === 'string') profileId = parsed.id
const priority = [ } catch (err) {
'java-runtime-delta', throw new Error(t('errors.fabricProfileInvalid', { message: (err as Error).message }))
'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
} }
if (!profileId) {
// 3) PATH 폴백. throw new Error(t('errors.fabricProfileInvalid', { message: 'missing id' }))
return javaName }
} await fsp.mkdir(versionDir, { recursive: true })
// 받은 바이트를 그대로 저장(무손실). 프로필의 id 는 versionId 와 동일하다.
function runJavaProcess(cmd: string, args: string[]): Promise<void> { await fsp.writeFile(versionJson, buf)
return new Promise((resolve, reject) => { sendLog(t('log.fabricInstallDone'))
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 { function deriveFileName(url: string): string {

View File

@@ -20,8 +20,8 @@ const api = {
// 최종 리소스팩 다운로드용 약관 목록 (showInFinalResourcepack 필터) // 최종 리소스팩 다운로드용 약관 목록 (showInFinalResourcepack 필터)
getFinalTermsList: (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> => getFinalTermsList: (): Promise<{ ok: boolean; terms?: Array<{ kind: string; label: string }>; message?: string }> =>
ipcRenderer.invoke('terms:listFinal'), 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'), ipcRenderer.invoke('finalResourcepack:install'),
// 3-1 // 3-1

View File

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

View File

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

View File

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

View File

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