feat(server): 사이트에서 권장 JDK 선택 + 설치기 권장 JDK 우선 탐색

- pack 에 recommendedJdk 추가(shared/types, store 정규화, 기본 25, 허용목록
  [8,11,17,21,25]). 사이트 편집기에 JDK 버전 드롭다운 추가(직접 입력 X).
- 설치기 JDK 탐색 순서 변경: ① 권장 JDK 자동설치 위치(temurin-<권장>) 우선 →
  ② 없으면 컴퓨터 JDK(JAVA_HOME/Program Files, 권장 버전 이상만 인정).
- 자동 설치/버전 검증도 pack 의 권장 버전을 사용(하드코딩 25 제거).
- 렌더러에 권장 JDK 표시, 관련 안내/문서 갱신. 버전 0.4.5→0.4.6.

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

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 홈 디렉터리를 되돌린다(<home>/bin/java.exe → <home>). */
+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 가 <home>/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) {

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

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)
     }

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<PackDefinition> & Record<string, unknown>): PackDefinition {
   const fallback = defaultPackDefinition(typeof input.name === 'string' ? input.name : 'new')
   const platform = (input.platform ?? {}) as Partial<PackDefinition['platform']>
@@ -112,6 +127,7 @@ export function normalizePackDefinition(input: Partial<PackDefinition> & 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)
   }

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/<mapPath> 에서 받아 .mc_custom/saves 로 풀 zip 파일 이름. */
   mapPath: string
   /** /file/servers/<serverPath> 에서 받아 서버 설치 경로로 풀 zip 파일 이름. */