# Velocity向けAntiVPN・ボット対策プラグイン：Kordonの導入

VPN対策を入れるのに最も簡単な場所はプロキシサーバーです。すべてのプレイヤーがそこを通り、背後のPaperサーバーには手を加えずに済みます。以下では、ファイルのダウンロードからモデレーターへの権限付与まで、VelocityでのKordonの導入手順をすべて説明します。

更新日: 2026-10-27

## 要点

- KordonはVelocity 3.4以降（4.x系を含む）で動作します。Java 21以降が必要です。
- プラグインはプロキシサーバーにだけ入れます。背後のサーバーには何もインストールしません。
- 設定ファイルはありません。すべてパネルで設定し、プロキシサーバーにはサーバーキーだけが保存されます。
- 権限プラグインがないと、Velocityはプレイヤーに一切の権限を与えないため、`/kordon`コマンドの権限はLuckPermsで付与します。
- プロキシサーバーが複数ある場合は、それぞれにプラグインを入れます。Kordonがそのうち何台をチェックするかはプランによって異なります。

## 必要なもの

[Minecraft向けKordon AntiVPNプラグイン](https://kordonlabs.com/ja)は、プロキシサーバーが受け付けるすべてのクライアントのバージョン（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分ほどで、パネルに「プラグインはオンラインです」と表示されます。

汎用の`Kordon.jar`をSpigotMCやHangarからダウンロードした場合、中にキーは入っていません。プロキシサーバーのコンソールでコマンドを実行して連携してください。キーは同じ**プラグイン**ページにあり、再起動は不要です。

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

> `plugins`フォルダーにKordonのファイルを2つ（たとえば古いバージョンと新しいバージョン）置かないでください。競合が起き、起動時にコンソールで警告が表示されます。

## 権限とコマンド

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/ja#pricing)によって異なります。無料プランでは1台、上位プランではそれ以上です。上限を超えたプロキシサーバーにはパネルで印が付き、Kordonはそのプロキシサーバーのチェックを行いません。そのプロキシサーバーのプラグインは「チェックできない場合」の設定に従ってプレイヤーの入室を許可するかどうかを決め、初期設定では許可しません。どのプロキシサーバーを数えるかは自分で選べます。

## Kordonが利用できない場合

プラグインはKordonの応答を最大3秒待ちます。応答がないときの動作は「チェックできない場合」の設定で決まります。初期設定では、チェックできなかったプレイヤーは入れません。「全員を許可」に切り替えることもできます。すでにゲーム内にいるプレイヤーには影響しません。例外が1つあります。プロキシサーバーの起動直後、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/ja/guides/block-vpn-minecraft-server)のガイドで説明しています。

## 自分のサーバーで試す

監視モードで始めましょう。Kordonがブロックする相手を表示するので、準備ができたら保護をオンにできます。 [アカウントを作成](https://panel.kordonlabs.com/register)

## ほかのガイド

- [MinecraftサーバーでVPN・プロキシをブロックする方法](https://kordonlabs.com/ja/guides/block-vpn-minecraft-server): プレイヤーがVPNやプロキシ経由で接続する理由、どんなブロック方法があるか、BungeeCordやVelocityへのKordon AntiVPNプラグインの導入手順を1つずつ解説します。
- [BungeeCord・Waterfall向けのAntiVPNとアンチボット：Kordonの導入方法](https://kordonlabs.com/ja/guides/bungeecord-antivpn-plugin): BungeeCord、Waterfall、各フォークへのKordon AntiVPN・アンチボットプラグインの導入方法：動作要件、権限、コマンド、Velocityへの移行。
- [Minecraftサーバーで参加できるバージョンを制限する方法](https://kordonlabs.com/ja/guides/minecraft-client-version-filter): Minecraftサーバーに必要なクライアントのバージョンだけを入れる方法です。ViaVersionを使う場合に必要な理由、Kordonでの範囲の設定、Bedrockプレイヤーの扱いを説明します。
