잘못된 plugin.yml
서버가 파일을 플러그인으로 인식하지 않을 때: 손상된 다운로드, 잘못된 파일 형식, 플러그인 대신 모드, 압축 파일 안의 압축 파일을 다룹니다.
업데이트 2026년 8월 13일
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
서버가 .jar 파일을 열었지만 내부에서 유효한 플러그인 설명을 찾지 못했어요.
원인
- 파일이 완전히 다운로드되지 않았어요. 가장 흔한 원인이에요. 다시 업로드해 주세요 — 서버 파일.
- 이것은 플러그인이 아니라 모드예요. Forge와 Fabric 모드는
plugins에서 작동하지 않아요 — 클라이언트 및 서버 모드. - 이것은 빌드된 플러그인이 아니라 라이브러리나 소스 코드예요.
- 파일 이름이 zip에서 변경되었어요. 플러그인 모음이 담긴 압축 파일은 플러그인이 아니에요. 압축을 풀고 내용물을 업로드해 주세요.
- 플러그인이 다른 플랫폼용으로 빌드되었어요. Paper 서버의
plugins폴더에 있는 Velocity 플러그인 같은 경우예요.
확인 방법
압축 프로그램으로 .jar 파일을 열어 보세요. 루트에 plugin.yml이 있어야 해요. 그곳에 fabric.mod.json이나 META-INF/mods.toml이 보인다면 그것은 모드이며 mods 폴더에 들어가야 해요.
파일 크기
서버에 있는 파일 크기와 다운로드 페이지의 크기를 비교해 보세요. 크기가 다르면 전송이 중단된 것이에요.
관련 오류: 플러그인이 로드되지 않아요.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
