> ## 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.

# 作れるもの・作れないもの

> いまのステージ開発キットで作れるものと、まだ作れないものです。

いまのステージ開発キットで作れるものと、いまはまだ作れないものです。

あなたが作りたいものを伝えると、エージェントは作り始める前に、それを[エンジンのリファレンス](https://docs.livlive.ai/developers/reference/engine.md)に照らします。そして、作れるもの、作れないものとその理由、作れないものごとにいちばん近い形を、あなたの言葉で伝えます。リファレンスは、そのたびに livlive からいまのものを読みます。この頁で迷ったときも、エージェントに聞いてください。

## 作れるもの

### 部屋

* 部屋の形は、GLB ファイル一つです。中に全部を入れて書き出します。作る道具は自由です(Blender、スクリプト、ほかの AI が作ったもの、手で書いた glTF など)。
* 明かり。部屋のライトと面の光、点けたり消したりできるスイッチ、部屋の電気(停電)、一瞬だけ光らせる光。
* 見た目の調子。背景の色、霧、線と色の段、明るいところからにじむ光。
* 天気。区域の中に降る雨、濡れる面、映り込み。
* 出来事。スタジオの「出来事」のボタンで起こし、明かりを点けたり消したり、物を見せたり隠したり、光らせたりします。出来事は、ボタンとテロップに出す言葉を持ちます。

### 物

* 座れる席。座るだけの席と、座って作業する席があります。
* 見て、話題にできる物。物には名前と一言の説明を付け、キャラクターはそれを読んで話題にします。
* 手に持てる物。別のファイルで持ってきた物に、持ち方を付けます。
* 始めは隠しておき、出来事で見せる物。

物の種類(ソファ、棚、看板など)と、それぞれの大きさの範囲は、リファレンスの「物の種類」にあります。

### キャラクターができること

キャラクターは、ステージにあるものから自分で選んで動きます。エンジンが持つ動作は、物のそばへ行く、見る、向きを変える、座る、立ち上がる、その場で待つ、物を使う、いつもの位置へ戻る、などです。どの物でどの動作が開くかは、リファレンスの「できること(can)と動作」にあります。

ステージのゲームは、自分の行為を持てます。行為が見せる動きは、エンジンの動きの名前から選びます(リファレンスの「行為の動き」)。

### ゲーム

* ステージだけのゲームを、ルール(TypeScript)で書けます。ゲームは一手ずつ進みます。
* 順番、キャラクターへの問い、画面に出す盤面、勝ちと終わりを持てます。
* 遊ぶ人数の最少と最多を決められます。最多は、一つの番組に出られるキャラクターの数までです。

### ステージのスキル

このステージで番組を作るときの手引きを、一つ持たせられます(`SKILL.md`)。このステージを使うコンテンツの構成表を書くとき、ツヅリがそれを読みます。

## いまは作れないもの

* **動き続けるゲーム。** ルールが動くのは、出来事があったときと、ルールが決めた時刻だけです。毎フレーム動き続けるゲーム(アクションのような、リアルタイムのゲーム)は、いまは作れません。決めた時刻ごとに起こすことはできます。
* **キャラクターのほかに動く人。** リファレンスにあるのは、物と、番組に出るキャラクターです。番組に出るキャラクターのほかに、お客さんや通りがかりの人を動かす方法は、リファレンスにありません。そういう役は、ほかのキャラクターが演じられます。
* **視聴者がゲームを動かすこと。** ゲームに届くのは、時刻、出来事、キャラクターの行為と席などです。視聴者の操作をゲームが受け取る口は、リファレンスにはありません。
* **絵を描くこと。** 盤面の見た目、キャラクターの体、カメラの撮り方は livlive のものです。ステージが決めるのは、部屋とその見た目の調子、盤面に載せる中身、カメラが立てる範囲と立てる場所です。
* **GLB の圧縮(Draco や meshopt など)や特別な描き方。** 使える GLB の拡張は決まっています(リファレンスの「数の上限」の拡張の一覧)。ほかの拡張は、まだ描けません。外して書き出します。

## ステージが決めないもの

キャラクターのせりふと、どの行為を選ぶかは、ステージでは決めません。ステージは選べるものを差し出し、キャラクターが選んで話します。物の一言も、キャラクターは指示としてではなく、その物についての事実として読みます。

番組のタイトル、区切りが始まるときに出るその区切りのタイトル、話している言葉の字幕、視聴者のコメントといった配信画面の言葉も、ステージでは決めません。どのステージでも配信画面が描きます。タイトルと区切りのタイトルは、番組のコンテンツで決まります。ステージが絵に重ねて出せる言葉は、出来事のテロップと、ゲームの盤面だけです。看板や貼り紙に描いた文字は、部屋の一部として映ります。

## 数の上限

| 上限 | いまの値 |
| - | - |
| 空間のファイルの大きさ(部屋と物を合わせて) | 最大 60 MB |
| 形の細かさ(三角形の数) | 最大 1,000,000 個 |
| 画像の数 | 最大 64 枚 |
| ライトの数 | 最大 16 個 |
| 面の光の数 | 最大 4 個 |
| 物を置ける数 | 最大 256 個 |
| 置いた物の部品の数(合計) | 最大 65,536 個 |
| 物の id の長さ | 最大 40 字 |
| 物の名前の長さ | 最大 40 字 |
| 物の説明の長さ | 最大 200 字 |
| 物ひとつのできること(can)の数 | 最大 16 語 |
| できること(can)の一語の長さ | 最大 32 字 |
| world.json の大きさ | 最大 256 KB |
| 区域(areas)の数 | 最大 32 個 |
| 区域ひとつの床の箱の数 | 最大 16 個 |
| ステージ自前のゲームのコード(keeper.js)の大きさ | 最大 64 KB |
| ルールの変換にかけられる時間 | 最大 5 秒 |

この表は、エンジンのリファレンスから自動で作っています。ほかの上限(盤面の字数、ルールが動く箱の時間やメモリなど)は、[エンジンのリファレンス](https://docs.livlive.ai/developers/reference/engine.md)にあります。


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