rpg-engine 0.19.1 → 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/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: 전체 가이드
|
|
3
3
|
|
|
4
4
|
**RPG Engine**은 **AI 게임 마스터**와 함께 테이블탑 롤플레잉 게임을 즐길 수 있게 해 줘요. **채팅**으로 GM과 대화해요. RPG Engine은 뒤에서 **세계를 기억하고**, **주사위를 굴리고**, **계산을 맡아요**. 채팅 옆에는 브라우저에 페이지를 하나 열어 두어요. 바로 **대시보드**예요. 캐릭터 시트, 주사위, 지도, 일지가 있어요.
|
|
@@ -64,13 +64,14 @@ GM은 캠페인을 대신 만들 수 없어요. `init`을 하기 전에는 에
|
|
|
64
64
|
|
|
65
65
|
### 2.4 AI 연결하기
|
|
66
66
|
|
|
67
|
-
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code
|
|
67
|
+
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code, Codex, Antigravity가 그 예예요. claude.ai나 ChatGPT 같은 일반 채팅이나 휴대폰 앱으로는 부족해요. GM이 컴퓨터에 있는 캠페인 파일에 접근할 수 있어야 하기 때문이에요. 에이전트마다 요금제와 로그인이 따로 필요해요. Claude Code는 유료 Claude 요금제, Codex는 ChatGPT 로그인, Antigravity는 Google 계정이 필요해요. Antigravity의 무료 요금제는 주간 사용량이 적어요. 설치는 각 에이전트의 페이지에서 한 번만 하면 돼요. [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: 캠페인 폴더에서 `claude`를 입력해요. 폴더를 신뢰하는지 물으면 **Yes, I trust this folder**를 선택하세요. 주의하세요. 처음 선택돼 있는 답은 *No, exit*이에요. 캠페인에는 작은 훅 `rpg --listen`도 들어 있어요. 이 질문에는 나오지 않지만, 대시보드에서 행동하면 GM에게 바로 알려 주는 역할을 해요.
|
|
70
70
|
- **Codex**: 캠페인 폴더에서 `codex`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 데스크톱 앱에서는 설정에서 게임 채팅의 메모리가 꺼져 있는지 확인하세요.
|
|
71
|
+
- **Antigravity**: 캠페인 폴더에서 `agy`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 캠페인에는 작은 훅 `rpg --approve`가 있어요. GM이 RPG Engine의 도구를 쓸 때마다 매번 허락을 구하지 않게 해 줘요. 이미지는 GM이 채팅에서 직접 그려요. Antigravity는 지난 채팅을 보관하고 메모리도 끌 수 없어요. 그래서 GM은 지난 채팅을 절대 읽지 않도록 안내받아요. 입력한 내용은 Google로 전송되고, Google에서 사람이 읽을 수도 있어요. 개인 정보는 게임에 넣지 마세요. RPG Engine은 Google 제품이 아니에요.
|
|
71
72
|
- **다른 에이전트**: 캠페인 폴더에서 에이전트를 시작하고 MCP 서버 `rpg mcp`를 연결해요. RPG Engine은 표준 MCP 서버예요. MCP를 지원하는 에이전트라면 로컬 에이전트를 포함해 어떤 것이든 GM이 될 수 있어요.
|
|
72
73
|
|
|
73
|
-
저희는 **Claude Code**로 플레이하고 테스트해요. **Codex**는 연결과 확인을 마쳤지만, 아직 캠페인 하나를 끝까지 플레이해 보지는 못했어요. 캠페인은 에이전트 자체의 메모리를 꺼요. 게임은 파일에 저장되기 때문에, 세이브로 돌아가면 정말 그 시점으로 돌아가요.
|
|
74
|
+
저희는 **Claude Code**로 플레이하고 테스트해요. **Codex**와 **Antigravity**는 연결과 확인을 마쳤지만, 아직 캠페인 하나를 끝까지 플레이해 보지는 못했어요. 캠페인은 에이전트 자체의 메모리를 꺼요. 게임은 파일에 저장되기 때문에, 세이브로 돌아가면 정말 그 시점으로 돌아가요.
|
|
74
75
|
|
|
75
76
|
### 2.5 첫 채팅
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ GM은 아직 정해지지 않은 것만 한 번에 몇 가지씩 물어봐요.
|
|
|
126
127
|
|
|
127
128
|
시도할 일은 직접 말해요. 그 결과는 GM이 알려 줘요. GM은 캐릭터 대신 결정하지 않고, 엔진에 대해서도 말하지 않아요. 대시보드 사용법은 GM에게 물어볼 수 있어요.
|
|
128
129
|
|
|
129
|
-
**대시보드에서 행동하기**: 캐릭터 시트에서 무기, 주문, 소지품 같은 이름을
|
|
130
|
+
**대시보드에서 행동하기**: 캐릭터 시트에서 무기, 주문, 소지품 같은 이름을 클릭하세요. 카드에 그것이 무엇인지 나와요. 그 항목으로 할 일을 **사용** 같은 버튼으로 고르고, 대상은 목록에서 고르거나 지도를 클릭해서 정해요. 사람을 클릭하면 말을 걸 수 있어요. 대시보드가 *후드 쓴 산적 1에게 메이스로 공격해요.* 같은 문장을 써 줘요. **GM에게 말하기**를 누르기 전에 문장을 고칠 수 있어요. GM은 이 문장을 채팅에서 한 말처럼 듣고, 다른 행동과 똑같이 판정해요. 사용 중인 AI 앱이 문장을 직접 받지 못하면 **복사**를 눌러 채팅에 붙여 넣을 수 있게 준비해요.
|
|
130
131
|
|
|
131
132
|
### 3.2 굴림
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ GM은 결과가 불확실하고 중요할 때만 굴림을 요청해요. 먼저
|
|
|
142
143
|
|
|
143
144
|
### 3.3 장면과 전투
|
|
144
145
|
|
|
145
|
-
이야기는 **장면** 단위로 흘러가요. 전투, 대화, 탐험, 이동, 휴식이 장면이 될 수 있어요. 장면이 끝날 때마다 게임이 자동으로 저장되고, 그 장면은 일지에 들어가요.
|
|
146
|
+
이야기는 **장면** 단위로 흘러가요. 전투, 대화, 탐험, 이동, 휴식이 장면이 될 수 있어요. 장면이 끝날 때마다 게임이 자동으로 저장되고, 그 장면은 일지에 들어가요. GM은 그 장면을 이야기 책의 한 챕터로 써 줘요.
|
|
146
147
|
|
|
147
148
|
전투에서 GM은 캐릭터의 차례가 아닌 차례를 모두 이야기하고, 선택할 수 있는 순간에 멈춰요. **장면** 맨 위에는 지금 누구의 차례인지와 다음 차례가 누구인지가 나와요. 지도 옆에는 캐릭터 카드가 보여요. 차례 순서, 파티의 체력, 적이 얼마나 다쳐 보이는지는 말로 표현되어 페이지 옆에 계속 보여요. 캐릭터가 쓰러지면 죽음 내성 굴림이 화면에 크게 나타나요.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ RPG Engine이 날짜를 관리해요. 세션과 세션 사이에는 게임 속
|
|
|
158
159
|
|
|
159
160
|
**세계**에는 캐릭터가 아는 장소, 장소 사이의 길, 지나온 길이 보이고, 나머지는 안개에 덮여 있어요. **장면**에는 지금 있는 장소의 지도가 있으면 누가 어디에 서 있는지와 함께 보여요. 전투 중 내 차례에는 갈 수 없는 칸이 가려져요. GM이 어디로 움직일지 물으면 칸을 누르거나 *E4* 처럼 적어요.
|
|
160
161
|
|
|
161
|
-
**세계**에는 캐릭터가 아는 것도 담겨 있어요. **지식**에는 캐릭터가 아는 사람, 장소, 세력, 생물, 이야기가 캐릭터가 아는 만큼만 나와요. 검색하거나, 하나를 열어 전체를 읽을 수 있어요. 본문 속 이름을 누르면 그 페이지로 가요. **문서**에는 캐릭터가 찾은 편지, 공고, 쪽지가 있어서 다시 읽을 수 있어요. **달력**에는 오늘 날짜, 퀘스트 기한과 남은 시간, 이야기가 흐른 날들이 나와요. 장면이 있는 날을 누르면 일지의
|
|
162
|
+
**세계**에는 캐릭터가 아는 것도 담겨 있어요. **지식**에는 캐릭터가 아는 사람, 장소, 세력, 생물, 이야기가 캐릭터가 아는 만큼만 나와요. 검색하거나, 하나를 열어 전체를 읽을 수 있어요. 본문 속 이름을 누르면 그 페이지로 가요. **문서**에는 캐릭터가 찾은 편지, 공고, 쪽지가 있어서 다시 읽을 수 있어요. **달력**에는 오늘 날짜, 퀘스트 기한과 남은 시간, 이야기가 흐른 날들이 나와요. 장면이 있는 날을 누르면 일지의 타임라인에서 그 장면들로 가요.
|
|
162
163
|
|
|
163
164
|
### 3.6 퀘스트, 일지, 메모
|
|
164
165
|
|
|
165
|
-
캐릭터가 맡은 일은 **일지**에서 퀘스트가 돼요. 목표, 기한,
|
|
166
|
+
캐릭터가 맡은 일은 **일지**에서 퀘스트가 돼요. 목표, 기한, 진행 상황이 함께 나와요. 별표를 누르면 **장면** 맨 위에 계속 보여요. **이야기**에서는 일지가 이야기를 한 권의 책처럼 들려줘요. 장면이 끝나면 GM이 고른 문체로 그 장면의 챕터를 산문으로 써요. 챕터별로 읽을 수 있고, 마지막 챕터는 책갈피로 표시돼요. Markdown이나 웹 페이지로 내려받아 인쇄하거나 다른 사람에게 건넬 수도 있어요. 이전에 시작한 게임이라면 GM에게 지금까지의 이야기를 써 달라고 하세요. **타임라인**에는 장면마다 무슨 일이 있었는지 나와요. 일지에는 **메모**도 보관돼요. 메모는 비공개예요. **공유**를 누르면 GM이 그 메모를 사실이 아니라 캐릭터의 생각으로 들어요. **동료**에서는 동료의 일기를 읽을 수 있어요. 동료는 가끔, 하루나 퀘스트가 끝날 때 자신이 생각하고 느낀 것을 몇 줄 적어요.
|
|
166
167
|
|
|
167
168
|
### 3.7 캐릭터의 이야기와 그림
|
|
168
169
|
|
|
@@ -209,8 +210,8 @@ RPG Engine은 도착한 장소, 맡은 퀘스트, 만난 인물의 이미지를
|
|
|
209
210
|
내 컴퓨터에서만 열리는 페이지예요. 그 컴퓨터의 브라우저에서만 볼 수 있고, 채팅이 열려 있는 동안만 작동해요. 채팅을 닫으면 *Not connected*라고 표시돼요. 다음 채팅을 열면 저절로 다시 연결돼요.
|
|
210
211
|
|
|
211
212
|
- **파티**: 내 캐릭터 시트와 동료들의 시트가 있어요. 숫자를 클릭하면 그 숫자로 굴려요. 숫자 위에 마우스를 올리면 그 숫자가 어디서 나왔는지 볼 수 있어요. 주사위 옆에 화살표가 있으면 굴림을 유리하게 하거나 불리하게 하는 요인도 보여요. GM이 레벨 업 때처럼 선택지를 준비하면 시트에 알림이 떠요. 알림을 누르면 선택지가 열려요. 원할 때 고르고, 선택지에 적힌 페이지를 읽고, 굴림이 필요한 선택지는 굴린 뒤 확인하세요. 그동안에도 이야기는 계속 이어져요. 옆에는 굴림 기록이 있어요.
|
|
212
|
-
- **장면**: 현재 위치, 그림과 지도, 그곳에 있는 인물, 지금 벌어지는 일을
|
|
213
|
-
- **일지**: 퀘스트, 이야기, 동료들의 일기, 내 메모가 있어요.
|
|
213
|
+
- **장면**: 현재 위치, 그림과 지도, 그곳에 있는 인물, 지금 벌어지는 일을 보여 줘요. 전투 중에는 차례와 내 캐릭터의 카드를 보여 줘요.
|
|
214
|
+
- **일지**: 퀘스트, 책으로 읽는 이야기, 타임라인, 동료들의 일기, 내 메모가 있어요.
|
|
214
215
|
- **세계**: 세계 지도, 내 캐릭터가 아는 것, 찾은 문서, 달력이 있어요.
|
|
215
216
|
- **주사위 트레이**: 주사위와 수정치를 고른 뒤 던져요. ×2는 주사위만 두 배로 하고 수정치는 두 배로 하지 않아요. 치명타 때와 같아요.
|
|
216
217
|
- **세이브**, **도움말**, **설정**, **정보**는 줄 끝에 아이콘으로 있어요. 설정에서는 페이지 자체의 환경설정도 바꿀 수 있어요. 테마, 주사위 소리, 주사위 세트가 있어요.
|
|
@@ -271,7 +272,7 @@ GM이 캠페인에 맞게 게임 시스템의 페이지를 바꾸면, 크리처
|
|
|
271
272
|
|
|
272
273
|
## 8. 더 알아보기: 캠페인 폴더 <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
열어 볼 필요는 없어요. 캠페인의 비밀이 들어
|
|
275
|
+
열어 볼 필요는 없어요. 캠페인의 비밀이 들어 있으니까요. 폴더에는 `campaign.yaml`(설정), `state.yaml`(게임 진행 상황), `world/`(캐릭터, 장소, 퀘스트 등을 한 개씩 담은 마크다운 페이지), `rules/`(하우스 룰), `images/`, `log.jsonl`(모든 변경 기록), `sessions/`(Claude Code와 Codex에서 GM과 나눈 채팅을 텍스트로 담은 폴더), `.saves/`, `.player/`(메모), 그리고 AI 에이전트에게 RPG Engine의 위치를 알려 주는 작은 파일들이 있어요. 페이지는 Obsidian 형식이에요. 페이지를 직접 고치면 GM이 다음 답변 때 알아채요.
|
|
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 komplette veiledningen
|
|
3
3
|
|
|
4
4
|
**RPG Engine** lar deg spille et rollespill rundt bordet med en **AI som spilleder**. Du snakker med spillederen i en **chat**. RPG Engine jobber bak kulissene: det **husker verden**, **kaster terningene** og **fører regnskapet**. Ved siden av chatten har du en side åpen i nettleseren, **dashbordet**, med karakterarket, terningene, kartene og dagboken din.
|
|
@@ -64,13 +64,14 @@ Spilleder kan ikke opprette en kampanje for deg: før `init` er det ingenting so
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Koble til AI-en din
|
|
66
66
|
|
|
67
|
-
Spillederen kjører i en **AI-agent**: en AI-app, i terminalen eller på skrivebordet, som kan arbeide med filene på datamaskinen din, for eksempel Claude Code eller
|
|
67
|
+
Spillederen kjører i en **AI-agent**: en AI-app, i terminalen eller på skrivebordet, som kan arbeide med filene på datamaskinen din, for eksempel Claude Code, Codex eller Antigravity. En vanlig chat som claude.ai eller ChatGPT, eller en app på telefonen, er ikke nok: spillederen må kunne nå kampanjens filer på datamaskinen din. Hver agent trenger sitt eget abonnement og sin egen innlogging: Claude Code et betalt Claude-abonnement, Codex en ChatGPT-innlogging, Antigravity en Google-konto, der gratisabonnementet har en liten ukentlig kvote. Du installerer agenten én gang, fra agentens egen side: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
|
-
- **Claude Code**: skriv `claude` i kampanjemappen. Når den spør om du stoler på mappen, velger du **Yes, I trust this folder**. Pass på: svaret som er valgt på forhånd, er *No, exit*. Kampanjen har også en liten krok, `rpg --listen`, som spørsmålet ikke viser: den forteller
|
|
69
|
+
- **Claude Code**: skriv `claude` i kampanjemappen. Når den spør om du stoler på mappen, velger du **Yes, I trust this folder**. Pass på: svaret som er valgt på forhånd, er *No, exit*. Kampanjen har også en liten krok, `rpg --listen`, som spørsmålet ikke viser: den forteller spillederen med en gang når du gjør noe fra dashbordet.
|
|
70
70
|
- **Codex**: skriv `codex` i kampanjemappen, og svar ja når den spør om du stoler på mappen. I skrivebordsappen sjekker du i innstillingene at minner er slått av for spillets chatter.
|
|
71
|
+
- **Antigravity**: skriv `agy` i kampanjemappen, og svar ja hvis den spør om du stoler på mappen. Kampanjen har en liten krok, `rpg --approve`, som lar spillederen bruke verktøyene til RPG Engine uten å spørre deg hver gang. Spillederen maler bildene i chatten selv. Antigravity beholder de tidligere chattene dine, og minnet kan ikke slås av: spillederen er instruert om aldri å lese dem. Det du skriver, går til Google, som kan la folk lese det: hold personopplysninger utenfor spillet. RPG Engine er ikke et Google-produkt.
|
|
71
72
|
- **En annen agent**: start den i kampanjemappen og gi den MCP-tjeneren `rpg mcp`. RPG Engine er en standard MCP-tjener: alle agenter som støtter MCP kan være spilleder, også lokale.
|
|
72
73
|
|
|
73
|
-
Vi spiller og tester med **Claude Code**. **Codex** er koblet til og kontrollert, men ingen hel kampanje er spilt med
|
|
74
|
+
Vi spiller og tester med **Claude Code**. **Codex** og **Antigravity** er koblet til og kontrollert, men ingen hel kampanje er spilt med dem ennå. Kampanjen slår av agentens eget minne: spillet lever i filene sine, slik at et lagret spill virkelig tar deg tilbake.
|
|
74
75
|
|
|
75
76
|
### 2.5 Den første chatten
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Utenfor historien skriver du mellom hakeparenteser: *[Hvordan fungerer det å gr
|
|
|
126
127
|
|
|
127
128
|
Du sier hva du prøver. Spillederen sier hva som skjer. Spillederen bestemmer aldri for karakteren din, og snakker aldri om motoren. Du kan spørre spillederen hvordan du bruker dashbordet.
|
|
128
129
|
|
|
129
|
-
**Å handle fra dashbordet**: klikk på et navn på karakterarket, for eksempel et våpen, en trylleformel eller noe du bærer p
|
|
130
|
+
**Å handle fra dashbordet**: klikk på et navn på karakterarket, for eksempel et våpen, en trylleformel eller noe du bærer på: kortet forteller hva det er. Velg hva du gjør med det, for eksempel **Bruk**, og deretter hvem det gjelder, i listen eller med et klikk på kartet. Du kan også klikke på en person for å snakke med vedkommende. Dashbordet skriver setningen for deg, *Jeg angriper Hooded Bandit 1 med Mace.*, og du kan endre den før du trykker **Si til spilleder**. Spillederen hører den som om den var sagt i chatten, og avgjør den som alt annet du gjør. Hvis AI-appen din ikke kan høre den av seg selv, gjør **Kopier** den klar til å limes inn i chatten.
|
|
130
131
|
|
|
131
132
|
### 3.2 Kast
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ Spillederen ber om et kast bare når utfallet er uvisst og har noe å si, og sie
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Scener og kamper
|
|
144
145
|
|
|
145
|
-
Historien går i **scener**: en kamp, en samtale, utforsking, reise, en hvile. Ved slutten av hver scene lagrer spillet seg selv,
|
|
146
|
+
Historien går i **scener**: en kamp, en samtale, utforsking, reise, en hvile. Ved slutten av hver scene lagrer spillet seg selv, scenen havner i dagboken din, og spillederen skriver den som et kapittel i boken om historien din.
|
|
146
147
|
|
|
147
148
|
I en kamp forteller spillederen om hver tur som ikke er din, og stopper der du kan bestemme. **Scene** viser øverst hvem sin tur det er og hvem som kommer etterpå, og karakterens kort ved siden av kartet. Turrekkefølgen, gruppens treffpoeng og hvor skadet fiendene ser ut, i ord, står ved siden av siden. Hvis karakteren din faller, vises dødsredningene store på siden.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Skurker har planer med frister. Hver nye dag flytter spillederen truslene som ti
|
|
|
158
159
|
|
|
159
160
|
**Verden** viser stedene karakteren din kjenner, veiene mellom dem og sporet du har gått, med tåke over resten. **Scene** viser kartet over stedet der du er, når det har et, med hvem som står hvor. I en kamp, på din tur, er rutene du ikke kan nå, tilslørt. Når spillederen spør hvor du flytter, trykk på en rute, eller skriv den, for eksempel *E4*.
|
|
160
161
|
|
|
161
|
-
**Verden** holder også det karakteren din vet. **Kunnskap** viser menneskene, stedene, fraksjonene, skapningene og historiene karakteren kjenner, hver slik karakteren kjenner dem. Søk i den, eller åpne en for å lese den i sin helhet. Et navn i teksten fører til sin side. **Dokumenter** holder brevene, kunngjøringene og sidene karakteren fant, så du kan lese dem igjen. **Kalender** viser i dag, fristene for oppdragene dine med tiden som er igjen, og dagene i historien: en dag med scener fører til
|
|
162
|
+
**Verden** holder også det karakteren din vet. **Kunnskap** viser menneskene, stedene, fraksjonene, skapningene og historiene karakteren kjenner, hver slik karakteren kjenner dem. Søk i den, eller åpne en for å lese den i sin helhet. Et navn i teksten fører til sin side. **Dokumenter** holder brevene, kunngjøringene og sidene karakteren fant, så du kan lese dem igjen. **Kalender** viser i dag, fristene for oppdragene dine med tiden som er igjen, og dagene i historien: en dag med scener fører til dem i tidslinjen i dagboken.
|
|
162
163
|
|
|
163
164
|
### 3.6 Oppdrag, dagbok og notater
|
|
164
165
|
|
|
165
|
-
En oppgave karakteren din tar på seg, blir et oppdrag i **Dagbok**, med mål, frist og det oppdraget måler. Sett stjerne på det for å ha det i sikte øverst i Scene.
|
|
166
|
+
En oppgave karakteren din tar på seg, blir et oppdrag i **Dagbok**, med mål, frist og det oppdraget måler. Sett stjerne på det for å ha det i sikte øverst i Scene. Under **Historie** forteller dagboken historien din som en bok: spillederen skriver et prosakapittel for hver scene når den er slutt, i stilen du har valgt. Les kapittel for kapittel, der det siste er merket med bokmerket sitt, og last ned historien som Markdown eller som en nettside du kan skrive ut eller gi videre. I et spill som ble påbegynt før, kan du be spillederen skrive historien så langt. **Tidslinje** viser scenene med det som skjedde i hver av dem. Dagboken holder også **Notater** du skriver selv: private, med mindre du trykker **Del** på ett. Da hører spillederen det som det du tenker, aldri som et faktum. Under **Følgesvenner** leser du dagbøkene til følgesvennene dine: nå og da, ved slutten av en dag eller et oppdrag, skriver de noen linjer om hva de tenker og føler.
|
|
166
167
|
|
|
167
168
|
### 3.7 Karakterens historie og bilde
|
|
168
169
|
|
|
@@ -208,9 +209,9 @@ Alle innstillinger kan endres, i chatten eller i **Innstillinger**. En avgjørel
|
|
|
208
209
|
|
|
209
210
|
En side på din egen datamaskin. Den åpnes bare i nettleseren på den maskinen, og den er i gang så lenge samtalen er åpen. Når samtalen lukkes, viser den *Not connected*. Den kommer tilbake av seg selv med neste samtale.
|
|
210
211
|
|
|
211
|
-
- **Gruppe**: karakterarket ditt og følgesvennenes. Klikk på et tall for å kaste det. Hold musepekeren over det for å se hvor det kommer fra. Når en pil markerer terningen, ser du også hva som gjør kastet bedre eller verre. Når
|
|
212
|
+
- **Gruppe**: karakterarket ditt og følgesvennenes. Klikk på et tall for å kaste det. Hold musepekeren over det for å se hvor det kommer fra. Når en pil markerer terningen, ser du også hva som gjør kastet bedre eller verre. Når spillederen forbereder valg til deg, for eksempel ved et nytt nivå, åpner et varsel på karakterarket dem. Velg når du vil, les sidene som alternativene nevner, kast der et alternativ krever det, og bekreft. Historien går videre i mellomtiden. Ved siden av ser du kastene.
|
|
212
213
|
- **Scene**: hvor du er, bilde og kart, hvem som er der, og hva som skjer. I en kamp ser du turene og kortet til karakteren din.
|
|
213
|
-
- **Dagbok**: oppdrag, historien, følgesvennenes dagbøker og notatene dine.
|
|
214
|
+
- **Dagbok**: oppdrag, historien som en bok, tidslinjen, følgesvennenes dagbøker og notatene dine.
|
|
214
215
|
- **Verden**: verdenskartet, det karakteren din vet, dokumentene som er funnet, og kalenderen.
|
|
215
216
|
- **Terningbrettet**: velg terninger og en modifikator, og kast. ×2 dobler terningene, aldri modifikatoren, som ved et kritisk treff.
|
|
216
217
|
- **Lagrede spill**, **Hjelp**, **Innstillinger** og **Om** ligger som ikoner ytterst i raden. Innstillinger rommer også sidens egne valg: tema, terninglyd og terningsett.
|
|
@@ -271,7 +272,7 @@ Ett språk per kampanje, spillederens, som dashbordet følger. Dashbordet levere
|
|
|
271
272
|
|
|
272
273
|
## 8. For de nysgjerrige: kampanjemappen <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Du trenger aldri å åpne den, og den inneholder hemmelighetene i kampanjen din. Den har `campaign.yaml` (innstillingene dine), `state.yaml` (hvor spillet står), `world/` (én markdown-side for hver karakter, hvert sted, hvert oppdrag og resten), `rules/` (husreglene dine), `images/`, `log.jsonl` (hver endring), `.saves/`, `.player/` (notatene dine) og de små filene som forteller AI-agenter hvor RPG Engine er. Sidene bruker Obsidians format. Hvis du endrer en side for hånd, får
|
|
275
|
+
Du trenger aldri å åpne den, og den inneholder hemmelighetene i kampanjen din. Den har `campaign.yaml` (innstillingene dine), `state.yaml` (hvor spillet står), `world/` (én markdown-side for hver karakter, hvert sted, hvert oppdrag og resten), `rules/` (husreglene dine), `images/`, `log.jsonl` (hver endring), `sessions/` (chattene dine med spillederen som tekst, fra Claude Code og Codex), `.saves/`, `.player/` (notatene dine) og de små filene som forteller AI-agenter hvor RPG Engine er. Sidene bruker Obsidians format. Hvis du endrer en side for hånd, får spillederen vite det ved neste svar.
|
|
275
276
|
|
|
276
277
|
RPG Engine holder seg i denne mappen: det leser og skriver spillet bare her, og rører aldri de andre filene dine. Mappene med regelbøkene dine leser det bare. Utenfor mappen har det bare egne datamapper (oversettelsene til dashbordet, teksten det har lest fra regelbøkene dine, og Codex eller Claude Code hvis du lar det installere dem) og midlertidige mapper mens et bilde tegnes. Alt annet agenten din vil gjøre på datamaskinen din, spør den deg om først. Et spillsystem eller en utvidelse er kode, slik enhver npm-pakke er det: en pakke som ikke er vår, kjører på datamaskinen din med dine tillatelser, og RPG Engine installerer den bare med ditt ja, i et skjema fra agenten din eller i et vindu på datamaskinen din. Si bare ja til pakker der du stoler på utviklerne.
|
|
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: de complete handleiding
|
|
3
3
|
|
|
4
4
|
**RPG Engine** laat je een tafelrollenspel spelen met een **AI als spelleider**. Je praat met de spelleider in een **chat**; RPG Engine werkt op de achtergrond: het **onthoudt de wereld**, **gooit de dobbelstenen** en **houdt de cijfers bij**. Naast de chat houd je een pagina open in je browser, het **dashboard**, met je karakterblad, de dobbelstenen, de kaarten en je dagboek.
|
|
@@ -64,13 +64,14 @@ De spelleider kan geen campagne voor je maken: vóór `init` vertelt niets je ag
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Je AI koppelen
|
|
66
66
|
|
|
67
|
-
De spelleider draait in een **AI-agent**: een AI-app, in de terminal of op het bureaublad, die met de bestanden op je computer kan werken, zoals Claude Code of
|
|
67
|
+
De spelleider draait in een **AI-agent**: een AI-app, in de terminal of op het bureaublad, die met de bestanden op je computer kan werken, zoals Claude Code, Codex of Antigravity. Een gewone chat zoals claude.ai of ChatGPT, of een app op je telefoon, is niet genoeg: de spelleider moet bij de bestanden van de campagne op je computer kunnen. Elke agent heeft een eigen abonnement en een eigen login: Claude Code een betaald Claude-abonnement, Codex een ChatGPT-login, Antigravity een Google-account, waarvan het gratis abonnement een klein weekquotum heeft. Je installeert de agent één keer, vanaf de eigen pagina: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: typ `claude` in de campagnemap. Als het vraagt of je de map vertrouwt, kies dan **Yes, I trust this folder**. Let op: het antwoord dat al geselecteerd staat is *No, exit*. De campagne heeft ook een klein hook, `rpg --listen`, dat de vraag niet laat zien: het vertelt de spelleider meteen wanneer je iets doet op het dashboard.
|
|
70
70
|
- **Codex**: typ `codex` in de campagnemap en zeg ja als het vraagt of je de map vertrouwt. Controleer in de desktop-app bij de instellingen dat het geheugen uit staat voor de chats van het spel.
|
|
71
|
+
- **Antigravity**: typ `agy` in de campagnemap en zeg ja als het vraagt of je de map vertrouwt. De campagne heeft een klein hook, `rpg --approve`, waarmee de spelleider de tools van RPG Engine kan gebruiken zonder het je elke keer te vragen. De spelleider schildert de afbeeldingen zelf in de chat. Antigravity bewaart je eerdere chats en het geheugen kan niet worden uitgezet: de spelleider krijgt de opdracht ze nooit te lezen. Wat je schrijft gaat naar Google, dat het door mensen kan laten lezen: houd persoonlijke gegevens buiten het spel. RPG Engine is geen product van Google.
|
|
71
72
|
- **Een andere agent**: start die in de campagnemap en geef hem de MCP-server `rpg mcp`. RPG Engine is een standaard MCP-server: elke agent die MCP ondersteunt kan de spelleider zijn, ook lokale agents.
|
|
72
73
|
|
|
73
|
-
Wij spelen en testen met **Claude Code**. **Codex**
|
|
74
|
+
Wij spelen en testen met **Claude Code**. **Codex** en **Antigravity** zijn gekoppeld en gecontroleerd, maar er is nog geen hele campagne mee gespeeld. De campagne zet het eigen geheugen van de agent uit: het spel leeft in de bestanden, zodat terugkeren naar een opgeslagen spel ook echt teruggaat.
|
|
74
75
|
|
|
75
76
|
### 2.5 De eerste chat
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Wil je buiten het verhaal om iets zeggen? Schrijf het dan tussen vierkante haken
|
|
|
126
127
|
|
|
127
128
|
Jij zegt wat je probeert; de spelleider zegt wat er gebeurt. De spelleider beslist nooit voor jouw personage en praat nooit over de engine. Je kunt de spelleider wel vragen hoe je het dashboard gebruikt.
|
|
128
129
|
|
|
129
|
-
**Handelen vanaf het dashboard**: klik op een naam op je karakterblad, zoals een wapen, een spreuk of iets wat je bij je hebt, en
|
|
130
|
+
**Handelen vanaf het dashboard**: klik op een naam op je karakterblad, zoals een wapen, een spreuk of iets wat je bij je hebt: de kaart zegt wat het is. Kies wat je ermee doet, zoals **Gebruiken**, en dan voor wie het bedoeld is, in de lijst of met een klik op de kaart. Of klik op iemand om met die persoon te praten. Het dashboard schrijft je zin, *Ik val Gemaskerde Bandiet 1 aan met Strijdknots.*, die je kunt aanpassen voordat je op **Zeg het tegen de spelleider** klikt. De spelleider hoort het alsof je het in de chat zei en beoordeelt het zoals al het andere. Kan je AI-app het niet zelf horen? Dan maakt **Kopiëren** de zin klaar om in de chat te plakken.
|
|
130
131
|
|
|
131
132
|
### 3.2 Worpen
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ De spelleider vraagt alleen om een worp als de uitkomst onzeker is en ertoe doet
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Scènes en gevechten
|
|
144
145
|
|
|
145
|
-
Het verhaal verloopt in **scènes**: een gevecht, een gesprek, verkennen, reizen of rusten. Aan het einde van elke scène slaat het spel zichzelf op,
|
|
146
|
+
Het verhaal verloopt in **scènes**: een gevecht, een gesprek, verkennen, reizen of rusten. Aan het einde van elke scène slaat het spel zichzelf op, komt de scène in je dagboek en schrijft de spelleider haar als hoofdstuk van het boek van je verhaal.
|
|
146
147
|
|
|
147
148
|
In een gevecht vertelt de spelleider elke beurt die niet van jou is, en stopt waar jij kunt beslissen. De **Scène** toont bovenaan wie er aan de beurt is en wie daarna komt, en de kaart van jouw personage naast de kaart van de plek. De volgorde van de beurten, de hitpoints van je groep en hoe gewond de vijanden eruitzien, in woorden, blijven naast de pagina staan. Valt jouw personage neer, dan verschijnen de tiro salvezza tegen de dood groot op de pagina.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Schurken hebben plannen met deadlines. Elke nieuwe dag laat de spelleider de dre
|
|
|
158
159
|
|
|
159
160
|
**Wereld** toont de plaatsen die jouw personage kent, de wegen ertussen en het pad dat je liep, met mist over de rest. **Scène** toont de kaart van de plek waar je bent, als die er is, met wie waar staat. In een gevecht zijn op jouw beurt de vakjes die je niet kunt bereiken verhuld. Vraagt de spelleider waarheen je gaat? Tik op een vakje, of schrijf het op, zoals *E4*.
|
|
160
161
|
|
|
161
|
-
**Wereld** bewaart ook wat jouw personage weet. **Kennis** toont de mensen, plaatsen, facties, wezens en verhalen die het personage kent, elk zoals het personage ze kent. Zoek erin, of open er een om het helemaal te lezen. Een naam in de tekst leidt naar de eigen pagina. **Documenten** bewaart de brieven, berichten en bladzijden die het personage vond, om ze nog eens te lezen. **Kalender** toont vandaag, de deadlines van je missies met de tijd die er nog is, en de dagen van het verhaal. Een dag met scènes leidt naar
|
|
162
|
+
**Wereld** bewaart ook wat jouw personage weet. **Kennis** toont de mensen, plaatsen, facties, wezens en verhalen die het personage kent, elk zoals het personage ze kent. Zoek erin, of open er een om het helemaal te lezen. Een naam in de tekst leidt naar de eigen pagina. **Documenten** bewaart de brieven, berichten en bladzijden die het personage vond, om ze nog eens te lezen. **Kalender** toont vandaag, de deadlines van je missies met de tijd die er nog is, en de dagen van het verhaal. Een dag met scènes leidt naar die scènes in de **Tijdlijn** van het Dagboek.
|
|
162
163
|
|
|
163
164
|
### 3.6 Missies, dagboek en notities
|
|
164
165
|
|
|
165
|
-
Een taak die jouw personage op zich neemt, wordt een missie in het **Dagboek**, met de doelen, de deadline en wat de missie meet. Geef er een ster aan om de missie bovenaan
|
|
166
|
+
Een taak die jouw personage op zich neemt, wordt een missie in het **Dagboek**, met de doelen, de deadline en wat de missie meet. Geef er een ster aan om de missie bovenaan bij **Scène** in beeld te houden. Onder **Verhaal** vertelt het Dagboek je verhaal als een boek: de spelleider schrijft voor elke scène een hoofdstuk in proza zodra de scène voorbij is, in de stijl die je koos. Lees het hoofdstuk voor hoofdstuk, het laatste gemarkeerd met een bladwijzer, en download het als Markdown of als webpagina om te printen of door te geven. Is je spel eerder begonnen? Vraag de spelleider dan om het verhaal tot nu toe te schrijven. **Tijdlijn** toont de scènes met wat er in elke scène gebeurde. Het Dagboek bewaart ook je **Notities**: die zijn privé, tenzij je er een **Deelt**. De spelleider hoort die dan als wat jij denkt, nooit als een feit. Onder **Metgezellen** lees je de dagboeken van je metgezellen. Af en toe, aan het einde van een dag of een missie, schrijven ze een paar regels over wat ze denken en voelen.
|
|
166
167
|
|
|
167
168
|
### 3.7 Het verhaal en het portret van je personage
|
|
168
169
|
|
|
@@ -210,7 +211,7 @@ Een pagina op je eigen computer. Je opent hem alleen in de browser van die compu
|
|
|
210
211
|
|
|
211
212
|
- **Groep**: jouw karakterblad en dat van je metgezellen. Klik op een getal om ermee te gooien. Beweeg je muis erover om te zien waar het getal vandaan komt. Staat er een pijl bij de dobbelsteen, dan zie je ook wat de worp beter of slechter maakt. Maakt de spelleider keuzes voor je klaar, bijvoorbeeld bij een nieuw level, dan opent een melding op het karakterblad die keuzes. Kies wanneer je wilt, lees de pagina's die bij de opties genoemd worden, gooi waar een optie om een worp vraagt en bevestig dan. Het verhaal gaat intussen door. Ernaast staan de worpen.
|
|
212
213
|
- **Scène**: waar je bent, met de afbeelding en de kaart, wie er is en wat er gebeurt. In een gevecht zie je de beurten en de kaart van jouw personage.
|
|
213
|
-
- **Dagboek**: missies, het verhaal, de dagboeken van je metgezellen en je notities.
|
|
214
|
+
- **Dagboek**: missies, het verhaal als boek, de tijdlijn, de dagboeken van je metgezellen en je notities.
|
|
214
215
|
- **Wereld**: de wereldkaart, wat jouw personage weet, de gevonden documenten en de kalender.
|
|
215
216
|
- **De dobbelbak**: kies dobbelstenen en een modifier en gooi. ×2 verdubbelt de dobbelstenen, nooit de modifier, zoals bij een kritieke treffer.
|
|
216
217
|
- **Opgeslagen spellen**, **Help**, **Instellingen** en **Over**: als pictogrammen aan het eind van de rij. Bij Instellingen vind je ook de voorkeuren van de pagina zelf: thema, dobbelgeluid en dobbelsteenset.
|
|
@@ -271,7 +272,7 @@ Eén taal per campagne: die van de spelleider, die het dashboard volgt. Het dash
|
|
|
271
272
|
|
|
272
273
|
## 8. Voor de nieuwsgierigen: de campagnemap <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Je hoeft de map nooit te openen, en er staan de geheimen van je campagne in. Er staan `campaign.yaml` (je instellingen), `state.yaml` (waar het spel nu staat), `world/` (één markdownpagina voor elk personage, elke plaats, elke missie en de rest), `rules/` (je huisregels), `images/`, `log.jsonl` (elke wijziging), `.saves/`, `.player/` (je notities) en de kleine bestanden die AI-agents vertellen waar RPG Engine staat. De pagina's gebruiken het formaat van Obsidian. Als je een pagina met de hand aanpast, hoort de spelleider dat bij het volgende antwoord.
|
|
275
|
+
Je hoeft de map nooit te openen, en er staan de geheimen van je campagne in. Er staan `campaign.yaml` (je instellingen), `state.yaml` (waar het spel nu staat), `world/` (één markdownpagina voor elk personage, elke plaats, elke missie en de rest), `rules/` (je huisregels), `images/`, `log.jsonl` (elke wijziging), `sessions/` (je chats met de spelleider als tekst, van Claude Code en Codex), `.saves/`, `.player/` (je notities) en de kleine bestanden die AI-agents vertellen waar RPG Engine staat. De pagina's gebruiken het formaat van Obsidian. Als je een pagina met de hand aanpast, hoort de spelleider dat bij het volgende antwoord.
|
|
275
276
|
|
|
276
277
|
RPG Engine blijft in deze map: het leest en schrijft het spel alleen hier en raakt je andere bestanden nooit aan. De mappen met je handboeken leest het alleen. Buiten deze map bewaart het alleen eigen gegevensmappen (de vertalingen van het dashboard, de tekst die het uit je handboeken las, en Codex of Claude Code als je het die laat installeren) en tijdelijke mappen terwijl er een afbeelding wordt getekend. Wil je agent iets anders doen op je computer, dan vraagt die het eerst aan jou. Een spelsysteem of een extensie is code, zoals elk npm-pakket: een pakket dat niet van ons is, draait op je computer met jouw rechten, en RPG Engine installeert het alleen met jouw ja, in een formulier van je agent of een venster van je computer. Zeg alleen ja tegen pakketten van makers die je vertrouwt.
|
|
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: pełny przewodnik
|
|
3
3
|
|
|
4
4
|
**RPG Engine** pozwala grać w tradycyjną grę fabularną z **AI w roli Mistrza Gry**. Rozmawiasz z Mistrzem Gry na **czacie**. RPG Engine pracuje w tle: **pamięta świat**, **rzuca kośćmi** i **prowadzi rachunki**. Obok czatu trzymasz otwartą w przeglądarce stronę, czyli **dashboard**, z kartą postaci, kośćmi, mapami i dziennikiem.
|
|
@@ -64,13 +64,14 @@ Mistrz Gry nie może utworzyć kampanii za Ciebie: przed `init` nic nie mówi ag
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Połącz swoją AI
|
|
66
66
|
|
|
67
|
-
Mistrz Gry działa w **agencie AI**: aplikacji AI, w terminalu lub na pulpicie, która potrafi pracować na plikach na Twoim komputerze, jak Claude Code czy
|
|
67
|
+
Mistrz Gry działa w **agencie AI**: aplikacji AI, w terminalu lub na pulpicie, która potrafi pracować na plikach na Twoim komputerze, jak Claude Code, Codex czy Antigravity. Zwykły czat, taki jak claude.ai lub ChatGPT, ani aplikacja na telefon nie wystarczą: Mistrz Gry musi mieć dostęp do plików kampanii na Twoim komputerze. Każdy agent wymaga własnego planu i logowania: Claude Code płatnego planu Claude, Codex logowania do ChatGPT, Antigravity konta Google, którego darmowy plan ma niewielki tygodniowy limit. Instalujesz go raz, ze strony agenta: [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**: w folderze kampanii wpisz `claude`. Gdy zapyta, czy ufasz folderowi, wybierz **Yes, I trust this folder**. Uwaga: domyślnie zaznaczona jest odpowiedź *No, exit*. Kampania ma też mały hook, `rpg --listen`, którego to pytanie nie pokazuje: informuje on Mistrza Gry od razu, gdy działasz z dashboardu.
|
|
70
70
|
- **Codex**: w folderze kampanii wpisz `codex` i zgódź się, gdy zapyta, czy ufasz folderowi. W jego aplikacji na pulpit sprawdź w ustawieniach, czy pamięć jest wyłączona dla czatów gry.
|
|
71
|
+
- **Antigravity**: w folderze kampanii wpisz `agy` i zgódź się, jeśli zapyta, czy ufasz folderowi. Kampania ma mały hook, `rpg --approve`, który pozwala Mistrzowi Gry używać narzędzi RPG Engine bez pytania Cię za każdym razem. Obrazy w czacie Mistrz Gry maluje sam. Antigravity zachowuje Twoje dawne czaty, a jego pamięci nie da się wyłączyć: Mistrz Gry ma polecenie, by nigdy ich nie czytać. To, co piszesz, trafia do Google, który może pozwolić ludziom to czytać: nie podawaj w grze danych osobowych. RPG Engine nie jest produktem Google.
|
|
71
72
|
- **Inny agent**: uruchom go w folderze kampanii i podaj mu serwer MCP `rpg mcp`. RPG Engine to standardowy serwer MCP: Mistrzem Gry może być każdy agent obsługujący MCP, także lokalny.
|
|
72
73
|
|
|
73
|
-
Gramy i testujemy z **Claude Code**. **Codex**
|
|
74
|
+
Gramy i testujemy z **Claude Code**. **Codex** i **Antigravity** są podłączone i sprawdzone, ale nie rozegrano z nimi jeszcze całej kampanii. Kampania wyłącza własną pamięć agenta: gra żyje w jego plikach, dzięki czemu powrót do zapisu naprawdę cofa grę.
|
|
74
75
|
|
|
75
76
|
### 2.5 Pierwszy czat
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Pisz, co robi lub mówi Twoja postać, własnymi słowami:
|
|
|
126
127
|
|
|
127
128
|
Ty mówisz, czego próbujesz. Mistrz Gry mówi, co się dzieje. Mistrz Gry nigdy nie decyduje za Twoją postać i nigdy nie mówi o silniku gry. Możesz go zapytać, jak korzystać z dashboardu.
|
|
128
129
|
|
|
129
|
-
**Działanie z poziomu dashboardu**: kliknij nazwę na karcie postaci, na przykład broń, zaklęcie lub coś, co nosisz, a potem
|
|
130
|
+
**Działanie z poziomu dashboardu**: kliknij nazwę na karcie postaci, na przykład broń, zaklęcie lub coś, co nosisz: karta pokaże, czym to jest. Wybierz, co chcesz z tym zrobić, na przykład **Użyj**, a potem, kogo to dotyczy: na liście albo kliknięciem na mapie. Możesz też kliknąć osobę, z którą chcesz porozmawiać. Dashboard układa Twoje zdanie, *Atakuję Zakapturzonego Bandytę 1 Maczugą.*, które możesz zmienić przed kliknięciem **Powiedz Mistrzowi Gry**. Mistrz Gry słyszy je tak, jakby padło na czacie, i rozstrzyga jak każde inne. Gdy Twoja aplikacja AI nie może go odebrać sama, **Kopiuj** przygotowuje zdanie do wklejenia na czacie.
|
|
130
131
|
|
|
131
132
|
### 3.2 Rzuty
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ Mistrz Gry prosi o rzut tylko wtedy, gdy wynik jest niepewny i ma znaczenie. Naj
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Sceny i walki
|
|
144
145
|
|
|
145
|
-
Opowieść toczy się w **scenach**: walka, rozmowa, zwiedzanie, podróż, odpoczynek. Na końcu każdej sceny gra zapisuje się sama,
|
|
146
|
+
Opowieść toczy się w **scenach**: walka, rozmowa, zwiedzanie, podróż, odpoczynek. Na końcu każdej sceny gra zapisuje się sama, scena trafia do Twojego dziennika, a Mistrz Gry spisuje ją jako rozdział książki o Twojej opowieści.
|
|
146
147
|
|
|
147
148
|
W walce Mistrz Gry opowiada o każdej turze, która nie jest Twoja, i zatrzymuje się tam, gdzie możesz podjąć decyzję. **Scena** pokazuje u góry, czyja jest tura i kto będzie następny, a obok mapy kartę Twojej postaci. Kolejność tur, punkty wytrzymałości drużyny i to, jak ranni wyglądają przeciwnicy (opisane słowami), zostają z boku strony. Jeśli Twoja postać upadnie, rzuty obronne przeciw śmierci pojawią się na stronie w dużym rozmiarze.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Złoczyńcy mają plany z terminami. Każdego nowego dnia Mistrz Gry porusza zag
|
|
|
158
159
|
|
|
159
160
|
**Świat** pokazuje miejsca, które zna Twoja postać, drogi między nimi i szlak, który przebyła, a resztę przykrywa mgła. **Scena** pokazuje mapę miejsca, w którym jesteś, jeśli je ma, razem z tym, kto gdzie stoi. W walce, w Twojej turze, pola poza zasięgiem są zasłonięte. Gdy Mistrz Gry pyta, dokąd się ruszasz, dotknij pola albo je wpisz, na przykład *E4*.
|
|
160
161
|
|
|
161
|
-
**Świat** przechowuje też wiedzę Twojej postaci. **Wiedza** zawiera listę osób, miejsc, frakcji, stworzeń i opowieści, które postać zna, każde tak, jak ona je zna: przeszukaj ją albo otwórz wpis, żeby przeczytać go w całości. Nazwa w tekście prowadzi do swojej strony. **Dokumenty** przechowują listy, ogłoszenia i strony, które postać znalazła, żeby można je było przeczytać ponownie. **Kalendarz** pokazuje dzisiejszy dzień, terminy zadań z pozostałym czasem oraz dni opowieści: dzień ze scenami prowadzi do
|
|
162
|
+
**Świat** przechowuje też wiedzę Twojej postaci. **Wiedza** zawiera listę osób, miejsc, frakcji, stworzeń i opowieści, które postać zna, każde tak, jak ona je zna: przeszukaj ją albo otwórz wpis, żeby przeczytać go w całości. Nazwa w tekście prowadzi do swojej strony. **Dokumenty** przechowują listy, ogłoszenia i strony, które postać znalazła, żeby można je było przeczytać ponownie. **Kalendarz** pokazuje dzisiejszy dzień, terminy zadań z pozostałym czasem oraz dni opowieści: dzień ze scenami prowadzi do nich na osi czasu w Dzienniku.
|
|
162
163
|
|
|
163
164
|
### 3.6 Zadania, dziennik i notatki
|
|
164
165
|
|
|
165
|
-
Sprawa, którą podejmuje Twoja postać, staje się zadaniem w **Dzienniku**, z jego celami, terminem i tym, co mierzy. Oznacz je gwiazdką, żeby zostało na widoku u góry Sceny. Dziennik opowiada
|
|
166
|
+
Sprawa, którą podejmuje Twoja postać, staje się zadaniem w **Dzienniku**, z jego celami, terminem i tym, co mierzy. Oznacz je gwiazdką, żeby zostało na widoku u góry Sceny. W części **Historia** Dziennik opowiada Twoją historię jak książkę: Mistrz Gry pisze rozdział prozą o każdej scenie, gdy ta się skończy, w stylu, który wybierasz. Czytaj rozdział po rozdziale, a ostatni przeczytany zaznaczy zakładka. Możesz pobrać książkę jako Markdown albo jako stronę internetową do wydruku lub przekazania dalej. W grze rozpoczętej wcześniej poproś Mistrza Gry o spisanie dotychczasowej historii. **Oś czasu** wylicza sceny wraz z tym, co się w każdej wydarzyło. Dziennik przechowuje też Twoje **Notatki**: są prywatne, chyba że klikniesz **Udostępnij** przy jednej z nich. Mistrz Gry słyszy wtedy notatkę jako to, co myślisz, nigdy jako fakt. W części **Towarzysze** czytasz dzienniki towarzyszy: od czasu do czasu, na koniec dnia lub zadania, zapisują kilka linijek o tym, co myślą i czują.
|
|
166
167
|
|
|
167
168
|
### 3.7 Historia i obraz postaci
|
|
168
169
|
|
|
@@ -208,9 +209,9 @@ Każde ustawienie można zmienić, na czacie lub w **Ustawieniach**. Rozstrzygni
|
|
|
208
209
|
|
|
209
210
|
Strona na Twoim komputerze, otwierana tylko w przeglądarce na tym komputerze. Działa, dopóki czat jest otwarty. Gdy czat się zamyka, pokazuje *Not connected*. Wraca sama przy następnym czacie.
|
|
210
211
|
|
|
211
|
-
- **Drużyna**: Twoja karta postaci i karty towarzyszy. Kliknij liczbę, aby wykonać rzut. Najedź na nią kursorem, aby zobaczyć, skąd się bierze. Gdy strzałka oznacza kość, zobaczysz też, co poprawia rzut lub go pogarsza. Gdy Mistrz Gry przygotowuje dla Ciebie wybory, na przykład przy nowym poziomie, otwiera je powiadomienie na karcie postaci. Wybierz, kiedy chcesz, przeczytaj strony wskazane w opcjach, wykonaj rzut tam, gdzie opcja tego wymaga, a potem potwierdź.
|
|
212
|
+
- **Drużyna**: Twoja karta postaci i karty towarzyszy. Kliknij liczbę, aby wykonać rzut. Najedź na nią kursorem, aby zobaczyć, skąd się bierze. Gdy strzałka oznacza kość, zobaczysz też, co poprawia rzut lub go pogarsza. Gdy Mistrz Gry przygotowuje dla Ciebie wybory, na przykład przy nowym poziomie, otwiera je powiadomienie na karcie postaci. Wybierz, kiedy chcesz, przeczytaj strony wskazane w opcjach, wykonaj rzut tam, gdzie opcja tego wymaga, a potem potwierdź. Opowieść toczy się w tym czasie dalej. Obok są rzuty.
|
|
212
213
|
- **Scena**: gdzie jesteś, obraz i mapa miejsca, kto tam jest, co się dzieje. W walce: tury i karta Twojej postaci.
|
|
213
|
-
- **Dziennik**: zadania,
|
|
214
|
+
- **Dziennik**: zadania, historia jako książka, jej oś czasu, dzienniki towarzyszy, Twoje notatki.
|
|
214
215
|
- **Świat**: mapa świata, to, co wie Twoja postać, znalezione dokumenty i kalendarz.
|
|
215
216
|
- **Tacka na kości**: wybierz kości i modyfikator, potem rzuć. ×2 podwaja kości, nigdy modyfikator, tak jak przy trafieniu krytycznym.
|
|
216
217
|
- **Zapisy**, **Pomoc**, **Ustawienia** i **Informacje**: ikony na końcu rzędu. W Ustawieniach są też preferencje samej strony: motyw, dźwięk kości, zestaw kości.
|
|
@@ -271,7 +272,7 @@ Jeden język na kampanię, język Mistrza Gry, za którym podąża dashboard. Da
|
|
|
271
272
|
|
|
272
273
|
## 8. Dla ciekawskich: folder kampanii <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Nie musisz go nigdy otwierać, a zawiera sekrety Twojej kampanii. Znajdziesz w nim `campaign.yaml` (Twoje ustawienia), `state.yaml` (stan gry), `world/` (jedna strona markdown dla każdej postaci, miejsca, zadania i reszty), `rules/` (Twoje zasady domowe), `images/`, `log.jsonl` (każda zmiana), `.saves/`, `.player/` (Twoje notatki) oraz małe pliki, które mówią agentom AI, gdzie jest RPG Engine. Strony mają format Obsidiana. Jeśli zmienisz stronę ręcznie, Mistrz Gry dowie się o tym przy najbliższej odpowiedzi.
|
|
275
|
+
Nie musisz go nigdy otwierać, a zawiera sekrety Twojej kampanii. Znajdziesz w nim `campaign.yaml` (Twoje ustawienia), `state.yaml` (stan gry), `world/` (jedna strona markdown dla każdej postaci, miejsca, zadania i reszty), `rules/` (Twoje zasady domowe), `images/`, `log.jsonl` (każda zmiana), `sessions/` (Twoje rozmowy z Mistrzem Gry w formie tekstu, z Claude Code i Codex), `.saves/`, `.player/` (Twoje notatki) oraz małe pliki, które mówią agentom AI, gdzie jest RPG Engine. Strony mają format Obsidiana. Jeśli zmienisz stronę ręcznie, Mistrz Gry dowie się o tym przy najbliższej odpowiedzi.
|
|
275
276
|
|
|
276
277
|
RPG Engine działa tylko w tym folderze: czyta i zapisuje grę wyłącznie tu i nigdy nie rusza Twoich innych plików. Foldery z podręcznikami tylko czyta. Poza nim trzyma jedynie własne foldery danych (tłumaczenia dashboardu, tekst odczytany z Twoich podręczników oraz Codex lub Claude Code, jeśli pozwolisz je zainstalować) i foldery tymczasowe na czas rysowania obrazu. Wszystko inne, czego agent chce na Twoim komputerze, robi dopiero po pytaniu. System gry lub rozszerzenie to kod, jak każdy pakiet npm: pakiet, który nie jest nasz, działa na Twoim komputerze z Twoimi uprawnieniami, a RPG Engine instaluje go tylko za Twoim „tak", w formularzu Twojego agenta lub w oknie komputera. Odpowiadaj „tak" tylko na pakiety, których autorom ufasz.
|
|
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: o guia completo
|
|
3
3
|
|
|
4
4
|
**RPG Engine** permite que você jogue um jogo de RPG de mesa com uma **IA como mestre**. Você conversa com o mestre em um **chat**; o RPG Engine trabalha nos bastidores: ele **lembra do mundo**, **rola os dados** e **faz as contas**. Ao lado do chat, você mantém aberta uma página no navegador, o **painel**, com sua ficha, os dados, os mapas e seu diário.
|
|
@@ -64,13 +64,14 @@ O mestre não pode criar uma campanha para você: antes do `init`, nada diz ao s
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Conectar sua IA
|
|
66
66
|
|
|
67
|
-
O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code ou o
|
|
67
|
+
O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code, o Codex ou o Antigravity. Um chat simples, como o claude.ai ou o ChatGPT, ou um app de celular, não basta: o mestre precisa acessar os arquivos da campanha no seu computador. Cada agente exige seu próprio plano e login: o Claude Code, um plano pago do Claude; o Codex, um login do ChatGPT; o Antigravity, uma conta Google, cujo plano gratuito tem uma pequena cota semanal. Você instala o agente uma vez, pela página dele: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: na pasta da campanha, escreva `claude`. Quando ele perguntar se você confia na pasta, escolha **Yes, I trust this folder**; atenção, a resposta já selecionada é *No, exit*. A campanha também tem um pequeno hook, `rpg --listen`, que a pergunta não mostra: ele avisa o mestre na hora quando você age pelo dashboard.
|
|
70
70
|
- **Codex**: na pasta da campanha, escreva `codex` e diga sim quando ele perguntar se você confia na pasta. No app de desktop, confira nas configurações se as memórias estão desligadas para os chats do jogo.
|
|
71
|
+
- **Antigravity**: na pasta da campanha, escreva `agy` e diga sim se ele perguntar se você confia na pasta. A campanha tem um pequeno hook, `rpg --approve`, que permite ao mestre usar as ferramentas do RPG Engine sem perguntar a você a cada vez. O mestre pinta as imagens no próprio chat. O Antigravity guarda seus chats anteriores, e a memória dele não pode ser desligada: o mestre é instruído a nunca lê-los. O que você escreve vai para o Google, que pode pedir a pessoas que leiam: não coloque dados pessoais no jogo. O RPG Engine não é um produto do Google.
|
|
71
72
|
- **Outro agente**: inicie-o na pasta da campanha e dê a ele o servidor MCP `rpg mcp`. O RPG Engine é um servidor MCP padrão: qualquer agente que suporte MCP pode ser o mestre, inclusive os locais.
|
|
72
73
|
|
|
73
|
-
Nós jogamos e testamos com o **Claude Code**; o **Codex**
|
|
74
|
+
Nós jogamos e testamos com o **Claude Code**; o **Codex** e o **Antigravity** estão conectados e verificados, mas nenhuma campanha inteira foi jogada com eles ainda. A campanha desliga a memória própria do agente: o jogo vive nos arquivos dele, para que voltar a um jogo salvo realmente volte no tempo.
|
|
74
75
|
|
|
75
76
|
### 2.5 O primeiro chat
|
|
76
77
|
|
|
@@ -126,7 +127,7 @@ Para falar fora da história, escreva entre colchetes: *[Como funciona a agarrad
|
|
|
126
127
|
|
|
127
128
|
Você diz o que tenta; o mestre diz o que acontece. O mestre nunca decide pelo seu personagem e nunca fala do motor do jogo. Você pode perguntar a ele como usar o dashboard.
|
|
128
129
|
|
|
129
|
-
**Agindo pelo dashboard**: clique em um nome da sua ficha, como uma arma, uma magia ou algo que você carrega, e depois em quem será o alvo; ou clique em uma pessoa para conversar. O dashboard escreve a frase por você, *Ataco Bandido Encapuzado 1 com Maça.*, e você pode alterá-la antes de clicar em **Dizer ao mestre**. O mestre a recebe como se tivesse sido dita no chat e decide como em qualquer outra ação. Se o seu aplicativo de IA não consegue receber a frase sozinho, **Copiar** deixa o texto pronto para colar no chat.
|
|
130
|
+
**Agindo pelo dashboard**: clique em um nome da sua ficha, como uma arma, uma magia ou algo que você carrega: o cartão dele diz o que é. Escolha o que fazer com ele, como **Usar**, e depois em quem será o alvo, na lista ou com um clique no mapa; ou clique em uma pessoa para conversar. O dashboard escreve a frase por você, *Ataco Bandido Encapuzado 1 com Maça.*, e você pode alterá-la antes de clicar em **Dizer ao mestre**. O mestre a recebe como se tivesse sido dita no chat e decide como em qualquer outra ação. Se o seu aplicativo de IA não consegue receber a frase sozinho, **Copiar** deixa o texto pronto para colar no chat.
|
|
130
131
|
|
|
131
132
|
### 3.2 Rolagens
|
|
132
133
|
|
|
@@ -142,7 +143,7 @@ O mestre só pede uma rolagem quando o resultado é incerto e importa, e antes d
|
|
|
142
143
|
|
|
143
144
|
### 3.3 Cenas e combates
|
|
144
145
|
|
|
145
|
-
A história se desenrola em **cenas**: um combate, uma conversa, uma exploração, uma viagem, um descanso. No fim de cada cena o jogo é salvo automaticamente,
|
|
146
|
+
A história se desenrola em **cenas**: um combate, uma conversa, uma exploração, uma viagem, um descanso. No fim de cada cena o jogo é salvo automaticamente, a cena entra no seu diário e o mestre a escreve como um capítulo do livro da sua história.
|
|
146
147
|
|
|
147
148
|
Em um combate, o mestre narra todos os turnos que não são seus e para quando você precisa decidir. A **Cena** mostra no alto de quem é a vez e quem vem depois, e o cartão do seu personagem ao lado do mapa; a ordem dos turnos, os pontos de vida do seu grupo e o estado dos inimigos, descrito em palavras, ficam ao lado da página. Se seu personagem cair, os testes de morte aparecem grandes na página.
|
|
148
149
|
|
|
@@ -158,11 +159,11 @@ Os vilões têm planos com prazos. A cada novo dia, o mestre move as ameaças qu
|
|
|
158
159
|
|
|
159
160
|
**Mundo** mostra os locais que seu personagem conhece, as estradas entre eles e o caminho que você percorreu, com névoa sobre o resto. **Cena** mostra o mapa do local onde você está, quando há um, com quem está em cada lugar; em um combate, na sua vez, os quadrados que você não alcança ficam velados. Quando o mestre perguntar para onde você se move, toque em um quadrado ou escreva-o, como *E4*.
|
|
160
161
|
|
|
161
|
-
**Mundo** também guarda o que seu personagem sabe. **Conhecimentos** lista as pessoas, os locais, as facções, as criaturas e as histórias que ele conhece, cada uma como ele a conhece: pesquise ou abra uma para ler por inteiro; um nome no texto leva à página correspondente. **Documentos** guarda as cartas, os avisos e as páginas que ele encontrou, para reler. **Calendário** mostra hoje, os prazos das suas missões com o tempo que resta e os dias da história: um dia com cenas leva
|
|
162
|
+
**Mundo** também guarda o que seu personagem sabe. **Conhecimentos** lista as pessoas, os locais, as facções, as criaturas e as histórias que ele conhece, cada uma como ele a conhece: pesquise ou abra uma para ler por inteiro; um nome no texto leva à página correspondente. **Documentos** guarda as cartas, os avisos e as páginas que ele encontrou, para reler. **Calendário** mostra hoje, os prazos das suas missões com o tempo que resta e os dias da história: um dia com cenas leva a elas na linha do tempo do Diário.
|
|
162
163
|
|
|
163
164
|
### 3.6 Missões, diário e notas
|
|
164
165
|
|
|
165
|
-
Uma tarefa que seu personagem assume vira uma missão no **Diário**, com seus objetivos, seu prazo e o que ela mede; marque-a com uma estrela para mantê-la à vista no alto da Cena
|
|
166
|
+
Uma tarefa que seu personagem assume vira uma missão no **Diário**, com seus objetivos, seu prazo e o que ela mede; marque-a com uma estrela para mantê-la à vista no alto da **Cena**. Em **História**, o Diário conta a sua história como um livro: o mestre escreve um capítulo em prosa para cada cena quando ela termina, no estilo que você escolheu; leia capítulo por capítulo, com o último marcado pelo marcador de página, e baixe o livro em Markdown ou como página da web, para imprimir ou compartilhar. Em um jogo começado antes, peça ao mestre que escreva a história até aqui. **Linha do tempo** lista as cenas com o que aconteceu em cada uma. O Diário também guarda suas **Notas**: privadas, a menos que você use **Compartilhar** em uma, e então o mestre a recebe como algo que seu personagem pensa, nunca como um fato. Em **Companheiros** você lê os diários dos seus companheiros: de vez em quando, no fim de um dia ou de uma missão, eles escrevem algumas linhas sobre o que pensam e sentem.
|
|
166
167
|
|
|
167
168
|
### 3.7 A história e a imagem do seu personagem
|
|
168
169
|
|
|
@@ -209,11 +210,11 @@ Toda configuração pode mudar, no chat ou em **Configurações**. Uma decisão
|
|
|
209
210
|
Uma página no seu próprio computador, aberta apenas no navegador desse computador e ativa enquanto o chat estiver aberto. Quando o chat é fechado, ela mostra *Not connected*; ela volta sozinha no próximo chat.
|
|
210
211
|
|
|
211
212
|
- **Grupo**: sua ficha e as dos seus companheiros. Clique em um número para rolá-lo; passe o mouse sobre ele para ver de onde vem e, quando uma seta marca o dado, o que melhora ou piora a rolagem. Quando o mestre prepara escolhas para você, como ao subir de nível, um aviso na ficha as abre: escolha quando quiser, leia as páginas que as opções indicam, role onde uma opção pedir uma rolagem e depois confirme; a história continua enquanto isso. Ao lado, as rolagens.
|
|
212
|
-
- **Cena**: onde você está, a imagem e o mapa do
|
|
213
|
-
- **Diário**: missões, a história, os diários dos seus companheiros, suas notas.
|
|
213
|
+
- **Cena**: onde você está, a imagem e o mapa do local, quem está presente, o que está acontecendo; em um combate, os turnos e o cartão do seu personagem.
|
|
214
|
+
- **Diário**: missões, a história como um livro, a linha do tempo, os diários dos seus companheiros, suas notas.
|
|
214
215
|
- **Mundo**: o mapa do mundo, o que seu personagem sabe, os documentos encontrados e o calendário.
|
|
215
216
|
- **A bandeja de dados**: escolha os dados e um modificador, e role; ×2 dobra os dados, nunca o modificador, como em um acerto crítico.
|
|
216
|
-
- **Jogos salvos**, **Ajuda**, **Configurações** e **Sobre**, como ícones no fim da fileira. As Configurações também guardam as preferências da própria página: tema, som dos dados, conjunto de dados.
|
|
217
|
+
- **Jogos salvos**, **Ajuda**, **Configurações** e **Sobre**, como ícones no fim da fileira. As **Configurações** também guardam as preferências da própria página: tema, som dos dados, conjunto de dados.
|
|
217
218
|
|
|
218
219
|
Quando o mestre pergunta algo a você, o aviso dele fica no topo, em qualquer seção em que você esteja.
|
|
219
220
|
|
|
@@ -271,7 +272,7 @@ Um idioma por campanha, o do mestre, que o painel acompanha. O painel já vem co
|
|
|
271
272
|
|
|
272
273
|
## 8. Para os curiosos: a pasta da campanha <!-- icon: list -->
|
|
273
274
|
|
|
274
|
-
Você nunca precisa abri-la, e ela guarda os segredos da sua campanha. Nela estão `campaign.yaml` (suas configurações), `state.yaml` (como está o jogo), `world/` (uma página em markdown para cada personagem, local, missão e o restante), `rules/` (suas regras da casa), `images/`, `log.jsonl` (cada alteração), `.saves/`, `.player/` (suas notas) e os pequenos arquivos que dizem aos agentes de IA onde o RPG Engine está. As páginas usam o formato do Obsidian. Se você alterar uma página à mão, o mestre fica sabendo na resposta seguinte.
|
|
275
|
+
Você nunca precisa abri-la, e ela guarda os segredos da sua campanha. Nela estão `campaign.yaml` (suas configurações), `state.yaml` (como está o jogo), `world/` (uma página em markdown para cada personagem, local, missão e o restante), `rules/` (suas regras da casa), `images/`, `log.jsonl` (cada alteração), `sessions/` (suas conversas com o mestre em texto, do Claude Code e do Codex), `.saves/`, `.player/` (suas notas) e os pequenos arquivos que dizem aos agentes de IA onde o RPG Engine está. As páginas usam o formato do Obsidian. Se você alterar uma página à mão, o mestre fica sabendo na resposta seguinte.
|
|
275
276
|
|
|
276
277
|
O RPG Engine fica dentro desta pasta: ele lê e grava o jogo somente aqui e nunca toca em seus outros arquivos. As pastas dos seus manuais, ele apenas lê. Fora dela, ele guarda só pastas de dados próprias (as traduções do painel, o texto que ele leu dos seus manuais, e o Codex ou o Claude Code, se você deixar que ele os instale) e pastas temporárias enquanto uma imagem é desenhada. Qualquer outra coisa que o seu agente queira fazer no computador, ele pergunta antes. Um sistema de jogo ou uma extensão é código, como qualquer pacote npm: um que não seja nosso roda no seu computador com as suas permissões, e o RPG Engine só o instala com o seu sim, em um formulário do seu agente ou em uma janela do computador. Diga sim apenas a pacotes cujos autores você conhece e em quem confia.
|
|
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: 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
|
|