rpg-engine 0.19.0 → 0.20.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/campaign/create-campaign.js +2 -2
- package/dist/campaign/find-campaign.d.ts +4 -0
- package/dist/campaign/find-campaign.js +5 -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 +30 -6
- 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 +55 -0
- package/dist/commands/book.js +105 -0
- package/dist/commands/chats.d.ts +38 -0
- package/dist/commands/chats.js +93 -0
- package/dist/commands/config/config.js +1 -1
- package/dist/commands/config/dashboard.d.ts +8 -1
- package/dist/commands/config/dashboard.js +63 -15
- package/dist/commands/config/words.d.ts +1 -1
- package/dist/commands/config/words.js +17 -4
- package/dist/commands/find.js +1 -1
- package/dist/commands/image.d.ts +9 -0
- package/dist/commands/image.js +95 -18
- package/dist/commands/index.js +4 -0
- package/dist/commands/init.js +3 -3
- package/dist/commands/scene/close.d.ts +2 -0
- package/dist/commands/scene/close.js +13 -2
- package/dist/commands/scene/result.d.ts +2 -0
- package/dist/commands/scene/scene.d.ts +2 -0
- package/dist/commands/shared/campaign/book.d.ts +29 -0
- package/dist/commands/shared/campaign/book.js +95 -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/sheet/sheet.d.ts +7 -0
- package/dist/commands/shared/sheet/sheet.js +27 -0
- package/dist/commands/shared/time/dawn.d.ts +1 -1
- package/dist/commands/shared/time/dawn.js +19 -7
- 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/consents.d.ts +2 -2
- package/dist/core/consents.js +3 -3
- package/dist/core/context.d.ts +38 -2
- package/dist/core/download.js +1 -1
- 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 +3 -3
- package/dist/dashboard/app.js +2 -2
- package/dist/dashboard/guide/ar.md +11 -10
- package/dist/dashboard/guide/cs.md +10 -9
- package/dist/dashboard/guide/da.md +12 -11
- package/dist/dashboard/guide/de.md +12 -11
- package/dist/dashboard/guide/el.md +12 -11
- package/dist/dashboard/guide/en.md +9 -8
- package/dist/dashboard/guide/es.md +10 -9
- package/dist/dashboard/guide/fi.md +10 -9
- package/dist/dashboard/guide/fr.md +16 -15
- package/dist/dashboard/guide/he.md +11 -10
- package/dist/dashboard/guide/hi.md +10 -9
- package/dist/dashboard/guide/hu.md +14 -13
- package/dist/dashboard/guide/is.md +10 -9
- package/dist/dashboard/guide/it.md +13 -12
- package/dist/dashboard/guide/ja.md +10 -9
- package/dist/dashboard/guide/ko.md +11 -10
- package/dist/dashboard/guide/nb.md +12 -11
- package/dist/dashboard/guide/nl.md +10 -9
- package/dist/dashboard/guide/pl.md +11 -10
- package/dist/dashboard/guide/pt.md +12 -11
- package/dist/dashboard/guide/ro.md +10 -9
- package/dist/dashboard/guide/ru.md +12 -11
- package/dist/dashboard/guide/sv.md +10 -9
- package/dist/dashboard/guide/tr.md +13 -12
- package/dist/dashboard/guide/uk.md +13 -12
- package/dist/dashboard/guide/zh.md +11 -10
- package/dist/dashboard/i18n/ar.json +31 -5
- package/dist/dashboard/i18n/cs.json +31 -5
- package/dist/dashboard/i18n/da.json +31 -5
- package/dist/dashboard/i18n/de.json +31 -5
- package/dist/dashboard/i18n/el.json +31 -5
- package/dist/dashboard/i18n/es.json +31 -5
- package/dist/dashboard/i18n/fi.json +31 -5
- package/dist/dashboard/i18n/fr.json +31 -5
- package/dist/dashboard/i18n/he.json +31 -5
- package/dist/dashboard/i18n/hi.json +31 -5
- package/dist/dashboard/i18n/hu.json +31 -5
- package/dist/dashboard/i18n/is.json +31 -5
- package/dist/dashboard/i18n/it.json +32 -6
- package/dist/dashboard/i18n/ja.json +31 -5
- package/dist/dashboard/i18n/ko.json +31 -5
- package/dist/dashboard/i18n/nb.json +31 -5
- package/dist/dashboard/i18n/nl.json +31 -5
- package/dist/dashboard/i18n/pl.json +31 -5
- package/dist/dashboard/i18n/pt.json +31 -5
- package/dist/dashboard/i18n/ro.json +31 -5
- package/dist/dashboard/i18n/ru.json +31 -5
- package/dist/dashboard/i18n/sv.json +31 -5
- package/dist/dashboard/i18n/tr.json +31 -5
- package/dist/dashboard/i18n/uk.json +31 -5
- package/dist/dashboard/i18n/zh.json +31 -5
- package/dist/dashboard/journal/book.js +106 -0
- package/dist/dashboard/journal/journal.js +9 -8
- package/dist/dashboard/parts/labels.js +6 -0
- package/dist/dashboard/parts/widgets.js +1 -1
- package/dist/dashboard/place/view.js +1 -1
- package/dist/dashboard/settings/settings.js +10 -4
- package/dist/dashboard/settings/setup.js +5 -3
- package/dist/dashboard/sheet/sheet.js +8 -5
- package/dist/dashboard/style.css +459 -96
- package/dist/dashboard/world/calendar.js +1 -1
- package/dist/dashboard/world/lore.js +1 -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/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/news.js +36 -5
- 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/instructions/start.md +1 -1
- package/package.json +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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. 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,14 @@ 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 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 sau Antigravity. 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ă. Î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).
|
|
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 un mic hook, `rpg --approve`, care îi permite maestrului de joc să folosească uneltele RPG Engine fără să te întrebe de fiecare dată. Maestrul de joc pictează imaginile chiar în chat. 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.
|
|
71
72
|
- **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.
|
|
72
73
|
|
|
73
|
-
Jucăm și testăm cu **Claude Code**; **Codex**
|
|
74
|
+
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.
|
|
74
75
|
|
|
75
76
|
### 2.5 Primul chat
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Când vrei să ieși din poveste, scrie între paranteze drepte: *[Cum funcțion
|
|
|
126
127
|
|
|
127
128
|
Tu spui ce încerci, iar maestrul de joc spune ce se întâmplă. Maestrul de joc nu decide niciodată pentru personajul tău și nu vorbește despre motor. Poți întreba maestrul de joc cum se folosește tabloul de bord.
|
|
128
129
|
|
|
129
|
-
**Acțiuni din tabloul de bord**: apasă pe un nume din fișa ta, de exemplu o armă, o vrajă sau un obiect pe care îl porți, apoi
|
|
130
|
+
**Acțiuni din tabloul de bord**: apasă pe un nume din fișa ta, de exemplu o armă, o vrajă sau un obiect pe care îl porți: cartonașul lui spune ce este. Alege ce faci cu el, de exemplu **Folosește**, apoi pentru cine este, în listă sau cu un clic pe hartă; sau apasă pe o persoană ca să vorbești cu ea. Tabloul de bord scrie propoziția pentru tine, *Atac Bandit cu glugă 1 cu Buzdugan.*, pe care o poți modifica înainte de **Spune-i maestrului de joc**. Maestrul de joc o aude ca pe o replică spusă în chat și o judecă la fel ca pe oricare alta. Dacă aplicația ta de AI nu o poate prelua singură, **Copiază** o pregătește ca s-o lipești în chat.
|
|
130
131
|
|
|
131
132
|
### 3.2 Aruncări
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ Maestrul de joc cere o aruncare doar când rezultatul este incert și contează,
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Scene și lupte
|
|
144
145
|
|
|
145
|
-
Povestea se desfășoară în **scene**: o luptă, o conversație, o explorare, o călătorie, un popas. La sfârșitul fiecărei scene jocul se salvează singur,
|
|
146
|
+
Povestea se desfășoară în **scene**: o luptă, o conversație, o explorare, o călătorie, un popas. La sfârșitul fiecărei scene jocul se salvează singur, scena intră în jurnalul tău, iar maestrul de joc o scrie ca pe un capitol din cartea poveștii tale.
|
|
146
147
|
|
|
147
148
|
Într-o luptă, maestrul de joc povestește fiecare tură care nu este a ta și se oprește acolo unde poți decide. **Scenă** arată sus al cui este rândul și cine urmează, iar lângă hartă apare cartonașul personajului tău. Ordinea turelor, punctele de viață ale grupului și cât de răniți arată dușmanii, în cuvinte, rămân lângă pagină. Dacă personajul tău cade, aruncările de salvare împotriva morții apar mari pe pagină.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Răufăcătorii au planuri cu termene limită. În fiecare zi nouă, maestrul de
|
|
|
158
159
|
|
|
159
160
|
**Lume** arată locurile pe care le cunoaște personajul tău, drumurile dintre ele și traseul parcurs, cu ceață peste restul. **Scenă** arată harta locului în care te afli, când are una, cu cine se află unde. Într-o luptă, în rândul tău, căsuțele pe care nu le poți atinge sunt acoperite. Când maestrul de joc te întreabă unde te muți, atinge o căsuță sau scrie-o, de exemplu *E4*.
|
|
160
161
|
|
|
161
|
-
**Lume** păstrează și ce știe personajul tău. **Cunoștințe**
|
|
162
|
+
**Lume** păstrează și ce știe personajul tău. **Cunoștințe** enumeră oamenii, locurile, facțiunile, creaturile și poveștile pe care le cunoaște personajul, fiecare așa cum îi este cunoscută: caută în listă sau deschide o intrare ca s-o citești întreagă; un nume din text duce la pagina lui. **Documente** păstrează scrisorile, anunțurile și paginile găsite, ca să le poți reciti. **Calendar** arată ziua de azi, termenele misiunilor tale cu timpul rămas și zilele poveștii: o zi cu scene duce la ele în Cronologia din Jurnal.
|
|
162
163
|
|
|
163
164
|
### 3.6 Misiuni, jurnal și notițe
|
|
164
165
|
|
|
165
|
-
O sarcină pe care o preia personajul tău devine o misiune în **Jurnal**, cu obiectivele ei, termenul limită și ce măsoară;
|
|
166
|
+
O sarcină pe care o preia personajul tău devine o misiune în **Jurnal**, cu obiectivele ei, termenul limită și ce măsoară; marchez-o cu stea ca s-o ai la vedere în partea de sus a paginii Scenă. La **Poveste**, Jurnalul îți spune povestea ca pe o carte: maestrul de joc scrie un capitol în proză pentru fiecare scenă, după ce se termină, în stilul pe care l-ai ales; citește capitol cu capitol, ultimul fiind marcat cu semnul de carte, și descarcă-l ca Markdown sau ca pagină web, ca să-l tipărești sau să-l dai mai departe. Într-un joc început înainte, cere maestrului de joc să scrie povestea de până acum. **Cronologia** enumeră scenele, cu ce s-a întâmplat în fiecare. Jurnalul păstrează și **notițele** tale: private, până când apeși **Partajează** pe una; maestrul de joc o aude ca pe ce gândești tu, niciodată ca pe un fapt. La **Însoțitori** citești jurnalele însoțitorilor tăi: din când în când, la sfârșitul unei zile sau al unei misiuni, ei scriu câteva rânduri despre ce gândesc și ce simt.
|
|
166
167
|
|
|
167
168
|
### 3.7 Povestea și chipul personajului tău
|
|
168
169
|
|
|
@@ -210,7 +211,7 @@ O pagină de pe propriul tău calculator, deschisă doar în browserul acelui ca
|
|
|
210
211
|
|
|
211
212
|
- **Grup**: fișa ta și fișele însoțitorilor tăi. Dă clic pe un număr ca să faci o aruncare; ține cursorul deasupra lui ca să vezi de unde vine și, când o săgeată marchează zarul, ce îmbunătățește sau înrăutățește aruncarea. Când maestrul de joc pregătește alegeri pentru tine, de exemplu la un nivel nou, o notificare de pe fișă le deschide: alege când vrei, citește paginile pe care le numesc opțiunile, aruncă acolo unde o opțiune cere o aruncare, apoi confirmă; povestea merge mai departe între timp. Alături, aruncările.
|
|
212
213
|
- **Scenă**: unde te afli, imaginea și harta ei, cine este de față, ce se întâmplă; într-o luptă, turele și cartonașul personajului tău.
|
|
213
|
-
- **Jurnal**: misiuni, povestea, jurnalele însoțitorilor tăi, notițele tale.
|
|
214
|
+
- **Jurnal**: misiuni, povestea ca o carte, cronologia ei, jurnalele însoțitorilor tăi, notițele tale.
|
|
214
215
|
- **Lume**: harta lumii, ce știe personajul tău, documentele găsite și calendarul.
|
|
215
216
|
- **Tava pentru zaruri**: alege zarurile și un modificator, apoi aruncă; ×2 dublează zarurile, niciodată modificatorul, ca la o lovitură critică.
|
|
216
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.
|
|
@@ -271,7 +272,7 @@ O singură limbă pe campanie, cea a maestrului, pe care o urmează dashboardul.
|
|
|
271
272
|
|
|
272
273
|
## 8. Pentru curioși: folderul campaniei <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Nu trebuie să îl deschizi niciodată, iar el conține secretele campaniei tale. Are `campaign.yaml` (setările tale), `state.yaml` (unde a ajuns jocul), `world/` (o pagină markdown pentru fiecare personaj, loc, misiune și restul), `rules/` (regulile tale de casă), `images/`, `log.jsonl` (fiecare schimbare), `.saves/`, `.player/` (notițele tale) și fișierele mici care spun agenților AI unde se află RPG Engine. Paginile folosesc formatul Obsidian. Dacă schimbi o pagină manual, maestrul de joc află la următorul răspuns.
|
|
275
|
+
Nu trebuie să îl deschizi niciodată, iar el conține secretele campaniei tale. Are `campaign.yaml` (setările tale), `state.yaml` (unde a ajuns jocul), `world/` (o pagină markdown pentru fiecare personaj, loc, misiune și restul), `rules/` (regulile tale de casă), `images/`, `log.jsonl` (fiecare schimbare), `sessions/` (conversațiile tale cu maestrul de joc, sub formă de text, din Claude Code și Codex), `.saves/`, `.player/` (notițele tale) și fișierele mici care spun agenților AI unde se află RPG Engine. Paginile folosesc formatul Obsidian. Dacă schimbi o pagină manual, maestrul de joc află la următorul răspuns.
|
|
275
276
|
|
|
276
277
|
RPG Engine rămâne în acest folder: citește și scrie jocul doar aici și nu atinge niciodată celelalte fișiere ale tale; folderele cu manualele tale doar le citește. În afara lui, păstrează doar foldere de date proprii (traducerile dashboardului, textul citit din manualele tale, iar Codex sau Claude Code dacă îl lași să le instaleze) și foldere temporare cât timp se desenează o imagine. Orice altceva vrea agentul tău să facă pe calculatorul tău, te întreabă mai întâi. Un sistem de joc sau o extensie este cod, ca orice pachet npm: unul care nu este al nostru rulează pe calculatorul tău cu permisiunile tale, iar RPG Engine îl instalează doar cu acordul tău, într-un formular al agentului tău sau într-o fereastră a calculatorului. Spune da doar pachetelor ai căror autori ai încredere.
|
|
277
278
|
|
|
@@ -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,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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
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
|
|
|
@@ -126,7 +127,7 @@ rpg init "The Salt Isles"
|
|
|
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
|
|
|
@@ -208,12 +209,12 @@ RPG Engine умеет создавать картинки мест, до кот
|
|
|
208
209
|
|
|
209
210
|
Страница на твоём компьютере. Она открывается только в браузере этого компьютера и работает, пока открыт чат. Когда чат закрывается, на ней появляется надпись *Not connected*. С новым чатом страница подключается сама.
|
|
210
211
|
|
|
211
|
-
- **Отряд**: твой лист персонажа и листы спутников. Нажми на число, чтобы сделать бросок. Наведи на него курсор, чтобы увидеть, откуда оно берётся. Если у кубика
|
|
212
|
+
- **Отряд**: твой лист персонажа и листы спутников. Нажми на число, чтобы сделать бросок. Наведи на него курсор, чтобы увидеть, откуда оно берётся. Если у кубика стоит стрелка, будет видно, что улучшает или ухудшает бросок. Когда мастер готовит для тебя выбор, например при получении нового уровня, на листе появляется уведомление, которое открывает этот выбор. Выбирай, когда удобно: прочитай страницы, на которые указывают варианты, сделай бросок там, где его требует вариант, и подтверди выбор. История тем временем продолжается. Рядом показаны броски.
|
|
212
213
|
- **Сцена**: где ты находишься, картинка и карта места, кто рядом, что происходит. В бою здесь видны ходы и карточка твоего персонажа.
|
|
213
|
-
- **Журнал**: задания,
|
|
214
|
+
- **Журнал**: задания, история как книга, хронология, дневники спутников, твои заметки.
|
|
214
215
|
- **Мир**: карта мира, то, что известно твоему персонажу, найденные документы и календарь.
|
|
215
216
|
- **Лоток для кубиков**: выбери кубики и модификатор, затем брось их. Кнопка ×2 удваивает кубики, но не модификатор, как при критическом попадании.
|
|
216
|
-
- **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В
|
|
217
|
+
- **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В Настройках также есть параметры самой страницы: тема, звук кубиков, набор кубиков.
|
|
217
218
|
|
|
218
219
|
Когда мастер задаёт тебе вопрос, его баннер остаётся вверху, в каком бы разделе ты ни был.
|
|
219
220
|
|
|
@@ -271,7 +272,7 @@ RPG Engine умеет создавать картинки мест, до кот
|
|
|
271
272
|
|
|
272
273
|
## 8. Для любопытных: папка кампании <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Открывать её тебе никогда не нужно. В ней хранятся секреты твоей кампании. В ней лежат `campaign.yaml` (твои настройки), `state.yaml` (текущее состояние игры), `world/` (по одной markdown-странице для каждого персонажа, места, задания и всего остального), `rules/` (твои домашние правила), `images/`, `log.jsonl` (каждое изменение), `.saves/`, `.player/` (твои заметки) и маленькие файлы, которые подсказывают ИИ-агентам, где находится RPG Engine. Страницы написаны в формате Obsidian. Если ты изменишь страницу вручную, мастер узнает об этом при следующем ответе.
|
|
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
|
|
|
@@ -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,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: den kompletta guiden
|
|
3
3
|
|
|
4
4
|
**RPG Engine** låter dig spela ett bordsrollspel med en **AI som spelledare**. Du pratar med spelledaren i en **chatt**. RPG Engine arbetar i bakgrunden: det **minns världen**, **slår tärningarna** och **för räkenskaperna**. Bredvid chatten har du en sida öppen i webbläsaren, **dashboarden**, med ditt rollformulär, tärningarna, kartorna och din dagbok.
|
|
@@ -64,13 +64,14 @@ Spelledaren kan inte skapa en kampanj åt dig. Före `init` vet din agent inte v
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Anslut din AI
|
|
66
66
|
|
|
67
|
-
Spelledaren körs i en **AI-agent**: en AI-app, i terminalen eller på skrivbordet, som kan arbeta med filerna på din dator, till exempel Claude Code eller
|
|
67
|
+
Spelledaren körs i en **AI-agent**: en AI-app, i terminalen eller på skrivbordet, som kan arbeta med filerna på din dator, till exempel Claude Code, Codex eller Antigravity. En vanlig chatt som claude.ai eller ChatGPT, eller en app i mobilen, räcker inte: spelledaren måste kunna nå kampanjens filer på din dator. Varje agent kräver sitt eget abonnemang och sin egen inloggning: Claude Code ett betalt Claude-abonnemang, Codex en ChatGPT-inloggning, Antigravity ett Google-konto, vars gratisabonnemang har en liten veckokvot. Du installerar agenten en gång, från dess egen sida: [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**: skriv `claude` i kampanjmappen. När den frågar om du litar på mappen väljer du **Yes, I trust this folder**. Se upp: svaret som är förvalt är *No, exit*. Kampanjen har också en liten hook, `rpg --listen`, som frågan inte visar. Den talar direkt om för spelledaren när du gör något på dashboarden.
|
|
70
70
|
- **Codex**: skriv `codex` i kampanjmappen och svara ja när den frågar om du litar på mappen. Kontrollera i inställningarna i skrivbordsappen att minnen är avstängda för spelets chattar.
|
|
71
|
+
- **Antigravity**: skriv `agy` i kampanjmappen och svara ja om den frågar om du litar på mappen. Kampanjen har en liten hook, `rpg --approve`, som låter spelledaren använda RPG Engines verktyg utan att fråga dig varje gång. Spelledaren målar bilderna i chatten själv. Antigravity sparar dina tidigare chattar, och dess minne kan inte stängas av: spelledaren har fått instruktion att aldrig läsa dem. Det du skriver går till Google, som kan låta människor läsa det: håll personuppgifter utanför spelet. RPG Engine är inte en produkt från Google.
|
|
71
72
|
- **En annan agent**: starta den i kampanjmappen och ge den MCP-servern `rpg mcp`. RPG Engine är en standardiserad MCP-server: alla agenter som stöder MCP kan vara spelledare, även lokala.
|
|
72
73
|
|
|
73
|
-
Vi spelar och testar med **Claude Code**. **Codex** är
|
|
74
|
+
Vi spelar och testar med **Claude Code**. **Codex** och **Antigravity** är anslutna och kontrollerade, men ingen hel kampanj har ännu spelats med dem. Kampanjen stänger av agentens eget minne: spelet finns i dess filer, så att en återgång till ett sparat spel verkligen tar dig tillbaka.
|
|
74
75
|
|
|
75
76
|
### 2.5 Den första chatten
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Skriv inom hakparenteser när du pratar utanför berättelsen: *[Hur fungerar br
|
|
|
126
127
|
|
|
127
128
|
Du säger vad du försöker göra. Spelledaren säger vad som händer. Spelledaren bestämmer aldrig något åt din rollperson och pratar aldrig om motorn. Du kan fråga spelledaren hur du använder dashboarden.
|
|
128
129
|
|
|
129
|
-
**Agera från dashboarden**: klicka på ett namn på ditt rollformulär, till exempel ett vapen, en besvärjelse eller något du bär på. Välj sedan vem det gäller. Du kan också klicka på en person för att prata med den. Dashboarden skriver din mening, *Jag attackerar Hooded Bandit 1 med Mace.*, och du kan ändra den innan du väljer **Säg till spelledaren**. Spelledaren hör den som om den sagts i chatten och dömer den som vilken annan handling som helst. Där din AI-app inte kan höra den själv gör **Kopiera** den klar att klistra in i chatten.
|
|
130
|
+
**Agera från dashboarden**: klicka på ett namn på ditt rollformulär, till exempel ett vapen, en besvärjelse eller något du bär på. Kortet säger vad det är. Välj vad du gör med det, till exempel **Använd**, och sedan vem det gäller, i listan eller med ett klick på kartan. Du kan också klicka på en person för att prata med den. Dashboarden skriver din mening, *Jag attackerar Hooded Bandit 1 med Mace.*, och du kan ändra den innan du väljer **Säg till spelledaren**. Spelledaren hör den som om den sagts i chatten och dömer den som vilken annan handling som helst. Där din AI-app inte kan höra den själv gör **Kopiera** den klar att klistra in i chatten.
|
|
130
131
|
|
|
131
132
|
### 3.2 Slag
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ Spelledaren ber om ett slag bara när utgången är osäker och spelar roll. Fö
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Scener och strider
|
|
144
145
|
|
|
145
|
-
Berättelsen går i **scener**: en strid, ett samtal, utforskning, resa eller vila. I slutet av varje scen sparas spelet av sig självt,
|
|
146
|
+
Berättelsen går i **scener**: en strid, ett samtal, utforskning, resa eller vila. I slutet av varje scen sparas spelet av sig självt, scenen hamnar i din dagbok, och spelledaren skriver den som ett kapitel i din berättelses bok.
|
|
146
147
|
|
|
147
148
|
I en strid berättar spelledaren varje tur som inte är din, och stannar där du kan bestämma. **Scen** visar högst upp vems tur det är och vem som kommer härnäst, och din rollpersons kort bredvid kartan. Turordningen, gruppens träffpoäng och hur skadade fienderna ser ut, i ord, står kvar bredvid sidan. Om din rollperson faller visas dödsslagen stort på sidan.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Skurkar har planer med tidsfrister. Varje ny dag flyttar spelledaren fram de hot
|
|
|
158
159
|
|
|
159
160
|
**Värld** visar de platser din rollperson känner till, vägarna mellan dem och spåret du har gått, med dimma över resten. **Scen** visar kartan över platsen där du är, när det finns en, och vem som står var. I en strid, på din tur, är de rutor du inte kan nå dolda. När spelledaren frågar vart du går, tryck på en ruta eller skriv den, till exempel *E4*.
|
|
160
161
|
|
|
161
|
-
**Värld** rymmer också det din rollperson vet. **Kunskap** listar de personer, platser, fraktioner, varelser och berättelser som rollpersonen känner till, var och en så som rollpersonen känner till den. Sök i listan, eller öppna en post för att läsa den helt. Ett namn i texten leder till sin sida. **Dokument** sparar breven, kungörelserna och sidorna som rollpersonen hittade, så att du kan läsa dem igen. **Kalender** visar dagens datum, dina uppdrags tidsfrister med tiden som är kvar, och berättelsens dagar. En dag med scener leder till
|
|
162
|
+
**Värld** rymmer också det din rollperson vet. **Kunskap** listar de personer, platser, fraktioner, varelser och berättelser som rollpersonen känner till, var och en så som rollpersonen känner till den. Sök i listan, eller öppna en post för att läsa den helt. Ett namn i texten leder till sin sida. **Dokument** sparar breven, kungörelserna och sidorna som rollpersonen hittade, så att du kan läsa dem igen. **Kalender** visar dagens datum, dina uppdrags tidsfrister med tiden som är kvar, och berättelsens dagar. En dag med scener leder till dem i dagbokens tidslinje.
|
|
162
163
|
|
|
163
164
|
### 3.6 Uppdrag, dagbok och anteckningar
|
|
164
165
|
|
|
165
|
-
En uppgift som din rollperson tar sig an blir ett uppdrag i **Dagbok**, med sina mål, sin tidsfrist och det den mäter. Stjärnmärk det för att ha det i sikte högst upp i Scen
|
|
166
|
+
En uppgift som din rollperson tar sig an blir ett uppdrag i **Dagbok**, med sina mål, sin tidsfrist och det den mäter. Stjärnmärk det för att ha det i sikte högst upp i **Scen**. Under **Berättelse** berättar dagboken din berättelse som en bok: spelledaren skriver ett kapitel i prosa för varje scen när den är slut, i den stil du har valt. Läs den kapitel för kapitel, där det senaste är markerat med sitt bokmärke, och ladda ner den som Markdown eller som en webbsida att skriva ut eller dela vidare. I ett spel som du började på tidigare ber du spelledaren skriva berättelsen hittills. **Tidslinje** listar scenerna med det som hände i var och en. Dagboken sparar också dina **Anteckningar**: de är privata, om du inte väljer **Dela** för en av dem. Spelledaren hör den då som något du tänker, aldrig som ett faktum. Under **Följeslagare** läser du dina följeslagares dagböcker. Då och då, i slutet av en dag eller ett uppdrag, skriver de några rader om vad de tänker och känner.
|
|
166
167
|
|
|
167
168
|
### 3.7 Din rollpersons historia och bild
|
|
168
169
|
|
|
@@ -210,7 +211,7 @@ En sida på din egen dator. Den öppnas bara i webbläsaren på den datorn och
|
|
|
210
211
|
|
|
211
212
|
- **Grupp**: ditt rollformulär och dina följeslagares. Klicka på ett tal för att slå det. Håll muspekaren över det för att se var det kommer ifrån och, när en pil markerar tärningen, vad som gör slaget bättre eller sämre. När spelledaren förbereder val åt dig, till exempel vid en ny nivå, öppnar du dem med en notis på rollformuläret. Välj när du vill, läs de sidor som alternativen nämner, slå där ett alternativ kräver slag och bekräfta sedan. Berättelsen fortsätter under tiden. Bredvid ser du slagen.
|
|
212
213
|
- **Scen**: var du är, dess bild och karta, vem som är där och vad som händer. I en strid visas turerna och din rollpersons kort.
|
|
213
|
-
- **Dagbok**: uppdrag, berättelsen, dina följeslagares dagböcker och dina anteckningar.
|
|
214
|
+
- **Dagbok**: uppdrag, berättelsen som en bok, dess tidslinje, dina följeslagares dagböcker och dina anteckningar.
|
|
214
215
|
- **Värld**: världskartan, det din rollperson vet, de dokument som hittats och kalendern.
|
|
215
216
|
- **Tärningsbrickan**: välj tärningar och en modifikation, och slå; ×2 fördubblar tärningarna, aldrig modifikationen, som vid en kritisk träff.
|
|
216
217
|
- **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. Inställningar rymmer också sidans egna val: tema, tärningsljud och tärningsset.
|
|
@@ -271,7 +272,7 @@ Ett språk per kampanj, spelledarens, som dashboarden följer. Dashboarden lever
|
|
|
271
272
|
|
|
272
273
|
## 8. För de nyfikna: kampanjmappen <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Du behöver aldrig öppna den, och den innehåller kampanjens hemligheter. Där finns `campaign.yaml` (dina inställningar), `state.yaml` (hur spelet står), `world/` (en markdownsida för varje rollperson, plats, uppdrag och allt annat), `rules/` (dina husregler), `images/`, `log.jsonl` (varje ändring), `.saves/`, `.player/` (dina anteckningar) och de små filerna som talar om för AI-agenter var RPG Engine finns. Sidorna använder Obsidians format. Om du ändrar en sida för hand får spelledaren veta det vid sitt nästa svar.
|
|
275
|
+
Du behöver aldrig öppna den, och den innehåller kampanjens hemligheter. Där finns `campaign.yaml` (dina inställningar), `state.yaml` (hur spelet står), `world/` (en markdownsida för varje rollperson, plats, uppdrag och allt annat), `rules/` (dina husregler), `images/`, `log.jsonl` (varje ändring), `sessions/` (dina chattar med spelledaren som text, från Claude Code och Codex), `.saves/`, `.player/` (dina anteckningar) och de små filerna som talar om för AI-agenter var RPG Engine finns. Sidorna använder Obsidians format. Om du ändrar en sida för hand får spelledaren veta det vid sitt nästa svar.
|
|
275
276
|
|
|
276
277
|
RPG Engine stannar i den här mappen: det läser och skriver spelet bara här och rör aldrig dina andra filer. Mapparna med dina regelböcker läser det bara. Utanför mappen sparar det bara egna datamappar (instrumentpanelens översättningar, texten det har läst ur dina regelböcker, samt Codex eller Claude Code om du låter det installera dem) och tillfälliga mappar medan en bild ritas. Allt annat som din agent vill göra på din dator frågar den dig om först. Ett spelsystem eller ett tillägg är kod, som varje npm-paket: ett som inte är vårt körs på din dator med dina behörigheter, och RPG Engine installerar det bara med ditt ja, i ett formulär från din agent eller i ett fönster på din dator. Säg bara ja till paket vars upphovspersoner du litar på.
|
|
277
278
|
|
|
@@ -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,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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
|
|
|
@@ -126,7 +127,7 @@ Hikâyenin dışına çıkmak için köşeli parantez kullan: *[Tutuşma nasıl
|
|
|
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
|
|
146
|
+
Hikâye **sahneler** halinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder, sahne günlüğüne girer ve oyun yöneticisi onu hikâyenin kitabına 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: oyun yöneticisi her sahne bitince seçtiğin üslupla düzyazı bir bölüm yazar. 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 her birinde olanlarla listeler. Günlük, **Notlar**'ı da tutar. Notlar özeldir; bir notu **Paylaş**ırsan oyun yöneticisi bunu 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
|
|
|
@@ -208,11 +209,11 @@ 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
|
+
- **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.
|
|
216
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.
|
|
217
218
|
|
|
218
219
|
Oyun yöneticisi sana bir şey sorduğunda, afişi hangi bölümde olursan ol en üstte kalır.
|
|
@@ -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
|
|
|
@@ -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,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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
|
|
|
@@ -126,7 +127,7 @@ rpg init "The Salt Isles"
|
|
|
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
|
|
|
@@ -209,10 +210,10 @@ RPG Engine може створювати зображення місць, до
|
|
|
209
210
|
Сторінка на твоєму комп'ютері. Вона відкривається лише в браузері цього комп'ютера й працює, поки відкритий чат. Коли чат закривається, вона показує *Not connected*. З наступним чатом вона підключається знову сама.
|
|
210
211
|
|
|
211
212
|
- **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо біля кубика є стрілка, побачиш, що покращує або погіршує кидок. Коли майстер готує для тебе вибір, наприклад на новому рівні, повідомлення на аркуші відкриває його: обирай, коли зручно, прочитай сторінки, які називають варіанти, зроби кидок там, де варіант його вимагає, і підтверди. Історія тим часом триває. Поруч видно кидки.
|
|
212
|
-
- **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут
|
|
213
|
-
- **Журнал**: завдання,
|
|
213
|
+
- **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут ходи й картка твого персонажа.
|
|
214
|
+
- **Журнал**: завдання, історія як книжка, її хронологія, щоденники супутників, твої нотатки.
|
|
214
215
|
- **Світ**: мапа світу, те, що знає твій персонаж, знайдені документи й календар.
|
|
215
|
-
- **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але
|
|
216
|
+
- **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але ніколи модифікатор, як при критичному влучанні.
|
|
216
217
|
- **Збереження**, **Довідка**, **Налаштування** й **Про гру**: значки в кінці рядка. У Налаштуваннях також є параметри самої сторінки: тема, звук кубиків, набір кубиків.
|
|
217
218
|
|
|
218
219
|
Коли майстер про щось питає, його банер лишається вгорі в будь-якому розділі.
|
|
@@ -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
|
|