この記事は Minecraft Command Advent Calendar 2023 25 日目の記事です。

はじめに

データパックや配布マップをアップデートした際にプレイヤーにそれを通知したいと思ったことはありませんか？
コマンドをある程度わかっている方であれば、その手のシステムをバニラで実装するのは不可能だと諦めていたかもしれません。
ですが、最近のアップデートによる技術革新等によりバニラでアップデート通知システムを作ることに成功したので、この記事ではどのようなアプローチでそれを実装したかを解説していきます。

この記事では、以下に関する知識を仮定します。

コマンド･データパック･マクロの基礎
storage の概念
NBTPath による NBT 操作

また、この記事のコードは全て 1.20.4 で動作確認を行っています。
最後に、完全なコードは GitHub に置いてあります。
煮るなり焼くなり好きにしてください。ただし自己責任でお願いします。

そもそもなぜ出来ないと思われていたか

一言で言えば｢アップデートの有無を取得する方法がない (と思われていた) から｣です。
Minecraft には多くのコマンドがありますが、アップデート有無を取得できる外部サーバーへのリクエストを行えるようなコマンドはありません。
また、Minecraft クライアントからの通信はマルチサーバーへの通信を除いてほぼ全てが Mojang 側のサーバーへの通信となっていて、そこにおいても任意の外部サーバーへのリクエストは不可能でした。¹

今回取ったアプローチ

まず、アップデート有無を取得できるためにはどのような条件が必要なのかを考えると、

ゲーム内部から取得できる値である
開発者が任意のタイミングでゲーム外部から変更できる値である
ざっとこの二点が挙がります。

こんな条件を満たすものが存在するのかと思われるかもしれませんが、実は偶然にも一つだけ存在します。
それは｢プレイヤーのスキン｣です。
プレイヤーのスキンはご存知の通りゲーム外部から変更することができ、ゲーム内部では player_head から取得することが出来ます。

player_head の仕様

player_head は以下のようなコマンドで設置することでプレイヤーのスキンが適用されます。

setblock 2023 -64 1225 minecraft:player_head{SkullOwner:{Name:"<プレイヤーの ID>"}}

ただし、スキンサーバーからのプレイヤーのスキンの取得は非同期で行われるため設置後 10 tick 程度待つ必要があります。²
また、取得したスキンの情報はサーバーにキャッシュされ、サーバーを再起動するまでは再度設置した際にキャッシュを参照します。

設置された player_head には以下のような構造でデータが保存されています。

{
  SkullOwner: {
    Name: <プレイヤーの ID>,
    Properties: {
      textures: [
        {
          Signature: <テクスチャのシグネチャ>,
          Value: Base64 エンコードされたスキンの JSON データ .... 中身: {
            timestamp: <スキンの取得時刻？>,
            profileId: <プレイヤーの UUID (ハイフン無し)>,
            profileName: <プレイヤーの ID>,
            signatureRequired: <true なんこれ>,
            textures: {
              SKIN: {
                url: <スキンサーバー上のプレイヤーのスキンの URL>,
                metadata: {
                  model: <スキンのモデル classic or slim>
                }
              }
            }
          }
        }
      ]
    }
  }
}

このデータの中で開発者側がスキンを変更することで制御できる値は、SkullOwner.Properties.textures[0].Value の Base64 文字列をパースした結果の textures.SKIN.url です。
この値は Minecraft ランチャーでスキンを登録した際に、スキンの画像に対して発行される URL です。
この URL は登録した時点で発行され、削除しない限りは別のスキンを利用しても元のスキンに戻したとしても同じ URL を扱います。³

実装

SkullOwner.Properties.textures[0].Value をパースして textures.SKIN.url を見ればスキンの変更を検知できることがわかったので、ひとまずは｢リリース時点のスキン URL と異なるスキン URL が取得できた場合はアップデートがリリースされた｣として扱う形で実装を行います。

Base64 パーサー

最初に SkullOwner.Properties.textures[0].Value の中身読むために Base64 パーサーを実装します。
ですが、Base64 パーサーの実装についてここに記すには余白は狭すぎるので、20 日目の記事で解説を別途行っています。
詳しくはそちらを参照してください。
https://qiita.com/ChenCMD/items/d7a7f9cabdcc7479ccdd

アップデートチェックシステム

次に呼び出す部分などは置いておいて、このシステムの本質であるアップデートチェックシステムを実装してみます。⁴
また、この時点では setblock 後に遅延させるような処理を作っていないため、

setblock 2023 -64 1225 minecraft:player_head{SkullOwner:{Name:"<プレイヤーの ID>"}}

で設置しスキンがロードされた後に手動で update_notifier:check_update/_ を実行する必要があります。

update_notifier/functions/check_update/_.mcfunction

update_notifier/functions/check_update/parse_value.m.mcfunction

データパックとしての体裁を整える

データパックの実装としては、

サーバーのロード時にアップデートを確認
アップデートが存在する場合は JOIN したプレイヤーにアップデート通知メッセージを出力する
メッセージのスキップをクリックした場合は、次の更新までメッセージを出力しなくする
といった簡易的かつ最低限必要な実装とします。

各関数の細かい解説は申し訳ないのですが力尽きたので省きます。ある程度の説明はコメントに書いたのでそちらを確認してください。

update_notifier/functions/load.mcfunction

update_notifier/functions/initialize.mcfunction

update_notifier/functions/tick.mcfunction

update_notifier/functions/check_update/_.mcfunction

update_notifier/functions/player_joined.mcfunction

update_notifier/functions/update_notification.mcfunction

動作確認

以下の順で動作確認を行ったデモ映像がこちらです。

スキンを変更せずにサーバーに join
サーバーを stop
スキンを変更
サーバーを開く
サーバーに join

かなりいい感じですね。

未解決の課題

1 アカウントで 1 配布物のアップデートしか扱えない

未検証ではありますが、スキンの登録時にスキン画像の URL が発行されることを利用して事前に大量のスキンを登録して置くことで理論上は 5 ~ 9 bit 程のデータを扱えるようになるので、複数のアップデートの有無をそこに持たせることが出来るかもしれません。⁵

スキンの変更が軽率に出来なくなる

こればっかりはどうしようもない気がします。アップデート管理用のアカウントを買うか前述の複数のスキン情報の登録を利用してごまかすしか無い気がします。

まとめ

この記事ではプレイヤーのスキン周りの仕様を利用して配布物のアップデート通知システムを実装してみました。
実用に耐えるかは正直未知数ではあるものの、｢使えるものは何でも使う｣主義のコマンド勢にとってはなかなか夢のあるシステムなのかなと個人的には思います。
ちょっと⁶遅れてしまいましたが、この技術をプレゼントとしてクリスマス当日の記事をここで終わりとします。

参考にさせていただいたサイト

細かいことを言えば、マルチサーバーへの通信以外にもサーバーリソースパックの DL 元サーバー等も Mojang 以外への通信ではありますが、まぁどうせ使えないのでそんなことはどうでもよいです。 ↩
この仕様に気づかずデータが reload 時しか取得できない問題に遭遇し、2 時間程度頭を抱えてました。つらかった。 ↩
このスキンの URL がスキン画像に対して冪等なものなのか、登録時点でランダムに発行されるものなのかは検証できてないです。多分後者だとは思うけど。 ↩
全てを実装した後に切り出しているので、もしかしたらここのコードは動かないかも。動かなかったらごめんね。 ↩
｢サーバー起動時に開発者が指定した数 bit の情報を流し込める｣と考えると、アップデート通知以外にも利用用途があるかもしれません。面白そうな利用用途を思いついたら是非教えてください。 ↩
記事を書き終えた時点で 12/25 の 30 時ですが、誤差です。 ↩