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>
2026-07-17 08:59:41 +09:00
parent a6118039a3
commit a1d8435b71
11 changed files with 115 additions and 51 deletions
--- 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%` 전개형 경로라 한글 사용자명에도 안전).

--- 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 =
    '<h3>' + tt('step3.sub32.heading') + '</h3>' +
    '<p class="formMessage">' + tt('step3.sub32.description') + '</p>' +
-    '<div class="fieldset"><label><input id="jdkPath" type="text" placeholder="C:\\Program Files\\Java\\jdk-25" value="' + (state.serverInstall.jdk || '') + '" /></label>' +
+    '<p class="formMessage"><strong>' + tt('step3.sub32.recommended', { major: recommendedJdk }) + '</strong></p>' +
+    '<div class="fieldset"><label><input id="jdkPath" type="text" placeholder="C:\\Program Files\\Java\\jdk-' + recommendedJdk + '" value="' + (state.serverInstall.jdk || '') + '" /></label>' +
    '<button class="secondaryBtn" id="pickJdk">' + tt('step3.sub32.pickFolder') + '</button>' +
    '<button class="secondaryBtn" id="auto">' + tt('step3.sub32.auto') + '</button>' +
    '<button class="secondaryBtn" id="install">' + tt('step3.sub32.install') + '</button></div>' +
@@ -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 })
    }
  })()
 }
--- 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}}",
--- 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)",
--- 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": {
--- 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 홈 디렉터리를 되돌린다(<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) {
--- 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
--- 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)
    }
--- 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<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)
  }
--- 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/<mapPath> 에서 받아 .mc_custom/saves 로 풀 zip 파일 이름. */
  mapPath: string
  /** /file/servers/<serverPath> 에서 받아 서버 설치 경로로 풀 zip 파일 이름. */
--- a/views/op/editor.ejs
+++ b/views/op/editor.ejs
@@ -80,6 +80,15 @@
          <span><%= t('editor.clientRecommendedRam') %></span>
          <input type="number" name="clientRecommendedRam" value="<%= pack.clientRecommendedRam %>" min="512" required />
        </label>
+        <label>
+          <span><%= t('editor.recommendedJdk') %></span>
+          <select name="recommendedJdk" required>
+            <% jdkOptions.forEach(function (major) { %>
+              <option value="<%= major %>" <%= major === pack.recommendedJdk ? 'selected' : '' %>>Java <%= major %></option>
+            <% }) %>
+          </select>
+          <small class="muted"><%= t('editor.recommendedJdkHint') %></small>
+        </label>
        <label>
          <span><%= t('editor.mapPath') %></span>
          <input name="mapPath" value="<%= pack.mapPath %>" placeholder="my-map.zip" pattern=".+\.zip" />