箱庭パーソナル診断 鯖民向け説明書 (Alpha-1.11.0)
これは何か
プレイヤーのプレイ内容(採取・設置・クラフト・戦闘・移動・ログイン頻度など)や、 Webサイトで受けられる質問診断(クイズ)から「個性タイプ」を診断し、Web上のランキング・ プレイヤーページで見られるようにする機能です。運営(OP)が管理するコマンドとは別に、 鯖民(サーバーのプレイヤー)が自分で使える機能・コマンドをまとめたものが本書です。
Web上の機能(ランキング閲覧、プレイヤー検索、クイズを受ける、結果をシェアする等)は マイクラ内のコマンドや権限を必要としません。ブラウザで公開URLにアクセスするだけで 誰でも利用できます。
1. 権限なしで誰でも使えること
マイクラ内コマンド
| コマンド | 内容 |
|---|---|
/personalitylink | Discordアカウント連携用のワンタイムコード(6桁、5分間有効)を発行する。発行後、Discordで/link <コード>を実行すると連携が完了する |
Webサイト(公開URL、ブラウザから誰でも閲覧可能)
| ページ | 内容 |
|---|---|
/(トップページ) | 総合リーダーボード。プレイ時間/採取/設置/クラフト/Mobキル/PvPキル/移動距離/ログイン回数でソート可能。「累計」に加えて「今週の伸び」「今月の伸び」の期間別ランキングにも切り替えられる(v1.11.0〜) |
/user/<プレイヤー名> | プレイヤー個人の統計・個性タイプ診断結果・称号バッジ・クイズ受診結果を表示。個性タイプ%の推移を折れ線グラフでも確認できる(v1.11.0〜) |
/quiz | 質問診断(クイズ)。MC名を入力すると実プレイ実績と合成した診断結果になる(未入力でも匿名診断可) |
/quiz/share/<共有ID> | クイズ結果のシェアリンク(X等に貼るとカード画像が表示される) |
/materials | サーバー全体の材質別ランキング・人気ブロック集計 |
/analytics | サイトのアクセス解析(個人を特定できる情報は含まない) |
/privacy | 本サービスのプライバシーポリシー |
Discordコマンド(Discord Bot連携時)
| コマンド | 内容 |
|---|---|
/personality [player] | 個性タイプ診断結果を表示(playerを省略すると自分の結果。要アカウント連携) |
/stats [player] | プレイ統計のサマリを表示 |
/link <code> | マイクラ内で発行したコードを使ってDiscordアカウントと連携する |
2. 権限が無いと使えないコマンド(念のため、運営専用のものも含む)
以下はすべて既定で OP(運営)専用 です。一般の鯖民には付与されません。
| コマンド | 必要な権限 | 既定 | 内容 |
|---|---|---|---|
/hpreload | hakoniwapersonality.reload | OP | config.yml・personality-types.yml・quiz-questions.yml・badges.ymlを再読込し、Webサーバー・Discord Botを再起動する(運営がバッジや診断タイプの設定を変更した際に使う) |
/hpadmin resetshareranking | hakoniwapersonality.admin | OP | 「みんなの人気診断コード」ランキングをリセットする(既存の個別シェアリンクは削除されない) |
/hpadmin viewplayer <プレイヤー名> | hakoniwapersonality.admin | OP | 指定プレイヤーのUUID・プレイ統計・材質別内訳・Discord連携状況・クイズ結果をまとめて表示する(サポート対応時の確認用) |
一般の鯖民がこれらのコマンドを実行しようとしても、権限が無いためサーバーに拒否されます。 「自分にもこの権限が欲しい」という場合は運営に相談してください(通常は付与されません)。
3. 補足
- 上記の権限名(
hakoniwapersonality.reload/hakoniwapersonality.admin)は権限管理プラグイン (LuckPerms等)で個別に付与・剥奪できますが、本サーバーでは既定通りOPのみに限定した運用を想定しています。 - Web上の機能(ランキング・プレイヤーページ・クイズ等)はマイクラ内の権限とは無関係に、 公開URLへアクセスできる全員が利用できます。