Minecraftプラグイン SimpleTpa

🔌 SimpleTPA について

SimpleTPA は、サーバー向けにシンプルなテレポートリクエスト（TPA）システムを提供する Minecraft プラグインです。プレイヤーが他のプレイヤーにテレポート要求を送信し、受信した要求を承認または拒否し、送信中の要求をキャンセルし、トグルで受信要求をブロックできるようにします。このプラグインは、ゲーム内のテレポート要求とサーバー側の設定のための、コンパクトで設定可能なワークフローに重点を置いています。

🎯 目的

SimpleTPA は、マルチプレイヤーサーバーで必要とされる、プレイヤー間の制御されたテレポートを解決します。クールダウンと未処理リクエストは1件 בלבדというルールでスパムを防ぎ、テレポート前のウォームアップ/遅延をサポートし、タイムアウト、サウンド、ログ記録の動作をサーバー管理者が設定できるようにします。

⚙️ 機能

• /tpa によるプレイヤー間のテレポート要求と、/tpahere による逆方向の要求。
• 要求の承認、拒否、キャンセルの操作（/tpaccept、/tpdeny、/tpacancel）。
• /tpatoggle で受信をオン/オフ切り替え。
• 設定可能な要求タイムアウト（デフォルトは 60 秒）。
• スパムを減らすための送信間クールダウンを設定可能。
• アクションバーのカウントダウン付きテレポートウォームアップ/遅延と、移動またはダメージ時のキャンセル。
• 1人のプレイヤーにつき保留中の要求は1件のみで、重複を防止。
• 要求、承認、拒否、成功したテレポートのサウンド効果をカスタマイズ可能。
• メッセージのカラーコード完全対応と、管理者向けの詳細なログオプション。

🧩 対象

• 軽量な TPA システムを求める小規模〜中規模の Survival/SMP サーバー。
• 大規模なテレポート機能一式よりも、最小限で設定可能なテレポート要求の動作を好むサーバー。
• クールダウン、ウォームアップ、ログのサーバー別設定を求める管理者。

🏗️ 使用例

• プレイヤーが /tpa で友達へのテレポートを要求し、友達が /tpaccept で承認すると、プラグインはテレポート前に設定されたウォームアップを適用します。
• サーバースタッフは、イベントや運営作業中にランダムなテレポート要求をブロックするため、スタッフメンバー向けに /tpatoggle を有効にします。
• 管理者は、プレイヤーがテレポート要求を連打しないようにクールダウンを設定します。

⌨️ コマンド

🔐 権限

⚙️ インストール

📥 セットアップ

• プラグインの公式リソースページから JAR をダウンロードします。
• ダウンロードした .jar を Spigot サーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動し、プラグインの読み込みメッセージをコンソールで確認します。

📦 依存関係

• 必須の依存関係は記載されていません。

🧾 設定

• このプラグインは設定ファイルを使用します（プラグインリソース上では config.yml と記載）。メジャーバージョンをまたいでアップグレードする際は、新しいデフォルトキーを適用するために、再起動前に既存の config.yml を削除することが推奨されています。
• 露出されている設定項目には、要求タイムアウト、クールダウン、テレポートウォームアップ、移動/ダメージによるキャンセル、サウンド設定、メッセージのカラーコード、ログオプションが含まれます。

🧠 技術メモ

• サポートが確認されている Minecraft バージョン（プラグインリソースに記載）：1.19、1.20、1.20.6、1.21。
• 確認済みプラットフォーム: Spigot。
• このプラグインはサーバー側でタイムアウト、クールダウン、ウォームアップの仕組みを実装し、期限切れの要求を自動でクリーンアップします。

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

SimpleTPA は、完全なテレポート/ホーム機能一式を追加せずに、特化した設定可能なテレポート要求システムが必要なときに役立ちます。シンプルな /tpa の流れ、スパム防止のためのクールダウン、より安全なテレポートのためのウォームアップ動作を求めるサーバーに適しています。