플러그인이 로드되지 않아요
/plugins에 플러그인이 나타나지 않는 이유를 알아봐요. 호환성 문제, 누락된 의존성, 설정 오류, 잘못된 폴더를 다뤄요.
업데이트 2026년 8월 13일
/plugins를 확인하세요 — 플러그인은 초록색(로드됨) 또는 빨간색(오류)으로 표시됩니다. 플러그인이 목록에 아예 없다면 서버가 해당 플러그인을 인식하지 못한 것입니다.
확인 순서
- 파일이 올바른 폴더에 있습니다.
.jar는 하위 폴더나mods가 아니라plugins에 있습니다. - 코어가 플러그인을 지원합니다. Fabric과 Forge는 플러그인을 전혀 지원하지 않습니다 — 코어와 버전. 바닐라 코어에는
plugins폴더가 아예 없습니다. - 버전. 플러그인이 다른 게임 버전용으로 빌드되었습니다 — 호환성.
- 의존성. Vault, ProtocolLib, PlaceholderAPI — 이것들이 없으면 플러그인이 조용히 로드에 실패합니다: 로그에
Unknown dependency가 표시됩니다 — 누락된 의존성. - 설정 오류. 손상된 YAML — 플러그인이 시작할 때 스스로 비활성화됩니다 — 플러그인 설정.
- 손상된 파일. 다운로드가 중단되면
Invalid plugin.yml이 발생합니다 — 분석.
로그 확인
시작 후 첫 몇 초에 정확한 원인이 들어 있습니다. 플러그인 이름과 Could not load, Unknown dependency, Error occurred while enabling 문구를 검색하세요 — 로그.
플러그인은 로드되었지만 작동하지 않습니다
이건 다른 문제입니다: 권한(lp verbose on), 설정, 필요한 의존성이 있는지 확인하세요 — LuckPerms, 권한이 적용되지 않음.
카탈로그를 통한 설치
제어판 카탈로그는 설치 전에 호환성을 확인하고 의존성을 설치합니다 — 설치 방법. 수동 설치는 모든 것을 직접 확인해야 한다는 뜻입니다.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
