箱庭パーソナル診断 鯖民向け説明書 (Alpha-1.12.0)

これは何か

プレイヤーのプレイ内容(採取・設置・クラフト・戦闘・移動・ログイン頻度など)や、 Webサイトで受けられる質問診断(クイズ)から「個性タイプ」を診断し、Web上のランキング・ プレイヤーページで見られるようにする機能です。運営(OP)が管理するコマンドとは別に、 鯖民(サーバーのプレイヤー)が自分で使える機能・コマンドをまとめたものが本書です。

Web上の機能(ランキング閲覧、プレイヤー検索、クイズを受ける、結果をシェアする等)は マイクラ内のコマンドや権限を必要としません。ブラウザで公開URLにアクセスするだけで 誰でも利用できます。

---

1. 権限なしで誰でも使えること

マイクラ内コマンド

コマンド	内容
/personalitylink	Discordアカウント連携用のワンタイムコード(6桁、5分間有効)を発行する。発行後、Discordで/link <コード>を実行すると連携が完了する

Webサイト(公開URL、ブラウザから誰でも閲覧可能)

ページ	内容
/(トップページ)	総合リーダーボード。プレイ時間/採取/設置/クラフト/Mobキル/PvPキル/移動距離/ログイン回数でソート可能。「累計」に加えて「今週の伸び」「今月の伸び」の期間別ランキングにも切り替えられる(v1.11.0〜)
/user/<プレイヤー名>	プレイヤー個人の統計・個性タイプ診断結果・称号バッジ・クイズ受診結果を表示。個性タイプ%の推移を折れ線グラフでも確認できる(v1.11.0〜)。診断結果のサブタイトルはログイン回数・プレイ時間・カテゴリ集中度に応じて自動で追加される(v1.12.0〜)
/quiz	質問診断(クイズ)。MC名を入力すると実プレイ実績と合成した診断結果になる(未入力でも匿名診断可)
/quiz/share/<共有ID>	クイズ結果のシェアリンク(X等に貼るとカード画像が表示される)
/materials	サーバー全体の材質別ランキング・人気ブロック集計。材質名で検索して順位を確認できる(v1.12.0〜)
/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へアクセスできる全員が利用できます。