# Ubichill

> ゆるく集まる、じぶんの部屋。描いたり、観たり、いっしょに過ごす、中央のない 2D メタバース。

Ubichill は URL を開くだけでカーソルがアバターになる 2D メタバース。
ワールドは YAML（World as Code）、機能は TypeScript で書く mod。どちらも URL で配り、作者署名で本物とわかる。
サーバー同士は ActivityPub の形で連合する。

- アプリ: https://ubichill.com/
- ソース: https://github.com/ubichill/ubichill
- 全文: https://hub.ubichill.com/llms-full.txt

## ドキュメント

- [ドキュメント](https://hub.ubichill.com/docs/): Ubichill の使い方・ワールドと mod の作り方・公開・サーバーの建て方。
- [しくみと用語](https://hub.ubichill.com/docs/concepts/): ワールド・インスタンス・mod・Component・サーバー・連合・作者署名・公開範囲。Ubichill を読み解くための言葉。
- [エディタでワールドを作る](https://hub.ubichill.com/docs/create/editor/): ブラウザのワールドエディタで、Entity を置き、mod の Component を付け、公開するまで。コードは要りません。
- [AI と一緒に作る](https://hub.ubichill.com/docs/create/with-ai/): ワールドの YAML と mod の TypeScript を AI エージェントに書いてもらい、手元で動かして確かめる流れ。
- [World as Code](https://hub.ubichill.com/docs/create/world-as-code/): ワールドを YAML で定義する考え方。ワールド＝URL、ステートレス、CRD 形式。
- [ワールド定義フォーマット](https://hub.ubichill.com/docs/create/world-format/): world.yaml の正確なフィールド定義（ubichill.com/v1alpha1）。
- [はじめかた](https://hub.ubichill.com/docs/getting-started/): アカウントを作ってホームワールドに入り、ランチパッドから部屋を移ったり、人を招いたりするまで。
- [アーキテクチャ](https://hub.ubichill.com/docs/internals/architecture/): 完全 CSR + Go/WebSocket、Worker サンドボックス、ECS。
- [コントリビュート](https://hub.ubichill.com/docs/internals/contributing/): 設計思想と PR の出し方。
- [プロトコルと互換の規則](https://hub.ubichill.com/docs/internals/protocols/): 約束ごとを 4 種類に分け、互換の扱いを決める。
- [サービストークン](https://hub.ubichill.com/docs/internals/service-token/): サーバー間・サービス間の認証トークン。
- [はじめての mod](https://hub.ubichill.com/docs/mods/): npm の ubichill と @ubichill/cli を入れて、押すと数が増えるボタンを作り、手元で動かすまで。15 分。
- [API リファレンス（Ubi.*）](https://hub.ubichill.com/docs/mods/api/): Ubi.state / event / entity / ui / media / canvas / player の一覧。
- [権限（capability）](https://hub.ubichill.com/docs/mods/capabilities/): mod が使える権限の一覧と危険度ティア。
- [CLI（@ubichill/cli）](https://hub.ubichill.com/docs/mods/cli/): ubichill dev / build / install / verify / login / publish の使い方。
- [mod パッケージ](https://hub.ubichill.com/docs/mods/package/): mod.json、Component、配布、バージョンと lock、作者署名。
- [mod の実行環境](https://hub.ubichill.com/docs/mods/runtime/): WASM・バイナリ・同梱アセット・通信の境界。
- [SDK（ubichill）](https://hub.ubichill.com/docs/mods/sdk/): mod が import する npm パッケージ ubichill の使い方。
- [署名して公開する](https://hub.ubichill.com/docs/publish/): 作者アカウントと公開環境のしくみ、Web・CLI・CI から公開する手順、置き場所の選び方、取り消しの意味。
- [@ubichill/cli](https://hub.ubichill.com/docs/releases/cli/): CLI の変更履歴。
- [ubichill（SDK）](https://hub.ubichill.com/docs/releases/sdk/): SDK の変更履歴。
- [公開範囲・フレンド・招待](https://hub.ubichill.com/docs/servers/access/): 部屋の 4 つの公開範囲、だれに見えてだれが入れるか、フレンド申請の規則、招待とリクエストインバイト。
- [連合のしくみ](https://hub.ubichill.com/docs/servers/federation/): 中央のサーバーを持たずに、どのサーバーの人ともフレンドになり、相手のサーバーの部屋に入れるしくみ。利用者と管理者のために。
- [セルフホスト（Helm）](https://hub.ubichill.com/docs/servers/self-hosting/): Helm チャートで Kubernetes に Ubichill を建てる。
- [トラブルシューティング](https://hub.ubichill.com/docs/servers/troubleshooting/): 動かないときに見るところ。