Skip to content
호스팅 · 오류 분석

잘못된 plugin.yml

서버가 파일을 플러그인으로 인식하지 않을 때: 손상된 다운로드, 잘못된 파일 형식, 플러그인 대신 모드, 압축 파일 안의 압축 파일을 다룹니다.

업데이트 2026년 8월 13일

org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml

서버가 .jar 파일을 열었지만 내부에서 유효한 플러그인 설명을 찾지 못했어요.

원인

  1. 파일이 완전히 다운로드되지 않았어요. 가장 흔한 원인이에요. 다시 업로드해 주세요 — 서버 파일.
  2. 이것은 플러그인이 아니라 모드예요. Forge와 Fabric 모드는 plugins에서 작동하지 않아요 — 클라이언트 및 서버 모드.
  3. 이것은 빌드된 플러그인이 아니라 라이브러리나 소스 코드예요.
  4. 파일 이름이 zip에서 변경되었어요. 플러그인 모음이 담긴 압축 파일은 플러그인이 아니에요. 압축을 풀고 내용물을 업로드해 주세요.
  5. 플러그인이 다른 플랫폼용으로 빌드되었어요. Paper 서버의 plugins 폴더에 있는 Velocity 플러그인 같은 경우예요.

확인 방법

압축 프로그램으로 .jar 파일을 열어 보세요. 루트에 plugin.yml이 있어야 해요. 그곳에 fabric.mod.json이나 META-INF/mods.toml이 보인다면 그것은 모드이며 mods 폴더에 들어가야 해요.

파일 크기

서버에 있는 파일 크기와 다운로드 페이지의 크기를 비교해 보세요. 크기가 다르면 전송이 중단된 것이에요.

관련 오류: 플러그인이 로드되지 않아요.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기