서버가 크래시했을 때 대처법

서버가 크래시를 일으켜도 제어판은 스택 트레이스만 남기지 않아요. "개요" 섹션에 원인이 식별된 카드와 버튼 하나가 나타나요. 보통 필요한 바로 그 동작이죠.

메모리 부족 (OOM)

가장 흔한 원인이에요. 로그에서는 java.lang.OutOfMemoryError: Java heap space로 보여요.

메모리는 "갑자기" 부족해지지 않아요. 모드, 넓은 렌더 거리에서의 월드 생성, 엔티티 농장이 메모리를 잡아먹죠. 효과가 큰 순서대로 도움이 되는 방법은 다음과 같아요.

1. 더 높은 플랜. 모드팩이 6 GB를 요구하는데 4 GB를 쓰고 있다면, 다른 방법은 소용없어요.
2. 무거운 모드 제거. 보통 월드 생성기와 동적 지도가 여기에 해당해요.
3. 렌더 거리 낮추기. 설정에서 view-distance를 6–8로 줄여요.

제어판의 메모리 그래프를 보세요. 몇 달째 선이 천장에 닿아 있다면 플랜이 확실히 원인이에요.

모드가 버전이나 코어와 맞지 않음

requires minecraft 1.20.1 but, Incompatible mod set, Could not load 'plugins/...'.

모드가 다른 Minecraft 버전이나 다른 로더용으로 만들어졌어요. "플러그인과 모드" 섹션에서 제거하거나, 서버 버전을 모드가 지원하는 버전으로 맞추세요. 제어판은 설치 중에 호환성을 확인하지만, 서버 버전을 바꾼 뒤 오래된 모드가 "뒤처질" 수 있어요. 같은 곳에서 호환되지 않는 목록을 보여줘요.

손상된 설정

while parsing a block, YAMLException, JsonSyntaxException.

보통 파일을 직접 편집한 뒤에 생겨요. "파일"을 열고 가장 최근에 수정된 .yml, .properties, .json을 확인하세요. YAML에서는 공백 대신 탭을 쓴 것이 거의 항상 원인이에요.

포트가 사용 중

FAILED TO BIND TO PORT! — 이전 서버 프로세스가 아직 포트를 잡고 있어요. "개요" 섹션에서 "강제 중지"를 누르고 다시 시작하세요.

잘못된 Java 버전

UnsupportedClassVersionError. 모드팩에 다른 Java가 필요해요. 보통 오래된 버전(1.7–1.12)이 여기에 해당해요. 지원팀에 문의하세요. 필요한 버전을 골라 고정해 드릴게요.

손상된 월드

Failed to load level, level.dat is corrupt. "월드와 복사본" → "백업" 섹션에서 최신 복사본을 복원하세요. 제어판은 파괴적인 변경 전에 직접 복사본을 만들어요.

원인이 식별되지 않으면

크래시 카드에서 "로그 열기"를 누르세요. 종료 직전의 마지막 200줄을 보여줘요. 지원팀에 보내주세요. 거의 항상 그것으로 충분해요.

로그를 직접 분석하려면 — 로그와 크래시 보고서. 서버가 크래시를 일으키지는 않지만 시작 단계에 아예 도달하지 못한다면, 체크리스트를 따라가세요: 서버가 시작되지 않음.