서버가 시작되지 않을 때: 체크리스트

Done (12.345s)! For help, type "help"가 “콘솔”에 나타나면 시작이 성공한 거예요. 대신 서버가 멈추거나 계속 돌기만 한다면, 아래 목록을 위에서부터 차례대로 확인해 보세요. 빈도순으로 정리되어 있어요.

0. “개요”에서 카드 확인하기

서버가 크래시하면 제어판이 개요 페이지에 원인을 바로 분석해서 보여줘요. 대부분은 여기서 끝나요. 더 자세한 내용은 서버 크래시: 어떻게 해야 하나요를 참고하세요.

1. 최근 설치

마지막으로 뭔가 설치하셨나요? 열에 아홉은 그게 원인이에요.

• “플러그인과 모드” 섹션에서 마지막으로 설치한 모드나 플러그인을 제거하고 서버를 다시 시작하세요.
• 모드팩을 설치했다면 메모리 요구 사항을 확인하세요. 플랜보다 무거운 모드팩은 절대 시작되지 않아요.

폴더 전체를 한 번에 확인하는 빠른 방법: 파일에서 mods를 mods_off로(또는 plugins를 plugins_off로) 이름을 바꾸고 서버를 시작하세요. 서버가 시작되면 원인은 그 안에 있어요. 절반씩 되돌려서 찾아보세요.

2. 메모리

java.lang.OutOfMemoryError, Killed 같은 줄이 나오거나, 월드를 불러오는 중에 오류 없이 로그가 끊긴다면 플랜의 한도에 도달한 거예요.

해결 방법: 무거운 모드를 제거하고, 설정에서 “렌더 거리”를 6–8로 낮추거나, 더 큰 플랜을 사용하세요(요금제).

3. 코어와 버전

• UnsupportedClassVersionError 또는 “Java 17/21 required” — 모드가 서버보다 최신 버전용으로 만들어졌어요. 보통은 모드팩에 속하지 않는, 직접 업로드한 .jar 파일이 원인이에요.
• Server attempted to load chunk saved with newer version — 월드가 게임의 최신 버전에서 만들어졌어요. 월드는 다운그레이드할 수 없으니 서버 버전을 다시 올려야 해요.
• Fabric/Forge 플러그인이나 Paper 모드는 서버와 함께 실행되지 않아요. 코어와 버전을 참고하세요.

4. 손상된 설정

while scanning, mapping values are not allowed here, Invalid configuration 같은 줄은 YAML을 편집했다는 뜻이에요.

대표적인 원인: 공백 대신 탭, 따옴표 누락, 들여쓰기 초과. 로그에서 문제라고 알려주는 파일을 열어 고치세요. 문제가 보이지 않으면 파일을 기본값으로 초기화하세요. 파일을 삭제하면 플러그인이 시작할 때 새로 만들어요.

5. 월드

Failed to load level, Exception reading level.dat — 월드가 손상된 거예요(보통 강제 종료 후나, 다른 버전의 남의 압축 파일을 업로드한 뒤에 발생해요).

최신 복사본을 복원하세요. “월드와 복사본” 섹션, 백업을 참고하세요.

6. 서버가 “시작”하자마자 멈추는 경우

• 서버 절전에 걸리지 않았는지 확인하세요. 무료 플랜은 빈 서버를 종료하는데, 이건 오류가 아니에요.
• 로그에 직접 입력한 명령이나 예약에 의한 stop이 보이나요? “자동화와 로그”에서 중지 작업이 실행 중일 수 있어요.

아무것도 도움이 되지 않았다면

“콘솔”에서 마지막 50줄을 복사해서 지원팀에 문의하세요. 로그가 있으면 몇 분 안에 답변을 받을 수 있어요. 로그가 없으면 저희도 함께 추측만 하게 돼요. 로그를 직접 읽는 방법은 로그와 크래시 보고서를 참고하세요.