Minecraftプラグイン Tebex

🔌 Tebexについて

Tebexは、稼働中のサーバーをTebexのウェブストアに接続し、オンライン購入をゲーム内に自動配布できるMinecraftプラグインです。公式の Tebex Plugin API を実装しており、対応サーバープラットフォーム向けにストア購入（アイテム、ランク、コマンド、サブスクリプション）のサーバー側処理を提供します。

🎯 目的

Tebexの主な目的は、Tebexウェブストアで作成された購入の配布を自動化することです。サーバー管理者はこのプラグインを使ってゲームサーバーをストアに接続し、購入が処理されたときに設定済みのサーバーコマンドを実行し、プレイヤーに購入リンクやストア関連情報をゲーム内で提供します。

⚙️ 機能

• 自動注文処理: プラグインはTebexを定期的に確認し、プレイヤーがオンラインのときに設定済みのサーバーコマンドを実行して購入を配布します。
• シークレットキーによるストア接続: サーバー側のシークレットキーコマンドを使って、サーバーをストアに接続できます。
• checkout とストア情報のためのゲーム内コマンドで、支払いリンクの作成やストアデータの確認ができます。
• リンク送信、強制チェック、パッケージデータ更新、デバッグログ有効化のための管理者向け・デバッグ用コマンド。
• 一般的なサーバープラットフォーム向けの公式ビルドによる複数プラットフォーム対応。

🧩 対象ユーザー

• Tebexウェブストアでアイテム、ランク、サブスクリプションを販売しているサーバー管理者。
• Bukkit/Spigot/Paper およびその他の対応プラットフォームで、オンライン購入の自動処理が必要な管理者。
• ウェブストアとゲームサーバーの間に、保守された公式連携を求めるネットワーク運営者。

🏗️ 使用例

• あるサーバーがTebexストアで見た目用アイテムを販売し、プレイヤーが次に参加したときにプラグインが自動でアイテムを付与する。
• 管理者がゲーム内コマンドで支援者向けの支払いリンクを生成し、プレイヤーに送る。
• ストア購入によってコマンドが実行され、プレイヤーを権限グループに追加したり、期間限定サブスクリプションを付与したりする。

⌨️ コマンド

🔐 権限

すべてのコマンドは、文書化されているコマンド名と完全に一致する権限ノードを使用します。デフォルト値は公式ドキュメントには記載されていません。

⚙️ インストール

📥 セットアップ

• サーバープラットフォーム用の公式プラグインビルドをダウンロードします。
• プラグインのJARをサーバーの plugins/ ディレクトリ（対応するmod環境では mods/）に配置します。
• サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。
• サーバー管理者として、シークレットキーコマンドを実行してサーバーをストアに接続します。

📦 依存関係

• 公式のインストール手順には、実行時の依存関係は記載されていません。プロジェクトのビルドには Java 開発環境が必要です。

🧠 技術メモ

• 公式ビルドは複数のサーバープラットフォーム向けに提供されており、プロジェクトは Tebex チームによって保守されています。
• プラグインは Tebex サービスを定期的に確認し、設定済みのサーバーコマンドを実行して、サーバープラットフォーム上で購入を処理します。
• リポジトリと公式ビルドは GPL-3.0 でライセンスされています。

🤝 このプラグインが役立つ場面

Tebexウェブストアを運営していて、アイテム、ランク、またはコマンドの購入を信頼性の高い公式なサーバー側処理で行いたい場合、Tebexプラグインはサーバーをストアに接続し、独自スクリプトなしで配布を自動化するための連携とゲーム内ツールを提供します。