BungeeCord VPN 차단·안티봇 플러그인 1.8–26.x

필요한 것

Minecraft 서버용 Kordon 안티 VPN 플러그인은 1.8부터 최신 릴리스까지 프록시 서버가 받아들이는 모든 클라이언트 버전에서 작동합니다. VPN 검사 외에도 공격 모드로 한꺼번에 몰려드는 봇으로부터 프록시 서버를 보호하며, 공격 모드는 모든 요금제에서 사용할 수 있습니다.

API 1.16 이상의 BungeeCord, Waterfall 또는 BungeeCord 포크와 Java 21 이상이 필요합니다. 프록시 서버가 더 오래된 Java에서 실행되면 시작할 때 콘솔에 UnsupportedClassVersionError가 표시됩니다.

Kordon은 프록시 서버에만 설치합니다. 그 뒤에 있는 Spigot이나 Paper 서버에는 아무것도 필요 없습니다. 플러그인은 Geyser와 Floodgate로 접속한 Bedrock 플레이어를 자동으로 인식합니다.

설치

계정을 만들고 패널에 서버를 추가하세요.
서버의 플러그인 페이지에서 Kordon.jar를 내려받으세요. 이 파일에는 서버 키가 이미 들어 있습니다.
파일을 프록시 서버의 config.yml과 같은 위치에 있는 plugins 폴더에 넣으세요.
프록시 서버를 다시 시작하세요.

콘솔에 연결 메시지가 출력되고, 1분 안에 패널에 ‘플러그인 온라인’이 표시됩니다:

Kordon connected to server "My Server". Mode: monitoring only. If Kordon is unavailable: let nobody in.

SpigotMC나 Hangar에서 받은 일반 Kordon.jar는 프록시 서버 콘솔에서 명령어로 연결하며, 다시 시작할 필요가 없습니다:

/kordon link <key>

서버 키는 비밀번호와 같습니다. 파일이나 키가 다른 사람 손에 들어가면 패널에서 새 키를 발급하세요. 기존 키는 바로 무효가 됩니다.

명령어 권한

LuckPerms가 없으면 권한은 BungeeCord의 config.yml에서 설정합니다. groups 섹션은 플레이어를 그룹에 넣고, permissions 섹션은 각 그룹이 할 수 있는 일을 나열합니다.

groups:
  Steve:
  - moderator
permissions:
  moderator:
  - kordon.command
  - kordon.command.whitelist
  - kordon.command.lookup
  - kordon.notify

LuckPerms를 쓴다면 같은 작업을 명령어로 합니다:

/lpb user Steve permission set kordon.command true

명령어마다 따로 권한이 있습니다: kordon.command.whitelist, kordon.command.blacklist, kordon.command.lookup, kordon.command.reload. kordon.notify 권한은 채팅으로 받는 Kordon 관리자 알림을 켭니다. /kordon link는 일반 권한에 포함되지 않으며, 소유자에게만 맡기는 것이 좋습니다. 긴 명령어에는 짧은 형태가 있습니다: /kordon wl, /kordon bl.

여러 프록시 서버

네트워크에 BungeeCord 인스턴스가 여러 개라면 각각에 같은 파일로 플러그인을 설치하세요. 프록시 서버는 ‘플러그인’ 섹션의 ‘프록시 서버’ 탭에 자동으로 나타납니다. 검사하는 프록시 서버의 수는 요금제에 따라 다릅니다. 한도를 넘는 프록시 서버는 Kordon이 처리하지 않으며, 패널에 그렇게 표시됩니다. 그런 프록시 서버의 플러그인은 ‘검사를 사용할 수 없을 때’ 설정을 따르며, 기본값으로는 플레이어의 접속을 허용하지 않습니다.

Velocity로 이전

PaperMC는 더 이상 Waterfall을 개발하지 않으며 Velocity로 옮기기를 권장합니다. 이전할 때 Kordon 쪽에서는 바꿀 것이 없습니다. 같은 Kordon.jar를 새 프록시 서버의 plugins 폴더에 넣으세요. 모든 설정, 목록, 접속 기록은 패널에 저장되어 있으므로 그대로 남습니다.

플러그인을 명령어로 연결했다면 키 파일이 있는 plugins/Kordon 폴더도 복사하거나, 새 프록시 서버에서 /kordon link를 다시 실행하세요. 두 프록시 서버가 모두 실행되는 동안에는 각각이 요금제 한도에 포함됩니다. 프록시 서버가 하나인 요금제에서는 두 번째 프록시 서버가 한도를 넘게 되므로, 플레이어를 옮기기 전에 기존 프록시 서버를 끄거나 패널에서 어느 프록시 서버를 셀지 선택하세요. Velocity의 권한 설정은 Velocity 가이드를 참고하세요.

BungeeCord와 Waterfall용 AntiVPN·안티봇: Kordon 설치

요약