Minecraft Servers HQ

Minecraftプラグイン PlaceholderAPI

PlaceholderAPI と確認されたサーバーの情報

SpigotPaperAPIAdmin ToolsPermissionsUtilityChatIntegrationDeveloper API

🔌 PlaceholderAPI について

PlaceholderAPI は、中央集約型のプレースホルダーシステムと拡張エコシステム（eCloud）を提供する Minecraft プラグインです。これにより、ほかのプラグインは、直接の連携や強い依存関係を必要とせずに、何千もの動的なプレースホルダー（プレイヤーデータ、経済値、プラグイン固有の値など）を読み取り、置き換えられます。

🎯 目的

このプラグインは、1つの拡張可能なプレースホルダー API を提供することで、プラグイン間の連携のしづらさを解消します。プラグイン作者は、名前付きプレースホルダーを提供する拡張を公開し、サーバー管理者はそれらを導入して、サーバー側のプラグイン（scoreboards、chat、holograms、GUI）が一貫した構文でライブデータを表示できるようにします。

⚙️ 特徴

  • 他のプラグインが利用できる、基本のプレースホルダー解析 API。
  • 拡張システム：個別に配布される拡張、またはプラグインに同梱された拡張。
  • eCloud（拡張クラウド）で、ゲーム内から検証済みの拡張を探してダウンロード可能。
  • 実行中に拡張を一覧表示、登録、解除、再読み込みする管理コマンド。
  • 1人のプレイヤー向けにプレースホルダーを評価したり、結果を全体に送信したりできるデバッグ/解析コマンド。トラブルシューティングに便利です。
  • サポート依頼時に、インストール済みの拡張やプラグインの状態を共有できる dump コマンドなどのユーティリティ。

🧩 対象ユーザー

  • 複数のプラグイン間で統一された動的テキストが必要なサーバー管理者（scoreboards、tablists、holograms、GUIs）。
  • 強い依存関係を強いずに、プレースホルダーを公開・利用したいプラグイン開発者。
  • 多くのプラグインを組み合わせ、一貫したプレースホルダー構文が必要な Survival、ミニゲーム、ネットワークサーバー。

🏗️ 使用例

  • サーバーに Vault 拡張を導入し、プレイヤーの所持金のような経済系プレースホルダーを scoreboard や chat のプラグインで使えるようにする。
  • 管理者が eCloud からプラグイン固有の拡張をダウンロードし、hologram プラグインで目標データをライブ表示できるようにする。
  • 開発者が PlaceholderExpansion を通じてプラグインデータを公開し、他のサーバーがそのプラグインに直接依存せずにデータを表示できるようにする。

⌨️ コマンド

コマンド説明権限アクセス
`/papi parse <playerme> `文字列内のプレースホルダーを解析し、デバッグ用に結果を表示します。未指定
`/papi bcparse <playerme> `プレースホルダーを解析し、結果を全プレイヤーに送信します。未指定
`/papi cmdparse <playerme> `プレースホルダーを解析し、結果のコマンドを実行します。未指定
/papi parserel <player1> <player2> <text>2人のプレイヤーを比較する関係プレースホルダーを解析します。未指定管理者
/papi list有効な/登録済みの拡張を一覧表示します。未指定管理者
/papi info <expansion>登録済み拡張の情報を表示します。未指定管理者
/papi register <filename>再起動せずに expansions フォルダ内の拡張 jar を登録します。未指定管理者
/papi unregister <filename>登録済みの拡張を登録解除/削除します。未指定管理者
/papi reloadPlaceholderAPI の設定を再読み込みし、新しくダウンロードされた拡張を登録します。未指定管理者
/papi versionプラグインのバージョンと作者を表示します。未指定管理者
/papi dumpサポート用にプラグイン/バージョン/拡張の情報を出力します（paste サービス）。未指定管理者
/papi ecloud download <expansion> [version]eCloud から検証済みの拡張をサーバーにダウンロードします。未指定管理者
`/papi ecloud list [allinstalled]`eCloud で利用可能な拡張、またはインストール済みの拡張を一覧表示します。
/papi ecloud placeholders <expansion>eCloud 拡張が提供するプレースホルダーを一覧表示します。未指定管理者
/papi ecloud statuseCloud サービスの接続状態を表示します。未指定管理者

(注: 上記のコマンドは、公式の PlaceholderAPI コマンドリファレンスに記載されています。個別コマンドの権限ノードは、参照先のコマンド文書には掲載されていません。)

⚙️ インストール

📥 セットアップ

  • 公式の PlaceholderAPI jar をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
  • サーバーを起動または再起動し、コンソールで PlaceholderAPI が読み込まれていることを確認します。
  • 拡張は、plugins/PlaceholderAPI/expansions/ に拡張 jar を置くか、ゲーム内の eCloud コマンドを使って導入します（検証済み拡張向け）。

📦 依存関係

  • PlaceholderAPI 自体は、動作に一般的なプラグイン依存関係を必要としません。拡張が提供する一部のプレースホルダーは、他のプラグインに依存します（たとえば、経済値を表示する拡張は対応する経済プラグインを必要とします）。これらの要件は拡張ごとに異なります。

🧠 技術メモ

  • PlaceholderAPI は Spigot 系サーバー向けに提供されており、Paper でも一般的に使用されています。プラグイン開発者が PlaceholderExpansions を登録できる API を公開しています。
  • 拡張は単体の jar ファイルとして配布することも、ほかのプラグインに同梱することもできます。単体拡張は通常 plugins/PlaceholderAPI/expansions/ にインストールします。
  • eCloud 機能により、ゲーム内で検証済み拡張の検索とダウンロードができます。eCloud のダウンロードを機能させるには、サーバーが外向き HTTPS を許可している必要があります。
  • このプラグインには、プレースホルダーが正しく解決されているか管理者が確認するためのデバッグおよび解析コマンドが含まれています。

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

サーバーで、動的なクロスプラグインデータを表示する必要がある複数のプラグイン（chat、tab、holograms、scoreboards、または GUIs）を使っている場合、PlaceholderAPI はプレースホルダー解決を中央化し、各利用側プラグインを直接変更せずにモジュール式の拡張で追加サポートを導入できるため便利です。

プラグイン PlaceholderAPI のサーバー

プラグイン PlaceholderAPI のページには、モニタリングがこのプラグインを確認したサーバー、使用されているプラットフォームとバージョンが表示されます。

プラグインはコマンド、経済、保護、アクセス権、ミニゲーム、連携、その他のメカニクスを追加できます。PlaceholderAPI の実際の役割はサーバーごとの設定によります。

データはサーバーの技術応答から自動生成されます。サーバーがプラグイン一覧を非公開にしている場合、PlaceholderAPI を使用していてもこのセクションに表示されないことがあります。

PlaceholderAPI を使用するサーバーの一覧を使って、プロジェクトを比較したり、対応バージョンを確認したり、公開サーバーでのプラグイン使用例を見つけたりできます。