# Velocity용 AntiVPN 및 안티봇 플러그인: Kordon 설정

VPN을 막기에 가장 쉬운 곳은 프록시 서버입니다. 모든 플레이어가 이곳을 지나가고, 그 뒤의 Paper 서버는 건드리지 않아도 됩니다. 아래에서 파일 다운로드부터 관리자에게 권한을 주는 단계까지 Velocity에서 Kordon을 설정하는 전체 과정을 설명합니다.

업데이트: 2026-10-27

## 요약

- Kordon은 4.x 브랜치를 포함한 Velocity 3.4 이상에서 동작하며, Java 21 이상이 필요합니다.
- 플러그인은 프록시 서버에만 설치합니다. 그 뒤의 서버에는 아무것도 설치하지 않습니다.
- 설정 파일은 없습니다. 모든 설정은 패널에서 하고, 프록시 서버에는 서버 키만 저장됩니다.
- 권한 플러그인이 없으면 Velocity는 플레이어에게 아무 권한도 주지 않으므로, `/kordon` 명령어 권한은 LuckPerms로 부여합니다.
- 프록시 서버가 여러 대라면 각 프록시 서버에 플러그인을 설치하세요. Kordon이 몇 대를 검사하는지는 요금제에 따라 다릅니다.

## 필요한 것

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

Velocity 3.4 이상이 필요하며 4.x 브랜치에서도 동작합니다. Java는 21 이상이어야 합니다. Velocity 4 자체가 Java 25를 요구하므로, 프록시 서버가 시작된다면 Kordon도 시작됩니다.

설치한 뒤 콘솔에 `UnsupportedClassVersionError`가 표시되면 프록시 서버가 오래된 Java 버전에서 실행 중이므로 Java를 업데이트해야 합니다.

Kordon은 Geyser와 Floodgate를 통해 접속하는 Bedrock 플레이어를 자동으로 알아봅니다. 이들을 위해 따로 설정할 것은 없습니다.

## 설치

1. [계정을 만들고](https://panel.kordonlabs.com/register) 패널에서 서버를 추가하세요.
2. 서버의 **플러그인** 페이지를 열고 `Kordon.jar`를 내려받으세요. 이 파일에는 서버 키가 이미 들어 있습니다.
3. 파일을 `velocity.toml` 옆의 `plugins` 폴더에 넣으세요.
4. Velocity를 완전히 다시 시작하고 콘솔을 확인하세요.

플러그인이 연결되면 콘솔에 서버 이름, 모드, Kordon에 연결할 수 없을 때의 동작이 담긴 줄이 출력됩니다. 새 서버는 관찰 모드로 시작합니다.

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

1분 정도 지나면 패널에 ‘플러그인 온라인’이 표시됩니다.

SpigotMC나 Hangar에서 범용 `Kordon.jar`를 내려받았다면 파일 안에 키가 없습니다. 프록시 서버 콘솔에서 명령어로 연결하세요. 키는 같은 **플러그인** 페이지에 있으며, 다시 시작할 필요는 없습니다.

```
/kordon link <key>
```

> `plugins` 폴더에 Kordon 파일을 두 개(예: 이전 버전과 새 버전) 두지 마세요. 서로 충돌하며, 시작할 때 콘솔에 경고가 표시됩니다.

## 권한과 명령어

Velocity는 권한 플러그인(보통 LuckPerms)을 설치하기 전까지 플레이어에게 아무 권한도 주지 않습니다. 관리자가 Kordon 명령어를 쓰려면 `kordon.command`와 필요한 명령어의 권한을 함께 주세요.

```
/lpv user Steve permission set kordon.command true
/lpv user Steve permission set kordon.command.whitelist true
/lpv user Steve permission set kordon.command.lookup true
/lpv user Steve permission set kordon.notify true
```

명령어가 하는 일:

- `/kordon status`는 Kordon 연결 상태, 보호 모드, 접속 중인 플레이어 수를 보여 줍니다.
- `/kordon lookup <nickname>`은 Kordon이 플레이어에 대해 알고 있는 정보를 보여 줍니다. IP를 보고 검색하려면 관리자에게 `kordon.command.lookup.ip`도 필요합니다.
- `/kordon whitelist add`와 `/kordon blacklist add`는 닉네임, IP 또는 대역을 목록에 추가하며, 원하면 `1d`, `7d`, `30d`, `never` 기간을 정할 수 있습니다.
- `kordon.notify` 권한이 있으면 채팅에서 Kordon의 관리자 알림을 받습니다.

`kordon.command`에는 `/kordon link`가 포함되지 않습니다. 이 명령어는 소유자만 쓰도록 두세요. 프록시 서버 콘솔에서는 모든 명령어를 실행할 수 있습니다. Velocity에서는 채팅의 `/kordon` 자동 완성이 모든 플레이어에게 보이지만, 권한이 없으면 명령어가 실행되지 않습니다. 게임 내 명령어를 아예 쓰지 않으려면 패널의 ‘플러그인’ 섹션에 있는 ‘게임 내 명령어’에서 끄세요. 이 스위치를 끄면 콘솔의 목록 및 조회 명령어도 꺼집니다.

## 프록시 서버가 여러 대일 때

대규모 네트워크는 로드 밸런서 뒤에 Velocity 인스턴스를 여러 대 둡니다. 각 프록시 서버에 같은 파일과 같은 키로 플러그인을 설치하세요. 프록시 서버는 패널의 ‘플러그인’ 섹션, ‘프록시 서버’ 탭에 각각 자동으로 나타납니다. 7일 동안 신호를 보내지 않은 프록시 서버는 목록에서 사라집니다.

Kordon이 몇 대의 프록시 서버를 검사하는지는 [요금제](https://kordonlabs.com/ko#pricing)에 따라 다릅니다. 무료 요금제는 한 대, 상위 요금제는 더 많습니다. 한도를 넘은 프록시 서버는 패널에 표시되며 Kordon이 처리하지 않습니다. 그 프록시 서버의 플러그인은 ‘검사를 사용할 수 없을 때’ 설정에 따라 플레이어의 접속을 허용하거나 막으며, 기본적으로는 허용하지 않습니다. 어떤 프록시 서버를 한도에 포함할지는 직접 고릅니다.

## Kordon에 연결할 수 없을 때

플러그인은 Kordon의 응답을 최대 3초 동안 기다립니다. 응답이 오지 않을 때의 동작은 ‘검사를 사용할 수 없을 때’ 설정으로 정합니다. 기본적으로 검사하지 못한 플레이어는 접속할 수 없습니다. ‘모두 접속 허용’으로 바꿀 수도 있습니다. 이미 게임 중인 플레이어에게는 영향이 없습니다. 예외가 하나 있습니다. 프록시 서버가 시작된 직후 Kordon이 한 번 응답하기 전까지는 플러그인이 모든 플레이어의 접속을 허용합니다.

## 자주 보는 콘솔 메시지

- `Kordon is not linked to a server`: 키가 없어서 플레이어가 검사 없이 접속합니다. `/kordon link <key>`로 플러그인을 연결하거나 내 서버의 **플러그인** 페이지에서 파일을 내려받으세요.
- `The Kordon panel does not accept this server's key`: 키가 다시 발급되었거나 서버가 삭제되었습니다. 패널에서 새 키를 받으세요.
- `Kordon did not answer`: Kordon이 3초 안에 응답하지 않았습니다. 해당 플레이어는 ‘검사를 사용할 수 없을 때’ 설정에 따라 처리되었습니다.
- `Kordon.jar was replaced while the proxy was running`: 실행 중인 프록시 서버에서 파일이 교체되었습니다. 다시 시작하세요.
- `A new Kordon version ... is available`: 새 버전이 나왔습니다. 패널에서 내려받으세요.

다음으로 보호 수준을 고르고, 관찰 모드에서 Kordon이 누구를 막았을지 확인하세요. [VPN과 프록시를 차단하는 방법](https://kordonlabs.com/ko/guides/block-vpn-minecraft-server) 가이드에서 이 내용을 다룹니다.

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

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

## 다른 가이드

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