Minecraft 플러그인 설치하는 법

단계별 안내

1. 1.서버가 플러그인을 실행할 수 있는지 확인하기

   플러그인에는 Bukkit 기반 서버 소프트웨어가 필요해요. 게임 서버는 Paper, Spigot, Purpur, Folia, 프록시는 BungeeCord나 Velocity. 바닐라 서버나 Fabric, Forge 서버는 플러그인을 불러오지 않아요.

2. 2.플러그인 버전 확인하기

   플러그인 페이지나 파일에 지원하는 Minecraft 버전이 적혀 있어요. 서버보다 새 버전용으로 빌드된 플러그인은 보통 로드를 거부해요.

3. 3.서버를 멈추고 .jar 복사하기

   .jar 파일을 서버 .jar 옆의 plugins/ 폴더에 넣으세요. 호스팅 패널이라면 파일 관리자나 SFTP로 업로드하세요. 압축을 풀지 마세요.

4. 4.의존성 설치하기

   플러그인에 다른 플러그인(Vault, PlaceholderAPI, ProtocolLib, LuckPerms)이 필요하면 그 .jar 파일도 plugins/에 넣으세요.

5. 5.서버를 시작하고 콘솔 읽기

   시작 로그에서 플러그인 이름을 찾으세요. "Enabling <Plugin>" 뒤에 오류가 없으면 로드된 거예요.

6. 6.게임 안에서 확인하고 설정하기

   /plugins를 실행하세요. 로드된 플러그인은 초록색, 활성화에 실패한 플러그인은 빨간색이에요. 설정은 plugins/<PluginName>/config.yml에 생기니, 수정하고 재시작하세요.

파일이 들어가는 곳

플러그인을 넣고 처음 시작한 뒤의 일반적인 서버 폴더는 이렇게 생겼어요:

• paper.jar(또는 spigot.jar): 서버 자체.
• plugins/MyPlugin.jar: 추가한 플러그인.
• plugins/MyPlugin/: 플러그인이 만드는 폴더. config.yml, 메시지, 저장된 데이터가 들어 있어요.
• logs/latest.log: 현재 실행의 로그. 로드 오류가 여기에 기록돼요.

/reload 말고 재시작하기

/reload는 서버를 재시작하지 않고 모든 플러그인을 내렸다가 다시 불러와요. 많은 플러그인이 이를 지원하지 않아서 리스너가 두 번 등록되거나, 데이터가 사라지거나, 메모리 누수가 생겨요. 플러그인을 추가, 제거, 업데이트한 뒤에는 항상 서버를 재시작하세요. 일부 플러그인에는 설정만 다시 불러오는 자체 명령어(예: /myplugin reload)가 있는데, 그건 써도 안전해요.

실제 서버에 설치하기 전에

• 서버 폴더를, 적어도 plugins/와 월드는 백업하세요.
• 먼저 사본에서 체험하기: 실제 서버와 같은 소프트웨어, 버전, 다른 플러그인. 플러그인 테스트하는 법을 참고하세요.
• 한 번에 플러그인 하나씩: 뭔가 망가지면 어느 플러그인 때문인지 알 수 있어요.
• 재업로드된 곳이 아니라 제작자 페이지에서 다운로드하세요(SpigotMC, Hangar, Modrinth, GitHub).

Codexe로 만든 플러그인

Codexe에서 만든 플러그인은 프로젝트 이름이 붙은 빌드된 .jar로 제공되고, 받기 전에 확인을 거쳐요. 컴파일된 클래스와 plugin.yml이 들어 있어야 하거든요. 어디에 설치하기 전에 비공개 테스트 서버에서 체험할 수 있고, 모든 플랜에서 무료예요. 테스트 서버는 의존성으로 나열된 플러그인을 대신 설치해 줘요. 내 서버용 .jar를 다운로드하려면 플랜이나 다운로드 팩이 필요해요.

질문