BungeeCord 플러그인 만드는 법

단계별 안내

1. 1.쓰고 있는 프록시 확인하기

   BungeeCord(또는 Waterfall 같은 포크)와 Velocity는 서로 다른 API예요. BungeeCord 플러그인은 Velocity에서 실행되지 않고, 그 반대도 마찬가지예요.

2. 2.프로젝트 설정하기

   bungeecord-api 의존성을 provided 스코프로 넣은 Maven 또는 Gradle 프로젝트. 실행할 때는 프록시가 제공해요.

3. 3.메인 클래스 작성

   net.md_5.bungee.api.plugin.Plugin을 상속하는 클래스. onEnable()에서 getProxy().getPluginManager()로 명령어와 리스너를 등록해요.

4. 4.bungee.yml에 정보 적기

   name, version, main, author. BungeeCord는 plugin.yml도 읽지만, bungee.yml을 쓰면 Spigot 플러그인과 헷갈리지 않아요. 명령어는 파일이 아니라 코드에서 등록해요.

5. 5.명령어와 리스너 작성

   명령어는 Command를 상속하고, 리스너는 Listener를 구현하며 PostLoginEvent나 ServerSwitchEvent 같은 이벤트용 @EventHandler 메서드를 가져요.

6. 6.필요하면 백엔드 서버와 통신하기

   프록시는 인벤토리나 월드를 볼 수 없어요. 그런 정보가 필요하면 각 백엔드 서버에 작은 보조 플러그인을 두고 프록시 플러그인과 플러그인 메시지를 주고받게 하세요.

7. 7.프록시에 설치하기

   .jar를 프록시의 plugins/ 폴더에 넣고, 백엔드 서버가 아니라 프록시를 재시작하세요.

유용한 프록시 이벤트

네트워크를 올바르게 설정하기

• 플레이어 이름과 UUID가 전달되도록 프록시의 config.yml에서 ip_forward를 켜고, 각 Spigot 또는 Paper 서버의 spigot.yml에서 bungeecord: true를 설정하세요.
• 백엔드 서버를 online-mode=false로 설정하고, 인터넷에서 직접 접속할 수 없고 프록시를 통해서만 접속되도록 하세요.
• 플러그인 메시지는 플레이어가 해당 백엔드 서버에 접속해 있을 때만 전달되므로, 아무도 없는 서버로 보낸 메시지는 도착하지 않아요.

설명 예시

"NetUtils라는 BungeeCord 1.21 프록시 플러그인. /lobby는 플레이어를 로비 서버로 보내요. /staffchat <message>(별칭 /sc)는 어느 서버에 있든 netutils.staff 권한이 있는 모두에게 메시지를 보내요. /maintenance on|off는 점검 MOTD를 표시하고 netutils.bypass 권한이 없는 플레이어를 내보내요. 스태프가 서버를 옮기면 스태프 채팅에 접속 메시지. 서버 이름, MOTD, 메시지는 config.yml에."

Codexe로 하기

BungeeCord/Velocity 유형을 고르고, 서로 다른 API이니 어떤 프록시를 쓰는지 적으세요. Codexe는 Maven으로 플러그인을 컴파일하고, 준비 완료 전에 .jar에 올바른 디스크립터가 있는지 확인해요. 요청에 버전이 없으면 BungeeCord API 1.21을 써요. 백엔드 보조 플러그인이 필요하면 별도의 Spigot/Paper 프로젝트로 요청하세요.

지금 체험하기는 아직 프록시 서버를 실행하지 않으니, 프록시 플러그인은 내 네트워크나 백엔드 서버 하나가 연결된 로컬 프록시에서 테스트하세요. BungeeCord 플러그인 생성기도 참고하세요.

질문