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