rpg-engine 0.21.0 → 0.23.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/dist/campaign/create-campaign.d.ts +5 -0
- package/dist/campaign/create-campaign.js +40 -12
- package/dist/campaign/find-campaign.d.ts +5 -0
- package/dist/campaign/find-campaign.js +10 -5
- package/dist/campaign/host-files.d.ts +15 -4
- package/dist/campaign/host-files.js +134 -14
- package/dist/campaign/index.d.ts +4 -3
- package/dist/campaign/index.js +4 -3
- package/dist/campaign/port.d.ts +6 -0
- package/dist/campaign/port.js +24 -0
- package/dist/campaign/settings.d.ts +17 -0
- package/dist/campaign/settings.js +24 -1
- package/dist/cli/cli.js +33 -6
- package/dist/commands/config/config.js +15 -1
- package/dist/commands/config/dashboard.d.ts +4 -0
- package/dist/commands/config/dashboard.js +43 -7
- package/dist/commands/config/shown.js +4 -0
- package/dist/commands/config/words.d.ts +3 -1
- package/dist/commands/config/words.js +29 -2
- package/dist/commands/image.d.ts +3 -0
- package/dist/commands/image.js +31 -4
- package/dist/commands/import/import.d.ts +1 -1
- package/dist/commands/import/import.js +5 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +21 -3
- package/dist/commands/mode.d.ts +1 -1
- package/dist/commands/package/data.js +27 -0
- package/dist/commands/package/theme.js +2 -1
- package/dist/commands/scene/scene.js +6 -1
- package/dist/commands/shared/books/adventures.d.ts +1 -0
- package/dist/commands/shared/books/adventures.js +1 -1
- package/dist/commands/shared/campaign/git.d.ts +25 -0
- package/dist/commands/shared/campaign/git.js +104 -0
- package/dist/commands/shared/campaign/images.js +5 -3
- package/dist/commands/shared/campaign/saves.js +5 -1
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +8 -5
- package/dist/commands/shared/packages/catalog.js +24 -5
- package/dist/commands/status.d.ts +1 -0
- package/dist/commands/status.js +8 -4
- package/dist/core/context.d.ts +17 -6
- package/dist/core/context.js +2 -1
- package/dist/core/version.d.ts +2 -0
- package/dist/core/version.js +5 -0
- package/dist/dashboard/guide/ar.md +12 -7
- package/dist/dashboard/guide/cs.md +11 -6
- package/dist/dashboard/guide/da.md +11 -6
- package/dist/dashboard/guide/de.md +13 -8
- package/dist/dashboard/guide/el.md +11 -6
- package/dist/dashboard/guide/en.md +10 -5
- package/dist/dashboard/guide/es.md +11 -6
- package/dist/dashboard/guide/fi.md +11 -6
- package/dist/dashboard/guide/fr.md +12 -7
- package/dist/dashboard/guide/he.md +11 -6
- package/dist/dashboard/guide/hi.md +11 -6
- package/dist/dashboard/guide/hu.md +11 -6
- package/dist/dashboard/guide/is.md +11 -6
- package/dist/dashboard/guide/it.md +42 -37
- package/dist/dashboard/guide/ja.md +12 -7
- package/dist/dashboard/guide/ko.md +11 -6
- package/dist/dashboard/guide/nb.md +12 -7
- package/dist/dashboard/guide/nl.md +13 -8
- package/dist/dashboard/guide/pl.md +11 -6
- package/dist/dashboard/guide/pt.md +11 -6
- package/dist/dashboard/guide/ro.md +11 -6
- package/dist/dashboard/guide/ru.md +12 -7
- package/dist/dashboard/guide/sv.md +11 -6
- package/dist/dashboard/guide/tr.md +12 -7
- package/dist/dashboard/guide/uk.md +12 -7
- package/dist/dashboard/guide/zh.md +11 -6
- package/dist/dashboard/i18n/ar.json +30 -2
- package/dist/dashboard/i18n/cs.json +30 -2
- package/dist/dashboard/i18n/da.json +30 -2
- package/dist/dashboard/i18n/de.json +30 -2
- package/dist/dashboard/i18n/el.json +30 -2
- package/dist/dashboard/i18n/es.json +30 -2
- package/dist/dashboard/i18n/fi.json +30 -2
- package/dist/dashboard/i18n/fr.json +30 -2
- package/dist/dashboard/i18n/he.json +30 -2
- package/dist/dashboard/i18n/hi.json +30 -2
- package/dist/dashboard/i18n/hu.json +30 -2
- package/dist/dashboard/i18n/is.json +30 -2
- package/dist/dashboard/i18n/it.json +30 -2
- package/dist/dashboard/i18n/ja.json +30 -2
- package/dist/dashboard/i18n/ko.json +30 -2
- package/dist/dashboard/i18n/nb.json +30 -2
- package/dist/dashboard/i18n/nl.json +30 -2
- package/dist/dashboard/i18n/pl.json +30 -2
- package/dist/dashboard/i18n/pt.json +30 -2
- package/dist/dashboard/i18n/ro.json +30 -2
- package/dist/dashboard/i18n/ru.json +30 -2
- package/dist/dashboard/i18n/sv.json +30 -2
- package/dist/dashboard/i18n/tr.json +30 -2
- package/dist/dashboard/i18n/uk.json +30 -2
- package/dist/dashboard/i18n/zh.json +30 -2
- package/dist/dashboard/packages/installed.js +2 -2
- package/dist/dashboard/packages/packages.js +1 -1
- package/dist/dashboard/parts/labels.js +7 -0
- package/dist/dashboard/settings/settings.js +45 -9
- package/dist/dashboard/shell/notices.js +1 -1
- package/dist/dashboard/shell/system-style.js +89 -5
- package/dist/dashboard/shell/tooltip.js +5 -4
- package/dist/dashboard/style.css +245 -84
- package/dist/git/git.d.ts +12 -0
- package/dist/git/git.js +175 -0
- package/dist/git/ignore.d.ts +2 -0
- package/dist/git/ignore.js +16 -0
- package/dist/git/index.d.ts +2 -0
- package/dist/git/index.js +2 -0
- package/dist/helpers/briefs.d.ts +4 -0
- package/dist/helpers/briefs.js +13 -0
- package/dist/helpers/chosen.d.ts +8 -4
- package/dist/helpers/chosen.js +38 -14
- package/dist/helpers/index.d.ts +3 -2
- package/dist/helpers/index.js +5 -3
- package/dist/helpers/opencode.d.ts +13 -0
- package/dist/helpers/opencode.js +202 -0
- package/dist/importer/index.d.ts +1 -1
- package/dist/importer/index.js +1 -1
- package/dist/instructions/index.d.ts +2 -2
- package/dist/instructions/index.js +3 -3
- package/dist/languages/pack.js +2 -1
- package/dist/server/approver.d.ts +4 -2
- package/dist/server/approver.js +27 -7
- package/dist/server/bell/antigravity.d.ts +10 -0
- package/dist/server/bell/antigravity.js +95 -0
- package/dist/server/bell/index.d.ts +2 -0
- package/dist/server/bell/index.js +2 -0
- package/dist/server/bell/listener.d.ts +43 -0
- package/dist/server/bell/listener.js +149 -0
- package/dist/server/dashboard/files.d.ts +3 -2
- package/dist/server/dashboard/files.js +44 -15
- package/dist/server/dashboard/index.d.ts +25 -3
- package/dist/server/dashboard/index.js +58 -23
- package/dist/server/dashboard/news.d.ts +5 -2
- package/dist/server/dashboard/news.js +82 -14
- package/dist/server/dashboard/ports.d.ts +17 -2
- package/dist/server/dashboard/ports.js +60 -4
- package/dist/server/mcp.d.ts +6 -4
- package/dist/server/mcp.js +66 -18
- package/dist/server/player-acts.d.ts +21 -1
- package/dist/server/player-acts.js +38 -2
- package/dist/server/route/front.d.ts +3 -0
- package/dist/server/route/front.js +97 -0
- package/dist/server/route/index.d.ts +3 -0
- package/dist/server/route/index.js +3 -0
- package/dist/server/route/notes.d.ts +8 -0
- package/dist/server/route/notes.js +50 -0
- package/dist/server/route/router.d.ts +31 -0
- package/dist/server/route/router.js +215 -0
- package/dist/themes/css.d.ts +1 -1
- package/dist/themes/css.js +101 -2
- package/dist/themes/index.d.ts +1 -1
- package/dist/themes/index.js +1 -1
- package/dist/themes/theme.d.ts +34 -3
- package/dist/themes/theme.js +176 -19
- package/instructions/core.md +1 -0
- package/instructions/dashboard-guide.md +1 -1
- package/instructions/start.md +1 -1
- package/instructions/voices-opencode.md +1 -0
- package/package.json +3 -2
- package/plugins/opencode.js +174 -0
- package/dist/server/bell-listener.d.ts +0 -9
- package/dist/server/bell-listener.js +0 -83
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine:完全ガイド
|
|
3
3
|
|
|
4
4
|
**RPG Engine**では、**AIをGM**にして、テーブルトークRPGを遊べます。GMとは**チャット**で会話します。RPG Engineは裏側で動き、**世界を記憶し**、**ダイスを振り**、**数値を管理**します。チャットの横にはブラウザーのページ、**ダッシュボード**を開いておきます。キャラクターシート、ダイス、マップ、ジャーナルが並びます。
|
|
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 AIをつなぐ
|
|
66
66
|
|
|
67
|
-
GMは **AIエージェント** の中で動きます。AIエージェントとは、パソコン上のファイルを扱えるAIアプリのことで、ターミナルでもデスクトップでも使えます。たとえば Claude Code、Codex、Antigravity です。claude.ai や ChatGPT のような普通のチャットや、スマートフォンのアプリでは足りません。GMは、パソコンにあるキャンペーンのファイルにアクセスする必要があるからです。エージェントごとに、プランとログインが必要です。Claude Code は有料のClaudeプラン、Codex は ChatGPT のログイン、Antigravity は Googleアカウントです。Antigravity
|
|
67
|
+
GMは **AIエージェント** の中で動きます。AIエージェントとは、パソコン上のファイルを扱えるAIアプリのことで、ターミナルでもデスクトップでも使えます。たとえば Claude Code、Codex、Antigravity、OpenCode です。claude.ai や ChatGPT のような普通のチャットや、スマートフォンのアプリでは足りません。GMは、パソコンにあるキャンペーンのファイルにアクセスする必要があるからです。エージェントごとに、プランとログインが必要です。Claude Code は有料のClaudeプラン、Codex は ChatGPT のログイン、Antigravity は Googleアカウントです。Antigravity の無料プランは、週ごとの利用枠が小さめです。OpenCode は、指定したモデルで動きます。ローカルで動くモデルも使えます。インストールは、それぞれのページから一度だけ行います:[Claude Code](https://code.claude.com/docs/en/setup)、[Codex](https://developers.openai.com/codex)、[Antigravity](https://antigravity.google)、[OpenCode](https://opencode.ai)。
|
|
68
68
|
|
|
69
69
|
- **Claude Code**:キャンペーンのフォルダで `claude` と入力します。フォルダを信頼するか聞かれたら、**Yes, I trust this folder** を選びます。最初に選ばれているのは *No, exit* なので、注意してください。キャンペーンには小さなフック `rpg --listen` もあります。この質問には表示されません。ダッシュボードで操作すると、すぐにGMへ伝えるしくみです。
|
|
70
70
|
- **Codex**:キャンペーンのフォルダで `codex` と入力します。フォルダを信頼するか聞かれたら、yes と答えます。デスクトップアプリでは、設定で、ゲームのチャットのメモリーがオフになっているか確認してください。
|
|
71
|
-
- **Antigravity**:キャンペーンのフォルダで `agy`
|
|
71
|
+
- **Antigravity**:キャンペーンのフォルダで `agy` と入力し、フォルダを信頼するか聞かれたら、yes と答えます。アプリを使う場合は、アプリでキャンペーンのフォルダを開きます。アプリ用に、RPG Engineは Antigravity 自身の設定ファイル(ホームフォルダの `.gemini/config/mcp_config.json`)にも自分を追加します。この設定は、キャンペーンのフォルダだけでなく、開くすべてのフォルダに適用されます。ただし、キャンペーンの外では何もしません。キャンペーンには小さなフックが2つあります。`rpg --approve` は、GMがRPG Engineのツールを、そのつど確認なしで使えるようにします。`rpg --listen` は、ダッシュボードで操作すると、すぐにGMへ伝えます。画像は、GMがチャットの中で自分で描きます。画像ツールが使えないときは、Claude と同じように、簡単なベクター画像を描きます。Antigravity は過去のチャットを保存し、そのメモリーはオフにできません。GMには、過去のチャットを決して読まないよう指示してあります。書いた内容はGoogleに送られ、人が読むことがあります。個人情報はゲームに書かないでください。RPG Engineは Google の製品ではありません。
|
|
72
|
+
- **OpenCode**:キャンペーンのフォルダで `opencode` と入力します。キャンペーンには小さなプラグイン `.opencode/plugins/rpg.js` があり、ダッシュボードで操作すると、すぐにGMへ伝えます。キャンペーンの中では、GMはRPG Engineを通してのみファイルを書き込みます。OpenCode自身のファイルの書き込みと編集はオフになっていて、コマンドを実行する前には確認が表示されます。画像は、GMが簡単なベクター画像として自分で描きます。Claude と同じ方法です。OpenCode で最後に選んだモデルが、チャットの外で、ダッシュボードとゲームのルールの翻訳や、取り込む文書の読み込みも行います。使えるモデルがない場合は、Codex か Claude Code があれば、そちらが行います。
|
|
72
73
|
- **ほかのエージェント**:キャンペーンのフォルダで起動し、MCPサーバー `rpg mcp` を渡します。RPG Engineは標準的なMCPサーバーです。MCPに対応したエージェントなら、ローカルで動くものも含めて、どれでもGMにできます。
|
|
73
74
|
|
|
75
|
+
GMが「RPG Engineのツールが見つからない」と言ったら、キャンペーンのフォルダで `rpg init` と入力します。すでにキャンペーンになっているフォルダでは、これらのファイルが最新の状態になるだけです。そのあと、新しいチャットを開きます。
|
|
76
|
+
|
|
74
77
|
プレイとテストは **Claude Code** で行っています。**Codex** と **Antigravity** は接続と動作の確認まで済んでいますが、キャンペーン全体をまだ遊び通してはいません。キャンペーンでは、エージェント自身のメモリーをオフにします。ゲームの内容はファイルに残るので、セーブに戻ると、本当にその時点に戻れます。
|
|
75
78
|
|
|
76
79
|
### 2.5 最初のチャット
|
|
@@ -183,6 +186,8 @@ RPG Engineは、シーンが終わるたびにキャンペーン全体をセー
|
|
|
183
186
|
|
|
184
187
|
戻ったあとは、**新しいチャットを開いて**ください。古いチャットは、取り消されたことを覚えています。新しいチャットで *continue* と書き、セーブの**新しいチャットを開いた**を押します。
|
|
185
188
|
|
|
189
|
+
キャンペーンのフォルダがgitリポジトリの場合、**設定**に**Git**のセクションがあります。選ぶまでは、すべてオフです。セッションの開始時、セーブのたび、シーンが終わるたびにコミットでき、希望すればそのあとにプッシュもできます。コミットは、その時点のキャンペーンのスナップショットです。プッシュは、スナップショットをGitHubなどのオンラインのリポジトリに送ります。これで、このパソコンの外にもコピーが残ります。セーブと、GMとのチャットは、許可しない限りリポジトリに入りません。チャットを入れるのは、リポジトリが非公開の場合だけにしてください。
|
|
190
|
+
|
|
186
191
|
### 3.9 セッション:中断と再開
|
|
187
192
|
|
|
188
193
|
やめたいときにいつでもやめられます。*[今夜はここまでにしよう。]* すべてすでにファイルに保存されています。再開するには、キャンペーンのフォルダでエージェントを起動し、*continue* と書きます。GMが短くおさらいしてから、続きを進めます。
|
|
@@ -211,10 +216,10 @@ RPG Engineは、行き着いた場所、引き受けたクエスト、出会っ
|
|
|
211
216
|
|
|
212
217
|
- **パーティ**:自分のシートと仲間のシート。数値をクリックするとロールできます。数値にカーソルを重ねると、その数値の由来が表示されます。ダイスの横に矢印がある場合は、ロールが有利になる要因と不利になる要因も表示されます。新しいレベルになったときなど、GMが選択肢を用意すると、シートに通知が表示され、そこから選択肢を開けます。選ぶタイミングは自由です。選択肢に挙がっているページを読み、ロールが必要な選択肢ではロールして、確定します。その間もストーリーは進みます。横にはロールの結果が並びます。
|
|
213
218
|
- **シーン**:現在地、その場所の絵とマップ、そこにいる人物、いま起きていること。戦闘中はターンと、キャラクターのカードが表示されます。
|
|
214
|
-
-
|
|
219
|
+
- **ジャーナル**:クエスト、本のようなストーリー、年表、仲間の日記、自分のメモ。
|
|
215
220
|
- **ワールド**:ワールドマップ、キャラクターが知っていること、見つけた文書、カレンダー。
|
|
216
221
|
- **ダイストレイ**:ダイスと修正値を選んで振ります。×2はダイスの数だけを2倍にし、修正値は2倍になりません。クリティカルヒットのときと同じ扱いです。
|
|
217
|
-
- **セーブ**、**ヘルプ**、**設定**、**概要**:行の末尾にアイコンで並んでいます。**設定**には、ページ自体の好みもあります。テーマ、ダイスの音、ダイスのセット、そして**ゲームのスタイル**です。ゲームのスタイルは、ページの色、顔、絵のことで、ゲームシステムのもの、パッケージ › 追加でカタログ、GitHubのリンク、.zip
|
|
222
|
+
- **セーブ**、**ヘルプ**、**設定**、**概要**:行の末尾にアイコンで並んでいます。**設定**には、ページ自体の好みもあります。テーマ、ダイスの音、ダイスのセット、そして**ゲームのスタイル**です。ゲームのスタイルは、ページの色、顔、絵のことで、ゲームシステムのもの、パッケージ › 追加でカタログ、GitHubのリンク、.zip、フォルダーから追加したテーマ、またはページ独自のものから選べます。テーマ独自のスタイルシートでページが読みにくくなったときは、そこで**テーマ独自のスタイル**をオフにします。**設定**は常にそれなしで表示されます。ページのアドレスの末尾に `#/settings` を付けると開けます。
|
|
218
223
|
|
|
219
224
|
GMから質問があると、どのセクションを開いていても、バナーが上部に表示され続けます。
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ GMが使うコマンドは、すべてキャンペーンフォルダーでも実
|
|
|
308
313
|
|
|
309
314
|
### 困ったとき
|
|
310
315
|
|
|
311
|
-
**ダッシュボードが開きません。** GMに聞いてください:`[OOC: ダッシュボードのリンクを教えてください。]`
|
|
316
|
+
**ダッシュボードが開きません。** GMに聞いてください:`[OOC: ダッシュボードのリンクを教えてください。]` ダッシュボードが使えるのは、そのキャンペーンのチャットが開いている間だけです。Claude CodeとCodexでは、チャットを開くと同時に起動します。Antigravityでは、最初のメッセージを送ると起動します。Claudeアプリでは、バックグラウンドにしばらく置いたチャットはスリープし、ページも一緒にスリープします。そのチャットをクリックすると、同じアドレスでページが戻ります。
|
|
312
317
|
|
|
313
318
|
**GMがゲームを知らないようです。** エージェントがRPG Engineを読み込んでいません。キャンペーンのフォルダで起動したか、フォルダを信頼したか確認してください。Claude Codeでは`/mcp`と書いて、`rpg`に再接続します。Codexでは、キャンペーンのフォルダで`codex mcp list`を実行すると、`rpg`が表示されるはずです。`rpg --version`が見つからない場合は、RPG Engineをもう一度インストールしてください([2.2](#22-install))。
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ GMが使うコマンドは、すべてキャンペーンフォルダーでも実
|
|
|
322
327
|
|
|
323
328
|
**インストールに失敗する、または`rpg`が起動しません。** `node --version`が24以降を示す必要があります。Windowsでスクリプトの実行が無効だと表示されたら、[2.1](#21-what-you-need)を見てください。Windowsでは、RPG Engineとキャンペーンを、`&`を含むパスに置かないでください。
|
|
324
329
|
|
|
325
|
-
**ダッシュボードのリンクが変わりました。**
|
|
330
|
+
**ダッシュボードのリンクが変わりました。** キャンペーンごとに専用のアドレスがあり、チャットが変わっても同じです。アドレスが変わるのは、別のプログラムがすでにそのアドレスを使っているときだけです。その場合はGMが新しいリンクを伝え、以後はそのリンクのままです。同じキャンペーンで2つ目のチャットを開いても、ページは同じアドレスのままです。最初のチャットを閉じると、2つ目のチャットがページを引き継ぎます。
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: 전체 가이드
|
|
3
3
|
|
|
4
4
|
**RPG Engine**은 **AI 게임 마스터**와 함께 테이블탑 롤플레잉 게임을 즐길 수 있게 해 줘요. **채팅**으로 GM과 대화해요. RPG Engine은 뒤에서 **세계를 기억하고**, **주사위를 굴리고**, **계산을 맡아요**. 채팅 옆에는 브라우저에 페이지를 하나 열어 두어요. 바로 **대시보드**예요. 캐릭터 시트, 주사위, 지도, 일지가 있어요.
|
|
@@ -64,13 +64,16 @@ GM은 캠페인을 대신 만들 수 없어요. `init`을 하기 전에는 에
|
|
|
64
64
|
|
|
65
65
|
### 2.4 AI 연결하기
|
|
66
66
|
|
|
67
|
-
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code, Codex, Antigravity가 그 예예요. claude.ai나 ChatGPT 같은 일반 채팅이나 휴대폰 앱으로는 부족해요. GM이 컴퓨터에 있는 캠페인 파일에 접근할 수 있어야 하기 때문이에요. 에이전트마다 요금제와 로그인이 따로 필요해요. Claude Code는 유료 Claude 요금제, Codex는 ChatGPT 로그인, Antigravity는 Google 계정이 필요해요. Antigravity의 무료 요금제는 주간 사용량이 적어요. 설치는 각 에이전트의 페이지에서 한 번만 하면 돼요. [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
67
|
+
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code, Codex, Antigravity, OpenCode가 그 예예요. claude.ai나 ChatGPT 같은 일반 채팅이나 휴대폰 앱으로는 부족해요. GM이 컴퓨터에 있는 캠페인 파일에 접근할 수 있어야 하기 때문이에요. 에이전트마다 요금제와 로그인이 따로 필요해요. Claude Code는 유료 Claude 요금제, Codex는 ChatGPT 로그인, Antigravity는 Google 계정이 필요해요. Antigravity의 무료 요금제는 주간 사용량이 적어요. OpenCode는 직접 연결한 모델로 쓸 수 있고, 로컬 모델도 가능해요. 설치는 각 에이전트의 페이지에서 한 번만 하면 돼요. [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: 캠페인 폴더에서 `claude`를 입력해요. 폴더를 신뢰하는지 물으면 **Yes, I trust this folder**를 선택하세요. 주의하세요. 처음 선택돼 있는 답은 *No, exit*이에요. 캠페인에는 작은 훅 `rpg --listen`도 들어 있어요. 이 질문에는 나오지 않지만, 대시보드에서 행동하면 GM에게 바로 알려 주는 역할을 해요.
|
|
70
70
|
- **Codex**: 캠페인 폴더에서 `codex`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 데스크톱 앱에서는 설정에서 게임 채팅의 메모리가 꺼져 있는지 확인하세요.
|
|
71
|
-
- **Antigravity**: 캠페인 폴더에서 `agy`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 캠페인에는 작은
|
|
71
|
+
- **Antigravity**: 캠페인 폴더에서 `agy`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 앱에서는 캠페인 폴더를 열어도 돼요. 앱을 쓰면 RPG Engine이 홈 폴더의 `.gemini/config/mcp_config.json`, 즉 Antigravity 자체 설정에도 스스로 추가돼요. 이 설정은 캠페인뿐 아니라 여는 모든 폴더에 적용되지만, 캠페인이 아닌 폴더에서는 아무 일도 하지 않아요. 캠페인에는 작은 훅이 두 개 있어요. `rpg --approve`는 GM이 RPG Engine의 도구를 쓸 때마다 매번 허락을 구하지 않게 해 주고, `rpg --listen`은 대시보드에서 행동하면 GM에게 바로 알려 줘요. GM이 이미지를 채팅에서 직접 그려요. 이미지 도구가 실패하면 Claude처럼 단순한 벡터 그림을 그려요. Antigravity는 지난 채팅을 보관하고 메모리도 끌 수 없어요. 그래서 GM은 지난 채팅을 절대 읽지 않도록 안내받아요. 입력한 내용은 Google로 전송되고, Google에서 사람이 읽을 수도 있어요. 개인 정보는 게임에 넣지 마세요. RPG Engine은 Google 제품이 아니에요.
|
|
72
|
+
- **OpenCode**: 캠페인 폴더에서 `opencode`를 입력해요. 캠페인에는 작은 플러그인 `.opencode/plugins/rpg.js`가 있어요. 대시보드에서 행동하면 GM에게 바로 알려 주는 역할을 해요. 캠페인에서 GM은 RPG Engine을 통해서만 파일을 써요. OpenCode 자체의 파일 쓰기와 편집 기능은 캠페인에서 꺼져 있고, 명령을 실행하기 전에는 먼저 물어봐요. GM은 이미지를 Claude처럼 단순한 벡터 그림으로 직접 그려요. OpenCode에서 마지막으로 고른 모델은 채팅 밖에서 대시보드와 게임 규칙을 번역하고, 가져온 문서를 읽는 일도 해요. 쓸 수 있는 모델이 없으면 Codex나 Claude Code가 있을 때 그쪽이 대신해요.
|
|
72
73
|
- **다른 에이전트**: 캠페인 폴더에서 에이전트를 시작하고 MCP 서버 `rpg mcp`를 연결해요. RPG Engine은 표준 MCP 서버예요. MCP를 지원하는 에이전트라면 로컬 에이전트를 포함해 어떤 것이든 GM이 될 수 있어요.
|
|
73
74
|
|
|
75
|
+
GM이 RPG Engine의 도구를 찾을 수 없다고 하면 캠페인 폴더에서 `rpg init`을 입력하세요. 이미 캠페인인 폴더에서는 이 파일들을 최신 상태로만 맞춰 줘요. 그다음 새 채팅을 열어요.
|
|
76
|
+
|
|
74
77
|
저희는 **Claude Code**로 플레이하고 테스트해요. **Codex**와 **Antigravity**는 연결과 확인을 마쳤지만, 아직 캠페인 하나를 끝까지 플레이해 보지는 못했어요. 캠페인은 에이전트 자체의 메모리를 꺼요. 게임은 파일에 저장되기 때문에, 세이브로 돌아가면 정말 그 시점으로 돌아가요.
|
|
75
78
|
|
|
76
79
|
### 2.5 첫 채팅
|
|
@@ -183,6 +186,8 @@ RPG Engine은 장면이 끝날 때마다 캠페인 전체를 저장해요. 나
|
|
|
183
186
|
|
|
184
187
|
되돌린 뒤에는 **새 채팅을 열어** 주세요. 이전 채팅은 취소된 일을 기억하고 있어요. 새 채팅에 *계속*이라고 적고, 세이브에서 **새 채팅을 열었어요**를 누르세요.
|
|
185
188
|
|
|
189
|
+
캠페인 폴더가 git 저장소라면 **설정**에 **Git** 섹션이 있어요. 직접 고르기 전에는 모두 꺼져 있어요. 세션을 시작할 때, 세이브할 때, 장면이 끝날 때마다 커밋할 수 있고, 원하면 그 뒤에 푸시도 할 수 있어요. 커밋은 그 순간 캠페인의 스냅숏이에요. 푸시는 스냅숏을 온라인 저장소(예를 들면 GitHub)로 보내요. 그러면 사본이 이 컴퓨터 밖에도 남아요. 세이브와 GM과 나눈 채팅은 허용하지 않는 한 저장소에 들어가지 않아요. 채팅은 저장소가 비공개일 때만 넣으세요.
|
|
190
|
+
|
|
186
191
|
### 3.9 세션: 멈추고 다시 돌아오기
|
|
187
192
|
|
|
188
193
|
원할 때 언제든 멈출 수 있어요. *[오늘 밤은 여기까지 해요.]* 모든 내용은 이미 파일에 저장되어 있어요. 돌아올 때는 캠페인 폴더에서 에이전트를 시작하고 *계속*이라고 적으세요. GM이 짧게 요약해 주고 이어서 진행해요.
|
|
@@ -214,7 +219,7 @@ RPG Engine은 도착한 장소, 맡은 퀘스트, 만난 인물의 이미지를
|
|
|
214
219
|
- **일지**: 퀘스트, 책으로 읽는 이야기, 타임라인, 동료들의 일기, 내 메모가 있어요.
|
|
215
220
|
- **세계**: 세계 지도, 내 캐릭터가 아는 것, 찾은 문서, 달력이 있어요.
|
|
216
221
|
- **주사위 트레이**: 주사위와 수정치를 고른 뒤 던져요. ×2는 주사위만 두 배로 하고 수정치는 두 배로 하지 않아요. 치명타 때와 같아요.
|
|
217
|
-
- **세이브**, **도움말**, **설정**, **정보**는 줄 끝에 아이콘으로 있어요.
|
|
222
|
+
- **세이브**, **도움말**, **설정**, **정보**는 줄 끝에 아이콘으로 있어요. **설정**에서는 페이지 자체의 환경설정도 바꿀 수 있어요. 테마, 주사위 소리, 주사위 세트, 그리고 페이지의 색, 얼굴, 그림을 정하는 **게임 스타일**이 있어요. 게임 스타일은 게임 시스템의 것, 패키지 › 추가에서 카탈로그, GitHub 링크, .zip 파일, 폴더로 추가한 테마, 또는 페이지 자체의 것 중에서 고를 수 있어요. 테마 고유의 스타일 시트 때문에 페이지가 읽기 어려우면 그곳에서 **테마 고유 스타일**을 끄세요. 설정 화면은 항상 그 스타일 없이 표시돼요. 페이지 주소 끝에 `#/settings`를 붙이면 열려요.
|
|
218
223
|
|
|
219
224
|
GM이 무언가를 물으면 어느 섹션에 있어도 질문 배너가 맨 위에 계속 표시돼요.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ GM이 쓰는 명령은 모두 캠페인 폴더에서 직접 실행할 수도 있
|
|
|
308
313
|
|
|
309
314
|
### 문제
|
|
310
315
|
|
|
311
|
-
**대시보드가 열리지 않아요.** GM에게 물어보세요. `[OOC: 대시보드 링크가 뭐예요?]`
|
|
316
|
+
**대시보드가 열리지 않아요.** GM에게 물어보세요. `[OOC: 대시보드 링크가 뭐예요?]` 대시보드는 그 캠페인의 채팅이 열려 있는 동안에만 열려요. Claude Code와 Codex에서는 채팅이 열릴 때 함께 시작되고, Antigravity에서는 첫 메시지를 보낼 때 시작돼요. Claude 앱에서는 채팅을 한동안 백그라운드에 두면 채팅이 잠들고, 페이지도 함께 잠들어요. 채팅을 클릭하면 같은 주소로 페이지가 다시 돌아와요.
|
|
312
317
|
|
|
313
318
|
**GM이 게임을 모르는 것 같아요.** 에이전트가 RPG Engine을 불러오지 못한 거예요. 캠페인 폴더에서 에이전트를 시작했는지, 폴더를 신뢰했는지 확인하세요. Claude Code에서는 `/mcp`를 입력하고 `rpg`를 다시 연결하세요. Codex에서는 캠페인 폴더에서 `codex mcp list`를 실행했을 때 `rpg`가 보여야 해요. `rpg --version`이 인식되지 않으면 RPG Engine을 다시 설치하세요([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ GM이 쓰는 명령은 모두 캠페인 폴더에서 직접 실행할 수도 있
|
|
|
322
327
|
|
|
323
328
|
**설치가 실패하거나 `rpg`가 시작되지 않아요.** `node --version`이 24 이상이어야 해요. Windows에서 스크립트 실행이 비활성화되어 있다고 나오면 [2.1](#21-what-you-need)을 보세요. Windows에서는 RPG Engine과 캠페인을 `&`가 들어간 경로에 두지 마세요.
|
|
324
329
|
|
|
325
|
-
**대시보드 링크가 바뀌었어요.** 다른 프로그램이
|
|
330
|
+
**대시보드 링크가 바뀌었어요.** 캠페인마다 자기 주소가 있고, 채팅이 바뀌어도 같은 주소예요. 다른 프로그램이 그 주소를 이미 쓰고 있을 때만 바뀌어요. 그러면 GM이 새 링크를 알려 주고, 그 뒤로는 새 링크가 그대로 유지돼요. 같은 캠페인의 채팅을 하나 더 열어도 페이지는 같은 주소에 있어요. 첫 번째 채팅을 닫으면 두 번째 채팅이 페이지를 이어받아요.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: den komplette veiledningen
|
|
3
3
|
|
|
4
4
|
**RPG Engine** lar deg spille et rollespill rundt bordet med en **AI som spilleder**. Du snakker med spillederen i en **chat**. RPG Engine jobber bak kulissene: det **husker verden**, **kaster terningene** og **fører regnskapet**. Ved siden av chatten har du en side åpen i nettleseren, **dashbordet**, med karakterarket, terningene, kartene og dagboken din.
|
|
@@ -64,13 +64,16 @@ Spilleder kan ikke opprette en kampanje for deg: før `init` er det ingenting so
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Koble til AI-en din
|
|
66
66
|
|
|
67
|
-
Spillederen kjører i en **AI-agent**: en AI-app, i terminalen eller på skrivebordet, som kan arbeide med filene på datamaskinen din, for eksempel Claude Code, Codex eller
|
|
67
|
+
Spillederen kjører i en **AI-agent**: en AI-app, i terminalen eller på skrivebordet, som kan arbeide med filene på datamaskinen din, for eksempel Claude Code, Codex, Antigravity eller OpenCode. En vanlig chat som claude.ai eller ChatGPT, eller en app på telefonen, er ikke nok: spillederen må kunne nå kampanjens filer på datamaskinen din. Hver agent trenger sitt eget abonnement og sin egen innlogging: Claude Code et betalt Claude-abonnement, Codex en ChatGPT-innlogging, Antigravity en Google-konto, der gratisabonnementet har en liten ukentlig kvote. OpenCode fungerer med modellene du gir den, også lokale. Du installerer agenten én gang, fra agentens egen side: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: skriv `claude` i kampanjemappen. Når den spør om du stoler på mappen, velger du **Yes, I trust this folder**. Pass på: svaret som er valgt på forhånd, er *No, exit*. Kampanjen har også en liten krok, `rpg --listen`, som spørsmålet ikke viser: den forteller spillederen med en gang når du gjør noe fra dashbordet.
|
|
70
70
|
- **Codex**: skriv `codex` i kampanjemappen, og svar ja når den spør om du stoler på mappen. I skrivebordsappen sjekker du i innstillingene at minner er slått av for spillets chatter.
|
|
71
|
-
- **Antigravity**: skriv `agy` i kampanjemappen, og svar ja hvis den spør om du stoler på mappen. Kampanjen har
|
|
71
|
+
- **Antigravity**: skriv `agy` i kampanjemappen, og svar ja hvis den spør om du stoler på mappen. Eller åpne kampanjemappen i appen. For appen legger RPG Engine seg også inn i Antigravitys egne innstillinger, `.gemini/config/mcp_config.json` i hjemmemappen din. De gjelder for hver mappe du åpner, ikke bare kampanjens: utenfor en kampanje gjør RPG Engine ingenting. Kampanjen har to små kroker: `rpg --approve` lar spillederen bruke verktøyene til RPG Engine uten å spørre deg hver gang, og `rpg --listen` forteller spillederen med en gang når du gjør noe fra dashbordet. Spillederen maler bildene i chatten selv. Når bildeverktøyet svikter, tegner spillederen enkle vektorbilder, slik Claude gjør. Antigravity beholder de tidligere chattene dine, og minnet kan ikke slås av: spillederen er instruert om aldri å lese dem. Det du skriver, går til Google, som kan la folk lese det: hold personopplysninger utenfor spillet. RPG Engine er ikke et Google-produkt.
|
|
72
|
+
- **OpenCode**: skriv `opencode` i kampanjemappen. Kampanjen har en liten plugin, `.opencode/plugins/rpg.js`, som forteller spillederen med en gang når du gjør noe fra dashbordet. I kampanjen skriver spillederen filer bare gjennom RPG Engine: OpenCodes egen skriving og redigering av filer er slått av der, og den spør deg før den kjører en kommando. Spillederen tegner bildene selv, som enkle vektorbilder, slik Claude gjør. OpenCode-en din, med modellen du valgte sist i den, oversetter også dashbordet og spillets regler og leser dokumentene du importerer, utenfor chatten. Har den ingen modell den kan bruke, gjør Codex eller Claude Code det hvis du har dem.
|
|
72
73
|
- **En annen agent**: start den i kampanjemappen og gi den MCP-tjeneren `rpg mcp`. RPG Engine er en standard MCP-tjener: alle agenter som støtter MCP kan være spilleder, også lokale.
|
|
73
74
|
|
|
75
|
+
Hvis spillederen ikke finner verktøyene til RPG Engine, skriver du `rpg init` i kampanjemappen: i en mappe som allerede er en kampanje, oppdaterer det bare disse filene. Åpne deretter en ny chat.
|
|
76
|
+
|
|
74
77
|
Vi spiller og tester med **Claude Code**. **Codex** og **Antigravity** er koblet til og kontrollert, men ingen hel kampanje er spilt med dem ennå. Kampanjen slår av agentens eget minne: spillet lever i filene sine, slik at et lagret spill virkelig tar deg tilbake.
|
|
75
78
|
|
|
76
79
|
### 2.5 Den første chatten
|
|
@@ -183,6 +186,8 @@ I alle modi kan du **begynne på nytt**, fra starten av spillet eller fra sesjon
|
|
|
183
186
|
|
|
184
187
|
Etter at du har gått tilbake, **åpne en ny chat**: den gamle husker det som er blitt angret. Skriv *fortsett* i den nye chatten, og trykk deretter på **Jeg har åpnet en ny chat** i Lagrede spill.
|
|
185
188
|
|
|
189
|
+
Hvis kampanjemappen er et git-arkiv, har **Innstillinger** en **Git**-del, alt avslått til du velger selv: en commit ved starten av hver sesjon, ved hvert lagrede spill og ved slutten av hver scene, og en push etter den hvis du vil. En commit er et øyeblikksbilde av kampanjen på det tidspunktet. En push sender øyeblikksbildene til arkivet på nettet, for eksempel på GitHub, slik at en kopi finnes utenfor denne datamaskinen. De lagrede spillene og chattene dine med spillederen holdes utenfor arkivet, med mindre du slipper dem inn. Slipp bare chattene inn hvis arkivet er privat.
|
|
190
|
+
|
|
186
191
|
### 3.9 Sesjoner: å stoppe og komme tilbake
|
|
187
192
|
|
|
188
193
|
Stopp når du vil: *[La oss stoppe her for i kveld.]* Alt er allerede lagret i filene. For å komme tilbake starter du agenten din i kampanjemappen og skriver *fortsett*: spillederen gir deg en kort oppsummering og fortsetter.
|
|
@@ -209,12 +214,12 @@ Alle innstillinger kan endres, i chatten eller i **Innstillinger**. En avgjørel
|
|
|
209
214
|
|
|
210
215
|
En side på din egen datamaskin. Den åpnes bare i nettleseren på den maskinen, og den er i gang så lenge samtalen er åpen. Når samtalen lukkes, viser den *Not connected*. Den kommer tilbake av seg selv med neste samtale.
|
|
211
216
|
|
|
212
|
-
- **Gruppe**: karakterarket ditt og følgesvennenes. Klikk på et tall for å kaste det. Hold musepekeren over det for å se hvor det kommer fra og, når en pil markerer terningen, hva som gjør kastet bedre eller verre. Når
|
|
217
|
+
- **Gruppe**: karakterarket ditt og følgesvennenes. Klikk på et tall for å kaste det. Hold musepekeren over det for å se hvor det kommer fra og, når en pil markerer terningen, hva som gjør kastet bedre eller verre. Når spilleder forbereder valg til deg, for eksempel ved et nytt nivå, åpner et varsel på karakterarket dem. Velg når du vil, les sidene som alternativene nevner, kast der et alternativ krever det, og bekreft. Historien går videre i mellomtiden. Ved siden av ser du kastene.
|
|
213
218
|
- **Scene**: hvor du er, bilde og kart, hvem som er der, og hva som skjer. I en kamp ser du turene og kortet til karakteren din.
|
|
214
219
|
- **Dagbok**: oppdrag, historien som en bok, tidslinjen, følgesvennenes dagbøker og notatene dine.
|
|
215
220
|
- **Verden**: verdenskartet, det karakteren din vet, dokumentene som er funnet, og kalenderen.
|
|
216
221
|
- **Terningbrettet**: velg terninger og en modifikator, og kast. ×2 dobler terningene, aldri modifikatoren, som ved et kritisk treff.
|
|
217
|
-
- **Lagrede spill**, **Hjelp**, **Innstillinger** og **Om** ligger som ikoner ytterst i raden. **Innstillinger** rommer også sidens egne valg: tema, terninglyd, terningsett og **Spillets stil**, altså fargene, ansiktene og bildene på siden. Du kan velge spillsystemets egen stil, et tema du har lagt til under Packages › Add fra katalogen, med en GitHub-lenke, en .zip eller en mappe, eller sidens egen stil.
|
|
222
|
+
- **Lagrede spill**, **Hjelp**, **Innstillinger** og **Om** ligger som ikoner ytterst i raden. **Innstillinger** rommer også sidens egne valg: tema, terninglyd, terningsett og **Spillets stil**, altså fargene, ansiktene og bildene på siden. Du kan velge spillsystemets egen stil, et tema du har lagt til under Packages › Add fra katalogen, med en GitHub-lenke, en .zip eller en mappe, eller sidens egen stil. Hvis temaets egen stilark gjør siden vanskelig å lese, slå av **Temaets egen stil** der. **Innstillinger** vises alltid uten den, på sidens adresse med `#/settings` til slutt.
|
|
218
223
|
|
|
219
224
|
Når spilleder spør deg om noe, blir banneretværende øverst, uansett hvilken del du er i.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ Hver kommando spilleder bruker, kan også kjøres i kampanjemappen: `rpg --help`
|
|
|
308
313
|
|
|
309
314
|
### Problemer
|
|
310
315
|
|
|
311
|
-
**Dashbordet åpnes ikke.** Spør spillederen: `[OOC: Hva er lenken til dashbordet?]`. Det fungerer bare mens en chat er åpen i
|
|
316
|
+
**Dashbordet åpnes ikke.** Spør spillederen: `[OOC: Hva er lenken til dashbordet?]`. Det fungerer bare mens en chat i den kampanjen er åpen: i Claude Code og Codex starter det når chatten åpnes, i Antigravity med den første meldingen din. I Claude-appen går en chat som har ligget en stund i bakgrunnen, i dvale, og siden med den: klikk på chatten, så kommer siden tilbake på samme adresse.
|
|
312
317
|
|
|
313
318
|
**Spillederen ser ikke ut til å kunne spillet.** Agenten din lastet ikke RPG Engine. Sjekk at du startet den i kampanjemappen og stolte på den. I Claude Code, skriv `/mcp` og koble til `rpg` på nytt. I Codex må `codex mcp list` i kampanjemappen vise `rpg`. Hvis `rpg --version` ikke blir funnet, installer RPG Engine på nytt ([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ Hver kommando spilleder bruker, kan også kjøres i kampanjemappen: `rpg --help`
|
|
|
322
327
|
|
|
323
328
|
**Installasjonen mislykkes, eller `rpg` vil ikke starte.** `node --version` må vise 24 eller nyere. Hvis Windows svarer at det er slått av å kjøre skript, se [2.1](#21-what-you-need). På Windows, hold RPG Engine og kampanjene dine unna stier som inneholder `&`.
|
|
324
329
|
|
|
325
|
-
**Lenken til dashbordet endret seg.**
|
|
330
|
+
**Lenken til dashbordet endret seg.** Hver kampanje har sin egen adresse, den samme chat etter chat. Den endres bare når et annet program allerede bruker den: spillederen gir deg den nye lenken, og fra da av beholder kampanjen den. En andre chat i samme kampanje beholder siden på samme adresse, og tar den over når du lukker den første.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: de complete handleiding
|
|
3
3
|
|
|
4
4
|
**RPG Engine** laat je een tafelrollenspel spelen met een **AI als spelleider**. Je praat met de spelleider in een **chat**; RPG Engine werkt op de achtergrond: het **onthoudt de wereld**, **gooit de dobbelstenen** en **houdt de cijfers bij**. Naast de chat houd je een pagina open in je browser, het **dashboard**, met je karakterblad, de dobbelstenen, de kaarten en je dagboek.
|
|
@@ -64,12 +64,15 @@ De spelleider kan geen campagne voor je maken: vóór `init` vertelt niets je ag
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Je AI koppelen
|
|
66
66
|
|
|
67
|
-
De spelleider draait in een **AI-agent**: een AI-app, in de terminal of op het bureaublad, die met de bestanden op je computer kan werken, zoals Claude Code, Codex of
|
|
67
|
+
De spelleider draait in een **AI-agent**: een AI-app, in de terminal of op het bureaublad, die met de bestanden op je computer kan werken, zoals Claude Code, Codex, Antigravity of OpenCode. Een gewone chat zoals claude.ai of ChatGPT, of een app op je telefoon, is niet genoeg: de spelleider moet bij de bestanden van de campagne op je computer kunnen. Elke agent heeft een eigen abonnement en een eigen login: Claude Code een betaald Claude-abonnement, Codex een ChatGPT-login, Antigravity een Google-account, waarvan het gratis abonnement een klein weekquotum heeft. OpenCode werkt met de modellen die je het geeft, ook lokale. Je installeert de agent één keer, vanaf de eigen pagina: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
|
-
- **Claude Code**: typ `claude` in de campagnemap. Als het vraagt of je de map vertrouwt, kies dan **Yes, I trust this folder**. Let op: het antwoord dat al geselecteerd staat is *No, exit*. De campagne heeft ook een
|
|
69
|
+
- **Claude Code**: typ `claude` in de campagnemap. Als het vraagt of je de map vertrouwt, kies dan **Yes, I trust this folder**. Let op: het antwoord dat al geselecteerd staat is *No, exit*. De campagne heeft ook een kleine hook, `rpg --listen`, die de vraag niet laat zien: de hook vertelt de spelleider meteen wanneer je iets doet op het dashboard.
|
|
70
70
|
- **Codex**: typ `codex` in de campagnemap en zeg ja als het vraagt of je de map vertrouwt. Controleer in de desktop-app bij de instellingen dat het geheugen uit staat voor de chats van het spel.
|
|
71
|
-
- **Antigravity**: typ `agy` in de campagnemap en zeg ja als het vraagt of je de map vertrouwt. De campagne heeft
|
|
72
|
-
- **
|
|
71
|
+
- **Antigravity**: typ `agy` in de campagnemap en zeg ja als het vraagt of je de map vertrouwt. Of open in de app de campagnemap. Voor de app voegt RPG Engine zichzelf ook toe aan de eigen instellingen van Antigravity, `.gemini/config/mcp_config.json` in je thuismap. Die gelden voor elke map die je opent, niet alleen voor die van de campagne: buiten een campagne doet RPG Engine dan niets. De campagne heeft twee kleine hooks: met `rpg --approve` kan de spelleider de tools van RPG Engine gebruiken zonder het je elke keer te vragen, en `rpg --listen` vertelt de spelleider meteen wanneer je iets doet op het dashboard. De spelleider schildert de afbeeldingen zelf in de chat. Als de afbeeldingstool het laat afweten, tekent de spelleider eenvoudige vectorafbeeldingen, zoals Claude dat doet. Antigravity bewaart je eerdere chats en het geheugen kan niet worden uitgezet: de spelleider krijgt de opdracht ze nooit te lezen. Wat je schrijft gaat naar Google, dat het door mensen kan laten lezen: houd persoonlijke gegevens buiten het spel. RPG Engine is geen product van Google.
|
|
72
|
+
- **OpenCode**: typ `opencode` in de campagnemap. De campagne heeft een kleine plug-in, `.opencode/plugins/rpg.js`, die de spelleider meteen vertelt wanneer je iets doet op het dashboard. In de campagne schrijft de spelleider alleen bestanden via RPG Engine: het eigen schrijven en bewerken van bestanden door OpenCode staat daar uit, en OpenCode vraagt het je eerst voordat het een commando uitvoert. De spelleider tekent de afbeeldingen zelf, als eenvoudige vectorafbeeldingen, zoals Claude dat doet. Jouw OpenCode, met het model dat je er het laatst in hebt gekozen, vertaalt buiten de chat ook het dashboard en de regels van het spel en leest de documenten die je importeert. Heeft het geen model dat het kan gebruiken, dan doen Codex of Claude Code dat, als je ze hebt.
|
|
73
|
+
- **Een andere agent**: start die in de campagnemap en geef de agent de MCP-server `rpg mcp`. RPG Engine is een standaard MCP-server: elke agent die MCP ondersteunt kan de spelleider zijn, ook lokale agents.
|
|
74
|
+
|
|
75
|
+
Zegt de spelleider dat die de tools van RPG Engine niet kan vinden, typ dan `rpg init` in de campagnemap. In een map die al een campagne is, brengt dit alleen deze bestanden op de nieuwste stand. Open daarna een nieuwe chat.
|
|
73
76
|
|
|
74
77
|
Wij spelen en testen met **Claude Code**. **Codex** en **Antigravity** zijn gekoppeld en gecontroleerd, maar er is nog geen hele campagne mee gespeeld. De campagne zet het eigen geheugen van de agent uit: het spel leeft in de bestanden, zodat terugkeren naar een opgeslagen spel ook echt teruggaat.
|
|
75
78
|
|
|
@@ -183,6 +186,8 @@ In elke modus kun je **opnieuw beginnen**, vanaf het begin van het spel of vanaf
|
|
|
183
186
|
|
|
184
187
|
Open na het teruggaan **een nieuwe chat**: de oude chat onthoudt wat ongedaan is gemaakt. Schrijf *ga verder* in de nieuwe chat en druk dan bij Opgeslagen spellen op **Ik heb een nieuwe chat geopend**.
|
|
185
188
|
|
|
189
|
+
Als de map van de campagne een git-repository is, heeft **Instellingen** een sectie **Git**, die helemaal uit staat tot jij kiest: een commit aan het begin van elke sessie, bij elke keer opslaan en aan het einde van elke scène, en daarna een push als je dat wilt. Een commit is een momentopname van de campagne op dat moment. Een push stuurt de momentopnamen naar de repository online, bijvoorbeeld op GitHub, zodat er ook buiten deze computer een kopie bestaat. De opgeslagen spellen en je chats met de spelleider blijven buiten de repository, tenzij je ze toelaat. Laat de chats alleen toe als de repository privé is.
|
|
190
|
+
|
|
186
191
|
### 3.9 Sessies: stoppen en terugkomen
|
|
187
192
|
|
|
188
193
|
Stop wanneer je wilt: *[Laten we er voor vanavond mee ophouden.]* Alles staat al opgeslagen in de bestanden. Om terug te komen start je je agent in de campagnemap en schrijf je *ga verder*. De spelleider geeft je een korte samenvatting en gaat verder.
|
|
@@ -214,7 +219,7 @@ Een pagina op je eigen computer. Je opent hem alleen in de browser van die compu
|
|
|
214
219
|
- **Dagboek**: missies, het verhaal als boek, de tijdlijn, de dagboeken van je metgezellen en je notities.
|
|
215
220
|
- **Wereld**: de wereldkaart, wat jouw personage weet, de gevonden documenten en de kalender.
|
|
216
221
|
- **De dobbelbak**: kies dobbelstenen en een modifier en gooi. ×2 verdubbelt de dobbelstenen, nooit de modifier, zoals bij een kritieke treffer.
|
|
217
|
-
- **Opgeslagen spellen**, **Help**, **Instellingen** en **Over**: als pictogrammen aan het eind van de rij. Bij **Instellingen** vind je ook de voorkeuren van de pagina zelf: thema, dobbelgeluid, dobbelsteenset en de **Stijl van het spel**. Dat zijn de kleuren, gezichten en afbeeldingen van de pagina. Je kiest die van het spelsysteem, een thema dat je hebt toegevoegd via Packages › Add (uit de catalogus, met een GitHub-link, met een .zip of met een map), of die van de pagina zelf.
|
|
222
|
+
- **Opgeslagen spellen**, **Help**, **Instellingen** en **Over**: als pictogrammen aan het eind van de rij. Bij **Instellingen** vind je ook de voorkeuren van de pagina zelf: thema, dobbelgeluid, dobbelsteenset en de **Stijl van het spel**. Dat zijn de kleuren, gezichten en afbeeldingen van de pagina. Je kiest die van het spelsysteem, een thema dat je hebt toegevoegd via Packages › Add (uit de catalogus, met een GitHub-link, met een .zip of met een map), of die van de pagina zelf. Maakt de eigen stijlpagina van een thema de pagina slecht leesbaar? Zet dan **Eigen stijl van het thema** daar uit. **Instellingen** zie je altijd zonder die stijl, op het adres van de pagina met `#/settings` aan het eind.
|
|
218
223
|
|
|
219
224
|
Als de spelleider je iets vraagt, blijft de banner bovenaan staan, in welk onderdeel je ook bent.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ Elk commando dat de spelleider gebruikt, kun je ook in de campagnemap uitvoeren:
|
|
|
308
313
|
|
|
309
314
|
### Problemen
|
|
310
315
|
|
|
311
|
-
**Het dashboard gaat niet open.** Vraag het de spelleider: `[OOC: Wat is de link naar het dashboard?]`. Het werkt alleen zolang er een chat open is in
|
|
316
|
+
**Het dashboard gaat niet open.** Vraag het de spelleider: `[OOC: Wat is de link naar het dashboard?]`. Het werkt alleen zolang er een chat van die campagne open is: in Claude Code en Codex start het zodra de chat opent, in Antigravity met je eerste bericht. In de Claude-app valt een chat die een tijdje op de achtergrond staat in slaap, en de pagina met de chat. Klik op de chat, en de pagina komt terug op hetzelfde adres.
|
|
312
317
|
|
|
313
318
|
**De spelleider lijkt het spel niet te kennen.** Je agent heeft RPG Engine niet geladen. Controleer of je hem in de campagnemap hebt gestart en de map hebt vertrouwd. Schrijf in Claude Code `/mcp` en verbind `rpg` opnieuw. In Codex moet `codex mcp list` in de campagnemap `rpg` tonen. Wordt `rpg --version` niet gevonden, installeer RPG Engine dan opnieuw ([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ Elk commando dat de spelleider gebruikt, kun je ook in de campagnemap uitvoeren:
|
|
|
322
327
|
|
|
323
328
|
**Installeren mislukt, of `rpg` start niet.** `node --version` moet 24 of nieuwer zeggen. Als Windows antwoordt dat het uitvoeren van scripts is uitgeschakeld, zie dan [2.1](#21-what-you-need). Houd RPG Engine en je campagnes op Windows buiten paden die `&` bevatten.
|
|
324
329
|
|
|
325
|
-
**De link naar het dashboard is veranderd.**
|
|
330
|
+
**De link naar het dashboard is veranderd.** Elke campagne houdt haar eigen adres, chat na chat. Het verandert alleen als een ander programma dat adres al gebruikt: de spelleider geeft je dan de nieuwe link, die de campagne daarna houdt. Een tweede chat van dezelfde campagne houdt de pagina op hetzelfde adres en neemt die over zodra je de eerste sluit.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: pełny przewodnik
|
|
3
3
|
|
|
4
4
|
**RPG Engine** pozwala grać w tradycyjną grę fabularną z **AI w roli Mistrza Gry**. Rozmawiasz z Mistrzem Gry na **czacie**. RPG Engine pracuje w tle: **pamięta świat**, **rzuca kośćmi** i **prowadzi rachunki**. Obok czatu trzymasz otwartą w przeglądarce stronę, czyli **dashboard**, z kartą postaci, kośćmi, mapami i dziennikiem.
|
|
@@ -64,13 +64,16 @@ Mistrz Gry nie może utworzyć kampanii za Ciebie: przed `init` nic nie mówi ag
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Połącz swoją AI
|
|
66
66
|
|
|
67
|
-
Mistrz Gry działa w **agencie AI**: aplikacji AI, w terminalu lub na pulpicie, która potrafi pracować na plikach na Twoim komputerze, jak Claude Code, Codex czy
|
|
67
|
+
Mistrz Gry działa w **agencie AI**: aplikacji AI, w terminalu lub na pulpicie, która potrafi pracować na plikach na Twoim komputerze, jak Claude Code, Codex, Antigravity czy OpenCode. Zwykły czat, taki jak claude.ai lub ChatGPT, ani aplikacja na telefon nie wystarczą: Mistrz Gry musi mieć dostęp do plików kampanii na Twoim komputerze. Każdy agent wymaga własnego planu i logowania: Claude Code płatnego planu Claude, Codex logowania do ChatGPT, Antigravity konta Google, którego darmowy plan ma niewielki tygodniowy limit. OpenCode działa z modelami, które mu podasz, także lokalnymi. Instalujesz agenta raz, ze strony agenta: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: w folderze kampanii wpisz `claude`. Gdy zapyta, czy ufasz folderowi, wybierz **Yes, I trust this folder**. Uwaga: domyślnie zaznaczona jest odpowiedź *No, exit*. Kampania ma też mały hook, `rpg --listen`, którego to pytanie nie pokazuje: informuje on Mistrza Gry od razu, gdy działasz z dashboardu.
|
|
70
70
|
- **Codex**: w folderze kampanii wpisz `codex` i zgódź się, gdy zapyta, czy ufasz folderowi. W jego aplikacji na pulpit sprawdź w ustawieniach, czy pamięć jest wyłączona dla czatów gry.
|
|
71
|
-
- **Antigravity**: w folderze kampanii wpisz `agy` i zgódź się, jeśli zapyta, czy ufasz folderowi. Kampania ma
|
|
71
|
+
- **Antigravity**: w folderze kampanii wpisz `agy` i zgódź się, jeśli zapyta, czy ufasz folderowi. Możesz też otworzyć folder kampanii w jego aplikacji. Na potrzeby aplikacji RPG Engine dodaje się również do własnych ustawień Antigravity, w pliku `.gemini/config/mcp_config.json` w Twoim folderze domowym. Ustawienia te obowiązują w każdym otwieranym folderze, nie tylko w folderze kampanii: poza kampanią RPG Engine nic nie robi. Kampania ma dwa małe hooki: `rpg --approve` pozwala Mistrzowi Gry używać narzędzi RPG Engine bez pytania Cię za każdym razem, a `rpg --listen` informuje Mistrza Gry od razu, gdy działasz z dashboardu. Obrazy w czacie Mistrz Gry maluje sam; gdy jego narzędzie do obrazów zawodzi, rysuje proste obrazy wektorowe, tak jak Claude. Antigravity zachowuje Twoje dawne czaty, a jego pamięci nie da się wyłączyć: Mistrz Gry ma polecenie, by nigdy ich nie czytać. To, co piszesz, trafia do Google, który może pozwolić ludziom to czytać: nie podawaj w grze danych osobowych. RPG Engine nie jest produktem Google.
|
|
72
|
+
- **OpenCode**: w folderze kampanii wpisz `opencode`. Kampania ma mały plugin, `.opencode/plugins/rpg.js`, który informuje Mistrza Gry od razu, gdy działasz z dashboardu. W kampanii Mistrz Gry zapisuje pliki wyłącznie przez RPG Engine: własne zapisywanie i edytowanie plików w OpenCode jest tam wyłączone, a przed uruchomieniem polecenia OpenCode pyta Cię o zgodę. Mistrz Gry sam rysuje obrazy, jako proste obrazy wektorowe, tak jak Claude. Twój OpenCode, z modelem, który ostatnio w nim wybrano, tłumaczy też dashboard i zasady gry oraz czyta importowane dokumenty, poza czatem. Jeśli nie ma modelu, którego może użyć, robią to Codex lub Claude Code, o ile je masz.
|
|
72
73
|
- **Inny agent**: uruchom go w folderze kampanii i podaj mu serwer MCP `rpg mcp`. RPG Engine to standardowy serwer MCP: Mistrzem Gry może być każdy agent obsługujący MCP, także lokalny.
|
|
73
74
|
|
|
75
|
+
Jeśli Mistrz Gry mówi, że nie może znaleźć narzędzi RPG Engine, wpisz `rpg init` w folderze kampanii: w folderze, który już jest kampanią, polecenie tylko aktualizuje te pliki. Potem otwórz nowy czat.
|
|
76
|
+
|
|
74
77
|
Gramy i testujemy z **Claude Code**. **Codex** i **Antigravity** są podłączone i sprawdzone, ale nie rozegrano z nimi jeszcze całej kampanii. Kampania wyłącza własną pamięć agenta: gra żyje w jego plikach, dzięki czemu powrót do zapisu naprawdę cofa grę.
|
|
75
78
|
|
|
76
79
|
### 2.5 Pierwszy czat
|
|
@@ -183,6 +186,8 @@ W każdym trybie możesz **zacząć od nowa**, od początku gry lub od sesji zer
|
|
|
183
186
|
|
|
184
187
|
Po powrocie **otwórz nowy czat**: stary pamięta to, co zostało cofnięte. Napisz *kontynuuj* na nowym czacie, a potem naciśnij **Nowy czat otwarty** w Zapisach.
|
|
185
188
|
|
|
189
|
+
Jeśli folder kampanii jest repozytorium Git, w **Ustawieniach** znajdziesz sekcję **Git**, w której wszystko jest wyłączone, dopóki nie wybierzesz inaczej: commit na początku każdej sesji, przy każdym zapisie i na końcu każdej sceny, a po nim, jeśli chcesz, push. Commit to migawka kampanii z danej chwili. Push wysyła migawki do repozytorium online, na przykład na GitHubie, żeby kopia istniała też poza tym komputerem. Zapisy i Twoje czaty z Mistrzem Gry nie trafiają do repozytorium, chyba że je tam dopuścisz. Dopuszczaj czaty tylko wtedy, gdy repozytorium jest prywatne.
|
|
190
|
+
|
|
186
191
|
### 3.9 Sesje: przerwa i powrót
|
|
187
192
|
|
|
188
193
|
Przerwij, kiedy chcesz: *[Skończmy na dziś.]* Wszystko jest już zapisane w plikach. Żeby wrócić, uruchom swojego agenta w folderze kampanii i napisz *kontynuuj*: Mistrz Gry krótko podsumuje, co było, i poprowadzi dalej.
|
|
@@ -214,7 +219,7 @@ Strona na Twoim komputerze, otwierana tylko w przeglądarce na tym komputerze. D
|
|
|
214
219
|
- **Dziennik**: zadania, historia jako książka, jej oś czasu, dzienniki towarzyszy, Twoje notatki.
|
|
215
220
|
- **Świat**: mapa świata, to, co wie Twoja postać, znalezione dokumenty i kalendarz.
|
|
216
221
|
- **Tacka na kości**: wybierz kości i modyfikator, potem rzuć. ×2 podwaja kości, nigdy modyfikator, tak jak przy trafieniu krytycznym.
|
|
217
|
-
- **Zapisy**, **Pomoc**, **Ustawienia** i **Informacje**: ikony na końcu rzędu. W **Ustawieniach** są też preferencje samej strony: motyw, dźwięk kości, zestaw kości oraz **Styl gry**, czyli kolory, ścianki kości i obrazy strony. Może to być styl systemu gry, motyw dodany w Packages › Add (z katalogu, z linku do GitHuba, z pliku .zip lub z folderu) albo styl samej strony.
|
|
222
|
+
- **Zapisy**, **Pomoc**, **Ustawienia** i **Informacje**: ikony na końcu rzędu. W **Ustawieniach** są też preferencje samej strony: motyw, dźwięk kości, zestaw kości oraz **Styl gry**, czyli kolory, ścianki kości i obrazy strony. Może to być styl systemu gry, motyw dodany w Packages › Add (z katalogu, z linku do GitHuba, z pliku .zip lub z folderu) albo styl samej strony. Jeśli własny arkusz stylów motywu sprawia, że strona jest trudna do czytania, wyłącz tam **Własny styl motywu**. **Ustawienia** zawsze pokazują się bez niego, pod adresem strony z `#/settings` na końcu.
|
|
218
223
|
|
|
219
224
|
Gdy Mistrz Gry o coś pyta, jego baner zostaje na górze, w jakiejkolwiek sekcji jesteś.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ Każde polecenie, którego używa Mistrz Gry, można też uruchomić w folderze
|
|
|
308
313
|
|
|
309
314
|
### Problemy
|
|
310
315
|
|
|
311
|
-
**Dashboard się nie otwiera.** Zapytaj Mistrza Gry: `[OOC: Jaki jest link do dashboardu?]`. Działa tylko wtedy, gdy
|
|
316
|
+
**Dashboard się nie otwiera.** Zapytaj Mistrza Gry: `[OOC: Jaki jest link do dashboardu?]`. Działa tylko wtedy, gdy otwarty jest czat tej kampanii: w Claude Code i Codex uruchamia się razem z czatem, w Antigravity z Twoją pierwszą wiadomością. W aplikacji Claude czat zostawiony na jakiś czas w tle zasypia, a razem z nim strona: kliknij czat, a strona wróci pod tym samym adresem.
|
|
312
317
|
|
|
313
318
|
**Mistrz Gry chyba nie zna gry.** Twój agent nie załadował RPG Engine. Sprawdź, czy uruchomiono go w folderze kampanii i czy ufasz temu folderowi. W Claude Code wpisz `/mcp` i połącz ponownie `rpg`. W Codex polecenie `codex mcp list` w folderze kampanii musi pokazać `rpg`. Jeśli `rpg --version` nie zostanie znalezione, zainstaluj RPG Engine ponownie ([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ Każde polecenie, którego używa Mistrz Gry, można też uruchomić w folderze
|
|
|
322
327
|
|
|
323
328
|
**Instalacja się nie udaje albo `rpg` nie startuje.** `node --version` musi pokazać 24 lub nowszą wersję. Jeśli Windows odpowie, że uruchamianie skryptów jest wyłączone, zobacz [2.1](#21-what-you-need). W systemie Windows trzymaj RPG Engine i swoje kampanie poza ścieżkami zawierającymi `&`.
|
|
324
329
|
|
|
325
|
-
**Link do dashboardu się zmienił.**
|
|
330
|
+
**Link do dashboardu się zmienił.** Każda kampania ma własny adres, taki sam czat po czacie. Zmienia się on tylko wtedy, gdy zajmuje go już inny program: Mistrz Gry poda Ci nowy link, który od tej chwili zostaje. Drugi czat tej samej kampanii zachowuje stronę pod tym samym adresem i przejmuje ją, gdy zamkniesz pierwszy.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: o guia completo
|
|
3
3
|
|
|
4
4
|
**RPG Engine** permite que você jogue um jogo de RPG de mesa com uma **IA como mestre**. Você conversa com o mestre em um **chat**; o RPG Engine trabalha nos bastidores: ele **lembra do mundo**, **rola os dados** e **faz as contas**. Ao lado do chat, você mantém aberta uma página no navegador, o **painel**, com sua ficha, os dados, os mapas e seu diário.
|
|
@@ -64,13 +64,16 @@ O mestre não pode criar uma campanha para você: antes do `init`, nada diz ao s
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Conectar sua IA
|
|
66
66
|
|
|
67
|
-
O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code, o Codex ou o
|
|
67
|
+
O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code, o Codex, o Antigravity ou o OpenCode. Um chat simples, como o claude.ai ou o ChatGPT, ou um app de celular, não basta: o mestre precisa acessar os arquivos da campanha no seu computador. Cada agente exige seu próprio plano e login: o Claude Code, um plano pago do Claude; o Codex, um login do ChatGPT; o Antigravity, uma conta Google, cujo plano gratuito tem uma pequena cota semanal; o OpenCode funciona com os modelos que você fornecer, inclusive locais. Você instala o agente uma vez, pela página dele: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: na pasta da campanha, escreva `claude`. Quando ele perguntar se você confia na pasta, escolha **Yes, I trust this folder**; atenção, a resposta já selecionada é *No, exit*. A campanha também tem um pequeno hook, `rpg --listen`, que a pergunta não mostra: ele avisa o mestre na hora quando você age pelo dashboard.
|
|
70
70
|
- **Codex**: na pasta da campanha, escreva `codex` e diga sim quando ele perguntar se você confia na pasta. No app de desktop, confira nas configurações se as memórias estão desligadas para os chats do jogo.
|
|
71
|
-
- **Antigravity**: na pasta da campanha, escreva `agy` e diga sim se ele perguntar se você confia na pasta. A campanha tem
|
|
71
|
+
- **Antigravity**: na pasta da campanha, escreva `agy` e diga sim se ele perguntar se você confia na pasta; ou, no app dele, abra a pasta da campanha. Para o app, o RPG Engine também se adiciona às configurações do próprio Antigravity, `.gemini/config/mcp_config.json` na sua pasta pessoal, que valem para toda pasta que você abrir, não só a da campanha: fora de uma campanha, ele não faz nada. A campanha tem dois pequenos hooks: `rpg --approve` permite ao mestre usar as ferramentas do RPG Engine sem perguntar a você a cada vez, e `rpg --listen` avisa o mestre na hora quando você age pelo dashboard. O mestre pinta as imagens no próprio chat; quando a ferramenta de imagens falha, ele desenha imagens vetoriais simples, como o Claude faz. O Antigravity guarda seus chats anteriores, e a memória dele não pode ser desligada: o mestre é instruído a nunca ler esses chats. O que você escreve vai para o Google, que pode pedir a pessoas que leiam: não coloque dados pessoais no jogo. O RPG Engine não é um produto do Google.
|
|
72
|
+
- **OpenCode**: na pasta da campanha, escreva `opencode`. A campanha tem um pequeno plugin, `.opencode/plugins/rpg.js`, que avisa o mestre na hora quando você age pelo dashboard. Na campanha, o mestre escreve arquivos somente pelo RPG Engine: a escrita e a edição de arquivos do próprio OpenCode ficam desligadas ali, e ele pergunta a você antes de executar um comando. O mestre desenha as imagens por conta própria, como imagens vetoriais simples, como o Claude faz. Seu OpenCode, com o modelo que você escolheu por último nele, também traduz o dashboard e as regras do jogo e lê os documentos que você importa, fora do chat; sem um modelo que possa usar, o Codex ou o Claude Code fazem isso, se você os tiver.
|
|
72
73
|
- **Outro agente**: inicie-o na pasta da campanha e dê a ele o servidor MCP `rpg mcp`. O RPG Engine é um servidor MCP padrão: qualquer agente que suporte MCP pode ser o mestre, inclusive os locais.
|
|
73
74
|
|
|
75
|
+
Se o mestre disser que não encontra as ferramentas do RPG Engine, escreva `rpg init` na pasta da campanha: em uma pasta que já é uma campanha, ele apenas atualiza esses arquivos; depois, abra um novo chat.
|
|
76
|
+
|
|
74
77
|
Nós jogamos e testamos com o **Claude Code**; o **Codex** e o **Antigravity** estão conectados e verificados, mas nenhuma campanha inteira foi jogada com eles ainda. A campanha desliga a memória própria do agente: o jogo vive nos arquivos dele, para que voltar a um jogo salvo realmente volte no tempo.
|
|
75
78
|
|
|
76
79
|
### 2.5 O primeiro chat
|
|
@@ -183,6 +186,8 @@ Em todos os modos você pode **recomeçar**, desde o início do jogo ou desde a
|
|
|
183
186
|
|
|
184
187
|
Depois de voltar, **abra um novo chat**: o antigo se lembra do que foi desfeito. Escreva *continuar* no novo chat e depois clique em **Abri um novo chat** em Jogos salvos.
|
|
185
188
|
|
|
189
|
+
Se a pasta da campanha for um repositório git, **Configurações** tem uma seção **Git**, tudo desligado até você escolher: um commit no início de cada sessão, em cada jogo salvo e no fim de cada cena, e um push depois dele, se você quiser. Um commit é uma foto da campanha naquele momento; um push envia essas fotos para o repositório online, no GitHub por exemplo, para que uma cópia fique fora deste computador. Os jogos salvos e seus chats com o mestre ficam fora do repositório, a menos que você os inclua; inclua os chats apenas se o repositório for privado.
|
|
190
|
+
|
|
186
191
|
### 3.9 Sessões: parar e voltar
|
|
187
192
|
|
|
188
193
|
Pare quando quiser: *[Vamos parar por aqui esta noite.]* Tudo já está salvo nos arquivos. Para voltar, inicie seu agente na pasta da campanha e escreva *continuar*: o mestre faz um resumo curto e segue em frente.
|
|
@@ -214,7 +219,7 @@ Uma página no seu próprio computador, aberta apenas no navegador desse computa
|
|
|
214
219
|
- **Diário**: missões, a história como um livro, a linha do tempo, os diários dos seus companheiros, suas notas.
|
|
215
220
|
- **Mundo**: o mapa do mundo, o que seu personagem sabe, os documentos encontrados e o calendário.
|
|
216
221
|
- **A bandeja de dados**: escolha os dados e um modificador, e role; ×2 dobra os dados, nunca o modificador, como em um acerto crítico.
|
|
217
|
-
- **Jogos salvos**, **Ajuda**, **Configurações** e **Sobre**, como ícones no fim da fileira. As
|
|
222
|
+
- **Jogos salvos**, **Ajuda**, **Configurações** e **Sobre**, como ícones no fim da fileira. As Configurações também guardam as preferências da própria página: tema, som dos dados, conjunto de dados e o **Estilo do jogo**, que define as cores, as fontes e as imagens da página: o do sistema de jogo, um tema que você adicionou em Packages › Add, a partir do catálogo, de um link do GitHub, de um .zip ou de uma pasta, ou o da própria página. Se a folha de estilo própria de um tema deixar a página difícil de ler, desative **Estilo próprio do tema** ali: as Configurações sempre aparecem sem ele, no endereço da página com `#/settings` no final.
|
|
218
223
|
|
|
219
224
|
Quando o mestre pergunta algo a você, o aviso dele fica no topo, em qualquer seção em que você esteja.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ Todo comando que o mestre usa também pode ser executado na pasta da campanha: `
|
|
|
308
313
|
|
|
309
314
|
### Problemas
|
|
310
315
|
|
|
311
|
-
**O painel não abre.** Pergunte ao mestre: `[OOC: Qual é o link do
|
|
316
|
+
**O painel não abre.** Pergunte ao mestre: `[OOC: Qual é o link do painel?]`. Ele só funciona enquanto há um chat aberto dessa campanha: no Claude Code e no Codex, ele começa junto com o chat; no Antigravity, com a sua primeira mensagem. No app do Claude, um chat deixado em segundo plano por um tempo adormece, e a página com ele: clique no chat, e a página volta no mesmo endereço.
|
|
312
317
|
|
|
313
318
|
**O mestre parece não conhecer o jogo.** Seu agente não carregou o RPG Engine. Confira se você o iniciou na pasta da campanha e se confiou nela. No Claude Code, escreva `/mcp` e reconecte o `rpg`. No Codex, `codex mcp list` na pasta da campanha deve mostrar `rpg`. Se o `rpg --version` não for encontrado, instale o RPG Engine de novo ([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ Todo comando que o mestre usa também pode ser executado na pasta da campanha: `
|
|
|
322
327
|
|
|
323
328
|
**A instalação falha, ou o `rpg` não inicia.** `node --version` deve mostrar 24 ou mais recente. Se o Windows responder que a execução de scripts está desabilitada, veja [2.1](#21-what-you-need). No Windows, mantenha o RPG Engine e suas campanhas fora de caminhos que contenham `&`.
|
|
324
329
|
|
|
325
|
-
**O link do painel mudou.**
|
|
330
|
+
**O link do painel mudou.** Cada campanha tem o próprio endereço, o mesmo chat após chat. Ele só muda quando outro programa já o está usando: o mestre dá a você o novo link, e daí em diante ele permanece. Um segundo chat da mesma campanha mantém a página no mesmo endereço e passa a controlá-la quando você fecha o primeiro.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: ghidul complet
|
|
3
3
|
|
|
4
4
|
**RPG Engine** îți permite să joci un joc de rol de masă cu o **IA în rolul de maestru de joc**. Vorbești cu maestrul de joc într-un **chat**; RPG Engine lucrează în spate: **își amintește lumea**, **aruncă zarurile** și **ține socotelile**. Lângă chat ții deschisă în browser o pagină, **dashboardul**, cu fișa ta, zarurile, hărțile și jurnalul.
|
|
@@ -64,13 +64,16 @@ Maestrul de joc nu poate crea o campanie în locul tău: înainte de `init`, nim
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Conectarea AI-ului
|
|
66
66
|
|
|
67
|
-
Maestrul de joc rulează într-un **agent AI**: o aplicație AI, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code, Codex sau
|
|
67
|
+
Maestrul de joc rulează într-un **agent AI**: o aplicație AI, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code, Codex, Antigravity sau OpenCode. Un chat obișnuit, precum claude.ai sau ChatGPT, sau o aplicație de telefon nu ajunge: maestrul de joc trebuie să poată accesa fișierele campaniei de pe calculatorul tău. Fiecare agent are nevoie de propriul abonament și de propria autentificare: Claude Code, un abonament Claude cu plată; Codex, o autentificare ChatGPT; Antigravity, un cont Google, al cărui abonament gratuit are o cotă săptămânală mică; OpenCode funcționează cu modelele pe care i le dai tu, inclusiv cu cele locale. Îl instalezi o singură dată, de pe pagina lui: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: în dosarul campaniei scrie `claude`. Când te întreabă dacă ai încredere în dosar, alege **Yes, I trust this folder**; atenție, răspunsul deja selectat este *No, exit*. Campania are și un mic hook, `rpg --listen`, pe care întrebarea nu-l arată: îi spune maestrului de joc pe loc când acționezi din dashboard.
|
|
70
70
|
- **Codex**: în dosarul campaniei scrie `codex` și răspunde da când te întreabă dacă ai încredere în dosar. În aplicația lui desktop, verifică în setări că memoriile sunt oprite pentru chaturile jocului.
|
|
71
|
-
- **Antigravity**: în dosarul campaniei scrie `agy` și răspunde da dacă te întreabă dacă ai încredere în dosar. Campania are
|
|
71
|
+
- **Antigravity**: în dosarul campaniei scrie `agy` și răspunde da dacă te întreabă dacă ai încredere în dosar; sau, în aplicația lui, deschide dosarul campaniei. Pentru aplicație, RPG Engine se adaugă și în setările proprii ale Antigravity, `.gemini/config/mcp_config.json` din dosarul tău personal, care se aplică fiecărui dosar pe care îl deschizi, nu doar celui al campaniei: în afara unei campanii nu face nimic. Campania are două mici hookuri: `rpg --approve` îi permite maestrului de joc să folosească uneltele RPG Engine fără să te întrebe de fiecare dată, iar `rpg --listen` îi spune maestrului de joc pe loc când acționezi din dashboard. Maestrul de joc pictează imaginile chiar în chat; când unealta lui de imagini nu merge, desenează imagini vectoriale simple, ca Claude. Antigravity păstrează chaturile tale anterioare, iar memoria lui nu poate fi oprită: maestrului de joc i se spune să nu le citească niciodată. Ce scrii ajunge la Google, care poate pune oameni să citească: nu introduce date personale în joc. RPG Engine nu este un produs Google.
|
|
72
|
+
- **OpenCode**: în dosarul campaniei scrie `opencode`. Campania are un mic plugin, `.opencode/plugins/rpg.js`, care îi spune maestrului de joc pe loc când acționezi din dashboard. În campanie, maestrul de joc scrie fișiere doar prin RPG Engine: scrierea și editarea proprie de fișiere a OpenCode sunt oprite acolo, iar el te întreabă înainte să ruleze o comandă. Maestrul de joc desenează imaginile chiar el, ca imagini vectoriale simple, la fel ca Claude. OpenCode-ul tău, cu modelul pe care l-ai ales ultima dată în el, traduce și dashboardul și regulile jocului și citește documentele pe care le imporți, în afara chatului; dacă nu are un model pe care să-l poată folosi, le face Codex sau Claude Code, dacă le ai.
|
|
72
73
|
- **Alt agent**: pornește-l în dosarul campaniei și dă-i serverul MCP `rpg mcp`. RPG Engine este un server MCP standard: orice agent care acceptă MCP poate fi maestrul de joc, inclusiv cei locali.
|
|
73
74
|
|
|
75
|
+
Dacă maestrul de joc spune că nu găsește uneltele RPG Engine, scrie `rpg init` în dosarul campaniei: într-un dosar care este deja o campanie, doar aduce la zi aceste fișiere; apoi deschide un chat nou.
|
|
76
|
+
|
|
74
77
|
Jucăm și testăm cu **Claude Code**; **Codex** și **Antigravity** sunt conectate și verificate, dar încă nu s-a jucat cu ele o campanie întreagă. Campania oprește memoria proprie a agentului: jocul trăiește în fișierele lui, ca revenirea la o salvare să însemne cu adevărat o revenire.
|
|
75
78
|
|
|
76
79
|
### 2.5 Primul chat
|
|
@@ -183,6 +186,8 @@ RPG Engine salvează toată campania la sfârșitul fiecărei scene. Setarea **s
|
|
|
183
186
|
|
|
184
187
|
După ce te-ai întors în timp, **deschide un chat nou**: cel vechi își amintește ce a fost anulat. Scrie *continuă* în chatul nou, apoi apasă **Am deschis un chat nou** în Salvări.
|
|
185
188
|
|
|
189
|
+
Dacă folderul campaniei este un depozit git, **Setări** are o secțiune **Git**, cu toate opțiunile dezactivate până când alegi tu: un commit la începutul fiecărei sesiuni, la fiecare salvare și la sfârșitul fiecărei scene, plus un push după aceea, dacă vrei. Un commit este o instantanee a campaniei din acel moment. Un push trimite instantaneele către depozitul online, de exemplu pe GitHub, ca o copie să existe și în afara acestui calculator. Salvările și chaturile tale cu maestrul de joc rămân în afara depozitului, dacă nu le permiți tu să intre. Permite intrarea chaturilor doar dacă depozitul este privat.
|
|
190
|
+
|
|
186
191
|
### 3.9 Sesiuni: oprirea și revenirea
|
|
187
192
|
|
|
188
193
|
Oprește-te oricând vrei: *[Să ne oprim aici pentru în seara asta.]* Totul este deja salvat în fișiere. Ca să revii, pornește-ți agentul în folderul campaniei și scrie *continuă*: maestrul de joc îți face un scurt rezumat și merge mai departe.
|
|
@@ -214,7 +219,7 @@ O pagină de pe propriul tău calculator, deschisă doar în browserul acelui ca
|
|
|
214
219
|
- **Jurnal**: misiuni, povestea ca o carte, cronologia ei, jurnalele însoțitorilor tăi, notițele tale.
|
|
215
220
|
- **Lume**: harta lumii, ce știe personajul tău, documentele găsite și calendarul.
|
|
216
221
|
- **Tava pentru zaruri**: alege zarurile și un modificator, apoi aruncă; ×2 dublează zarurile, niciodată modificatorul, ca la o lovitură critică.
|
|
217
|
-
- **Salvări**, **Ajutor**, **Setări** și **Despre**, ca pictograme la capătul rândului. Setări cuprinde și preferințele paginii: tema, sunetul zarurilor, setul de zaruri și **Stilul jocului**, adică culorile, chipurile și imaginile paginii: cele ale sistemului de joc, o temă adăugată din Packages › Add, din catalog, dintr-un link GitHub, dintr-un .zip sau dintr-un dosar, ori cele proprii ale paginii.
|
|
222
|
+
- **Salvări**, **Ajutor**, **Setări** și **Despre**, ca pictograme la capătul rândului. **Setări** cuprinde și preferințele paginii: tema, sunetul zarurilor, setul de zaruri și **Stilul jocului**, adică culorile, chipurile și imaginile paginii: cele ale sistemului de joc, o temă adăugată din Packages › Add, din catalog, dintr-un link GitHub, dintr-un .zip sau dintr-un dosar, ori cele proprii ale paginii. Dacă foaia de stil a unei teme face pagina greu de citit, dezactivează acolo **Stilul propriu al temei**: **Setări** se afișează întotdeauna fără ea, la adresa paginii cu `#/settings` la final.
|
|
218
223
|
|
|
219
224
|
Când maestrul de joc îți pune o întrebare, bannerul lui rămâne în partea de sus, indiferent în ce secțiune te afli.
|
|
220
225
|
|
|
@@ -308,7 +313,7 @@ Fiecare comandă pe care o folosește maestrul de joc poate fi rulată și în f
|
|
|
308
313
|
|
|
309
314
|
### Probleme
|
|
310
315
|
|
|
311
|
-
**
|
|
316
|
+
**Tabloul de bord nu se deschide.** Întreabă maestrul de joc: `[OOC: Care e linkul către tabloul de bord?]`. Funcționează doar cât timp este deschis un chat al acelei campanii. În Claude Code și în Codex pornește odată cu chatul, iar în Antigravity, odată cu primul tău mesaj. În aplicația Claude, un chat lăsat o vreme pe fundal adoarme, iar pagina odată cu el. Apasă pe chat și pagina revine la aceeași adresă.
|
|
312
317
|
|
|
313
318
|
**Maestrul pare să nu cunoască jocul.** Agentul tău nu a încărcat RPG Engine. Verifică dacă l-ai pornit în folderul campaniei și dacă ai avut încredere în el. În Claude Code, scrie `/mcp` și reconectează `rpg`. În Codex, `codex mcp list` în folderul campaniei trebuie să arate `rpg`. Dacă `rpg --version` nu e găsit, instalează din nou RPG Engine ([2.2](#22-install)).
|
|
314
319
|
|
|
@@ -322,4 +327,4 @@ Fiecare comandă pe care o folosește maestrul de joc poate fi rulată și în f
|
|
|
322
327
|
|
|
323
328
|
**Instalarea eșuează sau `rpg` nu pornește.** `node --version` trebuie să arate 24 sau mai nou. Dacă Windows răspunde că rularea scripturilor este dezactivată, vezi [2.1](#21-what-you-need). Pe Windows, ține RPG Engine și campaniile tale departe de căi care conțin `&`.
|
|
324
329
|
|
|
325
|
-
**Linkul
|
|
330
|
+
**Linkul tabloului de bord s-a schimbat.** Fiecare campanie are propria adresă, aceeași chat după chat. Adresa se schimbă doar când un alt program o folosește deja. Maestrul de joc îți dă noul link, iar de atunci acesta rămâne. Un al doilea chat al aceleiași campanii păstrează pagina la aceeași adresă și o preia după ce îl închizi pe primul.
|