마인크래프트 버전별 필요한 자바 버전 정리 (26.1 까지)

마인크래프트 서버는 1.16.5 이하는 자바 8, 1.17 ~ 1.17.1 은 자바 16, 1.18 ~ 1.20.4 는 자바 17, 1.20.5 ~ 1.21.x 는 자바 21, 26.1 이후는 자바 25 가 필요합니다. 서버가 안 켜지고 UnsupportedClassVersionError 가 뜨면 거의 자바 버전 문제입니다.

버전별 필요한 자바 (2026년 10월 기준)

- 1.16.5 이하: 자바 8

- 1.17 ~ 1.17.1: 자바 16

- 1.18 ~ 1.20.4: 자바 17

- 1.20.5 ~ 1.21.x: 자바 21

- 26.1 이후: 자바 25

낮은 자바로는 아예 안 켜지고, 높은 자바로는 대부분 그냥 켜집니다. 헷갈리면 높은 쪽을 쓰면 됩니다.

예외 두 가지

- 오래된 모드팩: 1.12, 1.16 대 모드팩은 자바 8 이 아니면 깨지는 게 많습니다

- 모드 로더: Forge, Fabric, NeoForge 는 새 버전이 나오고 한동안 따라오지 못합니다. 모드 서버는 로더가 그 버전을 지원한다고 할 때까지 올리지 마세요

확인하는 법

1. 지금 잡히는 자바 보기: 터미널이나 명령 프롬프트에서 java -version 을 칩니다. 첫 줄의 숫자가 버전입니다

2. 오류 문구 읽기: UnsupportedClassVersionError 뒤에 class file version 숫자가 나옵니다. 52 는 자바 8, 60 은 자바 16, 61 은 자바 17, 65 는 자바 21, 69 는 자바 25 입니다. 오류에 나온 숫자보다 지금 자바가 낮다는 뜻입니다

3. 서버 버전 보기: 서버 jar 파일 이름이나 서버 로그 앞부분에 마인크래프트 버전이 찍힙니다

자주 막히는 곳

- 새 자바를 깔았는데 같은 오류: 컴퓨터에 자바가 여러 개 있고 실행할 때 예전 것이 잡히는 경우입니다. java -version 결과가 방금 깐 버전과 다르면 이 경우입니다

- 실행 스크립트 하나로 여러 서버를 돌릴 때: 서버마다 맞는 자바가 다를 수 있습니다

- 모드팩 안내와 위 표가 다를 때: 모드팩 제작자가 적은 자바를 따르세요

여러 자바 같이 쓰기

자바는 한 컴퓨터에 여러 개 깔아 둘 수 있습니다. 서버마다 실행 줄에 자바 경로를 적어 주면 서로 안 섞입니다. 실행 줄 맨 앞의 java 대신 해당 버전 폴더 안 bin 의 java 파일 경로를 통째로 적고, 그 뒤에 -jar server.jar 를 붙이는 식입니다. 리눅스는 /usr/lib/jvm 아래, 윈도우는 Program Files 아래에 버전별 폴더가 생기는 경우가 많으니 거기서 찾으세요.

한 줄 요약

오류가 나면 java -version 부터 보고, 서버 버전에 맞는 자바 경로를 실행 줄에 직접 적으세요.