> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livlive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is livlive's documentation. An agent reaches livlive from outside through the `livlive` CLI or the livlive MCP server (see /developers/install, /developers/cli and /developers/mcp). The person links it to livlive once, in the browser: `livlive login`, the local MCP's `livlive_login` tool, or the remote MCP at https://backstage.livlive.ai/api/mcp signing in by OAuth; a personal token made in livlive's settings is for CI. Pages marked 準備中 describe parts not decided yet: do not guess their behaviour.

# ステージとは

> キャラクターが過ごし、番組の舞台になるステージを、あなたの PC の AI エージェントと一緒に作ります。

ステージは、キャラクターが入って過ごす場所です。そこには、キャラクターにできることが置いてあります。物、歩ける床と座れる席、点けたり開けたりできるもの、出来事、そのステージだけのゲームです。キャラクターは、その中から自分で選んで動きます。

ステージが先にあり、キャラクターの動きと言葉は、ステージが差し出すものから生まれます。だから良いステージは、キャラクターに本当にすることがあり、ひとつの場所として見えるステージです。見た目はその次です。

## どこで作るか

ステージは、あなたの PC の上で、あなたと AI エージェント(Claude Code など)が作ります。エージェントは、ステージ開発キットのスキルとエンジンのリファレンスを読んで作り方を知り、`livlive` コマンドで確かめて、livlive に登録します。部屋を作る道具は自由です。

livlive の画面には、ステージを作る場所はありません。ブラウザでするのは、確かめることと、登録することだけです。

| 場所 | すること |
| - | - |
| あなたの PC | 作る。部屋の形、物の並び、ゲームのルール |
| 開発用の頁(ブラウザ) | PC のフォルダにあるステージを、livlive のエンジンで描いて確かめる |
| ステージの頁(ブラウザ) | 登録したステージを確かめる(パッケージを選んで登録もできる) |
| スタジオ(ブラウザ) | リハーサルで、キャラクターがステージで過ごすのを見る |

ステージを描くエンジンは livlive の側にあり、PC には入りません。開発用の頁では、livlive のエンジンが PC のフォルダを読んで描きます。

登録は、ふつうエージェントが `livlive stage push` で行います。ステージの頁の設定にある「空間」でも、組み上がったパッケージ(room.glb と world.json、またはそれをまとめた zip)を選んで登録できます。`livlive stage new` で作ったフォルダは、`livlive stage push` で登録します。

## ステージの中身

ステージは、一つのフォルダ(パッケージ)として登録します。中身は層に分かれています。部屋はいつもあり、ほかの層は使うときだけ入れます。

| 層 | 中身 |
| - | - |
| 部屋 | 部屋の形(`room.glb`)と、エンジンが読む部屋の言葉(`world.json`)。物、席、歩ける範囲、カメラが立てる範囲、明かり、出来事 |
| 物 | 別のファイルで持ってきて、部屋に置く物 |
| ゲーム | ステージだけのゲームのルール。livlive の箱の中で動きます |
| スキル | このステージで番組を作るときの手引き(`SKILL.md`)。このステージを使うコンテンツの構成表を書くとき、ツヅリが読みます |

考え方は[仕組み](https://docs.livlive.ai/developers/stage-kit/concepts.md)に、ファイルの形は[エンジンのリファレンス](https://docs.livlive.ai/developers/reference/engine.md)にあります。

## あなたとエージェントの役目

| | あなた | エージェント |
| - | - | - |
| 決める | 何を作りたいか、どのキャラクターが過ごすか | 何が作れて何が作れないか、いちばん近い形を伝える |
| 作る | 任せる。使いたい道具やファイルがあれば渡す | 部屋、物、ゲームを作り、PC で確かめる |
| 見る | 開発用の頁でキャラクターに乗り移り、ステージの中を歩く | あなたが見たことから直す |
| 仕上げる | スタジオでリハーサルをする | 登録し、リハーサルに使うコンテンツを用意する |

流れは[はじめてのステージ](https://docs.livlive.ai/developers/stage-kit/first-stage.md)にあります。

## できあがりは、リハーサルで決まる

ステージは、見た目が整っても、検査を通っても、登録されても、まだできあがりではありません。livlive のスタジオのリハーサルで、あなたのキャラクターがそこで過ごしたとき、できあがりです。歩き回り、その場所らしいところに座ったり立ったりし、置かれた物を使い、ゲームがあれば遊んだときです。

## 用意するもの

> [!WARNING]
>
> いまは招待制βの準備中です。CLI と MCP は npm から入れられますが、使うには livlive のアカウント(招待制)が要ります。スキル(`npx skills add`)は、livlive-kit の公開とともに使えるようになります。

ステージ開発キットも、この livlive-kit に入っています。用意のしかたは、[クイックスタート](https://docs.livlive.ai/developers/quickstart.md)の「CLI で始める」と[インストールと連携](https://docs.livlive.ai/developers/install.md)にあります。

* **livlive のアカウントと、あなたのキャラクター。** 開発用の頁では、あなたのキャラクターがステージに入ります。リハーサルには、デビューしたキャラクターが要ります([キャラクター](https://docs.livlive.ai/guide/characters.md))。
* **PC で動く AI エージェント。** エージェントには、キットのスキル [stage-lead](https://docs.livlive.ai/developers/skills/stage-lead.md) と [stage-package](https://docs.livlive.ai/developers/skills/stage-package.md) を読ませます。自分のキーで絵と 3D を作るなら、[stage-art](https://docs.livlive.ai/developers/skills/stage-art.md) も読ませます。スキルの入れ方は[インストールと連携](https://docs.livlive.ai/developers/install.md)にあります。
* **`livlive` コマンド(CLI)。** Node.js 22.18 以上で動きます。入れ方と、livlive との連携(ブラウザで一度「連携する」を押します)は、[インストールと連携](https://docs.livlive.ai/developers/install.md)にあります。
* **部屋を Blender で作るときは Blender。** キットは、Blender で部屋を作るための道具(ルームキット)も持っています。
* **自分のキーで絵と 3D を作るときは、OpenAI と Tripo の API キー。** 料金は、OpenAI と Tripo のあなたのアカウントにかかります。キーは、エージェントがフォルダを作ってから、その `.env` に書きます。できた模型は Blender でステージに合わせるので、新しい版の Blender も要ります(古いときは、エージェントがどの版が要るかを伝えます)。キーが無くても、ステージは作れます。くわしくは[はじめてのステージ](https://docs.livlive.ai/developers/stage-kit/first-stage.md)の「自分のキーで、絵と 3D を作る」にあります。

## この章の頁

> [card] [作れるもの・作れないもの](https://docs.livlive.ai/developers/stage-kit/limits.md)
>
> いまのキットで作れるもの、まだ作れないもの、数の上限です。

> [card] [はじめてのステージ](https://docs.livlive.ai/developers/stage-kit/first-stage.md)
>
> 伝えるところからリハーサルまで、あなたとエージェントがすることです。

> [card] [仕組み](https://docs.livlive.ai/developers/stage-kit/concepts.md)
>
> 部屋、物の一言、ゲームの一手と盤面、ルールが動く箱です。

> [card] [ギャラリー](https://docs.livlive.ai/developers/stage-kit/gallery.md)
>
> できあがったステージと、その作られ方です。

> [!NOTE]
>
> 作りたいものごとの進め方(目的別の手引き)は準備中です。できあがったステージが増えてから書きます。

## エージェントが読むもの

エージェントは、作り始める前にスキル [stage-lead](https://docs.livlive.ai/developers/skills/stage-lead.md)(あなたとの進め方)と [stage-package](https://docs.livlive.ai/developers/skills/stage-package.md)(作り方と登録)を読み、[エンジンのリファレンス](https://docs.livlive.ai/developers/reference/engine.md)で、できることと上限を確かめます。あなたのキーで絵と 3D を作るときは、[stage-art](https://docs.livlive.ai/developers/skills/stage-art.md)(参考の絵と模型の作り方)も読みます。どれもエージェントのための英語の文ですが、エージェントが何をするかを知りたいときに読めます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.