Architecture
Storia は、連携して動く 4 つのソフトでできています。Storia サーバー 1 台だけでも完全な Minecraft サーバーです。Storia Proxy を足せばネットワークに、Storia Worker と Storia Relay を足せば 1 つのワールドを複数のマシンで動かせます。このページでは、それぞれの役割、動かす場所、やり取りする内容を説明します。
それぞれに 1 つの役割があります。組み合わせると、1 つのワールドを、プレイヤーの数に合わせて何台ものマシンで動かせます。
ゲームサーバー
玄関
Cluster のサーバー 1 台
まとめ役
次の仕組みは、Storia サーバー単体でも、Cluster の各ワーカーでも動きます。
Folia は近くのチャンクをリージョンにまとめ、リージョンごとに別々の CPU コアで処理します。ワールドの片側の重い拠点が、反対側のプレイヤーを遅くすることはありません。
リージョンが重くなりすぎると、密集チャンクのモブの判断の回数を減らします。そこにいるプレイヤーは制限されず、回路にも触れません。
エリトラで高速で飛ぶなど、自分で負荷を増やしている人だけ、リージョンが重い間は描画距離を短くします。
単体のサーバーでは、ワールドを RAM に置き、ディスクへはバックグラウンドで書き込みます。チャンクの保存や読み込みでディスクを待つことがありません。
空いているコアをすべて使って地形を前もって作ります。探索中は、できあがったチャンクを読み込むだけになります。
ワーカーでは、チャンクを Relay 経由で読み書きし、Relay が止まっている間は書き込みをディスクで待たせ、移動するプレイヤーを引き渡します。
ワーカー B にいる Bob が、ワーカー A にいる Alice の方へ飛んでいったときに起きること。
各ワーカーは毎秒、プレイヤーに見えている場所を Relay に報告します。
Bob の見える範囲が Alice のエリアに触れそうになります。Relay は 2 人を同じワーカーにまとめると決めます。その場所のプレイヤーが多い A です。
Relay はワーカー B に Bob の引き渡しを頼みます。B はインベントリ・進捗・統計・位置を保存し、準備完了を伝えます。
Storia Proxy は裏で Bob を同じエンティティ ID のままワーカー A につなぎ、接続を切り替えます。ログインし直しも、再スポーンも、読み込み画面もありません。
ワーカー A は Bob のデータを Relay から読み込みます。B が動かしていたセルは解放され、A が保存された状態から引き継ぎます。
Bob はそのまま飛び続けます。クライアントは、裏のサーバーが変わったことに気づきません。
プレイヤーのクライアントがプロキシのアドレスに ping します。Storia Proxy は、storia-proxy.toml の MOTD に {online} などのプレースホルダーを埋めて返します。
プロキシが Mojang でプレイヤーを認証します。Cluster では、ログアウトした場所を動かしているワーカーを Relay に聞き、そこにつなぎます。
modern フォワーディングが、プレイヤーの UUID とスキンを、フォワーディング用の秘密鍵で署名してサーバーに渡します。サーバーはこれを信頼できます。
タブリストは毎秒、プレイヤーとネットワークのプレースホルダーで更新されます。参加・退出・移動のメッセージは全員に届きます。
別のワーカーの場所に入ると、読み込み画面なしで移ります。ネットワーク内の別のサーバー（ロビーやミニゲーム）への移動は、普通のサーバー移動です。
| 接続 | 流れるもの | 保護 |
|---|---|---|
| プレイヤー ↔ Storia Proxy | Minecraft のプロトコル。移動、チャット、チャンクなど、ゲームに必要なものすべて。 | Minecraft 自体の暗号化（オンラインモード）。 |
| Storia Proxy ↔ Storia サーバー・ワーカー | 同じ Minecraft の通信と、引き継いだプレイヤーの身元。 | フォワーディング用の秘密鍵で署名。サーバーとワーカーはインターネットに直接公開しないでください。 |
| Storia Worker ↔ Storia Relay | チャンク、エンティティ、プレイヤーデータ、進捗、統計、地図、スコアボード、そしてどこを誰が動かすか。 | 合言葉から作った鍵で AES-256-GCM。合言葉そのものは送られません。 |
| Storia Proxy ↔ Storia Relay | プレイヤーをどのワーカーに入れるか、いつ移すか。 | 同じ暗号化。接続ごとに別の鍵を使います。 |
| 止まったもの | どうなるか |
|---|---|
| ワーカー（/stop） | 先にプレイヤーをほかのワーカーへ移してから、保存して止まります。キックされる人はいません。 |
| 落ちたワーカー | プロキシがそのプレイヤーを別のワーカーへ送ります。15 秒以内に、Relay がその場所を最後に保存された状態から別のワーカーに任せます。 |
| Relay | ワーカーは動き続け、戻るまで書き込みをディスクで待たせます。その間、新しいプレイヤーは入れず、移動も起きません。 |
| プロキシ | 戻るまで、プロキシ経由では入れません。サーバー・ワーカーとワールドは動き続け、何も失われません。 |
| 単体サーバーのマシン | RAM ワールドでは、最後の同期（初期設定で 5 分ごと）以降の変更が失われます。サーバーのプロセスだけが落ちた場合は、次の起動時に RAM 上のコピーから復旧します。 |
まずは 1 つ目から始めて、サーバーの成長に合わせてソフトを足していけます。
ほとんどのサーバーはこれで十分です。すべて 1 台のマシンで動かします。
Storia のみ
複数のゲームモードを 1 つのアドレスで。タブリストとメッセージは共通です。
Storia Proxy ＋ Storia
1 つの大きなワールドを複数のマシンで。プレイヤーが増えたらワーカーを足します。
Storia Proxy ＋ Storia Worker ＋ Storia Relay
| ソフト | Java | メモリ | ポート | 必要なファイル |
|---|---|---|---|---|
| Storia | 25 | ヒープ ＋ RAM 上のワールド | 25565 | ワールド |
| Storia Proxy | 21 以上 | 512 MB ほど | 25565 | なし |
| Storia Worker | 25 | Storia サーバーと同じくらい | 25565（非公開） | なし（Relay からワールドの設定を取り寄せる） |
| Storia Relay | 21 以上 | 512 MB ほど ＋ ディスク | 25590 | ワールド |
ポートはすべて変更できます。4 つのソフトは、ダウンロードページのすべてのリリースに入っています。