Skip to content
호스팅 · 문제 해결

플러그인이 로드되지 않아요

/plugins에 플러그인이 나타나지 않는 이유를 알아봐요. 호환성 문제, 누락된 의존성, 설정 오류, 잘못된 폴더를 다뤄요.

업데이트 2026년 8월 13일

/plugins를 확인하세요 — 플러그인은 초록색(로드됨) 또는 빨간색(오류)으로 표시됩니다. 플러그인이 목록에 아예 없다면 서버가 해당 플러그인을 인식하지 못한 것입니다.

확인 순서

  1. 파일이 올바른 폴더에 있습니다. .jar는 하위 폴더나 mods가 아니라 plugins에 있습니다.
  2. 코어가 플러그인을 지원합니다. Fabric과 Forge는 플러그인을 전혀 지원하지 않습니다 — 코어와 버전. 바닐라 코어에는 plugins 폴더가 아예 없습니다.
  3. 버전. 플러그인이 다른 게임 버전용으로 빌드되었습니다 — 호환성.
  4. 의존성. Vault, ProtocolLib, PlaceholderAPI — 이것들이 없으면 플러그인이 조용히 로드에 실패합니다: 로그에 Unknown dependency가 표시됩니다 — 누락된 의존성.
  5. 설정 오류. 손상된 YAML — 플러그인이 시작할 때 스스로 비활성화됩니다 — 플러그인 설정.
  6. 손상된 파일. 다운로드가 중단되면 Invalid plugin.yml이 발생합니다 — 분석.

로그 확인

시작 후 첫 몇 초에 정확한 원인이 들어 있습니다. 플러그인 이름과 Could not load, Unknown dependency, Error occurred while enabling 문구를 검색하세요 — 로그.

플러그인은 로드되었지만 작동하지 않습니다

이건 다른 문제입니다: 권한(lp verbose on), 설정, 필요한 의존성이 있는지 확인하세요 — LuckPerms, 권한이 적용되지 않음.

카탈로그를 통한 설치

제어판 카탈로그는 설치 전에 호환성을 확인하고 의존성을 설치합니다 — 설치 방법. 수동 설치는 모든 것을 직접 확인해야 한다는 뜻입니다.

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