箱庭パーソナル診断 鯖民向け説明書 (Alpha-1.12.11)
プレイヤーのプレイ内容(採取・設置・クラフト・戦闘・移動・ログイン頻度など)や、 Webページ(https://typediagnosis.hknw.link/)で受けられる質問診断(クイズ)から 「個性タイプ」を診断し、Web上のランキング・プレイヤーページで見られるようにする機能です。 運営(OP)が管理するコマンドとは別に、鯖民(サーバーのプレイヤー)が自分で使える 機能・コマンドをまとめたものが本書です。
WARNING
本書の記載内容の一部は、機能の更新状況等により当サーバーで実際に適用されていない場合があります。ご利用の際は、コマンドの実行やWebページへのアクセスなど、実際にご自身でお試しのうえご確認ください。 それぞれの機能・コマンドについては、実行した場合に何が起こるかを本書内で説明していますので、それをご確認いただいたうえでの利用によって生じた不利益等については、運営チームは責任を負いかねます。
1. できること
- プレイ実績(採取・設置・クラフト・戦闘・移動・ログイン頻度など)から「個性タイプ」を自動診断し、 Web上のランキング・プレイヤーページで確認できる
- ブラウザで質問に答えるだけの質問診断(クイズ)を受けられる(実プレイ実績と合成した診断結果も可)
- 総合リーダーボード(累計・週間・月間)、材質別ランキング・人気ブロック集計を確認できる
- プレイヤーごとの称号バッジ、拠点情報、統計の全期間推移・サーバー内順位推移をグラフで確認できる
- Discordアカウントと連携すると、Discord上からも診断結果や統計を確認できる
- サイト全体のアクセス解析(個人特定不可、サーバー全体のプレイ時間推移グラフ含む)を確認できる
2. 誰でも使えるコマンド
マイクラ内コマンド
| コマンド | 内容 |
|---|---|
/personalitylink | Discordアカウント連携用のワンタイムコード(6桁、5分間有効)を発行する。発行後、Discordで/link <コード>を実行すると連携が完了する |
Discordコマンド(Discord Bot連携時)
| コマンド | 内容 |
|---|---|
/personality [player] | 個性タイプ診断結果を表示(playerを省略すると自分の結果。要アカウント連携) |
/stats [player] | プレイ統計のサマリを表示 |
/link <code> | マイクラ内で発行したコードを使ってDiscordアカウントと連携する |
3. コマンド以外の使い方: Webサイト
以下はすべてマイクラ内のコマンドや権限を必要とせず、ブラウザで公開URLにアクセスするだけで 誰でも利用できます。
| ページ | 内容 |
|---|---|
/(トップページ) | 総合リーダーボード。プレイ時間/採取/設置/クラフト/Mobキル/PvPキル/移動距離/ログイン回数でソート可能。「累計」に加えて「今週の伸び」「今月の伸び」の期間別ランキングにも切り替えられる(v1.11.0〜)。期間別ランキングにもページ切り替えが付いた(v1.12.1〜) |
/user/<プレイヤー名> | プレイヤー個人の統計・個性タイプ診断結果・称号バッジ・クイズ受診結果を表示。個性タイプ%の推移を折れ線グラフでも確認できる(v1.11.0〜)。診断結果のサブタイトルはログイン回数・プレイ時間・カテゴリ集中度に応じて自動で追加される(v1.12.0〜)。プレイ時間の全期間推移・サーバー内順位の推移も折れ線グラフで確認できる(v1.12.5〜)。順位推移はプレイ時間以外(採取・設置・クラフト等)の指標にも切り替えられる(v1.12.8〜)。個性タイプの推移グラフは「割合(%)」に加えて、カテゴリ別の実績個数(設置数・破壊数・km等)でも表示できる(v1.12.10〜)。全期間推移グラフもプレイ時間だけでなく統計カードの8項目(採取・設置・クラフト・Mobキル・PvPキル・移動距離・ログイン回数)すべてに切り替えられる(v1.12.10〜) |
/quiz | 質問診断(クイズ)。MC名を入力すると実プレイ実績と合成した診断結果になる(未入力でも匿名診断可) |
/quiz/share/<共有ID> | クイズ結果のシェアリンク(X等に貼るとカード画像が表示される) |
/materials | サーバー全体の材質別ランキング・人気ブロック集計。材質名で検索して順位を確認できる(v1.12.0〜) |
/analytics | サイトのアクセス解析(個人を特定できる情報は含まない)。サーバー全体の合計プレイ時間の日次推移グラフも表示される(v1.12.5〜) |
/privacy | 本サービスのプライバシーポリシー |
4. 主要コマンドの使い方の例
Discordアカウントを連携する
- マイクラ内で
/personalitylinkを実行すると、6桁のワンタイムコードが発行されます(5分間有効)。 - Discordの連携先チャンネルで
/link <発行されたコード>を実行すると連携が完了します。 - 連携後は
/personalityや/statsをDiscord上で実行すると、自分のマイクラ名を省略しても 結果が表示されます。
自分の診断結果・推移グラフを見る
- ブラウザで
https://typediagnosis.hknw.link/user/<自分のプレイヤー名>を開きます。 - 個性タイプ診断結果・称号バッジ・統計サマリが表示されます。
- ページ中ほどの「個性タイプの推移」「〇〇の全期間推移」「サーバー内順位の推移」の各グラフ右上の プルダウンで、表示する指標(割合/個数、プレイ時間/採取/設置など)を切り替えられます。
質問診断(クイズ)を受ける
/quizにアクセスし、質問に順番に回答します。- 自分のマイクラ名を入力すると、実プレイ実績と合成した診断結果になります(未入力でも匿名診断可)。
- 結果画面から
/quiz/share/<共有ID>のシェアリンクが発行され、X等に貼るとカード画像付きで 共有できます。
5. よくある質問
- Q. 個性タイプがなかなか変わらない → 個性タイプはプレイ実績全体の比率で決まるため、直近の プレイだけでは大きく変わりにくい仕様です。全期間の推移は「個性タイプの推移」グラフで確認できます。
- Q. 推移グラフに「もう少しデータの蓄積が必要です」と出る → スナップショットが1日分(または 0件)しか無い状態です。数日プレイを続けると表示されるようになります。
- Q. 「権限がありません」と表示された → そのコマンドは7章の管理者専用コマンドです。必要であれば 運営に相談してください(通常は付与されません)。
- Q. Discordで
/personalityを実行しても自分の結果が出ない →/personalitylinkで発行した コードをまだ/linkしていない可能性があります。アカウント連携が必要です。
6. 注意点
- 個性タイプ診断・成長グラフはクリエイティブ/WorldEdit操作による採取・設置・クラフトを集計から 除外しています。
- Web上の機能(ランキング・プレイヤーページ・クイズ等)はマイクラ内の権限とは無関係に、 公開URLへアクセスできる全員が利用できます。
- 各種推移グラフのタイトルには、日付に加えて「そのデータが何時何分頃取得されたものか」も 表示されます(v1.12.8〜)。日次データは深夜0時ちょうどではなく、サーバーが実際にバッチ処理を 実行したタイミングの値であるため、時刻を明示することで数値の解釈のズレを防いでいます。 「今日」のデータはこの時刻・数値が既定5分おきに更新され続けます(v1.12.9〜、既定60分から v1.12.11で短縮)。
7. 管理者権限などが必要なコマンド
以下はすべて既定で 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〜) |
一般の鯖民がこれらのコマンドを実行しようとしても、権限が無いためサーバーに拒否されます。 上記の権限名(hakoniwapersonality.reload / hakoniwapersonality.admin)は権限管理プラグイン (LuckPerms等)で個別に付与・剥奪できますが、本サーバーでは既定通りOPのみに限定した運用を 想定しています。
備考
- 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で個人ページの順位推移グラフに指標切り替え(プレイ時間以外も選択可)を追加し、 各推移グラフの日付表示にスナップショット取得時刻(何時何分頃のデータか)を併記するようにした （Alpha-1.12.8版はこちら）
- Alpha-1.12.9でスナップショット保存間隔を24時間固定から既定60分(
growth.snapshot-refresh-interval-minutes) に変更し、「今日」のデータの時刻・数値がその日のうちも更新され続けるようにした （Alpha-1.12.9版はこちら） - Alpha-1.12.10で個性タイプの推移グラフに割合(%)/個数の切り替えを追加し、「プレイ時間の全期間推移」 グラフも統計カードの8項目すべてに切り替えられるよう拡張した （Alpha-1.12.10版はこちら）
- Alpha-1.12.11でスナップショット保存間隔を既定60分から既定5分に短縮し、各種推移グラフの 「今日」のデータがより短い間隔で最新化されるようにした
- 2026年8月10日 全プラグイン共通の8章構成テンプレート(できること/誰でも使えるコマンド/ コマンド以外の使い方/主要コマンドの使い方の例/よくある質問/注意点/管理者権限などが必要な コマンド/備考)に合わせて構成を再編(バージョン番号・内容自体の変更はなし)