rpg-engine 0.23.1 → 0.24.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/campaign/create-campaign.d.ts +1 -1
- package/dist/campaign/create-campaign.js +1 -1
- package/dist/campaign/find-campaign.js +11 -1
- package/dist/campaign/host-files.d.ts +5 -6
- package/dist/campaign/host-files.js +100 -60
- package/dist/campaign/settings.d.ts +3 -3
- package/dist/campaign/settings.js +5 -4
- package/dist/cli/cli.js +11 -2
- package/dist/commands/config/config.js +1 -1
- package/dist/commands/config/dashboard.js +23 -6
- package/dist/commands/config/words.js +1 -0
- package/dist/commands/image.js +3 -3
- package/dist/commands/import/import.d.ts +3 -1
- package/dist/commands/import/import.js +13 -5
- package/dist/commands/instructions.js +1 -1
- package/dist/commands/shared/campaign/images.js +3 -2
- package/dist/commands/shared/campaign/mode.js +1 -1
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +9 -9
- package/dist/commands/shared/sheet/sheet.d.ts +2 -2
- package/dist/commands/shared/sheet/sheet.js +3 -3
- package/dist/core/context.d.ts +8 -2
- package/dist/dashboard/acts/acts.js +39 -11
- package/dist/dashboard/acts/head.js +7 -0
- package/dist/dashboard/acts/names.js +4 -2
- package/dist/dashboard/acts/sending.js +23 -22
- package/dist/dashboard/acts/sheet.js +7 -149
- package/dist/dashboard/acts/strip.js +10 -14
- package/dist/dashboard/acts/talk.js +51 -0
- package/dist/dashboard/acts/thing.js +169 -0
- package/dist/dashboard/app.js +3 -3
- package/dist/dashboard/guide/ar.md +14 -14
- package/dist/dashboard/guide/cs.md +12 -12
- package/dist/dashboard/guide/da.md +12 -12
- package/dist/dashboard/guide/de.md +11 -11
- package/dist/dashboard/guide/el.md +11 -11
- package/dist/dashboard/guide/en.md +10 -10
- package/dist/dashboard/guide/es.md +11 -11
- package/dist/dashboard/guide/fi.md +11 -11
- package/dist/dashboard/guide/fr.md +12 -12
- package/dist/dashboard/guide/he.md +11 -11
- package/dist/dashboard/guide/hi.md +12 -12
- package/dist/dashboard/guide/hu.md +11 -11
- package/dist/dashboard/guide/is.md +11 -11
- package/dist/dashboard/guide/it.md +38 -38
- package/dist/dashboard/guide/ja.md +12 -12
- package/dist/dashboard/guide/ko.md +12 -12
- package/dist/dashboard/guide/nb.md +11 -11
- package/dist/dashboard/guide/nl.md +11 -11
- package/dist/dashboard/guide/pl.md +11 -11
- package/dist/dashboard/guide/pt.md +11 -11
- package/dist/dashboard/guide/ro.md +12 -12
- package/dist/dashboard/guide/ru.md +12 -12
- package/dist/dashboard/guide/sv.md +13 -13
- package/dist/dashboard/guide/tr.md +13 -13
- package/dist/dashboard/guide/uk.md +11 -11
- package/dist/dashboard/guide/zh.md +12 -12
- package/dist/dashboard/i18n/ar.json +33 -18
- package/dist/dashboard/i18n/cs.json +33 -18
- package/dist/dashboard/i18n/da.json +33 -18
- package/dist/dashboard/i18n/de.json +33 -18
- package/dist/dashboard/i18n/el.json +33 -18
- package/dist/dashboard/i18n/es.json +33 -18
- package/dist/dashboard/i18n/fi.json +33 -18
- package/dist/dashboard/i18n/fr.json +33 -18
- package/dist/dashboard/i18n/he.json +33 -18
- package/dist/dashboard/i18n/hi.json +33 -18
- package/dist/dashboard/i18n/hu.json +33 -18
- package/dist/dashboard/i18n/is.json +33 -18
- package/dist/dashboard/i18n/it.json +113 -98
- package/dist/dashboard/i18n/ja.json +33 -18
- package/dist/dashboard/i18n/ko.json +33 -18
- package/dist/dashboard/i18n/nb.json +33 -18
- package/dist/dashboard/i18n/nl.json +33 -18
- package/dist/dashboard/i18n/pl.json +33 -18
- package/dist/dashboard/i18n/pt.json +33 -18
- package/dist/dashboard/i18n/ro.json +33 -18
- package/dist/dashboard/i18n/ru.json +33 -18
- package/dist/dashboard/i18n/sv.json +33 -18
- package/dist/dashboard/i18n/tr.json +33 -18
- package/dist/dashboard/i18n/uk.json +33 -18
- package/dist/dashboard/i18n/zh.json +33 -18
- package/dist/dashboard/packages/outcomes.js +1 -1
- package/dist/dashboard/packages/packages.js +1 -1
- package/dist/dashboard/parts/icons.js +2 -0
- package/dist/dashboard/parts/labels.js +1 -0
- package/dist/dashboard/parts/layout.js +34 -0
- package/dist/dashboard/parts/widgets.js +6 -2
- package/dist/dashboard/settings/language-choice.js +1 -1
- package/dist/dashboard/settings/settings.js +65 -40
- package/dist/dashboard/settings/tabs.js +14 -0
- package/dist/dashboard/sheet/sheet.js +54 -33
- package/dist/dashboard/shell/notices.js +2 -2
- package/dist/dashboard/shell/pages.js +1 -1
- package/dist/dashboard/shell/top.js +1 -1
- package/dist/dashboard/style.css +122 -47
- package/dist/helpers/antigravity.d.ts +47 -0
- package/dist/helpers/antigravity.js +434 -0
- package/dist/helpers/chosen.d.ts +11 -7
- package/dist/helpers/chosen.js +64 -37
- package/dist/helpers/index.d.ts +1 -0
- package/dist/helpers/index.js +2 -1
- package/dist/helpers/opencode.js +117 -24
- package/dist/helpers/programs.d.ts +8 -0
- package/dist/helpers/programs.js +35 -2
- package/dist/helpers/stop.d.ts +2 -0
- package/dist/helpers/stop.js +20 -1
- package/dist/helpers/svg.d.ts +4 -1
- package/dist/helpers/svg.js +16 -4
- package/dist/instructions/index.d.ts +4 -2
- package/dist/instructions/index.js +6 -3
- package/dist/server/bell/antigravity.d.ts +7 -2
- package/dist/server/bell/antigravity.js +24 -6
- package/dist/server/bell/index.d.ts +1 -1
- package/dist/server/bell/index.js +1 -1
- package/dist/server/bell/listener.js +6 -1
- package/dist/server/fence.d.ts +21 -0
- package/dist/server/fence.js +69 -0
- package/dist/server/mcp.js +26 -0
- package/dist/server/player-acts.js +1 -1
- package/dist/server/subagent.d.ts +4 -0
- package/dist/server/subagent.js +30 -0
- package/instructions/voices-antigravity.md +1 -0
- package/instructions/voices-codex.md +1 -0
- package/instructions/voices-opencode.md +1 -1
- package/package.json +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,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,83c19e53,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: ghidul complet
|
|
3
3
|
|
|
4
4
|
**RPG Engine** îți permite să joci un joc de rol de masă cu o **IA în rolul de maestru de joc**. Vorbești cu maestrul de joc într-un **chat**; RPG Engine lucrează în spate: **își amintește lumea**, **aruncă zarurile** și **ține socotelile**. Lângă chat ții deschisă în browser o pagină, **dashboardul**, cu fișa ta, zarurile, hărțile și jurnalul.
|
|
@@ -67,14 +67,14 @@ Maestrul de joc nu poate crea o campanie în locul tău: înainte de `init`, nim
|
|
|
67
67
|
Maestrul de joc rulează într-un **agent AI**: o aplicație AI, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code, Codex, Antigravity sau OpenCode. Un chat obișnuit, precum claude.ai sau ChatGPT, sau o aplicație de telefon nu ajunge: maestrul de joc trebuie să poată accesa fișierele campaniei de pe calculatorul tău. Fiecare agent are nevoie de propriul abonament și de propria autentificare: Claude Code, un abonament Claude cu plată; Codex, o autentificare ChatGPT; Antigravity, un cont Google, al cărui abonament gratuit are o cotă săptămânală mică; OpenCode funcționează cu modelele pe care i le dai tu, inclusiv cu cele locale. Îl instalezi o singură dată, de pe pagina lui: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: în dosarul campaniei scrie `claude`. Când te întreabă dacă ai încredere în dosar, alege **Yes, I trust this folder**; atenție, răspunsul deja selectat este *No, exit*. Campania are și un mic hook, `rpg --listen`, pe care întrebarea nu-l arată: îi spune maestrului de joc pe loc când acționezi din dashboard.
|
|
70
|
-
- **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; sau, în aplicația lui, deschide dosarul campaniei. Pentru aplicație, RPG Engine se adaugă și în setările proprii ale Antigravity, `.gemini/config/mcp_config.json` din dosarul tău personal, care se aplică fiecărui dosar pe care îl deschizi, nu doar celui al campaniei: în afara unei campanii nu face nimic. Campania are două mici hookuri: `rpg --approve` îi permite maestrului de joc să folosească uneltele RPG Engine fără să te întrebe de fiecare dată, iar `rpg --listen` îi spune maestrului de joc pe loc când acționezi din dashboard. Maestrul de joc pictează imaginile chiar în chat
|
|
72
|
-
- **OpenCode**: în dosarul campaniei scrie `opencode`. Campania are un mic plugin, `.opencode/plugins/rpg.js`, care îi spune maestrului de joc pe loc când acționezi din dashboard. În campanie, maestrul de joc scrie fișiere doar prin RPG Engine: scrierea și editarea proprie de fișiere a OpenCode sunt oprite acolo, iar
|
|
70
|
+
- **Codex**: în dosarul campaniei scrie `codex` și răspunde da când te întreabă dacă ai încredere în dosar. În momentele-cheie, un personaj vorbește printr-un agent propriu, `.codex/agents/rpg-character.toml`, care știe doar ce știe personajul. Î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; sau, în aplicația lui, deschide dosarul campaniei. Pentru aplicație, RPG Engine se adaugă și în setările proprii ale Antigravity, `.gemini/config/mcp_config.json` din dosarul tău personal, care se aplică fiecărui dosar pe care îl deschizi, nu doar celui al campaniei: în afara unei campanii nu face nimic. Campania are două mici hookuri: `rpg --approve` îi permite maestrului de joc să folosească uneltele RPG Engine fără să te întrebe de fiecare dată, iar `rpg --listen` îi spune maestrului de joc pe loc când acționezi din dashboard. Maestrul de joc pictează imaginile chiar în chat, cu un abonament Google cu plată; în abonamentul gratuit, unealta de imagini nu funcționează, iar maestrul desenează imagini vectoriale simple, ca Claude. În momentele-cheie, un personaj vorbește printr-un agent propriu, `.agents/agents/rpg-character.md`: maestrul de joc scrie o replică a poveștii, iar răspunsul personajului vine după o clipă. Antigravity-ul tău traduce și dashboardul și regulile jocului și citește documentele pe care le imporți, în afara chatului, din cota contului tău Google: RPG Engine îl pornește separat de chaturile tale, așa că nu lasă nimic printre ele. Antigravity păstrează chaturile tale anterioare, iar memoria lui nu poate fi oprită: maestrului de joc i se spune să nu le citească niciodată. Ce scrii ajunge la Google, care poate pune oameni să citească: nu introduce date personale în joc. RPG Engine nu este un produs Google.
|
|
72
|
+
- **OpenCode**: în dosarul campaniei scrie `opencode`. Campania are un mic plugin, `.opencode/plugins/rpg.js`, care îi spune maestrului de joc pe loc când acționezi din dashboard. În campanie, maestrul de joc scrie fișiere doar prin RPG Engine: scrierea și editarea proprie de fișiere a OpenCode sunt oprite acolo, iar agentul te întreabă înainte să ruleze o comandă. Maestrul de joc desenează imaginile chiar el, ca imagini vectoriale simple, la fel ca Claude. În momentele-cheie, un personaj vorbește printr-un agent propriu, `.opencode/agents/rpg-character.md`: maestrul de joc scrie o replică a poveștii, iar răspunsul personajului vine după o clipă; un model local mic poate să nu-l apeleze. OpenCode-ul tău, cu modelul pe care l-ai ales ultima dată în el, traduce și dashboardul și regulile jocului și citește documentele pe care le imporți, în afara chatului; dacă nu are un model pe care să-l poată folosi, le face Codex sau Claude Code, dacă le ai.
|
|
73
73
|
- **Alt agent**: pornește-l în dosarul campaniei și dă-i serverul MCP `rpg mcp`. RPG Engine este un server MCP standard: orice agent care acceptă MCP poate fi maestrul de joc, inclusiv cei locali.
|
|
74
74
|
|
|
75
75
|
Dacă maestrul de joc spune că nu găsește uneltele RPG Engine, scrie `rpg init` în dosarul campaniei: într-un dosar care este deja o campanie, doar aduce la zi aceste fișiere; apoi deschide un chat nou.
|
|
76
76
|
|
|
77
|
-
Jucăm și testăm cu **Claude Code**; **Codex** și **
|
|
77
|
+
Jucăm și testăm cu **Claude Code**; **Codex**, **Antigravity** și **OpenCode** 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ă fie cu adevărat o revenire.
|
|
78
78
|
|
|
79
79
|
### 2.5 Primul chat
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ Când vrei să ieși din poveste, scrie `[OOC: …]` (out of character): *[OOC:
|
|
|
130
130
|
|
|
131
131
|
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.
|
|
132
132
|
|
|
133
|
-
**Acțiuni din
|
|
133
|
+
**Acțiuni din dashboard**: 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; o geantă se deschide cu săgeata ei, iar ⓘ-ul ei arată cartonașul. Alege ce faci cu obiectul. O acțiune care nu are nevoie de nimeni, precum **Echipează**, îți cere să confirmi pe același buton, *Confirmă: Echipez Scutul*: apasă-l din nou și acțiunea ajunge la maestrul de joc. O acțiune îndreptată spre cineva, precum **Atacă**, te întreabă spre cine, în listă sau cu un clic pe hartă; apoi butonul spune propoziția întreagă, *Atac Bandit cu glugă 1 cu Buzdugan*, iar un singur clic o trimite. Ca s-o spui în felul tău, apasă pe o persoană cu care vrei să vorbești sau scrie în chat. Maestrul de joc o aude ca pe o replică spusă în chat, o judecă la fel ca pe oricare alta și te întreabă cu butoane ce ai lăsat nespus. Acolo unde aplicația ta AI nu are sonerie, maestrul de joc citește acțiunea de îndată ce scrii următoarea dată în chat; dacă chatul fusese închis înainte, **Spune din nou** o trimite încă o dată.
|
|
134
134
|
|
|
135
135
|
### 3.2 Aruncări
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ Robotul din partea de sus a tabloului de bord este maestrul de joc: chipul lui u
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Imagini
|
|
200
200
|
|
|
201
|
-
RPG Engine poate genera imagini cu locurile la care ajungi, misiunile pe care le preiei și persoanele pe care le întâlnești, după cum
|
|
201
|
+
RPG Engine poate genera imagini cu locurile la care ajungi, misiunile pe care le preiei și persoanele pe care le întâlnești, după cum hotărăște setarea **Imagini**, plus portretul personajului tău când îl ceri. Aplicația ta AI le face cu mijloacele ei, cu autentificarea ta, în abonamentul tău și cu limitele lui: **Claude** le desenează ca imagini vectoriale, **Codex** și **Antigravity** le pictează, **OpenCode** desenează în chat imagini vectoriale simple. În **Setări > Campanie > Imagini** poți cere ca Codex sau Antigravity să le picteze și atunci când maestrul tău de joc este o altă aplicație: acolo unde cea aleasă de tine nu poate, le face chatul tău. **Setări** arată dacă acest calculator le poate genera și, dacă nu, cum le configurezi. Poți oricând să dai o imagine a ta, personajului tău sau oricărei pagini pe care o vezi: trece cursorul peste una dintre imaginile ei și în colț apare un mic buton cu o imagine (și de la tastatură, iar pe telefon mereu); în **Lume**, pagina pe care o deschizi are și **Schimbă imaginea…**, sau **Adaugă o imagine…** cât timp nu are niciuna. Imaginea ta o înlocuiește pe cea existentă. Sau pune fișierul în folderul **inbox** al campaniei și spune-i maestrului de joc pentru ce pagină este.
|
|
202
202
|
|
|
203
203
|
### 3.12 Siguranță: linii, văluri și oprire
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ O pagină de pe propriul tău calculator, deschisă doar în browserul acelui ca
|
|
|
219
219
|
- **Jurnal**: misiuni, povestea ca o carte, cronologia ei, jurnalele însoțitorilor tăi, notițele tale.
|
|
220
220
|
- **Lume**: harta lumii, ce știe personajul tău, documentele găsite și calendarul.
|
|
221
221
|
- **Tava pentru zaruri**: alege zarurile și un modificator, apoi aruncă; ×2 dublează zarurile, niciodată modificatorul, ca la o lovitură critică.
|
|
222
|
-
- **Salvări**, **Ajutor**, **Setări** și **Despre**, ca pictograme la capătul rândului. **Setări**
|
|
222
|
+
- **Salvări**, **Ajutor**, **Setări** și **Despre**, ca pictograme la capătul rândului. În **Setări**, la **Tablou de bord**, găsești și preferințele proprii ale paginii: modul, sunetul zarurilor, setul de zaruri și **Temă**, adică culorile, chipurile și imaginile paginii: cele ale sistemului de joc, o temă adăugată din Packages › Add, din catalog, dintr-un link GitHub, dintr-un .zip sau dintr-un dosar, ori cele proprii ale paginii. Dacă foaia de stil a unei teme face pagina greu de citit, dezactivează acolo **Stilul propriu al temei**: **Setări** se afișează întotdeauna fără el, la adresa paginii cu `#/settings/page` la final.
|
|
223
223
|
|
|
224
224
|
Când maestrul de joc îți pune o întrebare, bannerul lui rămâne în partea de sus, indiferent în ce secțiune te afli.
|
|
225
225
|
|
|
@@ -263,15 +263,15 @@ O extensie adaugă ceva unei campanii, peste sistemul ei de joc: o funcție prec
|
|
|
263
263
|
|
|
264
264
|
### 7.1 Trei feluri de a avea o lume
|
|
265
265
|
|
|
266
|
-
- **Creată din mers**: pornind de la premisa ta, maestrul construiește fiecare loc, persoană și intrigă chiar înainte să ai nevoie de ele și le păstrează.
|
|
266
|
+
- **Creată din mers**: pornind de la premisa ta, maestrul de joc construiește fiecare loc, persoană și intrigă chiar înainte să ai nevoie de ele și le păstrează.
|
|
267
267
|
- **Pregătită la început**: la fel, dar cu lumea construită înainte de joc.
|
|
268
|
-
- **Dintr-o aventură sau o carte a ta**: dă-i maestrului fișierul, *[Importă această aventură ca pe campania noastră: D:\Books\adventure.pdf. Nu-mi spune nimic din ce e în ea.]* Se citește cel mai bine ca text, EPUB, document Word sau PDF cu text selectabil; un PDF scanat se citește din imaginile paginilor, doar pe Windows, lent și cu câteva greșeli.
|
|
268
|
+
- **Dintr-o aventură sau o carte a ta**: dă-i maestrului de joc fișierul, *[OOC: Importă această aventură ca pe campania noastră: D:\Books\adventure.pdf. Nu-mi spune nimic din ce e în ea.]* Se citește cel mai bine ca text, EPUB, document Word sau PDF cu text selectabil; un PDF scanat se citește din imaginile paginilor, doar pe Windows, lent și cu câteva greșeli. Aplicația ta AI îl citește în afara chatului, sau altfel maestrul de joc din chat, în abonamentul tău: în Claude Code sau Codex îl citește unul dintre cele două, în Antigravity Antigravity-ul tău, în OpenCode modelul pe care l-ai ales ultima dată în el. Întregul document ajunge la firma care a creat agentul ce îl citește, conform termenilor contului tău și opțiunii tale privind antrenarea. Dashboardul arată cât a avansat citirea; dintr-un roman, maestrul de joc propune de unde să începi. Maestrul de joc scrie locurile, personajele și secretele.
|
|
269
269
|
|
|
270
270
|
O campanie se joacă o singură dată: ca să joci din nou aceeași aventură, creează o campanie nouă.
|
|
271
271
|
|
|
272
272
|
### 7.2 Limbi
|
|
273
273
|
|
|
274
|
-
O singură limbă pe campanie, cea a maestrului, pe care o urmează dashboardul. Dashboardul vine în 26 de limbi. Orice altă limbă este tradusă pe calculatorul tău de Codex sau Claude Code, sau,
|
|
274
|
+
O singură limbă pe campanie, cea a maestrului de joc, pe care o urmează dashboardul. Dashboardul vine în 26 de limbi. Orice altă limbă este tradusă pe calculatorul tău de aplicația ta AI, în afara chatului (Codex sau Claude Code; în Antigravity și OpenCode, cele proprii), sau, acolo unde niciuna nu poate, de maestrul de joc din chat. Termenii ediției a cincea în italiană vin din SRD-ul oficial italian; textul regulilor rămâne în engleză, iar maestrul de joc îl povestește în limba ta.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ Fiecare comandă pe care o folosește maestrul de joc poate fi rulată și în f
|
|
|
323
323
|
|
|
324
324
|
**Maestrul își amintește ceva ce am anulat.** Deschide un chat nou și apasă **Am deschis un chat nou** în Salvări.
|
|
325
325
|
|
|
326
|
-
**Nu apare nicio imagine.** Setări >
|
|
326
|
+
**Nu apare nicio imagine.** **Setări** > Campaign > Pictures arată dacă acest calculator le poate face și cum.
|
|
327
327
|
|
|
328
328
|
**Instalarea eșuează sau `rpg` nu pornește.** `node --version` trebuie să arate 24 sau mai nou. Dacă Windows răspunde că rularea scripturilor este dezactivată, vezi [2.1](#21-what-you-need). Pe Windows, ține RPG Engine și campaniile tale departe de căi care conțin `&`.
|
|
329
329
|
|
|
@@ -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,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,83c19e53,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: полное руководство
|
|
3
3
|
|
|
4
4
|
**RPG Engine** позволяет играть в настольную ролевую игру с **ИИ в роли мастера**. Ты общаешься с мастером в **чате**, а RPG Engine работает за кулисами: он **помнит мир**, **бросает кубики** и **ведёт учёт**. Рядом с чатом в браузере открыта страница, **панель управления**: на ней лист персонажа, кубики, карты и журнал.
|
|
@@ -66,15 +66,15 @@ rpg init "The Salt Isles"
|
|
|
66
66
|
|
|
67
67
|
Мастер работает в **ИИ-агенте**. Это приложение с ИИ, в терминале или на компьютере, которое умеет работать с файлами на твоём компьютере, например Claude Code, Codex, Antigravity или OpenCode. Обычного чата вроде claude.ai или ChatGPT или приложения на телефоне недостаточно: мастеру нужен доступ к файлам кампании на твоём компьютере. Каждому агенту нужны свой тариф и свой вход: для Claude Code — платный тариф Claude, для Codex — вход через ChatGPT, для Antigravity — аккаунт Google, у которого бесплатный тариф даёт небольшую недельную квоту. OpenCode работает с моделями, которые ты ему подключишь, в том числе с локальными. Агент устанавливается один раз, со своей страницы: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
|
-
- **Claude Code**: в папке кампании напиши `claude`. Когда он спросит, доверяешь ли ты этой папке, выбери **Yes, I trust this folder**. Осторожно: заранее выбран другой ответ — *No, exit*. В кампании есть и маленький хук, `rpg --listen`, о котором вопрос не
|
|
70
|
-
- **Codex**: в папке кампании напиши `codex` и согласись, когда он спросит, доверяешь ли ты папке. В
|
|
71
|
-
- **Antigravity**: в папке кампании напиши `agy` и согласись, если он спросит, доверяешь ли ты папке. Или открой папку кампании в его приложении. Для приложения RPG Engine также добавляет себя в собственные настройки Antigravity: файл `.gemini/config/mcp_config.json` в твоей домашней папке. Эти настройки действуют для любой папки, которую ты открываешь, а не только для кампании. Вне кампании RPG Engine ничего не делает. В кампании есть два маленьких хука. Хук `rpg --approve` позволяет мастеру пользоваться инструментами RPG Engine без вопроса к тебе каждый раз, а хук `rpg --listen` сразу сообщает мастеру, когда ты что-то делаешь на дашборде. Картинки мастер рисует прямо в
|
|
72
|
-
- **OpenCode**: в папке кампании напиши `opencode`. В кампании есть маленький плагин, `.opencode/plugins/rpg.js`, который сразу сообщает мастеру, когда ты что-то делаешь на дашборде. В кампании мастер записывает файлы только через RPG Engine: собственная запись и правка файлов в OpenCode там отключена, а перед запуском команды
|
|
69
|
+
- **Claude Code**: в папке кампании напиши `claude`. Когда он спросит, доверяешь ли ты этой папке, выбери **Yes, I trust this folder**. Осторожно: заранее выбран другой ответ — *No, exit*. В кампании есть и маленький хук, `rpg --listen`, о котором вопрос не говорит: он сразу сообщает мастеру, когда ты что-то делаешь на дашборде.
|
|
70
|
+
- **Codex**: в папке кампании напиши `codex` и согласись, когда он спросит, доверяешь ли ты папке. В ключевые моменты персонаж говорит через собственного агента, `.codex/agents/rpg-character.toml`, который знает только то, что знает сам персонаж. В приложении Codex для компьютера проверь в настройках, что память отключена для чатов игры.
|
|
71
|
+
- **Antigravity**: в папке кампании напиши `agy` и согласись, если он спросит, доверяешь ли ты папке. Или открой папку кампании в его приложении. Для приложения RPG Engine также добавляет себя в собственные настройки Antigravity: файл `.gemini/config/mcp_config.json` в твоей домашней папке. Эти настройки действуют для любой папки, которую ты открываешь, а не только для кампании. Вне кампании RPG Engine ничего не делает. В кампании есть два маленьких хука. Хук `rpg --approve` позволяет мастеру пользоваться инструментами RPG Engine без вопроса к тебе каждый раз, а хук `rpg --listen` сразу сообщает мастеру, когда ты что-то делаешь на дашборде. Картинки мастер рисует прямо в чате, при платном тарифе Google. На бесплатном тарифе его инструмент для картинок не срабатывает, и мастер рисует простые векторные картинки, как это делает Claude. В ключевые моменты персонаж говорит через собственного агента, `.agents/agents/rpg-character.md`: мастер пишет реплику истории, а ответ персонажа приходит чуть позже. Твой Antigravity также переводит дашборд и правила игры и читает документы, которые ты импортируешь, вне чата, в рамках квоты твоего аккаунта Google. RPG Engine запускает его отдельно от твоих собственных чатов, поэтому среди них ничего не остаётся. Antigravity хранит твои прошлые чаты, и его память нельзя отключить: мастеру велено никогда их не читать. Всё, что ты пишешь, уходит в Google, а там это могут читать люди. Не пиши в игре личные данные. RPG Engine — не продукт Google.
|
|
72
|
+
- **OpenCode**: в папке кампании напиши `opencode`. В кампании есть маленький плагин, `.opencode/plugins/rpg.js`, который сразу сообщает мастеру, когда ты что-то делаешь на дашборде. В кампании мастер записывает файлы только через RPG Engine: собственная запись и правка файлов в OpenCode там отключена, а перед запуском команды OpenCode спрашивает тебя. Картинки мастер рисует сам, простыми векторными рисунками, как это делает Claude. В ключевые моменты персонаж говорит через собственного агента, `.opencode/agents/rpg-character.md`: мастер пишет реплику истории, а ответ персонажа приходит чуть позже. Маленькая локальная модель может его не вызвать. Твой OpenCode с моделью, выбранной в нём последней, также переводит дашборд и правила игры и читает документы, которые ты импортируешь, вне чата. Если подходящей модели нет, это делают Codex или Claude Code, когда они у тебя установлены.
|
|
73
73
|
- **Другой агент**: запусти его в папке кампании и подключи к нему MCP-сервер `rpg mcp`. RPG Engine — стандартный MCP-сервер: мастером может стать любой агент с поддержкой MCP, в том числе локальный.
|
|
74
74
|
|
|
75
75
|
Если мастер говорит, что не находит инструменты RPG Engine, выполни `rpg init` в папке кампании. В папке, которая уже стала кампанией, эта команда только обновляет эти файлы. После этого открой новый чат.
|
|
76
76
|
|
|
77
|
-
Мы играем и проверяем на **Claude Code**. **Codex** и **
|
|
77
|
+
Мы играем и проверяем на **Claude Code**. **Codex**, **Antigravity** и **OpenCode** подключены и проверены, но целую кампанию на них ещё не проходили. Кампания отключает собственную память агента: игра живёт в её файлах, чтобы возврат к сохранению действительно возвращал назад.
|
|
78
78
|
|
|
79
79
|
### 2.5 Первый чат
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ rpg init "The Salt Isles"
|
|
|
130
130
|
|
|
131
131
|
Ты говоришь, что пытаешься сделать. Мастер говорит, что происходит. Мастер никогда не решает за твоего персонажа и никогда не говорит о движке. Можно спросить его, как пользоваться панелью.
|
|
132
132
|
|
|
133
|
-
**Действия с
|
|
133
|
+
**Действия с дашборда**: нажми на название в листе персонажа, например на оружие, заклинание или предмет, который ты несёшь. Откроется его карточка с описанием. Сумка раскрывается стрелкой, а значок ⓘ показывает её карточку. Выбери, что сделать с предметом. Если действие никого не касается, например **Экипировать**, кнопка просит подтвердить прямо на ней: *Подтвердить: Я экипирую Щит*. Нажми её ещё раз, и действие уйдёт мастеру. Если действие направлено на кого-то, например **Атаковать**, дашборд спросит, на кого: в списке или щелчком по карте. Тогда на кнопке появится вся фраза, *Я атакую Бандита в капюшоне 1 булавой*, и одного щелчка хватит, чтобы отправить её. Чтобы сказать по-своему, нажми на персонажа, с которым хочешь поговорить, или напиши в чат. Мастер слышит это так, будто сказано в чате, разбирает как любое другое действие и кнопками спрашивает о том, что ты не уточнил(а). Если у твоего ИИ-приложения нет способа получить сигнал сразу, мастер прочтёт это, как только ты в следующий раз напишешь в чат. Если чат был закрыт, кнопка **Повторить** отправит действие ещё раз.
|
|
134
134
|
|
|
135
135
|
### 3.2 Броски
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ RPG Engine сохраняет всю кампанию в конце каждой
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Картинки
|
|
200
200
|
|
|
201
|
-
RPG Engine умеет создавать картинки мест, до которых ты добираешься, заданий, которые берёшь, и тех, кого встречаешь, как задано в настройке **Картинки**. А ещё портрет твоего персонажа, когда попросишь.
|
|
201
|
+
RPG Engine умеет создавать картинки мест, до которых ты добираешься, заданий, которые берёшь, и тех, кого встречаешь, как задано в настройке **Картинки**. А ещё портрет твоего персонажа, когда попросишь. Твоё ИИ-приложение создаёт их своими средствами, с твоим входом, по твоему тарифу и в его пределах: **Claude** рисует их как векторные картинки, **Codex** и **Antigravity** пишут их красками, **OpenCode** рисует простые векторные картинки в чате. В **Настройки > Кампания > Картинки** можно включить, чтобы Codex или Antigravity создавали картинки и тогда, когда твой мастер работает в другом приложении. Если выбранное приложение не может, картинки создаёт твой чат. В **Настройках** видно, может ли этот компьютер их создавать, а если нет, то как это настроить. Ты всегда можешь дать свою картинку, персонажу или любой странице, которую видишь: наведи указатель на одну из её картинок, и в углу появится маленькая кнопка с картинкой (с клавиатуры тоже, а на телефоне она видна всегда). В разделе **Мир** у открытой страницы тоже есть **Сменить изображение…**, а пока картинки нет, **Добавить изображение…**. Твоя картинка заменяет прежнюю. Или положи файл в папку кампании **inbox** и скажи мастеру, для какой он страницы.
|
|
202
202
|
|
|
203
203
|
### 3.12 Безопасность: границы, завесы и стоп
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ RPG Engine умеет создавать картинки мест, до кот
|
|
|
219
219
|
- **Журнал**: задания, история как книга, хронология, дневники спутников, твои заметки.
|
|
220
220
|
- **Мир**: карта мира, то, что известно твоему персонажу, найденные документы и календарь.
|
|
221
221
|
- **Лоток для кубиков**: выбери кубики и модификатор, затем брось их. Кнопка ×2 удваивает кубики, но не модификатор, как при критическом попадании.
|
|
222
|
-
- **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В **Настройках**
|
|
222
|
+
- **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В **Настройках** в разделе **Панель** есть и параметры самой страницы: режим, звук кубиков, набор кубиков и **Тема** — цвета, облик и картинки страницы. Это может быть стиль игровой системы, тема, добавленная в Packages › Add (из каталога, по ссылке на GitHub, из файла .zip или из папки), или собственный стиль страницы. Если собственный стиль темы мешает читать страницу, отключи **Собственный стиль темы** там же. **Настройки** всегда открываются без него, по адресу страницы с `#/settings/page` в конце.
|
|
223
223
|
|
|
224
224
|
Когда мастер задаёт тебе вопрос, его баннер остаётся вверху, в каком бы разделе ты ни был.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ RPG Engine умеет создавать картинки мест, до кот
|
|
|
265
265
|
|
|
266
266
|
- **Создаётся на ходу**: по твоему замыслу мастер создаёт каждое место, каждого персонажа и каждый сюжет прямо перед тем, как они понадобятся, и запоминает их.
|
|
267
267
|
- **Готовится в начале**: то же самое, но мир создаётся до начала игры.
|
|
268
|
-
- **Из твоего приключения или книги**: дай мастеру файл, *[Импортируй это приключение как нашу кампанию: D:\Books\adventure.pdf. Ничего из него мне не рассказывай.]* Лучше всего читаются текст, EPUB, документ Word или PDF с выделяемым текстом. PDF-скан читается по картинкам страниц, только в Windows, медленно и с ошибками. Файл читает
|
|
268
|
+
- **Из твоего приключения или книги**: дай мастеру файл, *[Импортируй это приключение как нашу кампанию: D:\Books\adventure.pdf. Ничего из него мне не рассказывай.]* Лучше всего читаются текст, EPUB, документ Word или PDF с выделяемым текстом. PDF-скан читается по картинкам страниц, только в Windows, медленно и с ошибками. Файл читает твоё ИИ-приложение вне чата, а если оно не может, то мастер в чате, по твоему тарифу. В Claude Code или Codex читает один из этих двух, в Antigravity — твой Antigravity, в OpenCode — модель, выбранная в нём последней. Весь документ уходит создателю того, что его читает, на условиях твоей учётной записи и с учётом твоего выбора насчёт обучения моделей. Дашборд показывает, как идёт работа. Если это роман, мастер предлагает, с чего начать. Мастер пишет места, персонажей и секреты.
|
|
269
269
|
|
|
270
270
|
Кампания проходится один раз: чтобы сыграть то же приключение снова, создай новую кампанию.
|
|
271
271
|
|
|
272
272
|
### 7.2 Языки
|
|
273
273
|
|
|
274
|
-
У кампании один язык, язык мастера, и дашборд следует за ним. Дашборд поставляется на 26 языках. Любой другой язык
|
|
274
|
+
У кампании один язык, язык мастера, и дашборд следует за ним. Дашборд поставляется на 26 языках. Любой другой язык переводит на твоём компьютере твоё ИИ-приложение вне чата (Codex или Claude Code; в Antigravity и OpenCode — их собственные модели), а если ни одно не может, то мастер в чате. Термины пятой редакции на итальянском берутся из официального итальянского SRD. Текст правил остаётся на английском, а мастер пересказывает его на твоём языке.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ RPG Engine работает только в этой папке: читает и
|
|
|
323
323
|
|
|
324
324
|
**Мастер помнит то, что я отменил.** Открой новый чат и нажми **Новый чат открыт** в Сохранениях.
|
|
325
325
|
|
|
326
|
-
**Картинки не появляются.** В Настройки > Картинки сказано, может ли этот компьютер их
|
|
326
|
+
**Картинки не появляются.** В Настройки > Кампания > Картинки сказано, может ли этот компьютер их создавать и как это сделать.
|
|
327
327
|
|
|
328
328
|
**Установка не удаётся, или `rpg` не запускается.** Команда `node --version` должна показать 24 или новее. Если Windows отвечает, что запуск скриптов отключён, смотри [2.1](#21-what-you-need). В Windows не держи RPG Engine и свои кампании в путях, где есть `&`.
|
|
329
329
|
|
|
@@ -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,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,83c19e53,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. 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.
|
|
@@ -67,14 +67,14 @@ Spelledaren kan inte skapa en kampanj åt dig. Före `init` vet din agent inte v
|
|
|
67
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, Antigravity eller OpenCode. 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. OpenCode fungerar med de modeller du ger den, även lokala. 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), [OpenCode](https://opencode.ai).
|
|
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
|
-
- **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, eller öppna kampanjmappen i appen. För appen lägger RPG Engine också till sig själv i Antigravitys egna inställningar, `.gemini/config/mcp_config.json` i din hemmapp. De gäller för varje mapp du öppnar, inte bara kampanjens: utanför en kampanj gör RPG Engine ingenting. Kampanjen har två små hooks: `rpg --approve` låter spelledaren använda RPG Engines verktyg utan att fråga dig varje gång, och `rpg --listen` talar direkt om för spelledaren när du gör något på dashboarden. Spelledaren målar bilderna i chatten själv.
|
|
72
|
-
- **OpenCode**: skriv `opencode` i kampanjmappen. Kampanjen har ett litet plugin, `.opencode/plugins/rpg.js`, som direkt talar om för spelledaren när du gör något på dashboarden. I kampanjen skriver spelledaren filer bara via RPG Engine: OpenCodes eget skrivande och redigerande av filer är avstängt där, och den frågar dig innan den kör ett kommando. Spelledaren ritar bilderna själv, som enkla vektorbilder, som Claude gör. Din OpenCode, med den modell du senast valde i den, översätter också dashboarden och spelets regler och läser dokumenten du importerar, utanför chatten. Om den inte har någon modell den kan använda gör Codex eller Claude Code det, om du har dem.
|
|
70
|
+
- **Codex**: skriv `codex` i kampanjmappen och svara ja när den frågar om du litar på mappen. I viktiga ögonblick talar en rollperson genom en egen agent, `.codex/agents/rpg-character.toml`, som bara vet det rollpersonen vet. 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, eller öppna kampanjmappen i appen. För appen lägger RPG Engine också till sig själv i Antigravitys egna inställningar, `.gemini/config/mcp_config.json` i din hemmapp. De gäller för varje mapp du öppnar, inte bara kampanjens: utanför en kampanj gör RPG Engine ingenting. Kampanjen har två små hooks: `rpg --approve` låter spelledaren använda RPG Engines verktyg utan att fråga dig varje gång, och `rpg --listen` talar direkt om för spelledaren när du gör något på dashboarden. Spelledaren målar bilderna i chatten själv, med ett betalt Google-abonnemang. Med gratisabonnemanget misslyckas bildverktyget, och då ritar spelledaren enkla vektorbilder, som Claude gör. I viktiga ögonblick talar en rollperson genom en egen agent, `.agents/agents/rpg-character.md`: spelledaren skriver en replik i berättelsen, och rollpersonens svar kommer en stund senare. Din Antigravity översätter också dashboarden och spelets regler och läser dokumenten du importerar, utanför chatten, på ditt Google-kontos kvot. RPG Engine startar den separat från dina egna chattar, så den lämnar inga spår bland dem. 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.
|
|
72
|
+
- **OpenCode**: skriv `opencode` i kampanjmappen. Kampanjen har ett litet plugin, `.opencode/plugins/rpg.js`, som direkt talar om för spelledaren när du gör något på dashboarden. I kampanjen skriver spelledaren filer bara via RPG Engine: OpenCodes eget skrivande och redigerande av filer är avstängt där, och den frågar dig innan den kör ett kommando. Spelledaren ritar bilderna själv, som enkla vektorbilder, som Claude gör. I viktiga ögonblick talar en rollperson genom en egen agent, `.opencode/agents/rpg-character.md`: spelledaren skriver en replik i berättelsen, och rollpersonens svar kommer en stund senare. En liten lokal modell kanske inte anropar den. Din OpenCode, med den modell du senast valde i den, översätter också dashboarden och spelets regler och läser dokumenten du importerar, utanför chatten. Om den inte har någon modell den kan använda gör Codex eller Claude Code det, om du har dem.
|
|
73
73
|
- **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.
|
|
74
74
|
|
|
75
75
|
Om spelledaren säger att den inte hittar RPG Engines verktyg, skriv `rpg init` i kampanjmappen. I en mapp som redan är en kampanj uppdaterar det bara dessa filer. Öppna sedan en ny chatt.
|
|
76
76
|
|
|
77
|
-
Vi spelar och testar med **Claude Code**. **Codex** och **
|
|
77
|
+
Vi spelar och testar med **Claude Code**. **Codex**, **Antigravity** och **OpenCode** ä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.
|
|
78
78
|
|
|
79
79
|
### 2.5 Den första chatten
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ Skriv `[OOC: …]` (out of character) när du pratar utanför berättelsen: *[OO
|
|
|
130
130
|
|
|
131
131
|
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.
|
|
132
132
|
|
|
133
|
-
**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 **
|
|
133
|
+
**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. En väska öppnas med sin pil, och dess ⓘ visar kortet. Välj vad du gör med det. Något som inte rör någon annan, till exempel **Utrusta**, ber dig bekräfta på samma knapp, *Bekräfta: Jag utrustar Shield*. Tryck på den igen, så går det till spelledaren. Något du gör mot någon, till exempel **Attackera**, frågar vem, i listan eller med ett klick på kartan. Sedan säger knappen hela meningen, *Jag attackerar Hooded Bandit 1 med Mace*, och ett klick skickar den. Vill du säga det på ditt eget sätt, klicka på en person att prata med, eller skriv i chatten. Spelledaren hör det som om det sagts i chatten, dömer det som vilken annan handling som helst och frågar dig med knappar efter det du lämnade ute. Där din AI-app inte kan höra det direkt läser spelledaren det så fort du nästa gång skriver i chatten. Om chatten var stängd förut skickar **Säg det igen** det en gång till.
|
|
134
134
|
|
|
135
135
|
### 3.2 Slag
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ Roboten högst upp på dashboarden är spelledaren. Dess ansikte följer berätt
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Bilder
|
|
200
200
|
|
|
201
|
-
RPG Engine kan låta skapa bilder av platserna ni når, uppdragen ni tar och dem ni möter, så som inställningen **Bilder** säger, och din rollpersons porträtt när du ber om det.
|
|
201
|
+
RPG Engine kan låta skapa bilder av platserna ni når, uppdragen ni tar och dem ni möter, så som inställningen **Bilder** säger, och din rollpersons porträtt när du ber om det. Din egen AI-app skapar dem med sina egna medel, med din inloggning, på din plan och inom dess ramar: **Claude** ritar dem som vektorbilder, **Codex** och **Antigravity** målar dem, **OpenCode** ritar enkla vektorbilder i chatten. I **Inställningar > Kampanj > Bilder** kan du låta Codex eller Antigravity måla dem även när din spelledare är en annan app: där den du valde inte kan, skapar din chatt dem. **Inställningar** visar om den här datorn kan göra dem, och hur du ställer in det om den inte kan. Du kan alltid ge en egen bild, till din rollperson eller till vilken sida som helst du ser: för pekaren över en av sidans bilder, så visas en liten bildknapp i hörnet (det går också med tangentbordet, och på en telefon syns den alltid). I **Värld** har sidan du öppnar dessutom **Byt bild…**, eller **Lägg till bild…** så länge den saknar en. Din bild tar den befintliga bildens plats. Eller lägg filen i kampanjens mapp **inbox** och tala om för spelledaren vilken sida den är till för.
|
|
202
202
|
|
|
203
203
|
### 3.12 Trygghet: gränser, slöjor och stopp
|
|
204
204
|
|
|
@@ -215,11 +215,11 @@ Varje inställning kan ändras, i chatten eller i **Inställningar**. Ett avgör
|
|
|
215
215
|
En sida på din egen dator. Den öppnas bara i webbläsaren på den datorn och är aktiv medan chatten är öppen. När chatten stängs visar den *Not connected*. Den kommer tillbaka av sig själv med nästa chatt.
|
|
216
216
|
|
|
217
217
|
- **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.
|
|
218
|
-
- **Scen**: var du är, dess bild och karta,
|
|
218
|
+
- **Scen**: var du är, dess bild och karta, vilka som är där och vad som händer. I en strid visas turerna och din rollpersons kort.
|
|
219
219
|
- **Dagbok**: uppdrag, berättelsen som en bok, dess tidslinje, dina följeslagares dagböcker och dina anteckningar.
|
|
220
220
|
- **Värld**: världskartan, det din rollperson vet, de dokument som hittats och kalendern.
|
|
221
|
-
- **Tärningsbrickan**: välj tärningar och en modifikation, och sl
|
|
222
|
-
- **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. **Inställningar**
|
|
221
|
+
- **Tärningsbrickan**: välj tärningar och en modifikation, och slå. ×2 fördubblar tärningarna, aldrig modifikationen, som vid en kritisk träff.
|
|
222
|
+
- **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. Under **Inställningar** hittar du också, under **Översikt**, sidans egna val: läge, tärningsljud, tärningsset och **Tema**, alltså sidans färger, ansikten och bilder. Temat kan komma från spelsystemet, från ett tema du lagt till under Packages › Add (från katalogen, en GitHub-länk, en .zip-fil eller en mapp) eller från sidan själv. Om ett temas egen stilmall gör sidan svårläst, stäng av **Temats egen stil** där. **Inställningar** visas alltid utan den, på sidans adress med `#/settings/page` i slutet.
|
|
223
223
|
|
|
224
224
|
När spelledaren frågar dig något ligger dess banderoll kvar högst upp, oavsett vilken del du befinner dig i.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ Ett tillägg lägger till något i en kampanj, ovanpå dess spelsystem: en funkt
|
|
|
265
265
|
|
|
266
266
|
- **Skapad allteftersom**: utifrån din premiss bygger spelledaren varje plats, person och intrig strax innan du behöver den, och sparar den.
|
|
267
267
|
- **Förberedd i början**: samma sak, men med världen byggd före spelet.
|
|
268
|
-
- **Från ditt eget äventyr eller din egen bok**: ge spelledaren filen, *[Importera det här äventyret som vår kampanj: D:\Books\adventure.pdf. Berätta inget som står i det.]* Det läses bäst som text, en EPUB, ett Word-dokument eller en PDF vars text går att markera. En inskannad PDF läses från bilderna av sina sidor, bara i Windows, långsamt och med några fel.
|
|
268
|
+
- **Från ditt eget äventyr eller din egen bok**: ge spelledaren filen, *[Importera det här äventyret som vår kampanj: D:\Books\adventure.pdf. Berätta inget som står i det.]* Det läses bäst som text, en EPUB, ett Word-dokument eller en PDF vars text går att markera. En inskannad PDF läses från bilderna av sina sidor, bara i Windows, långsamt och med några fel. Din egen AI-app läser det utanför chatten, annars spelledaren i chatten, på din plan: i Claude Code eller Codex läser en av de två, i Antigravity din Antigravity, i OpenCode den modell du senast valde i den. Hela dokumentet skickas till tillverkaren av den som läser det, enligt villkoren för ditt konto och dess val om träning. Dashboarden visar hur långt det har kommit. Från en roman föreslår spelledaren var du ska börja. Spelledaren skriver platserna, personerna och hemligheterna.
|
|
269
269
|
|
|
270
270
|
En kampanj spelas en gång: vill du spela samma äventyr igen, skapa en ny kampanj.
|
|
271
271
|
|
|
272
272
|
### 7.2 Språk
|
|
273
273
|
|
|
274
|
-
Ett språk per kampanj, spelledarens, som dashboarden följer. Dashboarden levereras med 26 språk. Vilket annat som helst översätts på din dator av Codex eller Claude Code, eller,
|
|
274
|
+
Ett språk per kampanj, spelledarens, som dashboarden följer. Dashboarden levereras med 26 språk. Vilket annat som helst översätts på din dator av din egen AI-app utanför chatten (Codex eller Claude Code, i Antigravity och OpenCode deras egna), eller, där ingen av dem kan, av spelledaren i chatten. Femte utgåvans termer på italienska kommer från den officiella italienska SRD:n. Regeltexten förblir på engelska, och spelledaren berättar den på ditt språk.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg
|
|
|
323
323
|
|
|
324
324
|
**Spelledaren minns något jag ångrade.** Öppna en ny chatt och tryck på **Jag har öppnat en ny chatt** i Sparade spel.
|
|
325
325
|
|
|
326
|
-
**Inga bilder visas.** Inställningar > Bilder visar om den här datorn kan göra dem, och hur.
|
|
326
|
+
**Inga bilder visas.** Inställningar > Kampanj > Bilder visar om den här datorn kan göra dem, och hur.
|
|
327
327
|
|
|
328
328
|
**Installationen misslyckas, eller `rpg` startar inte.** `node --version` måste visa 24 eller senare. Om Windows svarar att det är inaktiverat att köra skript, se [2.1](#21-what-you-need). I Windows: håll RPG Engine och dina kampanjer borta från sökvägar som innehåller `&`.
|
|
329
329
|
|
|
@@ -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,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,83c19e53,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. 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.
|
|
@@ -66,15 +66,15 @@ Oyun yöneticisi senin için kampanya oluşturamaz: `init` çalışmadan önce a
|
|
|
66
66
|
|
|
67
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, Antigravity veya OpenCode 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. OpenCode, verdiğin modellerle çalışır; yerel modeller de dahildir. 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), [OpenCode](https://opencode.ai).
|
|
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
|
|
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
|
|
72
|
-
- **OpenCode**: kampanya klasöründe `opencode` yaz. Kampanyada küçük bir eklenti vardır: `.opencode/plugins/rpg.js`. Gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir. Kampanyada oyun yöneticisi dosyaları yalnızca RPG Engine üzerinden yazar
|
|
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. Gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir.
|
|
70
|
+
- **Codex**: kampanya klasöründe `codex` yaz ve klasöre güvenip güvenmediğini sorduğunda evet de. Önemli anlarda bir karakter, kendine ait bir ajan üzerinden konuşur: `.codex/agents/rpg-character.toml`. Bu ajan yalnızca karakterin bildiklerini bilir. 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. Ya da uygulamasında kampanya klasörünü aç. Uygulama için RPG Engine kendini Antigravity'nin kendi ayarlarına da ekler: bu ayarlar ana dizinindeki `.gemini/config/mcp_config.json` dosyasındadır. Yalnızca kampanya için değil, açtığın her klasör için geçerlidir. Kampanyanın dışında hiçbir şey yapmaz. Kampanyada iki küçük kanca vardır: `rpg --approve`, oyun yöneticisinin RPG Engine araçlarını her seferinde sana sormadan kullanmasını sağlar. `rpg --listen` ise gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir. Oyun yöneticisi görselleri sohbetin içinde kendisi boyar. Bunun için ücretli bir Google planı gerekir. Ücretsiz planda görsel aracı çalışmaz ve oyun yöneticisi, Claude'un yaptığı gibi, basit vektör görseller çizer. Önemli anlarda bir karakter, kendine ait bir ajan üzerinden konuşur: `.agents/agents/rpg-character.md`. Oyun yöneticisi hikâyeden bir satır yazar, karakterin cevabı biraz sonra gelir. Antigravity'n ayrıca gösterge panelini ve oyunun kurallarını çevirir, içe aktardığın belgeleri de okur. Bunu sohbetin dışında, Google hesabının kotasıyla yapar. RPG Engine onu senin kendi sohbetlerinden ayrı başlatır, bu yüzden sohbetlerinin arasında hiçbir iz bırakmaz. 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.
|
|
72
|
+
- **OpenCode**: kampanya klasöründe `opencode` yaz. Kampanyada küçük bir eklenti vardır: `.opencode/plugins/rpg.js`. Gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir. Kampanyada oyun yöneticisi dosyaları yalnızca RPG Engine üzerinden yazar. OpenCode'un kendi dosya yazma ve düzenleme özelliği orada kapalıdır. OpenCode bir komut çalıştırmadan önce sana sorar. Oyun yöneticisi görselleri, Claude'un yaptığı gibi, basit vektör görseller olarak kendisi çizer. Önemli anlarda bir karakter, kendine ait bir ajan üzerinden konuşur: `.opencode/agents/rpg-character.md`. Oyun yöneticisi hikâyeden bir satır yazar, karakterin cevabı biraz sonra gelir. Küçük bir yerel model bu ajanı çağırmayabilir. OpenCode'un, içinde en son seçtiğin modelle, gösterge panelini ve oyunun kurallarını çevirmesi ve içe aktardığın belgeleri okuması da sohbetin dışında gerçekleşir. Kullanabileceği bir model yoksa, sende varsa Codex ya da Claude Code bunu yapar.
|
|
73
73
|
- **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.
|
|
74
74
|
|
|
75
75
|
Oyun yöneticisi RPG Engine'in araçlarını bulamadığını söylerse kampanya klasöründe `rpg init` yaz: zaten kampanya olan bir klasörde bu komut yalnızca bu dosyaları günceller. Sonra yeni bir sohbet aç.
|
|
76
76
|
|
|
77
|
-
Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** ve **
|
|
77
|
+
Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex**, **Antigravity** ve **OpenCode** 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.
|
|
78
78
|
|
|
79
79
|
### 2.5 İlk sohbet
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ Hikâyenin dışına çıkmak için `[OOC: …]` yaz (karakter dışı): *[OOC:
|
|
|
130
130
|
|
|
131
131
|
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.
|
|
132
132
|
|
|
133
|
-
**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
|
|
133
|
+
**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. Bir çanta okuyla açılır, ⓘ simgesi de çantanın kartını gösterir. Onunla ne yapacağını seç. Kimseyi gerektirmeyen bir eylem, örneğin **Kuşan**, aynı düğmede onay ister: *Onayla: Kalkanı kuşanıyorum*. Düğmeye bir kez daha bas, eylem oyun yöneticisine gider. Birine yönelik bir eylem, örneğin **Saldır**, kimin için olduğunu sorar: listeden ya da haritaya tıklayarak seç. Sonra düğme cümlenin tamamını söyler, *Kapüşonlu Haydut 1'e Gürz ile saldırıyorum*, ve tek tıkla gider. Kendi sözlerinle söylemek için konuşmak istediğin kişiye tıkla ya da sohbete yaz. Oyun yöneticisi bunu sohbette söylenmiş gibi duyar, diğer her şey gibi karara bağlar ve eksik bıraktığın şeyi sana düğmelerle sorar. Yapay zekâ uygulaman oyun yöneticisine anında haber veremiyorsa, oyun yöneticisi bunu sen sohbete bir sonraki yazışında okur. Sohbet daha önce kapatıldıysa **Tekrar söyle** bunu bir kez daha gönderir.
|
|
134
134
|
|
|
135
135
|
### 3.2 Atışlar
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ Gösterge panelinin üstündeki robot oyun yöneticisidir. Yüzü hikâyenin ton
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Resimler
|
|
200
200
|
|
|
201
|
-
RPG Engine, ulaştığın yerlerin, üstlendiğin görevlerin ve karşılaştığın kişilerin görsellerini
|
|
201
|
+
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. İstersen karakterinin portresini de yaptırır. Görselleri kendi yapay zekâ uygulaman, kendi imkânlarıyla, senin girişinle, senin planın ve sınırlarınla yapar: **Claude** vektör görsel olarak çizer, **Codex** ve **Antigravity** boyar, **OpenCode** sohbette basit vektör görseller çizer. **Ayarlar > Kampanya > Görseller** bölümünde, oyun yöneticin başka bir uygulama olsa da Codex'in ya da Antigravity'nin görselleri boyamasını sağlayabilirsin. Seçtiğin uygulama yapamıyorsa görselleri sohbetin kendisi yapar. **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.
|
|
202
202
|
|
|
203
203
|
### 3.12 Güvenlik: sınırlar, perdeler ve dur
|
|
204
204
|
|
|
@@ -214,12 +214,12 @@ Her ayar değiştirilebilir, sohbette ya da **Ayarlar**'da. Oyun yöneticisinin
|
|
|
214
214
|
|
|
215
215
|
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.
|
|
216
216
|
|
|
217
|
-
- **Grup**: senin karakter kağıdın ve yoldaşlarınınkiler. Bir sayıya tıklayarak onu at
|
|
217
|
+
- **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.
|
|
218
218
|
- **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.
|
|
219
219
|
- **Günlük**: görevler, kitap olarak hikâye, zaman çizelgesi, yoldaşlarının günlükleri, notların.
|
|
220
220
|
- **Dünya**: dünya haritası, karakterinin bildikleri, bulunan belgeler ve takvim.
|
|
221
221
|
- **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.
|
|
222
|
-
- **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. **Ayarlar** sayfanın kendi tercihlerini
|
|
222
|
+
- **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. **Ayarlar** ayrıca **Gösterge paneli** altında sayfanın kendi tercihlerini içerir: mod, zar sesi, zar seti ve **Tema**. Tema, sayfanın renkleri, yazı tipleri ve resimleridir. Bunlar oyun sisteminin teması 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 teması olabilir. Bir temanın kendi stil sayfası sayfayı okumayı zorlaştırırsa orada **Temanın kendi stili** seçeneğini kapat. **Ayarlar** her zaman o stil olmadan görünür: sayfanın adresinin sonuna `#/settings/page` ekleyerek aç.
|
|
223
223
|
|
|
224
224
|
Oyun yöneticisi sana bir şey sorduğunda, afişi hangi bölümde olursan ol en üstte kalır.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ Eklenti, bir kampanyaya oyun sisteminin üstüne yeni bir şey katar. Örneğin
|
|
|
265
265
|
|
|
266
266
|
- **Anında yapılan**: öncülünden yola çıkarak oyun yöneticisi her yeri, kişiyi ve olay örgüsünü tam ihtiyacın olmadan önce kurar ve saklar.
|
|
267
267
|
- **Baştan hazırlanan**: aynısı, ama dünya oyundan önce kurulur.
|
|
268
|
-
- **Kendi macerandan veya kitabından**: oyun yöneticisine dosyasını ver, *[Bu macerayı kampanyamız olarak içe aktar: D:\Books\adventure.pdf. İçindekilerden hiçbirini bana söyleme.]* En iyi metin, EPUB, Word belgesi veya metni seçilebilen bir PDF olarak okunur. Taranmış bir PDF sayfalarının görsellerinden okunur; yalnızca Windows'ta, yavaş ve birkaç hatayla.
|
|
268
|
+
- **Kendi macerandan veya kitabından**: oyun yöneticisine dosyasını ver, *[OOC: Bu macerayı kampanyamız olarak içe aktar: D:\Books\adventure.pdf. İçindekilerden hiçbirini bana söyleme.]* En iyi metin, EPUB, Word belgesi veya metni seçilebilen bir PDF olarak okunur. Taranmış bir PDF sayfalarının görsellerinden okunur; yalnızca Windows'ta, yavaş ve birkaç hatayla. Onu sohbetin dışında kendi yapay zekâ uygulaman okur, olmazsa sohbetteki oyun yöneticisi okur; senin planınla. Claude Code ya da Codex kullanıyorsan bu ikisinden biri okur, Antigravity'de senin Antigravity'n, OpenCode'da içinde en son seçtiğin model. Belgenin tamamı, onu okuyanın yapımcısına gider; hesabının koşullarına ve eğitim konusundaki tercihine tabidir. Gösterge paneli ne kadar ilerlediğini gösterir. Bir romandan başlıyorsan oyun yöneticisi nereden başlanacağını önerir. Yerleri, karakterleri ve sırları yazar.
|
|
269
269
|
|
|
270
270
|
Bir kampanya bir kez oynanır: aynı macerayı yeniden oynamak için yeni bir kampanya oluştur.
|
|
271
271
|
|
|
272
272
|
### 7.2 Diller
|
|
273
273
|
|
|
274
|
-
Kampanya başına tek dil vardır: oyun yöneticisinin dili;
|
|
274
|
+
Kampanya başına tek dil vardır: oyun yöneticisinin dili; gösterge paneli onu izler. Gösterge paneli 26 dille gelir. Başka her dil, bilgisayarında kendi yapay zekâ uygulaman tarafından sohbetin dışında çevrilir (Codex ya da Claude Code; Antigravity ve OpenCode'da kendileri). Hiçbiri yapamıyorsa sohbetteki oyun yöneticisi çevirir. Beşinci sürümün İtalyanca terimleri resmî İtalyanca SRD'den gelir. Kural metni İngilizce kalır, oyun yöneticisi onu senin dilinde anlatır.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
|
|
|
323
323
|
|
|
324
324
|
**Oyun yöneticisi geri aldığım bir şeyi hatırlıyor.** Yeni bir sohbet aç ve Kayıtlar'da **Yeni sohbet açtım** düğmesine bas.
|
|
325
325
|
|
|
326
|
-
**Hiç görsel çıkmıyor.** Ayarlar >
|
|
326
|
+
**Hiç görsel çıkmıyor.** Ayarlar > Campaign > Pictures, bu bilgisayarın görsel yapıp yapamadığını ve nasıl yapabileceğini söyler.
|
|
327
327
|
|
|
328
328
|
**Kurulum başarısız oluyor veya `rpg` başlamıyor.** `node --version` çıktısı 24 veya daha yeni olmalı. Windows betiklerin çalıştırılmasının devre dışı olduğunu söylerse [2.1](#21-what-you-need) bölümüne bak. Windows'ta RPG Engine'i ve kampanyalarını `&` içeren yollardan uzak tut.
|
|
329
329
|
|