Minecraftプラグイン PlayerPoints

🔌 PlayerPoints について

PlayerPoints は、サーバー向けにポイントベースの通貨システムを提供する Minecraft プラグインです。ほかのプラグインが直接統合できるように API を公開し、人気プラグイン向けの任意の hook を提供し、SQL ベースのストレージにも対応しています。

🎯 目的

PlayerPoints は、ほかのプラグインが付与・消費・参照できる、軽量な二次経済（ポイント）をサーバーに提供することを目的としています。完全な通貨経済プラグインを必要とせず、シンプルでスクリプト化しやすいポイント/通貨システムを実現します。

⚙️ 機能

• プレイヤーアカウント向けのポイントベース通貨システム。
• ほかのプラグインがポイントを読み取り・変更できる公開 API。
• 永続ストレージ向けの SQL 対応（リポジトリでは SQL 対応が説明されています）。
• Vault と PlaceholderAPI 向けの任意の統合 hook。
• 初回起動時に独自のプラグインデータフォルダを作成し、設定とデータを保存します。

🧩 対象ユーザー

• 2つ目のポイント通貨を求める Survival と SMP サーバー。
• プラグイン作者がプレイヤーポイントを付与・確認するためのシンプルな API を必要とするサーバー。
• Vault/PlaceholderAPI との任意の統合を好むサーバー。

🏗️ 使用例

• ミニゲームやクエストの報酬としてポイントを付与する。
• 別のプラグインを通じて、ポイントを装飾アイテムやサーバー権限の購入用通貨として使う。
• ランクシステム、ランキング、進行管理を作成するためにポイントを読み取るプラグイン。

⚙️ インストール

📥 セットアップ

• 公式リソースからプラグインの jar をダウンロードし、サーバーの plugins/ ディレクトリに jar を配置します。
• サーバーを起動します。初回起動時に PlayerPoints は plugins/PlayerPoints フォルダを作成し、設定ファイルとデータファイルを保存します。
• サーバーコンソールで PlayerPoints のメッセージを確認し、プラグインが読み込まれたことを確認します。

📦 依存関係

• 必須の依存関係はありません。
• 任意: Vault（任意 hook）と PlaceholderAPI（任意 hook）。

🧠 技術メモ

• 公式情報では Spigot とその派生版との互換性が示されています。Paper が推奨されます。CraftBukkit はサポートされていません。
• このプロジェクトは Minecraft 1.8.8 以降のバージョンをサポートしています。
• このプラグインは GPL-3.0 ライセンスのオープンソースで、他のプラグインとの統合のための API を公開しています。

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

API と、一般的なエコシステムプラグインとの任意の統合を備えた、わかりやすくスクリプト化しやすいポイントシステムが必要なとき、PlayerPoints は他のプラグインが確実に hook できる、目的を絞った解決策を提供します。