diff --git a/docs/installer.md b/docs/installer.md index 2aa5a03..12e13e4 100644 --- a/docs/installer.md +++ b/docs/installer.md @@ -28,9 +28,10 @@ ### 3-2. JDK 확인 -- 환경변수(`JAVA_HOME`, `JDK_HOME`) → 자동 설치 위치(`%APPDATA%\jdk\temurin-25`) → `C:\Program Files\Java` 순으로 자동 탐색. -- 최신 마인크래프트 서버는 Java 25 이상을 요구합니다(예: 서버 번들러 class file 69.0). 그보다 낮은 자바(17/21 등)는 있어도 `UnsupportedClassVersionError` 로 서버가 뜨지 않으므로, 자동 탐색은 **Java 25 미만을 "없음"으로 처리**해 자동 설치로 유도합니다. -- **자동 설치** 버튼을 누르면 Adoptium Temurin 25 LTS Windows x64 zip 을 받아 `%APPDATA%\jdk\temurin-25\` 에 풀어 사용합니다. +- 각 음악퀴즈(pack)는 사이트 편집기에서 **권장 JDK 버전**(예: Java 25)을 지정합니다. 설치기는 이 권장 버전을 기준으로 동작합니다. +- 탐색 순서: **① 권장 JDK 자동 설치 위치(`%APPDATA%\jdk\temurin-<권장>`) 를 가장 먼저** 확인 → 없으면 **② 컴퓨터의 JDK(`JAVA_HOME` / `JDK_HOME` / `C:\Program Files\Java`)** 를 확인. +- 최신 마인크래프트 서버는 특정 자바 버전 이상을 요구합니다(예: 서버 번들러 class file 69.0 = Java 25). 그보다 낮은 자바는 있어도 `UnsupportedClassVersionError` 로 서버가 뜨지 않으므로, 자동 탐색은 **권장 버전 미만을 "없음"으로 처리**해 자동 설치로 유도합니다. 직접 선택/입력한 경로도 "다음" 에서 버전을 검증해 미만이면 진행을 막습니다. +- **자동 설치** 버튼을 누르면 Adoptium Temurin(권장 버전) Windows x64 zip 을 받아 `%APPDATA%\jdk\temurin-<권장>\` 에 풀어 사용합니다. - 설치 중 같은 버튼이 "설치 취소" 로 바뀌고, 누르면 다운로드를 즉시 중단하고 부분 파일을 정리합니다. - 서버 zip 의 `run.bat` 이 시스템 PATH 의 `java` 를 그대로 쓰면 낡은 자바로 실행돼 실패할 수 있어, 설치기가 준비/선택한 JDK 의 `java` 를 쓰도록 `run.bat` 을 자동으로 수정합니다(자동 설치 JDK 는 `%APPDATA%` 전개형 경로라 한글 사용자명에도 안전). diff --git a/installer/renderer.js b/installer/renderer.js index 392b098..af977ef 100644 --- a/installer/renderer.js +++ b/installer/renderer.js @@ -593,10 +593,17 @@ function renderSubStep31(host, back, done) { } function renderSubStep32(host, back, done) { + // 선택한 음악퀴즈(pack)의 권장 JDK. 설치기는 이 버전을 우선 찾고/설치한다. + var selPack = (state.packs && state.packs.find) + ? state.packs.find(function (p) { return p.key === state.selectedPackKey }) + : null + var recommendedJdk = (selPack && selPack.pack && selPack.pack.recommendedJdk) ? selPack.pack.recommendedJdk : 25 + host.innerHTML = '

' + tt('step3.sub32.heading') + '

' + '

' + tt('step3.sub32.description') + '

' + - '
' + + '

' + tt('step3.sub32.recommended', { major: recommendedJdk }) + '

' + + '
' + '' + '' + '
' + @@ -633,14 +640,16 @@ function renderSubStep32(host, back, done) { autoBtn.addEventListener('click', async function () { if (installing) return - var detect = await installerApi.detectJdk() + var detect = await installerApi.detectJdk(recommendedJdk) if (detect.found) { input.value = detect.path - msg.textContent = tt('step3.sub32.found', { path: detect.path }) + msg.textContent = detect.source === 'recommended' + ? tt('step3.sub32.foundRecommended', { path: detect.path, major: recommendedJdk }) + : tt('step3.sub32.found', { path: detect.path }) msg.classList.remove('error') msg.classList.add('success') } else { - msg.textContent = tt('step3.sub32.notFound') + msg.textContent = tt('step3.sub32.notFound', { major: recommendedJdk }) msg.classList.remove('success') msg.classList.add('error') } @@ -662,7 +671,7 @@ function renderSubStep32(host, back, done) { msg.classList.remove('success', 'error') msg.textContent = tt('step3.sub32.downloading') try { - var result = await installerApi.installJdk() + var result = await installerApi.installJdk(recommendedJdk) if (result.ok && result.path) { input.value = result.path state.serverInstall.jdk = result.path @@ -700,11 +709,11 @@ function renderSubStep32(host, back, done) { msg.classList.remove('success', 'error') msg.textContent = tt('step3.sub32.verifying') try { - var v = await installerApi.verifyJdk(val) + var v = await installerApi.verifyJdk(val, recommendedJdk) if (!v || !v.ok) { msg.classList.add('error') msg.textContent = (v && v.major) - ? tt('step3.sub32.versionTooLow', { major: v.major, required: (v && v.required) || 25 }) + ? tt('step3.sub32.versionTooLow', { major: v.major, required: (v && v.required) || recommendedJdk }) : tt('step3.sub32.versionUnknown') nextBtn.disabled = false return @@ -720,13 +729,15 @@ function renderSubStep32(host, back, done) { done() }) ;(async function () { - var detect = await installerApi.detectJdk() + var detect = await installerApi.detectJdk(recommendedJdk) if (detect.found && !input.value) { input.value = detect.path - msg.textContent = tt('step3.sub32.autoDetected', { path: detect.path }) + msg.textContent = detect.source === 'recommended' + ? tt('step3.sub32.foundRecommended', { path: detect.path, major: recommendedJdk }) + : tt('step3.sub32.autoDetected', { path: detect.path }) msg.classList.add('success') } else if (!detect.found) { - msg.textContent = tt('step3.sub32.notFoundHint') + msg.textContent = tt('step3.sub32.notFoundHint', { major: recommendedJdk }) } })() } diff --git a/locales/installer/ko-kr.json b/locales/installer/ko-kr.json index 4f1552a..1941cbe 100644 --- a/locales/installer/ko-kr.json +++ b/locales/installer/ko-kr.json @@ -90,10 +90,12 @@ "auto": "자동 탐색", "install": "자동 설치", "installCancel": "설치 취소", + "recommended": "권장 JDK: Java {{major}} (이 음악퀴즈 서버 실행용)", "found": "JDK 발견: {{path}}", + "foundRecommended": "권장 JDK(Java {{major}}) 발견: {{path}}", "autoDetected": "JDK 자동 탐색됨: {{path}}", - "notFound": "서버 실행에 필요한 Java 25 이상을 찾지 못했습니다(낮은 버전이 설치돼 있어도 서버가 뜨지 않습니다). \"자동 설치\" 를 눌러 설치하거나 직접 선택해 주세요.", - "notFoundHint": "Java 25 이상을 찾지 못했습니다. \"자동 설치\" 를 누르면 Temurin 25 를 받아 설치합니다.", + "notFound": "서버 실행에 필요한 Java {{major}} 이상을 찾지 못했습니다(낮은 버전이 설치돼 있어도 서버가 뜨지 않습니다). \"자동 설치\" 를 눌러 설치하거나 직접 선택해 주세요.", + "notFoundHint": "Java {{major}} 이상을 찾지 못했습니다. \"자동 설치\" 를 누르면 Temurin {{major}} 를 받아 설치합니다.", "cancelRequested": "JDK 설치 취소 요청 중...", "downloading": "JDK 다운로드 중...", "installComplete": "JDK 자동 설치 완료: {{path}}", @@ -102,7 +104,7 @@ "installError": "JDK 설치 오류: {{message}}", "pathRequired": "JDK 경로를 입력해 주세요.", "verifying": "선택한 JDK 버전을 확인하는 중…", - "versionTooLow": "선택한 Java {{major}} 는 너무 낮습니다. 서버 실행에는 Java {{required}} 이상이 필요합니다. \"자동 설치\" 로 Temurin 25 를 받거나 Java 25 이상 폴더를 선택해 주세요.", + "versionTooLow": "선택한 Java {{major}} 는 너무 낮습니다. 서버 실행에는 Java {{required}} 이상이 필요합니다. \"자동 설치\" 로 Temurin {{required}} 를 받거나 Java {{required}} 이상 폴더를 선택해 주세요.", "versionUnknown": "선택한 경로에서 Java 실행 파일을 찾지 못했거나 버전을 확인할 수 없습니다. JDK 폴더(bin\\java.exe 가 있는 곳)를 선택하거나 \"자동 설치\" 를 눌러 주세요." }, "sub33": { @@ -204,7 +206,7 @@ "packLoadFail": "pack 로드 실패 ({{file}}): {{message}}", "packsLoaded": "로드된 음악퀴즈: {{count}}개", "selectedPack": "선택: {{key}}", - "jdkInstallStart": "JDK(Temurin 25) 자동 설치 시작 — 다운로드 중...", + "jdkInstallStart": "JDK(Temurin {{major}}) 자동 설치 시작 — 다운로드 중...", "jdkDownloadProgress": "JDK 다운로드: {{percent}}% ({{loaded}}MB / {{total}}MB)", "jdkExtracting": "JDK 압축 해제 중...", "jdkDoneRoot": "JDK 자동 설치 완료: {{path}}", diff --git a/locales/server/ko-kr.json b/locales/server/ko-kr.json index 297f64f..e8e74ff 100644 --- a/locales/server/ko-kr.json +++ b/locales/server/ko-kr.json @@ -125,6 +125,8 @@ "serverMaxRam": "서버 최대 램 (MB)", "clientMinRam": "클라이언트 최소 램 (MB)", "clientRecommendedRam": "클라이언트 권장 램 (MB)", + "recommendedJdk": "권장 JDK (서버 실행용)", + "recommendedJdkHint": "설치기가 이 버전을 우선 찾고, 없으면 자동 설치합니다. 서버가 요구하는 자바 버전에 맞춰 고르세요(최신 마인크래프트는 보통 Java 25).", "mapPath": "맵 파일 (.zip)", "mapPathHint": "/file/maps/ 아래 zip 파일 이름.", "serverPath": "서버 파일 (.zip)", diff --git a/package.json b/package.json index 372ac26..0c7f4f6 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "minecraft-music-quiz-installer", - "version": "0.4.5", + "version": "0.4.6", "description": "마인크래프트 음악퀴즈 간편설치기 + 관리 사이트", "main": "dist/installer/main.js", "scripts": { diff --git a/src/installer/main.ts b/src/installer/main.ts index c26ebe8..88eebf9 100644 --- a/src/installer/main.ts +++ b/src/installer/main.ts @@ -19,7 +19,7 @@ import type { ServerInstallPayload } from './types.js' import type { Manifest, PackDefinition } from '../shared/types.js' -import { normalizePackDefinition } from '../shared/store.js' +import { normalizePackDefinition, normalizeRecommendedJdk } from '../shared/store.js' import { getMcCustomDirName, withCustomDirName } from '../shared/paths.js' import { loadEnv, getManifestUrl } from '../shared/env.js' import { loadComponentI18n } from '../shared/i18n.js' @@ -252,13 +252,13 @@ ipcMain.handle('install:validatePath', async (_event, target: string) => { return { ok: true, message: absolute } }) -// 자동 설치할 JDK 메이저 버전. 최신 마인크래프트 서버(번들러)가 요구하는 자바 버전에 -// 맞춘다. 마인크래프트 서버 jar 이 "class file version 69.0"(=Java 25)처럼 더 최신 -// 자바를 요구하면, 낮은 자바로 실행 시 UnsupportedClassVersionError 로 서버가 뜨지 -// 않는다. 최신 마인크래프트는 Java 25(LTS)를 요구하므로 25 로 맞춘다. -const BUNDLED_JDK_MAJOR = '25' -const BUNDLED_JDK_DIRNAME = `temurin-${BUNDLED_JDK_MAJOR}` -const REQUIRED_JAVA_MAJOR = Number(BUNDLED_JDK_MAJOR) +// 권장 JDK 메이저는 사이트의 pack.recommendedJdk 로 결정된다(미지정/이상값은 기본값 25). +// 최신 마인크래프트 서버 jar 이 "class file version 69.0"(=Java 25)처럼 특정 자바 버전을 +// 요구하며, 그보다 낮은 자바로 실행하면 UnsupportedClassVersionError 로 서버가 뜨지 않는다. +/** 자동 설치 폴더 이름(예: temurin-25). */ +function jdkDirName(major: number): string { + return `temurin-${major}` +} /** * java 실행 파일의 메이저 버전을 조회한다(`java -version` 은 stderr 로 출력). @@ -297,36 +297,48 @@ function findJavaExeInHome(candidate: string): string { return '' } -ipcMain.handle('jdk:detect', async () => { +/** javaExe 로부터 JDK 홈 디렉터리를 되돌린다(/bin/java.exe → ). */ +function homeFromJavaExe(javaExe: string, fallbackHome: string): string { + return path.basename(path.dirname(javaExe)) === 'bin' + ? path.dirname(path.dirname(javaExe)) + : fallbackHome +} + +ipcMain.handle('jdk:detect', async (_event, recommendedInput?: number) => { + const required = normalizeRecommendedJdk(recommendedInput) + + // 1) 권장 JDK(설치기가 자동 설치하는 위치)를 가장 먼저 찾는다. + const recommendedHome = path.join(getAppDataDir(), 'jdk', jdkDirName(required)) + const recJava = findJavaExeInHome(recommendedHome) + if (recJava && getJavaMajor(recJava) >= required) { + return { found: true, path: homeFromJavaExe(recJava, recommendedHome), source: 'recommended', major: required } + } + + // 2) 없으면 컴퓨터의 JDK(JAVA_HOME/JDK_HOME/Program Files)를 확인한다. + // 권장 버전 미만은 서버 실행에 부족하므로(UnsupportedClassVersionError) "없음" 처리. const candidates: string[] = [] if (process.env.JAVA_HOME) candidates.push(process.env.JAVA_HOME) if (process.env.JDK_HOME) candidates.push(process.env.JDK_HOME) - // 자동 설치 위치(우리 설치기가 만든 JDK)도 후보에 포함. - candidates.push(path.join(getAppDataDir(), 'jdk', BUNDLED_JDK_DIRNAME)) candidates.push('C:\\Program Files\\Java') - - // 최신 마인크래프트 서버는 Java 25 이상을 요구한다. 너무 낮은 자바(예: 17/21)는 - // 있어도 UnsupportedClassVersionError 로 서버가 안 뜨므로, 요구 버전 미만은 - // "없음" 으로 처리해 자동 설치로 유도한다. for (const candidate of candidates) { if (!candidate) continue const javaExe = findJavaExeInHome(candidate) if (!javaExe) continue - if (getJavaMajor(javaExe) < REQUIRED_JAVA_MAJOR) continue - // 홈 디렉터리를 반환(java.exe 가 /bin/java.exe 인 경우 상위 두 단계가 홈). - const home = path.basename(path.dirname(javaExe)) === 'bin' ? path.dirname(path.dirname(javaExe)) : candidate - return { found: true, path: home } + const major = getJavaMajor(javaExe) + if (major < required) continue + return { found: true, path: homeFromJavaExe(javaExe, candidate), source: 'system', major } } - return { found: false, path: '' } + return { found: false, path: '', major: required } }) // 사용자가 직접 입력/선택한 JDK 경로가 서버 실행에 충분한 버전인지 확인한다. // ok=true → major >= 요구 버전(25). // major=0 → 경로에서 java 를 못 찾거나 버전을 못 읽음(실행 실패 등). -ipcMain.handle('jdk:verify', async (_event, jdkPath: string): Promise<{ ok: boolean; major: number; required: number }> => { +ipcMain.handle('jdk:verify', async (_event, jdkPath: string, recommendedInput?: number): Promise<{ ok: boolean; major: number; required: number }> => { + const required = normalizeRecommendedJdk(recommendedInput) const javaExe = jdkPath ? findJavaExeInHome(jdkPath) : '' const major = javaExe ? getJavaMajor(javaExe) : 0 - return { ok: major >= REQUIRED_JAVA_MAJOR, major, required: REQUIRED_JAVA_MAJOR } + return { ok: major >= required, major, required } }) // ── JDK 자동 설치(Temurin 25, 취소 가능) ────────────────────────────── @@ -403,22 +415,23 @@ function downloadStream( }) } -ipcMain.handle('jdk:install', async (): Promise<{ ok: boolean; path?: string; message?: string }> => { +ipcMain.handle('jdk:install', async (_event, recommendedInput?: number): Promise<{ ok: boolean; path?: string; message?: string }> => { if (jdkInstall.inProgress) { return { ok: false, message: t('errors.jdkBusy') } } + const required = normalizeRecommendedJdk(recommendedInput) jdkInstall.inProgress = true const controller = new AbortController() jdkInstall.controller = controller const tmpRoot = path.join(getAppDataDir(), 'jdk-cache') await fsp.mkdir(tmpRoot, { recursive: true }) - const tempZip = path.join(tmpRoot, `${BUNDLED_JDK_DIRNAME}-${Date.now()}.zip`) - const destDir = path.join(getAppDataDir(), 'jdk', BUNDLED_JDK_DIRNAME) + const tempZip = path.join(tmpRoot, `${jdkDirName(required)}-${Date.now()}.zip`) + const destDir = path.join(getAppDataDir(), 'jdk', jdkDirName(required)) jdkInstall.destDir = destDir try { // Adoptium API v3: latest GA JDK(Windows x64). 본문은 307 로 GitHub 릴리즈로 리다이렉트. - const url = `https://api.adoptium.net/v3/binary/latest/${BUNDLED_JDK_MAJOR}/ga/windows/x64/jdk/hotspot/normal/eclipse?project=jdk` - sendLog(t('log.jdkInstallStart')) + const url = `https://api.adoptium.net/v3/binary/latest/${required}/ga/windows/x64/jdk/hotspot/normal/eclipse?project=jdk` + sendLog(t('log.jdkInstallStart', { major: required })) let lastPctReported = -1 await downloadStream(url, tempZip, controller.signal, (loaded, total) => { if (total > 0) { diff --git a/src/installer/preload.ts b/src/installer/preload.ts index 4673e9a..e363fae 100644 --- a/src/installer/preload.ts +++ b/src/installer/preload.ts @@ -24,10 +24,12 @@ const api = { ipcRenderer.invoke('install:validatePath', target), // 3-2 - detectJdk: (): Promise<{ found: boolean; path: string }> => ipcRenderer.invoke('jdk:detect'), - verifyJdk: (jdkPath: string): Promise<{ ok: boolean; major: number; required: number }> => - ipcRenderer.invoke('jdk:verify', jdkPath), - installJdk: (): Promise<{ ok: boolean; path?: string; message?: string }> => ipcRenderer.invoke('jdk:install'), + detectJdk: (recommendedJdk?: number): Promise<{ found: boolean; path: string; source?: string; major?: number }> => + ipcRenderer.invoke('jdk:detect', recommendedJdk), + verifyJdk: (jdkPath: string, recommendedJdk?: number): Promise<{ ok: boolean; major: number; required: number }> => + ipcRenderer.invoke('jdk:verify', jdkPath, recommendedJdk), + installJdk: (recommendedJdk?: number): Promise<{ ok: boolean; path?: string; message?: string }> => + ipcRenderer.invoke('jdk:install', recommendedJdk), cancelJdkInstall: (): Promise<{ ok: boolean }> => ipcRenderer.invoke('jdk:cancelInstall'), // 3-3 diff --git a/src/server/routes/op.ts b/src/server/routes/op.ts index b640b4a..d48e2cf 100644 --- a/src/server/routes/op.ts +++ b/src/server/routes/op.ts @@ -23,7 +23,8 @@ import { savePackList, setPackPublic, setTermVisibility, - writeAccounts + writeAccounts, + SUPPORTED_JDK_MAJORS } from '../../shared/store.js' import { hashPassword, isHashed, verifyPassword } from '../password.js' import { fetchReleaseVersions } from '../../shared/mojang.js' @@ -187,7 +188,8 @@ opRouter.get('/op/dashboard/:packName', requireAuth, async (req, res, next) => { packKey, pack: definition, releases, - isPublic + isPublic, + jdkOptions: SUPPORTED_JDK_MAJORS }) } catch (error) { next(error) @@ -570,6 +572,7 @@ opRouter.post('/op/dashboard/:packName', requireAuth, async (req, res, next) => serverMaxRam: Number(pickFirstValue(req.body.serverMaxRam)), clientMinRam: Number(pickFirstValue(req.body.clientMinRam)), clientRecommendedRam: Number(pickFirstValue(req.body.clientRecommendedRam)), + recommendedJdk: Number(pickFirstValue(req.body.recommendedJdk)), mapPath: pickFirstValue(req.body.mapPath), serverPath: pickFirstValue(req.body.serverPath) } diff --git a/src/shared/store.ts b/src/shared/store.ts index 7b2363f..ca19215 100644 --- a/src/shared/store.ts +++ b/src/shared/store.ts @@ -52,6 +52,7 @@ export function defaultPackDefinition(name: string): PackDefinition { serverMaxRam: 4096, clientMinRam: 2048, clientRecommendedRam: 4096, + recommendedJdk: DEFAULT_JDK_MAJOR, mapPath: '', serverPath: '' } @@ -78,6 +79,20 @@ function sanitizeFolderName(input: unknown): string { const ALLOWED_LOADERS: LoaderType[] = ['vanilla', 'forge', 'fabric', 'neoforge'] +/** + * 사이트에서 고를 수 있고 설치기가 자동 설치할 수 있는 JDK 메이저 버전 목록(LTS). + * 마인크래프트 버전대별: 8(구버전) / 11(1.17) / 17(1.18~1.20.4) / 21(1.20.5~) / 25(최신). + */ +export const SUPPORTED_JDK_MAJORS: number[] = [8, 11, 17, 21, 25] +/** recommendedJdk 미지정/이상값일 때의 기본 권장 버전. */ +export const DEFAULT_JDK_MAJOR = 25 + +/** 입력값을 허용된 JDK 메이저로 보정. 목록 밖이면 기본값. */ +export function normalizeRecommendedJdk(input: unknown): number { + const n = Math.floor(Number(input)) + return SUPPORTED_JDK_MAJORS.includes(n) ? n : DEFAULT_JDK_MAJOR +} + export function normalizePackDefinition(input: Partial & Record): PackDefinition { const fallback = defaultPackDefinition(typeof input.name === 'string' ? input.name : 'new') const platform = (input.platform ?? {}) as Partial @@ -112,6 +127,7 @@ export function normalizePackDefinition(input: Partial & Record< serverMaxRam: clampNumber(input.serverMaxRam, fallback.serverMaxRam), clientMinRam: clampNumber(input.clientMinRam, fallback.clientMinRam), clientRecommendedRam: clampNumber(input.clientRecommendedRam, fallback.clientRecommendedRam), + recommendedJdk: normalizeRecommendedJdk(input.recommendedJdk), mapPath: sanitizeZipFileName(input.mapPath), serverPath: sanitizeZipFileName(input.serverPath) } diff --git a/src/shared/types.ts b/src/shared/types.ts index 6214ca4..07f3fee 100644 --- a/src/shared/types.ts +++ b/src/shared/types.ts @@ -28,6 +28,11 @@ export interface PackDefinition { serverMaxRam: number clientMinRam: number clientRecommendedRam: number + /** + * 서버 실행에 권장하는 JDK 메이저 버전(예: 25). 설치기가 이 버전을 우선 탐색/설치한다. + * 사이트에서 선택하며, 허용 목록(SUPPORTED_JDK_MAJORS) 밖의 값은 기본값으로 보정된다. + */ + recommendedJdk: number /** /file/maps/ 에서 받아 .mc_custom/saves 로 풀 zip 파일 이름. */ mapPath: string /** /file/servers/ 에서 받아 서버 설치 경로로 풀 zip 파일 이름. */ diff --git a/views/op/editor.ejs b/views/op/editor.ejs index 2613034..dee5726 100644 --- a/views/op/editor.ejs +++ b/views/op/editor.ejs @@ -80,6 +80,15 @@ <%= t('editor.clientRecommendedRam') %> +