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

지금도 많은 네트워크가 BungeeCord나 Waterfall에서 운영됩니다. VPN을 차단하려고 Velocity로 옮길 필요는 없습니다. Kordon은 같은 파일로 설치하고 설정 방법도 같습니다.

업데이트: 2026-10-27

## 요약

- BungeeCord, Waterfall, 그리고 BungeeCord API 1.16 이상의 포크(FlameCord, XCord, Travertine 등)를 지원합니다.
- Java 21 이상이 필요합니다.
- `Kordon.jar`는 BungeeCord와 Velocity에서 같은 파일이므로 프록시 서버를 바꿔도 그대로 쓸 수 있습니다.
- 명령어 권한은 BungeeCord 자체의 `config.yml`에 넣거나 LuckPerms로 부여합니다.

## 필요한 것

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

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

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

## 설치

1. [계정을 만들고](https://panel.kordonlabs.com/register) 패널에 서버를 추가하세요.
2. 서버의 **플러그인** 페이지에서 `Kordon.jar`를 내려받으세요. 이 파일에는 서버 키가 이미 들어 있습니다.
3. 파일을 프록시 서버의 `config.yml`과 같은 위치에 있는 `plugins` 폴더에 넣으세요.
4. 프록시 서버를 다시 시작하세요.

콘솔에 연결 메시지가 출력되고, 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 인스턴스가 여러 개라면 각각에 같은 파일로 플러그인을 설치하세요. 프록시 서버는 ‘플러그인’ 섹션의 ‘프록시 서버’ 탭에 자동으로 나타납니다. 검사하는 프록시 서버의 수는 [요금제](https://kordonlabs.com/ko#pricing)에 따라 다릅니다. 한도를 넘는 프록시 서버는 Kordon이 처리하지 않으며, 패널에 그렇게 표시됩니다. 그런 프록시 서버의 플러그인은 ‘검사를 사용할 수 없을 때’ 설정을 따르며, 기본값으로는 플레이어의 접속을 허용하지 않습니다.

## Velocity로 이전

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

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

## 내 서버에서 사용해 보세요

관찰 모드로 시작하세요. Kordon이 누구를 막을지 보여 주고, 준비가 되면 보호를 켜면 됩니다. [계정 만들기](https://panel.kordonlabs.com/register)

## 다른 가이드

- [Minecraft 서버에서 VPN과 프록시를 차단하는 방법](https://kordonlabs.com/ko/guides/block-vpn-minecraft-server): 플레이어가 VPN과 프록시로 접속하는 이유, 이를 차단하는 여러 방법, 그리고 BungeeCord나 Velocity에 Kordon AntiVPN 플러그인을 설정하는 과정을 단계별로 설명합니다.
- [Velocity용 AntiVPN 및 안티봇 플러그인: Kordon 설정](https://kordonlabs.com/ko/guides/velocity-antivpn-plugin): Minecraft 1.8부터 26.x까지 지원하는 Kordon AntiVPN 및 안티봇 플러그인을 Velocity 3.4와 4.x에 설치하는 방법: Java, LuckPerms 권한, 명령어, 여러 프록시 서버.
- [Minecraft 서버에서 접속 버전을 제한하는 방법](https://kordonlabs.com/ko/guides/minecraft-client-version-filter): 원하는 클라이언트 버전만 Minecraft 서버에 들어오게 하는 방법: ViaVersion을 쓸 때 왜 필요한지, Kordon에서 범위를 설정하는 방법, Bedrock 플레이어는 어떻게 되는지 알아봅니다.