箱庭パーソナル診断 鯖民向け説明書 (Alpha-1.12.8)
プレイヤーのプレイ内容(採取・設置・クラフト・戦闘・移動・ログイン頻度など)や、 Webページ(https://typediagnosis.hknw.link/)で受けられる質問診断(クイズ)から 「個性タイプ」を診断し、Web上のランキング・プレイヤーページで見られるようにする機能です。 運営(OP)が管理するコマンドとは別に、鯖民(サーバーのプレイヤー)が自分で使える 機能・コマンドをまとめたものが本書です。
Web上の機能(ランキング閲覧、プレイヤー検索、クイズを受ける、結果をシェアする等)は マイクラ内のコマンドや権限を必要としません。ブラウザで公開URLにアクセスするだけで 誰でも利用できます。
WARNING
本書の記載内容の一部は、機能の更新状況等により当サーバーで実際に適用されていない場合があります。ご利用の際は、コマンドの実行やWebページへのアクセスなど、実際にご自身でお試しのうえご確認ください。 それぞれの機能・コマンドについては、実行した場合に何が起こるかを本書内で説明していますので、それをご確認いただいたうえでの利用によって生じた不利益等については、運営チームは責任を負いかねます。
1. 権限なしで誰でも使えること
マイクラ内コマンド
| コマンド | 内容 |
|---|---|
/personalitylink | Discordアカウント連携用のワンタイムコード(6桁、5分間有効)を発行する。発行後、Discordで/link <コード>を実行すると連携が完了する |
Webサイト(公開URL、ブラウザから誰でも閲覧可能)
| ページ | 内容 |
|---|---|
/(トップページ) | 総合リーダーボード。プレイ時間/採取/設置/クラフト/Mobキル/PvPキル/移動距離/ログイン回数でソート可能。「累計」に加えて「今週の伸び」「今月の伸び」の期間別ランキングにも切り替えられる(v1.11.0〜)。期間別ランキングにもページ切り替えが付いた(v1.12.1〜) |
/user/<プレイヤー名> | プレイヤー個人の統計・個性タイプ診断結果・称号バッジ・クイズ受診結果を表示。個性タイプ%の推移を折れ線グラフでも確認できる(v1.11.0〜)。診断結果のサブタイトルはログイン回数・プレイ時間・カテゴリ集中度に応じて自動で追加される(v1.12.0〜)。プレイ時間の全期間推移・サーバー内順位の推移も折れ線グラフで確認できる(v1.12.5〜)。順位推移はプレイ時間以外(採取・設置・クラフト等)の指標にも切り替えられる(v1.12.8〜) |
/quiz | 質問診断(クイズ)。MC名を入力すると実プレイ実績と合成した診断結果になる(未入力でも匿名診断可) |
/quiz/share/<共有ID> | クイズ結果のシェアリンク(X等に貼るとカード画像が表示される) |
/materials | サーバー全体の材質別ランキング・人気ブロック集計。材質名で検索して順位を確認できる(v1.12.0〜) |
/analytics | サイトのアクセス解析(個人を特定できる情報は含まない)。サーバー全体の合計プレイ時間の日次推移グラフも表示される(v1.12.5〜) |
/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連携状況・クイズ結果をまとめて表示する(サポート対応時の確認用)。サブコマンド・プレイヤー名ともTab補完に対応(v1.12.7〜) |
一般の鯖民がこれらのコマンドを実行しようとしても、権限が無いためサーバーに拒否されます。 「自分にもこの権限が欲しい」という場合は運営に相談してください(通常は付与されません)。
3. 補足
- 上記の権限名(
hakoniwapersonality.reload/hakoniwapersonality.admin)は権限管理プラグイン (LuckPerms等)で個別に付与・剥奪できますが、本サーバーでは既定通りOPのみに限定した運用を想定しています。 - Web上の機能(ランキング・プレイヤーページ・クイズ等)はマイクラ内の権限とは無関係に、 公開URLへアクセスできる全員が利用できます。
- 各種推移グラフのタイトルには、日付に加えて「そのデータが何時何分頃取得されたものか」も 表示されます(v1.12.8〜)。日次データは深夜0時ちょうどではなく、サーバーが実際にバッチ処理を 実行したタイミングの値であるため、時刻を明示することで数値の解釈のズレを防いでいます。
備考
- 2026年7月26日 新命名規則で初版公開(Alpha-1.11.0)（Alpha-1.11.0版はこちら）
- Alpha-1.12.0で材質名オートコンプリート(
/materials検索)・診断サブタイトルの動的付与を追加（Alpha-1.12.0版はこちら） - Alpha-1.12.1で週間/月間ランキングの基準スナップショット不具合を修正、ページ切り替えに対応（Alpha-1.12.1版はこちら）
- Alpha-1.12.2で日次スナップショット保存時のSQL構文エラーを修正（Alpha-1.12.2版はこちら）
- Alpha-1.12.3で全期間の統計推移を記録し続ける永続履歴テーブルを追加(閲覧機能は未実装、鯖民向け説明書の単体ファイルは作成せず、Alpha-1.12.5作成時に変更履歴として合わせて追記)
- Alpha-1.12.4でプライバシーポリシーの本体規約への参照リンクを現行URLに統一(鯖民向け説明書の単体ファイルは作成せず、Alpha-1.12.5作成時に変更履歴として合わせて追記)
- Alpha-1.12.5でプレイヤーページに全期間プレイ時間推移・順位推移グラフ、アクセス解析ページに サーバー全体のプレイ時間推移グラフを追加(Alpha-1.12.3で記録のみだった永続履歴テーブルを初めて閲覧に使用)（Alpha-1.12.5版はこちら）
- Alpha-1.12.6でプライバシーポリシーページのヘッダーに最終改定日の表示が抜けていた不備を修正（Alpha-1.12.6版はこちら）
- Alpha-1.12.7で
/hpadminにTab補完(サブコマンド・プレイヤー名)を追加。 同バージョンより仕様書もバージョンごとファイル(仕様書-vX.Y.Z.md)方式に統一（Alpha-1.12.7版はこちら） - Alpha-1.12.8で個人ページの順位推移グラフに指標切り替え(プレイ時間以外も選択可)を追加し、 各推移グラフの日付表示にスナップショット取得時刻(何時何分頃のデータか)を併記するようにした