ProxyTracer LogoProxyTracer
Skip to Content
Documentationプラットフォーム & CMSMinecraft サーバー

Minecraftサーバー（Paper、Velocity、BungeeCord）

ゲームサーバーに参加する前に、VPN やプロキシ接続を確実にブロック。

ProxyTracer は、参加プレイヤーの IP を高精度な ProxyTracer API と照合し、悪意ある接続を ブロック、警告、または ログ記録 します。BAN 回避、不正なサブアカウント、VPN を利用したボットレイドの対策に最適です。

プレビュー

ゲーム内キック画面プレビューコンソール警告アラートプレビュー
Minecraft Kick ScreenConsole Warning Log

ProxyTracer を選ぶ理由

  • リアルタイム検出: 常に最新の状態に保たれる ProxyTracer の住宅用およびパブリック VPN データベースに対する高精度チェック。
  • マルチプラットフォーム対応: 単一サーバー（Paper/Spigot）およびプロキシネットワーク（Velocity または BungeeCord/Waterfall）向けの専用プラグインを提供。
  • 高速パフォーマンス: 組み込みのインメモリキャッシュにより API クレジットを節約し、再参加するプレイヤーの接続遅延をゼロに抑えます。
  • スマートホワイトリスト: 信頼できるプレイヤー名やネットワーク IP を除外するホワイトリストコマンドを完備。
  • Discord 通知連携: ブロックされた VPN 参加ログを管理者 Discord チャンネルに直接送信可能。
  • カスタムキック画面: proxytracer.com を引用した、わかりやすく洗練されたブロックメッセージをプレイヤーに表示。

どの jar ファイルをインストールすべきですか？

サーバー環境インストールする jar ファイル配置先ディレクトリ操作
単一 Paper / Spigot / Purpur サーバーproxytracer-bukkit-1.4.0.jarゲームサーバーの plugins/ ダウンロード
Velocity プロキシネットワークproxytracer-velocity-1.4.0.jarプロキシサーバーの plugins/（Paper 側には配置しないでください） ダウンロード
BungeeCord / Waterfall ネットワークproxytracer-bungee-1.4.0.jarプロキシサーバーの plugins/（Paper 側には配置しないでください） ダウンロード
重要なルール: ProxyTracer は 実際のクライアント IP が見える場所 にインストールしてください。プロキシネットワーク（Velocity または BungeeCord）を運用している場合は、プロキシサーバー上のみ にインストールしてください。Bukkit/Paper サーバーとプロキシサーバーの両方でブロックモードを実行しないでください（二重課金や冗長なチェックの原因となります）。

クイックセットアップ（60秒）

  1. ProxyTracer.com/dashboard で無料の API キーを取得します。
  2. Releases から環境に合った適切な jar ファイルをダウンロードします。
  3. サーバーの plugins/ ディレクトリに jar ファイルを配置し、サーバーを一度起動します。
  4. ゲーム内またはサーバーコンソールから直接 API キーを設定します: 
    /proxytracer set your_api_key_here
    (このコマンドにより、設定ファイル config.yml にキーが自動保存され、プラグインがリロードされます)
  5. /proxytracer status を実行して接続を確認します。

主要な設定項目

mode: "block"          # プロキシ検出時のアクション: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # APIがオフラインになった場合のフェイルオープンポリシー: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # スタッフに色付きのゲーム内チャットメッセージを送信 (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # IPチェックの結果を24時間キャッシュ
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

コマンドと権限

すべてのコマンドは /proxytracer プレフィックスで始まります:

  • /proxytracer notify <on|off|toggle> — 管理スタッフ向けの色付きゲーム内チャット通知のオン/オフを切り替えます。
  • /proxytracer notify add|remove|list [player] — ゲーム内通知の受信を許可するスタッフのユーザー名を追加/削除/一覧表示します（config.yml に自動保存）。
  • /proxytracer set <api_key> — API キーを直接設定し、config.yml に保存して再読み込みします。
  • /proxytracer status — 設定ステータス、API 認証情報、ゲーム内通知の状態を確認します。
  • /proxytracer check <ip> — 指定した IP アドレスを手動で照会します。
  • /proxytracer cache clear — ローカル IP キャッシュをクリアします。
  • /proxytracer reload — 設定ファイルを再読み込みします。
  • /proxytracer whitelist name add|remove|list [player] — 特定のプレイヤーを検出から除外します。
  • /proxytracer whitelist ip add|remove|list [ip] — 特定のネットワーク IP を検出から除外します。

権限ノード一覧:

  • proxytracer.admin — リロード、ステータス確認、管理者コマンドへのアクセス権限。
  • proxytracer.bypass — この権限を持つプレイヤーは、ログイン時のプロキシチェックをバイパスします。
  • proxytracer.notify — VPN ユーザーが検出された際、スタッフ向けゲーム内警告通知を受信する権限。

(注: デフォルトでは、これらの権限はサーバーオペレーター（OP）にのみ割り当てられます。他のプレイヤーやモデレーターグループに付与する場合は、LuckPerms などの権限管理プラグインを使用してください)

互換性と動作要件

  • Java バージョン: Java 17 以降（Java 17、21、22 で完全テスト済み）。本プラグインは Java 17 をターゲットとしてコンパイルされています。
  • 対応サーバーソフトウェア: Paper / Spigot / Purpur（1.13 〜 1.21.x）、Velocity（3.x）、BungeeCord / Waterfall（最新ビルド）。
  • API アクセス: proxytracer.com で登録された無料または有料の API キー。

トラブルシューティング: 実際のIPアドレスに関する問題 (127.0.0.1)

参加するすべてのプレイヤーが 127.0.0.1 から接続しているとログに記録される場合、ProxyTracer API は正確なスキャンを行えません。これは、ホスティングのネットワーク構成またはフロントエンドプロキシがプレイヤーの実際の IP をマスクしていることを示しています。

解決手順:

  1. プロキシネットワーク（Velocity / BungeeCord）の場合: ProxyTracer は ゲートウェイプロキシ上のみ（Velocity/Bungee）に導入してください。バックエンドのゲームサーバーが実際の IP を受信できるよう、プレイヤー情報転送が有効になっていることを確認してください（velocity.toml の player-info-forwarding-mode = "modern"、または BungeeCord の config.yml の ip_forward: true）。
  2. 共有ホスト（TickHosting パネルプロキシ等）の場合: ホストが Proxy Protocol 経由で接続ヘッダーを転送している場合は、Paper の設定（config/paper-global.yml 内の proxies.proxy-protocol: true）で有効化してサーバーを再起動してください。警告: ホストが明示的に Proxy Protocol をサポートしていない限り、この設定を有効にしないでください。誤って有効にすると、すべてのプレイヤーが参加できなくなります。

料金とAPI利用枠

ProxyTracer Minecraft プラグインは 100% 無料です。検出機能の利用には ProxyTracer API への接続が必要です:

- 無料プラン: 月間 100 回チェック（小規模 SMP や開発テスト向け）
- Starter（€3/月）: 成長中の公開サーバーに最適
- Pro（€9/月） / Scale（€39/月）: 大規模ネットワーク向け

API キーを作成してプランを選択: ProxyTracer

最終更新日:
Flarum