rpg-engine 0.19.1 → 0.21.0
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 +9 -6
- package/dist/adventures/index.d.ts +1 -1
- package/dist/adventures/index.js +1 -1
- package/dist/adventures/source.d.ts +3 -0
- package/dist/adventures/source.js +11 -49
- package/dist/campaign/create-campaign.d.ts +1 -1
- package/dist/campaign/create-campaign.js +4 -3
- package/dist/campaign/find-campaign.d.ts +6 -0
- package/dist/campaign/find-campaign.js +7 -1
- package/dist/campaign/host-files.js +22 -0
- package/dist/campaign/index.d.ts +2 -2
- package/dist/campaign/index.js +2 -2
- package/dist/campaign/last-choices.d.ts +10 -4
- package/dist/campaign/last-choices.js +43 -17
- package/dist/campaign/settings.d.ts +10 -2
- package/dist/campaign/settings.js +32 -8
- package/dist/chats/chat.d.ts +33 -0
- package/dist/chats/chat.js +50 -0
- package/dist/chats/claude-code.d.ts +5 -0
- package/dist/chats/claude-code.js +39 -0
- package/dist/chats/codex.d.ts +3 -0
- package/dist/chats/codex.js +42 -0
- package/dist/chats/index.d.ts +5 -0
- package/dist/chats/index.js +12 -0
- package/dist/chats/keep.d.ts +10 -0
- package/dist/chats/keep.js +50 -0
- package/dist/chats/read.d.ts +8 -0
- package/dist/chats/read.js +46 -0
- package/dist/cli/cli.js +6 -1
- package/dist/cli/command-line.js +3 -2
- package/dist/commands/book.d.ts +36 -0
- package/dist/commands/book.js +129 -0
- package/dist/commands/chats.d.ts +38 -0
- package/dist/commands/chats.js +93 -0
- package/dist/commands/config/config.js +2 -2
- package/dist/commands/config/dashboard.d.ts +8 -1
- package/dist/commands/config/dashboard.js +70 -16
- package/dist/commands/config/words.d.ts +1 -1
- package/dist/commands/config/words.js +18 -5
- package/dist/commands/find.js +1 -1
- package/dist/commands/image.d.ts +14 -0
- package/dist/commands/image.js +100 -20
- package/dist/commands/index.js +4 -0
- package/dist/commands/init.js +3 -3
- package/dist/commands/package/data.d.ts +35 -0
- package/dist/commands/package/data.js +117 -0
- package/dist/commands/package/here.d.ts +7 -2
- package/dist/commands/package/here.js +23 -11
- package/dist/commands/package/install.js +14 -15
- package/dist/commands/package/language.d.ts +15 -0
- package/dist/commands/package/language.js +109 -0
- package/dist/commands/package/package.js +20 -10
- package/dist/commands/package/result.d.ts +19 -0
- package/dist/commands/package/theme.d.ts +13 -0
- package/dist/commands/package/theme.js +66 -0
- package/dist/commands/package/uninstall.d.ts +4 -1
- package/dist/commands/package/uninstall.js +29 -9
- package/dist/commands/scene/close.d.ts +2 -0
- package/dist/commands/scene/close.js +20 -2
- package/dist/commands/scene/result.d.ts +2 -0
- package/dist/commands/scene/scene.d.ts +2 -0
- package/dist/commands/shared/books/adventures.d.ts +0 -4
- package/dist/commands/shared/books/adventures.js +2 -31
- package/dist/commands/shared/books/words.js +3 -2
- package/dist/commands/shared/campaign/book.d.ts +42 -0
- package/dist/commands/shared/campaign/book.js +118 -0
- package/dist/commands/shared/campaign/chats.d.ts +11 -0
- package/dist/commands/shared/campaign/chats.js +29 -0
- package/dist/commands/shared/campaign/images.js +7 -1
- package/dist/commands/shared/campaign/mode.js +3 -1
- package/dist/commands/shared/campaign/saves.js +13 -5
- package/dist/commands/shared/campaign/world.js +2 -1
- package/dist/commands/shared/packages/catalog.d.ts +3 -3
- package/dist/commands/shared/packages/catalog.js +98 -42
- package/dist/commands/shared/packages/unpacked.d.ts +50 -0
- package/dist/commands/shared/packages/unpacked.js +146 -0
- package/dist/commands/shared/sheet/sheet.d.ts +7 -0
- package/dist/commands/shared/sheet/sheet.js +27 -0
- package/dist/commands/status.d.ts +1 -0
- package/dist/commands/status.js +4 -0
- package/dist/commands/view/page.js +4 -3
- package/dist/commands/view/result.d.ts +2 -0
- package/dist/commands/view/view.d.ts +1 -0
- package/dist/commands/view/view.js +4 -0
- package/dist/core/archive.d.ts +13 -0
- package/dist/core/archive.js +76 -0
- package/dist/core/consents.d.ts +2 -2
- package/dist/core/consents.js +3 -3
- package/dist/core/context.d.ts +40 -2
- package/dist/core/context.js +1 -0
- package/dist/core/download.js +1 -1
- package/dist/core/store.d.ts +5 -1
- package/dist/core/store.js +15 -2
- package/dist/dashboard/acts/names.js +10 -5
- package/dist/dashboard/acts/sending.js +5 -2
- package/dist/dashboard/acts/sheet.js +66 -15
- package/dist/dashboard/api.js +27 -4
- package/dist/dashboard/app.js +9 -4
- package/dist/dashboard/guide/ar.md +16 -15
- package/dist/dashboard/guide/cs.md +15 -14
- package/dist/dashboard/guide/da.md +17 -16
- package/dist/dashboard/guide/de.md +17 -16
- package/dist/dashboard/guide/el.md +17 -16
- package/dist/dashboard/guide/en.md +14 -13
- package/dist/dashboard/guide/es.md +15 -14
- package/dist/dashboard/guide/fi.md +15 -14
- package/dist/dashboard/guide/fr.md +20 -19
- package/dist/dashboard/guide/he.md +15 -14
- package/dist/dashboard/guide/hi.md +15 -14
- package/dist/dashboard/guide/hu.md +19 -18
- package/dist/dashboard/guide/is.md +15 -14
- package/dist/dashboard/guide/it.md +18 -17
- package/dist/dashboard/guide/ja.md +15 -14
- package/dist/dashboard/guide/ko.md +16 -15
- package/dist/dashboard/guide/nb.md +17 -16
- package/dist/dashboard/guide/nl.md +15 -14
- package/dist/dashboard/guide/pl.md +16 -15
- package/dist/dashboard/guide/pt.md +16 -15
- package/dist/dashboard/guide/ro.md +15 -14
- package/dist/dashboard/guide/ru.md +16 -15
- package/dist/dashboard/guide/sv.md +15 -14
- package/dist/dashboard/guide/tr.md +18 -17
- package/dist/dashboard/guide/uk.md +19 -18
- package/dist/dashboard/guide/zh.md +16 -15
- package/dist/dashboard/i18n/ar.json +63 -9
- package/dist/dashboard/i18n/cs.json +63 -9
- package/dist/dashboard/i18n/da.json +63 -9
- package/dist/dashboard/i18n/de.json +63 -9
- package/dist/dashboard/i18n/el.json +63 -9
- package/dist/dashboard/i18n/es.json +63 -9
- package/dist/dashboard/i18n/fi.json +63 -9
- package/dist/dashboard/i18n/fr.json +63 -9
- package/dist/dashboard/i18n/he.json +63 -9
- package/dist/dashboard/i18n/hi.json +63 -9
- package/dist/dashboard/i18n/hu.json +63 -9
- package/dist/dashboard/i18n/is.json +63 -9
- package/dist/dashboard/i18n/it.json +64 -10
- package/dist/dashboard/i18n/ja.json +63 -9
- package/dist/dashboard/i18n/ko.json +63 -9
- package/dist/dashboard/i18n/nb.json +63 -9
- package/dist/dashboard/i18n/nl.json +63 -9
- package/dist/dashboard/i18n/pl.json +63 -9
- package/dist/dashboard/i18n/pt.json +63 -9
- package/dist/dashboard/i18n/ro.json +63 -9
- package/dist/dashboard/i18n/ru.json +63 -9
- package/dist/dashboard/i18n/sv.json +63 -9
- package/dist/dashboard/i18n/tr.json +63 -9
- package/dist/dashboard/i18n/uk.json +63 -9
- package/dist/dashboard/i18n/zh.json +63 -9
- package/dist/dashboard/journal/book.js +107 -0
- package/dist/dashboard/journal/journal.js +16 -12
- package/dist/dashboard/kit.js +1 -1
- package/dist/dashboard/packages/catalog.js +31 -14
- package/dist/dashboard/packages/engine.js +46 -2
- package/dist/dashboard/packages/installed.js +13 -0
- package/dist/dashboard/packages/outcomes.js +21 -0
- package/dist/dashboard/packages/packages.js +41 -18
- package/dist/dashboard/packages/rows.js +3 -1
- package/dist/dashboard/parts/icons.js +3 -0
- package/dist/dashboard/parts/labels.js +6 -0
- package/dist/dashboard/parts/picture.js +89 -0
- package/dist/dashboard/parts/refusals.js +8 -1
- package/dist/dashboard/parts/widgets.js +3 -2
- package/dist/dashboard/place/view.js +1 -1
- package/dist/dashboard/play/scene.js +8 -5
- package/dist/dashboard/settings/settings.js +32 -16
- package/dist/dashboard/settings/setup.js +5 -3
- package/dist/dashboard/sheet/party.js +5 -2
- package/dist/dashboard/sheet/sheet.js +10 -6
- package/dist/dashboard/shell/notices.js +2 -2
- package/dist/dashboard/shell/system-style.js +45 -12
- package/dist/dashboard/shell/tooltip.js +223 -0
- package/dist/dashboard/style.css +775 -261
- package/dist/dashboard/world/calendar.js +1 -1
- package/dist/dashboard/world/lore.js +5 -4
- package/dist/dashboard/world/place-card.js +2 -1
- package/dist/helpers/briefs.d.ts +5 -0
- package/dist/helpers/briefs.js +8 -0
- package/dist/helpers/chosen.d.ts +8 -2
- package/dist/helpers/chosen.js +110 -6
- package/dist/helpers/codex.js +2 -1
- package/dist/helpers/index.d.ts +2 -2
- package/dist/helpers/index.js +2 -2
- package/dist/images/images.d.ts +2 -0
- package/dist/images/images.js +16 -2
- package/dist/images/index.d.ts +1 -1
- package/dist/images/index.js +1 -1
- package/dist/languages/index.d.ts +1 -1
- package/dist/languages/index.js +1 -1
- package/dist/languages/pack.d.ts +4 -1
- package/dist/languages/pack.js +16 -5
- package/dist/packages/engine.d.ts +7 -0
- package/dist/packages/engine.js +32 -1
- package/dist/packages/index.d.ts +1 -1
- package/dist/packages/index.js +1 -1
- package/dist/server/approver.d.ts +6 -0
- package/dist/server/approver.js +28 -0
- package/dist/server/chats.d.ts +3 -0
- package/dist/server/chats.js +27 -0
- package/dist/server/dashboard/engine.d.ts +18 -0
- package/dist/server/dashboard/engine.js +31 -0
- package/dist/server/dashboard/files.d.ts +8 -1
- package/dist/server/dashboard/files.js +30 -10
- package/dist/server/dashboard/index.d.ts +3 -0
- package/dist/server/dashboard/index.js +10 -1
- package/dist/server/dashboard/news.js +36 -5
- package/dist/server/dashboard/pictures.d.ts +7 -0
- package/dist/server/dashboard/pictures.js +62 -0
- package/dist/server/dashboard/writes.d.ts +5 -3
- package/dist/server/dashboard/writes.js +45 -14
- package/dist/server/mcp.js +37 -6
- package/dist/server/player-acts.d.ts +7 -2
- package/dist/server/player-acts.js +10 -3
- package/dist/testing/index.js +1 -0
- package/dist/themes/index.d.ts +2 -1
- package/dist/themes/index.js +4 -2
- package/dist/themes/installed.d.ts +14 -0
- package/dist/themes/installed.js +28 -0
- package/dist/themes/theme.d.ts +7 -0
- package/dist/themes/theme.js +22 -0
- package/instructions/core.md +3 -3
- package/instructions/dashboard-guide.md +1 -0
- package/instructions/mentor-hints.md +1 -1
- package/instructions/mentor-tutorial.md +1 -1
- package/instructions/party.md +1 -1
- package/instructions/play.md +2 -2
- package/instructions/start.md +1 -1
- package/package.json +2 -2
- package/systems/free/instructions/outcomes-told.md +1 -1
|
@@ -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,4c052d2b,8b310594,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,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,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,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: eksiksiz kılavuz
|
|
3
3
|
|
|
4
4
|
**RPG Engine**, masa başı rol yapma oyununu **yapay zekâ oyun yöneticisiyle** oynamanı sağlar. Oyun yöneticisiyle bir **sohbette** konuşursun; RPG Engine ise arka planda çalışır: **dünyayı hatırlar**, **zarları atar** ve **hesapları tutar**. Sohbetin yanında tarayıcında bir sayfa açık tutarsın: **gösterge paneli**. Orada karakter kağıdın, zarların, haritaların ve günlüğün durur.
|
|
@@ -64,13 +64,14 @@ Oyun yöneticisi senin için kampanya oluşturamaz: `init` çalışmadan önce a
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Yapay zekânı bağla
|
|
66
66
|
|
|
67
|
-
Oyun yöneticisi bir **yapay zekâ ajanında** çalışır. Bu, terminalde ya da masaüstünde çalışan, bilgisayarındaki dosyalarla iş yapabilen bir yapay zekâ uygulamasıdır; Claude Code
|
|
67
|
+
Oyun yöneticisi bir **yapay zekâ ajanında** çalışır. Bu, terminalde ya da masaüstünde çalışan, bilgisayarındaki dosyalarla iş yapabilen bir yapay zekâ uygulamasıdır; Claude Code, Codex veya Antigravity gibi. claude.ai ya da ChatGPT gibi düz bir sohbet veya bir telefon uygulaması yetmez: oyun yöneticisinin bilgisayarındaki kampanya dosyalarına erişmesi gerekir. Her ajanın kendi planı ve girişi vardır: Claude Code için ücretli bir Claude planı, Codex için bir ChatGPT girişi, Antigravity için bir Google hesabı; ücretsiz planın haftalık kotası küçüktür. Ajanı kendi sayfasından bir kez kurarsın: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
|
-
- **Claude Code**: kampanya klasöründe `claude` yaz. Klasöre güvenip güvenmediğini sorduğunda **Yes, I trust this folder** seçeneğini seç; dikkat, önceden seçili gelen cevap *No, exit* olur. Kampanyada ayrıca küçük bir kanca (hook) vardır: `rpg --listen`. Soruda görünmez;
|
|
69
|
+
- **Claude Code**: kampanya klasöründe `claude` yaz. Klasöre güvenip güvenmediğini sorduğunda **Yes, I trust this folder** seçeneğini seç; dikkat, önceden seçili gelen cevap *No, exit* olur. Kampanyada ayrıca küçük bir kanca (hook) vardır: `rpg --listen`. Soruda görünmez; dashboard'dan bir şey yaptığında oyun yöneticisine hemen haber verir.
|
|
70
70
|
- **Codex**: kampanya klasöründe `codex` yaz ve klasöre güvenip güvenmediğini sorduğunda evet de. Masaüstü uygulamasında, ayarlardan oyunun sohbetleri için belleklerin kapalı olduğunu kontrol et.
|
|
71
|
+
- **Antigravity**: kampanya klasöründe `agy` yaz ve klasöre güvenip güvenmediğini sorarsa evet de. Kampanyada küçük bir kanca vardır: `rpg --approve`. Oyun yöneticisinin RPG Engine araçlarını her seferinde sana sormadan kullanmasını sağlar. Görselleri oyun yöneticisi sohbetin içinde kendisi çizer. Antigravity geçmiş sohbetlerini saklar ve belleği kapatılamaz: oyun yöneticisine bunları asla okumaması söylenir. Yazdıkların Google'a gider ve Google bunları insanlara okutabilir: kişisel verilerini oyunun dışında tut. RPG Engine bir Google ürünü değildir.
|
|
71
72
|
- **Başka bir ajan**: ajanı kampanya klasöründe başlat ve ona `rpg mcp` MCP sunucusunu ver. RPG Engine standart bir MCP sunucusudur: MCP destekleyen her ajan oyun yöneticisi olabilir, yerel olanlar da.
|
|
72
73
|
|
|
73
|
-
Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** bağlı ve kontrol edildi, ama
|
|
74
|
+
Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** ve **Antigravity** bağlı ve kontrol edildi, ama onlarla henüz tam bir kampanya oynanmadı. Kampanya, ajanın kendi belleğini kapatır: oyun dosyalarında yaşar, böylece bir kayda dönmek gerçekten geri dönmek olur.
|
|
74
75
|
|
|
75
76
|
### 2.5 İlk sohbet
|
|
76
77
|
|
|
@@ -122,11 +123,11 @@ Karakterin ne yapıyor ya da ne söylüyorsa kendi sözlerinle yaz:
|
|
|
122
123
|
|
|
123
124
|
> Han sahibine bu gece başka kimin uğradığını soruyorum.
|
|
124
125
|
|
|
125
|
-
Hikâyenin dışına çıkmak için
|
|
126
|
+
Hikâyenin dışına çıkmak için `[OOC: …]` yaz (karakter dışı): *[OOC: Tutuşma nasıl işliyor?]* Oyun yöneticisi de aynı şekilde yanıt verir.
|
|
126
127
|
|
|
127
128
|
Sen neyi denediğini söylersin, ne olacağını oyun yöneticisi söyler. Oyun yöneticisi karakterin adına asla karar vermez ve motordan asla söz etmez. Gösterge panelini nasıl kullanacağını ona sorabilirsin.
|
|
128
129
|
|
|
129
|
-
**Gösterge panelinden eylem yapmak**:
|
|
130
|
+
**Gösterge panelinden eylem yapmak**: Karakter kağıdındaki bir ada tıkla; bu bir silah, bir büyü ya da taşıdığın bir şey olabilir. Kartı bunun ne olduğunu söyler. Onunla ne yapacağını seç, örneğin **Kullan**. Sonra kimin için olduğunu listeden ya da haritaya tıklayarak seç. Biriyle konuşmak için de kişiye tıklayabilirsin. Gösterge paneli cümleni yazar, örneğin *Kapüşonlu Haydut 1'e Gürz ile saldırıyorum.* **Oyun yöneticisine söyle**'ye basmadan önce cümleyi değiştirebilirsin. Oyun yöneticisi bunu sohbette söylenmiş gibi duyar ve diğer her şey gibi karara bağlar. Yapay zekâ uygulaman cümleyi kendi başına duyamıyorsa **Kopyala** cümleyi sohbete yapıştırmaya hazırlar.
|
|
130
131
|
|
|
131
132
|
### 3.2 Atışlar
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ Oyun yöneticisi atış istemeyi yalnızca sonuç belirsizse ve önemliyse yapar
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Sahneler ve çatışmalar
|
|
144
145
|
|
|
145
|
-
Hikâye **sahneler** halinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder ve sahne günlüğüne girer.
|
|
146
|
+
Hikâye **sahneler** halinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder ve sahne günlüğüne girer. Hikâye bir dönemece girdiğinde oyun yöneticisi, son bölümden bu yana geçen sahneleri hikâyenin kitabına yeni bir bölüm olarak yazar.
|
|
146
147
|
|
|
147
148
|
Bir çatışmada, sırası sende olmayan her sırayı oyun yöneticisi anlatır ve karar verebileceğin yerde durur. **Sahne** üstte sırasının kimde olduğunu ve sonra kimin geldiğini, haritanın yanında da karakterinin kartını gösterir. Sıraların düzeni, grubunun can puanları ve düşmanların ne kadar yaralı göründüğü ise sözcüklerle sayfanın yanında durur. Karakterin düşerse ölüm kurtarmaları sayfada büyük görünür.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Kötülerin son tarihli planları vardır. Her yeni günde oyun yöneticisi, zam
|
|
|
158
159
|
|
|
159
160
|
**Dünya**, karakterinin bildiği yerleri, aralarındaki yolları ve yürüdüğün izi gösterir; gerisi sisle örtülüdür. **Sahne**, bulunduğun yerin haritasını, varsa, kimin nerede durduğuyla birlikte gösterir. Çatışmada, sıran geldiğinde ulaşamayacağın kareler örtülür. Oyun yöneticisi nereye gideceğini sorduğunda bir kareye dokun ya da *E4* gibi yaz.
|
|
160
161
|
|
|
161
|
-
**Dünya** ayrıca karakterinin bildiklerini de tutar. **Bilgiler**, karakterin tanıdığı kişileri, yerleri, hizipleri, yaratıkları ve hikâyeleri listeler; her biri karakterin bildiği haliyle yazılır. İçinde arama yapabilir ya da birini açıp tamamını okuyabilirsin. Metindeki bir ad, kendi sayfasına götürür. **Belgeler**, bulunan mektupları, duyuruları ve sayfaları tekrar okuman için saklar. **Takvim** bugünü, görevlerinin kalan süreyle birlikte son tarihlerini ve hikâyenin günlerini gösterir. Sahnesi olan bir gün, Günlük'teki
|
|
162
|
+
**Dünya** ayrıca karakterinin bildiklerini de tutar. **Bilgiler**, karakterin tanıdığı kişileri, yerleri, hizipleri, yaratıkları ve hikâyeleri listeler; her biri karakterin bildiği haliyle yazılır. İçinde arama yapabilir ya da birini açıp tamamını okuyabilirsin. Metindeki bir ad, kendi sayfasına götürür. **Belgeler**, bulunan mektupları, duyuruları ve sayfaları tekrar okuman için saklar. **Takvim** bugünü, görevlerinin kalan süreyle birlikte son tarihlerini ve hikâyenin günlerini gösterir. Sahnesi olan bir gün, seni Günlük'teki zaman çizelgesinde o sahnelere götürür.
|
|
162
163
|
|
|
163
164
|
### 3.6 Görevler, günlük ve notlar
|
|
164
165
|
|
|
165
|
-
Karakterinin üstlendiği bir iş, **Günlük**'te hedefleri, son tarihi ve neyi ölçtüğüyle bir görev olur.
|
|
166
|
+
Karakterinin üstlendiği bir iş, **Günlük**'te hedefleri, son tarihi ve neyi ölçtüğüyle bir görev olur. Sahne'nin en üstünde görünür kalması için görevi yıldızla. **Hikâye** altında Günlük, hikâyeni bir kitap gibi anlatır: hikâye her dönemece girdiğinde oyun yöneticisi, seçtiğin üslupla düzyazı bir bölüm yazar ve bir önceki bölümden bu yana geçen sahneleri anlatır. Bölüm bölüm oku; sonuncusu yer imiyle işaretlidir. Hikâyeyi Markdown olarak ya da yazdırmak veya paylaşmak için web sayfası olarak indirebilirsin. Daha önce başlamış bir oyunda oyun yöneticisinden şimdiye kadarki hikâyeyi yazmasını iste. **Zaman çizelgesi**, sahneleri numaralı olarak, her birinde olanlarla listeler. Günlük, **Notlar**'ı da tutar. Notlar özeldir. **Paylaş**'a basarsan oyun yöneticisi o notu senin düşüncen olarak duyar, asla bir gerçek olarak değil. **Yoldaşlar** altında yoldaşlarının günlüklerini okursun: arada bir, bir günün ya da görevin sonunda, düşündükleri ve hissettikleri hakkında birkaç satır yazarlar.
|
|
166
167
|
|
|
167
168
|
### 3.7 Karakterinin hikâyesi ve resmi
|
|
168
169
|
|
|
@@ -192,7 +193,7 @@ Gösterge panelinin üstündeki robot oyun yöneticisidir. Yüzü hikâyenin ton
|
|
|
192
193
|
|
|
193
194
|
### 3.11 Resimler
|
|
194
195
|
|
|
195
|
-
RPG Engine, ulaştığın yerlerin, üstlendiğin görevlerin ve karşılaştığın kişilerin görsellerini, **Görseller** ayarının dediği gibi yaptırabilir; istersen karakterinin portresini de. Kendi Codex'ini ya da Claude Code'unu, kendi girişinle, kendi planın ve sınırlarınla kullanır: **Codex** boyar, o yoksa **Claude Code** çizer. **Ayarlar**, bu bilgisayarın görsel yapıp yapamadığını ve yapamıyorsa nasıl kurulacağını söyler.
|
|
196
|
+
RPG Engine, ulaştığın yerlerin, üstlendiğin görevlerin ve karşılaştığın kişilerin görsellerini, **Görseller** ayarının dediği gibi yaptırabilir; istersen karakterinin portresini de. Kendi Codex'ini ya da Claude Code'unu, kendi girişinle, kendi planın ve sınırlarınla kullanır: **Codex** boyar, o yoksa **Claude Code** çizer. **Ayarlar**, bu bilgisayarın görsel yapıp yapamadığını ve yapamıyorsa nasıl kurulacağını söyler. Karakterine ya da gördüğün herhangi bir sayfaya her zaman kendi görselini verebilirsin: imleci sayfanın görsellerinden birinin üstüne getir, köşesinde küçük bir resim düğmesi çıkar (klavyeyle de çıkar, telefonda her zaman görünür). **Dünya**'da açtığın sayfada da **Resmi değiştir…** vardır; sayfanın görseli yoksa **Resim ekle…** vardır. Seninki, sayfadaki görselin yerini alır. Ya da dosyayı kampanyanın **inbox** klasörüne bırak ve oyun yöneticisine hangi sayfa için olduğunu söyle.
|
|
196
197
|
|
|
197
198
|
### 3.12 Güvenlik: sınırlar, perdeler ve dur
|
|
198
199
|
|
|
@@ -208,12 +209,12 @@ Her ayar değiştirilebilir, sohbette ya da **Ayarlar**'da. Oyun yöneticisinin
|
|
|
208
209
|
|
|
209
210
|
Kendi bilgisayarındaki bir sayfa. Yalnızca o bilgisayarın tarayıcısında açılır ve sohbet açık olduğu sürece canlıdır. Sohbet kapanınca *Bağlı değil* yazar. Bir sonraki sohbetle kendiliğinden geri gelir.
|
|
210
211
|
|
|
211
|
-
- **Grup**: senin karakter kağıdın ve yoldaşlarınınkiler. Bir sayıya tıklayarak onu
|
|
212
|
+
- **Grup**: senin karakter kağıdın ve yoldaşlarınınkiler. Bir sayıya tıklayarak onu at; üzerine gelirsen sayının nereden geldiğini görürsün. Bir ok zarını işaretliyorsa atışı neyin iyileştirdiğini ya da kötüleştirdiğini de görürsün. Oyun yöneticisi sana seçimler hazırladığında, örneğin yeni bir seviyede, karakter kağıdındaki bir bildirim bunları açar. İstediğin zaman seç, seçeneklerin adını verdiği sayfaları oku, bir seçenek atış istiyorsa at, sonra onayla. Hikâye bu sırada devam eder. Yanında atışlar yer alır.
|
|
212
213
|
- **Sahne**: bulunduğun yer, resmi ve haritası, orada kimlerin olduğu, neler olduğu. Çatışmada sıralar ve karakterinin kartı da burada görünür.
|
|
213
|
-
- **Günlük**: görevler, hikâye, yoldaşlarının günlükleri, notların.
|
|
214
|
+
- **Günlük**: görevler, kitap olarak hikâye, zaman çizelgesi, yoldaşlarının günlükleri, notların.
|
|
214
215
|
- **Dünya**: dünya haritası, karakterinin bildikleri, bulunan belgeler ve takvim.
|
|
215
|
-
- **Zar tepsisi**: zarları ve bir değiştirici seç, sonra at. ×2 zarları ikiye katlar, değiştiriciyi asla katlamaz
|
|
216
|
-
- **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. Ayarlar
|
|
216
|
+
- **Zar tepsisi**: zarları ve bir değiştirici seç, sonra at. ×2 zarları ikiye katlar, değiştiriciyi asla katlamaz; kritik vuruşta olduğu gibi.
|
|
217
|
+
- **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. **Ayarlar** sayfanın kendi tercihlerini de içerir: tema, zar sesi, zar seti ve **Oyunun stili**. Oyunun stili, sayfanın renkleri, yüzleri ve resimleridir. Bunlar oyun sisteminin stili olabilir, Packages › Add ile eklediğin bir tema olabilir (katalogdan, bir GitHub bağlantısından, bir .zip dosyasından ya da bir klasörden) ya da sayfanın kendi stili olabilir.
|
|
217
218
|
|
|
218
219
|
Oyun yöneticisi sana bir şey sorduğunda, afişi hangi bölümde olursan ol en üstte kalır.
|
|
219
220
|
|
|
@@ -271,7 +272,7 @@ Kampanya başına tek dil vardır: oyun yöneticisinin dili; panel onu izler. Pa
|
|
|
271
272
|
|
|
272
273
|
## 8. Merak edenler için: kampanya klasörü <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Onu açman gerekmez
|
|
275
|
+
Onu açman hiç gerekmez; kampanyanın sırlarını içerir. İçinde şunlar var: `campaign.yaml` (ayarların), `state.yaml` (oyunun geldiği yer), `world/` (her karakter, yer, görev ve diğerleri için birer markdown sayfası), `rules/` (ev kuralların), `images/`, `log.jsonl` (her değişiklik), `sessions/` (oyun yöneticisiyle sohbetlerin metin olarak, Claude Code ve Codex'ten), `.saves/`, `.player/` (notların) ve yapay zekâ ajanlarına RPG Engine'in nerede olduğunu söyleyen küçük dosyalar. Sayfalar Obsidian biçimini kullanır. Bir sayfayı elle değiştirirsen oyun yöneticisi bunu bir sonraki cevabında öğrenir.
|
|
275
276
|
|
|
276
277
|
RPG Engine bu klasörde kalır. Oyunu yalnızca burada okur ve yazar, diğer dosyalarına hiç dokunmaz. Kılavuzlarının klasörlerini ise yalnızca okur. Bunun dışında yalnızca kendi veri klasörlerini tutar (panonun çevirileri, kılavuzlarından okuduğu metin, izin verirsen kurduğu Codex veya Claude Code) ve bir resim çizilirken geçici klasörler kullanır. Ajanının bilgisayarında yapmak istediği başka her şey için önce sana sorar. Bir oyun sistemi ya da eklenti koddur, her npm paketi gibi. Bizim olmayan bir paket bilgisayarında senin izinlerinle çalışır. RPG Engine onu yalnızca senin evetinle kurar. Bu onayı ajanının bir formunda ya da bilgisayarının bir penceresinde verirsin. Yalnızca yazarlarına güvendiğin paketlere evet de.
|
|
277
278
|
|
|
@@ -293,7 +294,7 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
|
|
|
293
294
|
|
|
294
295
|
### Sorular
|
|
295
296
|
|
|
296
|
-
**Kuralları bilmem gerekiyor mu?** Hayır. Eğitim akıl hocasını seç ve istediğin zaman
|
|
297
|
+
**Kuralları bilmem gerekiyor mu?** Hayır. Eğitim akıl hocasını seç ve istediğin zaman `[OOC: …]` içinde sor.
|
|
297
298
|
|
|
298
299
|
**Oyun yöneticisi hile yapabilir mi?** RPG Engine'in yaptığı bir atışı değiştiremez; yalnızca hikâye zorluğunda değiştirebilir. Belirlenmiş gerçekleri de değiştiremez.
|
|
299
300
|
|
|
@@ -307,7 +308,7 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
|
|
|
307
308
|
|
|
308
309
|
### Sorunlar
|
|
309
310
|
|
|
310
|
-
**
|
|
311
|
+
**Gösterge paneli açılmıyor.** Oyun yöneticisine sor: `[OOC: Gösterge panelinin bağlantısı ne?]`. Yalnızca o kampanyada bir sohbet açıkken, oyun yöneticisinin ilk yanıtından sonra çalışır.
|
|
311
312
|
|
|
312
313
|
**Oyun yöneticisi oyunu bilmiyor gibi.** Ajanın RPG Engine'i yüklemedi. Onu kampanya klasöründe başlattığını ve klasöre güvendiğini kontrol et. Claude Code'da `/mcp` yaz ve `rpg`'yi yeniden bağla. Codex'te kampanya klasöründe `codex mcp list` çıktısında `rpg` görünmelidir. `rpg --version` bulunamıyorsa RPG Engine'i yeniden kur ([2.2](#22-install)).
|
|
313
314
|
|
|
@@ -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,4c052d2b,8b310594,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,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,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,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: повний посібник
|
|
3
3
|
|
|
4
4
|
**RPG Engine** дає змогу грати в настільну рольову гру, де **майстром є ШІ**. Ти спілкуєшся з майстром у **чаті**, а RPG Engine працює за лаштунками: він **пам'ятає світ**, **кидає кубики** і **веде облік**. Поруч із чатом у браузері відкрита сторінка, **панель керування**, де є твій аркуш персонажа, кубики, мапи та журнал.
|
|
@@ -64,13 +64,14 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Підключення ШІ
|
|
66
66
|
|
|
67
|
-
Майстер працює в **ШІ-агенті**: це застосунок зі ШІ, в терміналі або на робочому столі, який уміє працювати з файлами на твоєму комп'ютері, наприклад Claude Code або
|
|
67
|
+
Майстер працює в **ШІ-агенті**: це застосунок зі ШІ, в терміналі або на робочому столі, який уміє працювати з файлами на твоєму комп'ютері, наприклад Claude Code, Codex або Antigravity. Звичайного чату на кшталт claude.ai чи ChatGPT або застосунку на телефоні недостатньо: майстрові потрібен доступ до файлів кампанії на твоєму комп'ютері. Кожен агент потребує свого тарифу й входу в обліковий запис: Claude Code потребує платного тарифу Claude, Codex потребує входу через ChatGPT, Antigravity потребує облікового запису Google, безкоштовний тариф якого має невелику тижневу квоту. Встановлюєш агента один раз, зі сторінки самого агента: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
|
-
- **Claude Code**: у папці кампанії напиши `claude`. Коли він запитає, чи ти довіряєш цій папці, вибери **Yes, I trust this folder**. Будь
|
|
69
|
+
- **Claude Code**: у папці кампанії напиши `claude`. Коли він запитає, чи ти довіряєш цій папці, вибери **Yes, I trust this folder**. Будь обережний: попередньо вибрана відповідь — *No, exit*. У кампанії є також невеликий гачок, `rpg --listen`, якого це запитання не показує: він одразу повідомляє майстрові, коли ти робиш щось на дашборді.
|
|
70
70
|
- **Codex**: у папці кампанії напиши `codex` і погодься, коли він запитає, чи ти довіряєш цій папці. У його застосунку для комп'ютера перевір у налаштуваннях, що пам'ять вимкнена для чатів гри.
|
|
71
|
+
- **Antigravity**: у папці кампанії напиши `agy` і погодься, якщо він запитає, чи ти довіряєш цій папці. У кампанії є невеликий гачок, `rpg --approve`, який дозволяє майстрові користуватися інструментами RPG Engine, не питаючи тебе щоразу. Зображення в чаті малює сам майстер. Antigravity зберігає твої попередні чати, а його пам'ять неможливо вимкнути: майстрові наказано ніколи їх не читати. Усе, що ти пишеш, потрапляє до Google, де це можуть читати люди: не вказуй у грі особистих даних. RPG Engine не є продуктом Google.
|
|
71
72
|
- **Інший агент**: запусти його в папці кампанії й підключи до нього MCP-сервер `rpg mcp`. RPG Engine — це стандартний MCP-сервер: майстром може стати будь-який агент, що підтримує MCP, зокрема локальні.
|
|
72
73
|
|
|
73
|
-
Ми граємо й тестуємо з **Claude Code**. **Codex** підключено й перевірено, але цілої кампанії з
|
|
74
|
+
Ми граємо й тестуємо з **Claude Code**. **Codex** і **Antigravity** підключено й перевірено, але цілої кампанії з ними ще не зіграно. Кампанія вимикає власну пам'ять агента: гра живе в його файлах, тож повернення до збереження справді повертає назад.
|
|
74
75
|
|
|
75
76
|
### 2.5 Перший чат
|
|
76
77
|
|
|
@@ -122,11 +123,11 @@ rpg init "The Salt Isles"
|
|
|
122
123
|
|
|
123
124
|
> Я питаю корчмаря, хто ще заходив сьогодні ввечері.
|
|
124
125
|
|
|
125
|
-
|
|
126
|
+
Поза історією пиши `[OOC: …]` (out of character, «поза персонажем»): *[OOC: Як працює захоплення?]* Майстер відповідає так само.
|
|
126
127
|
|
|
127
128
|
Ти кажеш, що пробуєш зробити, а майстер каже, що відбувається. Майстер ніколи не вирішує за твого персонажа і ніколи не говорить про рушій гри. Можеш питати в майстра, як користуватися дашбордом.
|
|
128
129
|
|
|
129
|
-
**Дії з дашборда**: клацни на назву в аркуші персонажа, наприклад на зброю, заклинання чи річ, яку
|
|
130
|
+
**Дії з дашборда**: клацни на назву в аркуші персонажа, наприклад на зброю, заклинання чи річ, яку носиш: її картка пояснює, що це. Обери, що з нею робити, наприклад **Використати**, а потім на кого це спрямовано: у списку або клацанням на мапі. Або клацни на особу, з якою хочеш поговорити. Дашборд складе твоє речення, *Я атакую Бандита в каптурі 1 булавою.*, і його можна змінити, перш ніж натиснути **Сказати майстру**. Майстер сприймає його так, ніби його написано в чаті, і розглядає як будь-яку іншу дію. Якщо застосунок з ШІ не може отримати речення сам, **Копіювати** підготує його, щоб вставити в чат.
|
|
130
131
|
|
|
131
132
|
### 3.2 Кидки
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ rpg init "The Salt Isles"
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Сцени та бої
|
|
144
145
|
|
|
145
|
-
Історія розгортається в **сценах**: бій, розмова, дослідження, подорож, відпочинок. Наприкінці кожної сцени гра зберігається сама,
|
|
146
|
+
Історія розгортається в **сценах**: бій, розмова, дослідження, подорож, відпочинок. Наприкінці кожної сцени гра зберігається сама, сцена потрапляє до твого журналу, а коли історія повертає, майстер записує сцени від попереднього розділу як новий розділ книжки твоєї історії.
|
|
146
147
|
|
|
147
148
|
У бою майстер розповідає про кожен хід, що не належить тобі, і зупиняється там, де ти можеш вирішувати. **Сцена** показує вгорі, чий зараз хід і хто йде наступним, а картка твого персонажа лежить біля мапи. Порядок ходів, очки здоров'я твого загону та те, наскільки поранені вороги (словами), залишаються збоку сторінки. Якщо твій персонаж падає, на сторінці з'являються великі кидки проти смерті.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ RPG Engine веде дату. Між сесіями ігровий час не
|
|
|
158
159
|
|
|
159
160
|
**Світ** показує місця, які знає твій персонаж, дороги між ними та пройдений шлях, а решту вкриває туман. **Сцена** показує мапу місця, де ти перебуваєш, якщо вона є, і хто де стоїть. У бою, на твій хід, клітинки, до яких не дістатися, затінені. Коли майстер питає, куди ти йдеш, торкнись клітинки або напиши її, наприклад *E4*.
|
|
160
161
|
|
|
161
|
-
**Світ** також зберігає те, що знає твій персонаж.
|
|
162
|
+
**Світ** також зберігає те, що знає твій персонаж. У **Знаннях** зібрано людей, місця, угруповання, істот та історії, відомі персонажу, кожне саме так, як персонаж про це знає: шукай серед них або відкрий запис, щоб прочитати повністю. Ім'я в тексті веде на його сторінку. **Документи** зберігають листи, оголошення та сторінки, які знайшов персонаж, щоб перечитати їх. **Календар** показує сьогоднішній день, строки твоїх завдань із часом, що лишився, і дні історії: день зі сценами веде до них у хронології Журналу.
|
|
162
163
|
|
|
163
164
|
### 3.6 Завдання, журнал і нотатки
|
|
164
165
|
|
|
165
|
-
Справа, за яку береться твій персонаж, стає завданням у **Журналі**, зі своїми цілями, строком і тим, що воно вимірює. Познач його зірочкою, щоб
|
|
166
|
+
Справа, за яку береться твій персонаж, стає завданням у **Журналі**, зі своїми цілями, строком і тим, що воно вимірює. Познач його зірочкою, щоб воно лишалося на виду вгорі **Сцени**. У розділі **Історія** Журнал розповідає твою історію як книжку: щоразу, коли історія повертає, майстер пише розділ прози, у якому переказує сцени від попереднього розділу, у стилі за твоїм вибором. Читай розділ за розділом, останній позначено закладкою, а завантажити історію можна як Markdown або як вебсторінку, щоб надрукувати чи передати комусь. У грі, яку розпочато раніше, попроси майстра написати історію на цей момент. **Хронологія** перелічує пронумеровані сцени з тим, що сталося в кожній. Журнал також зберігає твої **Нотатки**: вони приватні, доки ти не натиснеш **Поділитися** на одній із них. Майстер сприймає її як те, що ти думаєш, а не як факт. У розділі **Супутники** ти читаєш щоденники супутників: час від часу, наприкінці дня чи завдання, вони записують кілька рядків про те, що думають і відчувають.
|
|
166
167
|
|
|
167
168
|
### 3.7 Історія та зображення персонажа
|
|
168
169
|
|
|
@@ -192,7 +193,7 @@ RPG Engine зберігає всю кампанію наприкінці кож
|
|
|
192
193
|
|
|
193
194
|
### 3.11 Зображення
|
|
194
195
|
|
|
195
|
-
RPG Engine може створювати зображення місць, до яких ти доходиш, завдань, за які береш, і тих, кого зустрічаєш, як визначає налаштування
|
|
196
|
+
RPG Engine може створювати зображення місць, до яких ти доходиш, завдань, за які береш, і тих, кого зустрічаєш, як визначає налаштування **Зображення**, а також портрет твого персонажа, коли попросиш. Він використовує твій власний Codex або Claude Code, з твоїм входом, на твоєму тарифі та в його межах: **Codex** малює їх, а якщо його немає, їх створює **Claude Code**. **Налаштування** показують, чи може цей комп'ютер їх створювати, і як це налаштувати, якщо ні. Завжди можна дати власне зображення, своєму персонажу або будь-якій сторінці, яку бачиш: наведи вказівник на одне з її зображень, і в кутку з'явиться маленька кнопка із зображенням (з клавіатури теж, а на телефоні вона є завжди). У **Світі** сторінка, яку ти відкриваєш, також має **Змінити зображення…**, а поки зображення немає, має **Додати зображення…**. Твоє зображення займає місце наявного. Або кинь файл у теку **inbox** кампанії й скажи майстру, для якої він сторінки.
|
|
196
197
|
|
|
197
198
|
### 3.12 Безпека: лінії, завіси та стоп
|
|
198
199
|
|
|
@@ -208,12 +209,12 @@ RPG Engine може створювати зображення місць, до
|
|
|
208
209
|
|
|
209
210
|
Сторінка на твоєму комп'ютері. Вона відкривається лише в браузері цього комп'ютера й працює, поки відкритий чат. Коли чат закривається, вона показує *Not connected*. З наступним чатом вона підключається знову сама.
|
|
210
211
|
|
|
211
|
-
- **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо
|
|
212
|
-
- **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут
|
|
213
|
-
- **Журнал**: завдання,
|
|
212
|
+
- **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо стрілка позначає його кубик, побачиш, що покращує або погіршує кидок. Коли майстер готує для тебе вибір, наприклад на новому рівні, повідомлення на аркуші відкриває його: обирай, коли зручно, прочитай сторінки, які називають варіанти, зроби кидок там, де варіант його вимагає, і підтверди. Історія тим часом триває. Поруч видно кидки.
|
|
213
|
+
- **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут ходи й картка твого персонажа.
|
|
214
|
+
- **Журнал**: завдання, історія як книжка, її хронологія, щоденники супутників, твої нотатки.
|
|
214
215
|
- **Світ**: мапа світу, те, що знає твій персонаж, знайдені документи й календар.
|
|
215
|
-
- **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але
|
|
216
|
-
- **Збереження**, **Довідка**, **Налаштування** й **Про гру**: значки в кінці рядка. У
|
|
216
|
+
- **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але ніколи модифікатор, як при критичному влучанні.
|
|
217
|
+
- **Збереження**, **Довідка**, **Налаштування** й **Про гру**: значки в кінці рядка. У **Налаштуваннях** також є параметри самої сторінки: тема, звук кубиків, набір кубиків і **Стиль гри**: кольори, обличчя кубиків і зображення сторінки. Це може бути стиль гральної системи, тема, яку ти додав(-ла) у Packages › Add з каталогу, за посиланням GitHub, із .zip або з теки, чи власний стиль сторінки.
|
|
217
218
|
|
|
218
219
|
Коли майстер про щось питає, його банер лишається вгорі в будь-якому розділі.
|
|
219
220
|
|
|
@@ -271,7 +272,7 @@ RPG Engine може створювати зображення місць, до
|
|
|
271
272
|
|
|
272
273
|
## 8. Для допитливих: тека кампанії <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Відкривати її
|
|
275
|
+
Відкривати її не потрібно, а ще в ній зберігаються секрети твоєї кампанії. У ній є `campaign.yaml` (твої налаштування), `state.yaml` (поточний стан гри), `world/` (по одній сторінці markdown для кожного персонажа, місця, завдання та решти), `rules/` (твої домашні правила), `images/`, `log.jsonl` (кожна зміна), `sessions/` (твої розмови з майстром у вигляді тексту, з Claude Code і Codex), `.saves/`, `.player/` (твої нотатки) і невеликі файли, що кажуть ШІ-агентам, де RPG Engine. Сторінки мають формат Obsidian. Якщо змінити сторінку вручну, майстер дізнається про це в наступній відповіді.
|
|
275
276
|
|
|
276
277
|
RPG Engine працює лише в цій теці: читає й записує гру тільки тут і ніколи не чіпає інших твоїх файлів; теки з твоїми посібниками він тільки читає. Поза нею він зберігає лише власні теки з даними (переклади панелі, текст, прочитаний із твоїх посібників, а також Codex або Claude Code, якщо дозволиш їх встановити) і тимчасові теки, поки малюється картинка. Усе інше, що агент захоче зробити на твоєму комп'ютері, він спершу спитає в тебе. Ігрова система чи розширення — це код, як і будь-який пакет npm: пакет не від нас запускається на твоєму комп'ютері з твоїми правами, а RPG Engine встановлює його лише з твоєї згоди, у формі твого агента або у вікні комп'ютера. Погоджуйся лише на пакети, чиїм авторам довіряєш.
|
|
277
278
|
|
|
@@ -293,7 +294,7 @@ RPG Engine працює лише в цій теці: читає й запису
|
|
|
293
294
|
|
|
294
295
|
### Запитання
|
|
295
296
|
|
|
296
|
-
**Чи треба мені знати правила?** Ні. Обери наставника в режимі навчання й питай у
|
|
297
|
+
**Чи треба мені знати правила?** Ні. Обери наставника в режимі навчання й питай у `[OOC: …]`, коли захочеш.
|
|
297
298
|
|
|
298
299
|
**Чи може майстер шахраювати?** Він не може змінити кидок, зроблений RPG Engine, окрім складності «історія», ані вже встановлені факти.
|
|
299
300
|
|
|
@@ -307,7 +308,7 @@ RPG Engine працює лише в цій теці: читає й запису
|
|
|
307
308
|
|
|
308
309
|
### Проблеми
|
|
309
310
|
|
|
310
|
-
|
|
311
|
+
**Дашборд не відкривається.** Спитай майстра: `[OOC: Яке посилання на дашборд?]`. Він працює лише поки в цій кампанії відкритий чат, після першої відповіді майстра.
|
|
311
312
|
|
|
312
313
|
**Схоже, майстер не знає гри.** Твій агент не завантажив RPG Engine. Перевір, що ти запустив його в теці кампанії й дозволив довіру до неї. У Claude Code напиши `/mcp` і підключи `rpg` знову. У Codex команда `codex mcp list` у теці кампанії має показати `rpg`. Якщо `rpg --version` не знайдено, встанови RPG Engine знову ([2.2](#22-install)).
|
|
313
314
|
|
|
@@ -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,4c052d2b,8b310594,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,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,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,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine:完整指南
|
|
3
3
|
|
|
4
4
|
**RPG Engine** 让你和一位 **AI 主持人**一起玩桌面角色扮演游戏。你在**聊天**里和主持人交谈;RPG Engine 在幕后工作:它**记住世界**,**掷骰子**,**记账**。聊天旁边,你在浏览器里开着一个页面,也就是**仪表盘**,上面有你的角色卡、骰子、地图和日志。
|
|
@@ -64,13 +64,14 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 连接你的 AI
|
|
66
66
|
|
|
67
|
-
主持人运行在一个 **AI 智能体**里:这是一个在终端或桌面上运行的 AI 应用,能处理你电脑上的文件,比如 Claude Code 或
|
|
67
|
+
主持人运行在一个 **AI 智能体**里:这是一个在终端或桌面上运行的 AI 应用,能处理你电脑上的文件,比如 Claude Code、Codex 或 Antigravity。像 claude.ai 或 ChatGPT 这样的普通聊天,或者手机应用,都不够用:主持人需要读取你电脑上的战役文件。每个智能体都需要自己的套餐和登录:Claude Code 需要付费的 Claude 套餐,Codex 需要 ChatGPT 登录,Antigravity 需要 Google 账号,其免费套餐每周的额度很小。你只需安装一次,从它自己的页面安装:[Claude Code](https://code.claude.com/docs/en/setup),[Codex](https://developers.openai.com/codex),[Antigravity](https://antigravity.google)。
|
|
68
68
|
|
|
69
69
|
- **Claude Code**:在战役文件夹里输入 `claude`。当它询问是否信任这个文件夹时,选择 **Yes, I trust this folder**。注意,默认选中的答案是 *No, exit*。战役里还有一个小钩子 `rpg --listen`,这个询问不会显示它:当你在仪表盘上操作时,它会立刻通知主持人。
|
|
70
70
|
- **Codex**:在战役文件夹里输入 `codex`,当它询问是否信任这个文件夹时,回答“是”。如果用它的桌面应用,请在设置里确认游戏的聊天已关闭记忆。
|
|
71
|
+
- **Antigravity**:在战役文件夹里输入 `agy`,如果它询问是否信任这个文件夹,回答“是”。战役里有一个小钩子 `rpg --approve`,让主持人使用 RPG Engine 的工具时不必每次都问你。主持人直接在聊天里画图。Antigravity 会保留你过去的聊天,它的记忆无法关闭:主持人已被告知绝不读取这些内容。你写的内容会发送给 Google,Google 可能安排人员查看:请不要在游戏里写入个人信息。RPG Engine 不是 Google 的产品。
|
|
71
72
|
- **其他智能体**:在战役文件夹里启动它,并给它 MCP 服务器 `rpg mcp`。RPG Engine 是标准的 MCP 服务器:任何支持 MCP 的智能体都可以当主持人,本地运行的也行。
|
|
72
73
|
|
|
73
|
-
我们用 **Claude Code** 来游玩和测试;**Codex**
|
|
74
|
+
我们用 **Claude Code** 来游玩和测试;**Codex** 和 **Antigravity** 已经接入并检查过,但还没有用它们完整玩过一个战役。战役会关闭智能体自带的记忆:游戏存在它的文件里,这样回到某个存档时,才是真正回到过去。
|
|
74
75
|
|
|
75
76
|
### 2.5 第一次聊天
|
|
76
77
|
|
|
@@ -122,11 +123,11 @@ rpg init "The Salt Isles"
|
|
|
122
123
|
|
|
123
124
|
> 我问旅店老板,今晚还有谁路过。
|
|
124
125
|
|
|
125
|
-
|
|
126
|
+
想跳出故事时,请写 `[OOC: …]`(角色之外):*[OOC: 擒抱是怎么运作的?]* 主持人也会用同样的方式回答。
|
|
126
127
|
|
|
127
128
|
你说出想做的尝试,主持人说出结果。主持人不会替你的角色做决定,也不会谈论引擎。你可以问主持人怎么使用控制面板。
|
|
128
129
|
|
|
129
|
-
|
|
130
|
+
**在控制面板上行动**:点击角色卡上的名称,比如武器、法术或随身物品,它的卡片会说明这是什么。再选择要对它做什么,比如**使用**,然后在列表里选择对象,或者在地图上点一下;也可以点击一个人,与其交谈。控制面板会替你写好句子,例如 *我用硬头锤攻击兜帽强盗 1。*,你可以在**告诉主持人**之前修改。主持人听到的就像你在聊天里说的一样,也会照常裁定。如果你的 AI 应用无法自动接收,点击**复制**,再粘贴到聊天里。
|
|
130
131
|
|
|
131
132
|
### 3.2 掷骰
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ rpg init "The Salt Isles"
|
|
|
142
143
|
|
|
143
144
|
### 3.3 场景与战斗
|
|
144
145
|
|
|
145
|
-
|
|
146
|
+
故事以**场景**推进:一场战斗、一次对话、探索、旅行、休息。每个场景结束时,游戏会自动存档,这个场景会记入你的日志,故事转折时,主持人还会把上一章之后的各个场景写成你的故事之书中的新一章。
|
|
146
147
|
|
|
147
148
|
在战斗中,主持人会讲述每个不属于你的回合,并在需要你决定时停下。**场景**顶部会显示轮到谁,以及下一个是谁;你的角色卡在地图旁边。回合顺序、队伍的生命值,以及敌人的伤势(用文字描述),都留在页面一侧。如果你的角色倒下,死亡豁免会大大地显示在页面上。
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ RPG Engine 会记录日期。两次游玩之间,游戏时间会停止,除非
|
|
|
158
159
|
|
|
159
160
|
**世界**显示你的角色所知道的地点、地点之间的道路,以及你走过的路径,其余部分笼罩在迷雾中。**场景**显示你所在之处的地图(如果有的话),以及谁站在哪里;战斗中轮到你时,你到不了的格子会被遮住。主持人问你往哪里移动时,点一下格子,或者直接写出来,比如 *E4*。
|
|
160
161
|
|
|
161
|
-
|
|
162
|
+
**世界**还保存着你的角色所知道的事。**见闻**列出角色所知道的人物、地点、派系、生物和故事,每条都按角色的了解来写:可以搜索,也可以打开一条完整阅读;文中的名称可以跳转到对应页面。**文档**保存角色找到的信件、告示和纸页,可以随时重读。**日历**显示今天、任务的期限和剩余时间,以及故事中的日子:有场景的那一天会通向日志时间线里对应的场景。
|
|
162
163
|
|
|
163
164
|
### 3.6 任务、日志与笔记
|
|
164
165
|
|
|
165
|
-
|
|
166
|
+
角色接下的事务,会在**日志**里成为一个任务,附有目标、期限和衡量方式;给它加星,就会一直显示在场景顶部。在**故事**下,日志会把你的故事讲成一本书:每当故事出现转折,主持人就会按你选择的风格,把上一章之后的各个场景写成新的一章文字;你可以一章一章地读,最后读到的一章会有书签标记,也可以下载为 Markdown 或网页,用来打印或分享给别人。如果游戏是之前开始的,可以请主持人写出到目前为止的故事。**时间线**列出各个场景,按序编号,并写明每个场景中发生的事。日志还保存着你的**笔记**:笔记是私人的,除非你**分享**一条,主持人会把它当作你的想法来听,而不是事实。在**同伴**下,你可以读到同伴们的日记:他们会不时在一天或一个任务结束时,写下几行所思所感。
|
|
166
167
|
|
|
167
168
|
### 3.7 你的角色的故事与画像
|
|
168
169
|
|
|
@@ -192,7 +193,7 @@ RPG Engine 会在每个场景结束时保存整个战役。其余由**存档**
|
|
|
192
193
|
|
|
193
194
|
### 3.11 图片
|
|
194
195
|
|
|
195
|
-
RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务和遇见的人生成图片,你提出要求时也会生成角色的肖像。它使用你自己的 Codex 或 Claude Code,用你的登录账号,走你的套餐和额度:优先由 **Codex** 绘制,否则由 **Claude Code**
|
|
196
|
+
RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务和遇见的人生成图片,你提出要求时也会生成角色的肖像。它使用你自己的 Codex 或 Claude Code,用你的登录账号,走你的套餐和额度:优先由 **Codex** 绘制,否则由 **Claude Code** 绘制。**设置**会告诉你这台电脑能不能生成图片,不能的话该怎么设置。你随时可以给角色或任何你看到的页面添加自己的图片:把鼠标指针移到页面的某张图片上,图片角落会出现一个小小的图片按钮(用键盘也可以,在手机上则始终显示);在**世界**里,你打开的页面还有**更换图片…**,没有图片时则是**添加图片…**。你的图片会取代原有的图片。也可以把文件放进战役的 **inbox** 文件夹,再告诉主持人它是给哪个页面的。
|
|
196
197
|
|
|
197
198
|
### 3.12 安全:底线、帷幕与停止
|
|
198
199
|
|
|
@@ -210,10 +211,10 @@ RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务
|
|
|
210
211
|
|
|
211
212
|
- **队伍**:你的角色卡和同伴的角色卡。点击一个数字即可掷骰;把鼠标悬停在上面,可以看到这个数字的来源。如果数字旁有箭头标出骰子,还能看到什么会让这次掷骰更有利或更不利。主持人为你准备选项时(比如升级的时候),角色卡上会出现一条通知,点开就能查看:你可以随时选择,先读一读选项所指的页面,遇到需要掷骰的选项就掷骰,最后确认;故事会照常继续。旁边是掷骰记录。
|
|
212
213
|
- **场景**:你所在的地方,以及它的图片和地图、在场的人、正在发生的事。战斗中,这里会显示回合顺序和你的角色的卡片。
|
|
213
|
-
-
|
|
214
|
-
-
|
|
214
|
+
- **日志**:任务、书一般的故事、时间线、同伴的日记,还有你的笔记。
|
|
215
|
+
- **世界**:世界地图、你的角色所知道的事、找到的文档和日历。
|
|
215
216
|
- **骰盘**:选择骰子和调整值,然后掷出。×2 会让骰子数量加倍,调整值不加倍,就像重击时那样。
|
|
216
|
-
-
|
|
217
|
+
- **存档**、**帮助**、**设置**和**关于**,以图标的形式排在这一行的末尾。设置里还有页面自己的偏好:主题、骰子音效、骰子款式,以及**游戏风格**,也就是页面的配色、骰面和图片。可选的风格有:游戏系统自带的;你在 Packages › Add 中从目录、GitHub 链接、.zip 或文件夹添加的主题;或者页面自带的。
|
|
217
218
|
|
|
218
219
|
主持人向你提问时,它的提示条会一直停在页面顶部,不论你在哪个部分。
|
|
219
220
|
|
|
@@ -271,7 +272,7 @@ SRD 里没有的内容,你也可以玩,只要来自你自己拥有的书:
|
|
|
271
272
|
|
|
272
273
|
## 8. 好奇者专区:战役文件夹 <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
你完全不需要打开它,而且里面存着你战役的秘密。其中有 `campaign.yaml`(你的设置)、`state.yaml`(游戏进行到哪里)、`world/`(每个角色、地点、任务等各占一页 markdown)、`rules/`(你的房规)、`images/`、`log.jsonl
|
|
275
|
+
你完全不需要打开它,而且里面存着你战役的秘密。其中有 `campaign.yaml`(你的设置)、`state.yaml`(游戏进行到哪里)、`world/`(每个角色、地点、任务等各占一页 markdown)、`rules/`(你的房规)、`images/`、`log.jsonl`(每一次改动)、`sessions/`(你与主持人的聊天文字记录,来自 Claude Code 和 Codex)、`.saves/`、`.player/`(你的笔记),以及告诉 AI 助手 RPG Engine 在哪里的几个小文件。页面采用 Obsidian 的格式。如果你手动修改了某个页面,主持人会在下一次回答时得知。
|
|
275
276
|
|
|
276
277
|
RPG Engine 只在这个文件夹内活动:它只在这里读写游戏,绝不会碰你的其他文件;你的手册所在的文件夹,它只读取。在这个文件夹之外,它只保留自己的数据文件夹(仪表盘的翻译、它从你的手册中读出的文字,以及你允许安装的 Codex 或 Claude Code),还有绘制图片时用到的临时文件夹。你的 AI 助手若想在电脑上做别的事,都会先征求你的同意。游戏系统或扩展就是代码,和所有 npm 包一样:不是我们提供的包,会以你的权限在你的电脑上运行,RPG Engine 只有在你同意后才会安装,你可以在 AI 助手的表单或电脑的窗口中确认。只对你信任其作者的包说“是”。
|
|
277
278
|
|
|
@@ -293,7 +294,7 @@ RPG Engine 只在这个文件夹内活动:它只在这里读写游戏,绝不
|
|
|
293
294
|
|
|
294
295
|
### 问题
|
|
295
296
|
|
|
296
|
-
**我需要懂规则吗?**
|
|
297
|
+
**我需要懂规则吗?** 不需要。选择教程导师,想问什么就用 `[OOC: …]` 提问。
|
|
297
298
|
|
|
298
299
|
**主持人会作弊吗?** 除了难度为“故事”时,它无法更改 RPG Engine 已经掷出的结果,也无法更改已经确定的事实。
|
|
299
300
|
|
|
@@ -307,7 +308,7 @@ RPG Engine 只在这个文件夹内活动:它只在这里读写游戏,绝不
|
|
|
307
308
|
|
|
308
309
|
### 故障
|
|
309
310
|
|
|
310
|
-
**仪表盘打不开。** 问主持人:`[仪表盘的链接是什么?]`。只有在该战役里有聊天开着、并且主持人已做出第一次回复之后,它才能用。
|
|
311
|
+
**仪表盘打不开。** 问主持人:`[OOC: 仪表盘的链接是什么?]`。只有在该战役里有聊天开着、并且主持人已做出第一次回复之后,它才能用。
|
|
311
312
|
|
|
312
313
|
**主持人似乎不懂这个游戏。** 你的智能体没有加载 RPG Engine。请检查你是否在战役文件夹里启动了它,并且选择了信任。在 Claude Code 里,输入 `/mcp` 并重新连接 `rpg`。在 Codex 里,在战役文件夹中运行 `codex mcp list`,必须能看到 `rpg`。如果提示找不到 `rpg --version`,请重新安装 RPG Engine([2.2](#22-install))。
|
|
313
314
|
|