Minecraftプラグイン PurePerms

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

🔌 PurePermsについて

PurePermsは、PocketMine-MP向けの権限管理プラグインで、Bukkit系の権限プラグインに似たグループベースの権限管理、グループ継承、ユーザーへの権限割り当てを提供します。PocketMine-MPサーバー向けで、プラグイン作者向けの小さなAPIも公開しています。

🎯 目的

PurePermsは、サーバー管理者が名前付きグループを定義し、グループやユーザーに権限を割り当て、PocketMine-MPサーバー向けに継承やワールドごと(任意)の権限動作を設定できるようにするためにあります。

⚙️ 機能

  • グループの作成・削除と、デフォルトグループの設定。
  • グループや個別ユーザーへの権限の付与・削除。
  • 複数グループの継承システム。
  • ワールドごとの権限サポート(任意、設定可能)。
  • 複数のデータプロバイダ: YAML (yamlv1/yamlv2) と MySQL。
  • 多言語メッセージリソース。
  • プラグイン開発者向けの小さな PurePerms API を提供。

🧩 対象ユーザー

  • グループベースの権限管理が必要な PocketMine-MP (Bedrock) サーバー管理者。
  • 既存の権限APIと連携したい PocketMine-MP 向けプラグイン開発者。

🏗️ 使用例

  • Guest、Member、Moderator などのランクを作成し、グループ権限を割り当てる。
  • 継承を使って Moderator ランクに Member の権限を継承させ、さらに管理用ノードを追加する。
  • 大規模構成では MySQL、単一サーバー構成では YAML に権限を保存する。

⌨️ コマンド

コマンド説明権限アクセス
/addgroup <group>グループ一覧に新しいグループを追加します。pperms.command.addgroup管理者
/addparent <target_group> <parent_group>あるグループの継承リストに別のグループを追加します。pperms.command.addparent管理者
/defgroup <group> [world]デフォルトグループを設定します。pperms.command.defgroup管理者
/fperms特定のプラグインの権限を検索します。pperms.command.fperms管理者
/groupsすべてのグループの一覧を表示します。pperms.command.groups管理者
/grpinfo <group> [world]グループの情報を表示します。pperms.command.grpinfo管理者
/listgperms <group> <page> [world]グループの権限を一覧表示します。pperms.command.listgperms管理者
/listuperms <player> <page> [world]ユーザーの権限を一覧表示します。pperms.command.listuperms管理者
/ppinfoプラグイン情報を表示します。pperms.command.ppinfo管理者
/ppsudo <login / register>Noeul アカウントに登録またはログインします(プラグイン機能)。pperms.command.ppsudo管理者
/ppreloadPurePerms の設定を再読み込みします。pperms.command.ppreload管理者
/rmgroup <group>グループを削除します。pperms.command.rmgroup管理者
/rmparent <target_group> <parent_group>グループの継承から親グループを削除します。pperms.command.rmparent管理者
/setgperm <group> <permission> [world]グループに権限を追加します。pperms.command.setgperm管理者
/setgroup <player> <group> [world]ユーザーのグループを設定します。pperms.command.setgroup管理者
/setuperm <player> <permission> [world]ユーザーに権限を追加します。pperms.command.setuperm管理者
/unsetgperm <group> <permission> [world]グループから権限を削除します。pperms.command.unsetgperm管理者
/unsetuperm <player> <permission> [world]ユーザーから権限を削除します。pperms.command.unsetuperm管理者
/usrinfo <player> [world]ユーザーの情報を表示します。pperms.command.usrinfo管理者

🔐 権限

権限説明デフォルト
pperms.command.addgroup/addgroup の使用を許可します。未指定
pperms.command.addparent/addparent の使用を許可します。未指定
pperms.command.defgroup/defgroup の使用を許可します。未指定
pperms.command.fperms/fperms の使用を許可します。未指定
pperms.command.groups/groups の使用を許可します。未指定
pperms.command.grpinfo/grpinfo の使用を許可します。未指定
pperms.command.listgperms/listgperms の使用を許可します。未指定
pperms.command.listuperms/listuperms の使用を許可します。未指定
pperms.command.ppinfo/ppinfo の使用を許可します。未指定
pperms.command.ppsudo/ppsudo の使用を許可します。未指定
pperms.command.ppreload/ppreload の使用を許可します。未指定
pperms.command.rmgroup/rmgroup の使用を許可します。未指定
pperms.command.rmparent/rmparent の使用を許可します。未指定
pperms.command.setgperm/setgperm の使用を許可します。未指定
pperms.command.setgroup/setgroup の使用を許可します。未指定
pperms.command.setuperm/setuperm の使用を許可します。未指定
pperms.command.unsetgperm/unsetgperm の使用を許可します。未指定
pperms.command.unsetuperm/unsetuperm の使用を許可します。未指定
pperms.command.usrinfo/usrinfo の使用を許可します。未指定

⚙️ インストール

📥 セットアップ

  • 公式の PurePerms ビルドをダウンロードし、ダウンロードしたファイルをサーバーの plugins/ ディレクトリにコピーします。
  • プラグインを初期化できるように、サーバーを停止してから再起動するか、停止中なら起動してください。
  • サーバーコンソールのログを確認し、プラグインが読み込まれ、設定ファイルが作成されたことを確認します。

📦 依存関係

  • PurePerms は必須の外部プラグイン依存関係を指定していません。選択可能なデータプロバイダをサポートしています(設定を参照)。

🧾 設定

  • PurePerms は data-provider を設定できる構成を作成します(対応値: mysql, yamlv1, yamlv2)。
  • 設定項目には default-languagedisable-openable-multiworld-perms、および mysql プロバイダ使用時の MySQL 接続設定が含まれます。

🧠 技術メモ

  • 対応プラットフォーム: PocketMine-MP(Pocket/Bedrock サーバーソフトウェア)。
  • 対応ストレージバックエンド(設定可能): YAML (yamlv1/yamlv2) と MySQL。
  • 多言語メッセージリソースが用意されており、設定から選択できます。
  • このプラグインは、他の PocketMine-MP プラグインが PurePerms のデータとやり取りするための API を公開しています。

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

PocketMine-MP サーバーを運営していて、オプションの MySQL 保存と多言語対応を備えた Bukkit 風のグループ・権限システムが必要なら、PurePerms はそれらの中核機能と統合用の小さな API を提供します。

プラグイン PurePerms のサーバー

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

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

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

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