rpg-engine 0.22.0 → 0.23.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/dist/campaign/create-campaign.d.ts +5 -0
- package/dist/campaign/create-campaign.js +40 -12
- package/dist/campaign/find-campaign.d.ts +5 -0
- package/dist/campaign/find-campaign.js +10 -5
- package/dist/campaign/host-files.d.ts +15 -4
- package/dist/campaign/host-files.js +130 -13
- package/dist/campaign/index.d.ts +2 -2
- package/dist/campaign/index.js +2 -2
- package/dist/cli/cli.js +18 -6
- package/dist/commands/config/dashboard.js +6 -1
- package/dist/commands/config/words.js +1 -1
- package/dist/commands/image.d.ts +3 -0
- package/dist/commands/image.js +31 -4
- package/dist/commands/import/import.d.ts +1 -1
- package/dist/commands/import/import.js +5 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +21 -3
- package/dist/commands/shared/campaign/git.js +1 -1
- package/dist/commands/shared/campaign/images.js +5 -3
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +8 -5
- package/dist/core/context.d.ts +15 -6
- package/dist/core/context.js +2 -1
- package/dist/dashboard/guide/ar.md +7 -4
- package/dist/dashboard/guide/cs.md +6 -3
- package/dist/dashboard/guide/da.md +6 -3
- package/dist/dashboard/guide/de.md +6 -3
- package/dist/dashboard/guide/el.md +6 -3
- package/dist/dashboard/guide/en.md +5 -2
- package/dist/dashboard/guide/es.md +6 -3
- package/dist/dashboard/guide/fi.md +6 -3
- package/dist/dashboard/guide/fr.md +7 -4
- package/dist/dashboard/guide/he.md +6 -3
- package/dist/dashboard/guide/hi.md +6 -3
- package/dist/dashboard/guide/hu.md +6 -3
- package/dist/dashboard/guide/is.md +6 -3
- package/dist/dashboard/guide/it.md +37 -34
- package/dist/dashboard/guide/ja.md +6 -3
- package/dist/dashboard/guide/ko.md +6 -3
- package/dist/dashboard/guide/nb.md +6 -3
- package/dist/dashboard/guide/nl.md +8 -5
- package/dist/dashboard/guide/pl.md +6 -3
- package/dist/dashboard/guide/pt.md +6 -3
- package/dist/dashboard/guide/ro.md +6 -3
- package/dist/dashboard/guide/ru.md +7 -4
- package/dist/dashboard/guide/sv.md +6 -3
- package/dist/dashboard/guide/tr.md +7 -4
- package/dist/dashboard/guide/uk.md +7 -4
- package/dist/dashboard/guide/zh.md +6 -3
- package/dist/dashboard/i18n/ar.json +5 -2
- package/dist/dashboard/i18n/cs.json +5 -2
- package/dist/dashboard/i18n/da.json +5 -2
- package/dist/dashboard/i18n/de.json +5 -2
- package/dist/dashboard/i18n/el.json +5 -2
- package/dist/dashboard/i18n/es.json +5 -2
- package/dist/dashboard/i18n/fi.json +5 -2
- package/dist/dashboard/i18n/fr.json +5 -2
- package/dist/dashboard/i18n/he.json +5 -2
- package/dist/dashboard/i18n/hi.json +5 -2
- package/dist/dashboard/i18n/hu.json +5 -2
- package/dist/dashboard/i18n/is.json +5 -2
- package/dist/dashboard/i18n/it.json +5 -2
- package/dist/dashboard/i18n/ja.json +5 -2
- package/dist/dashboard/i18n/ko.json +5 -2
- package/dist/dashboard/i18n/nb.json +5 -2
- package/dist/dashboard/i18n/nl.json +5 -2
- package/dist/dashboard/i18n/pl.json +5 -2
- package/dist/dashboard/i18n/pt.json +5 -2
- package/dist/dashboard/i18n/ro.json +5 -2
- package/dist/dashboard/i18n/ru.json +5 -2
- package/dist/dashboard/i18n/sv.json +5 -2
- package/dist/dashboard/i18n/tr.json +5 -2
- package/dist/dashboard/i18n/uk.json +5 -2
- package/dist/dashboard/i18n/zh.json +5 -2
- package/dist/dashboard/parts/labels.js +1 -1
- package/dist/dashboard/settings/settings.js +13 -4
- package/dist/dashboard/shell/notices.js +1 -1
- package/dist/dashboard/style.css +15 -7
- package/dist/helpers/briefs.d.ts +4 -0
- package/dist/helpers/briefs.js +13 -0
- package/dist/helpers/chosen.d.ts +8 -4
- package/dist/helpers/chosen.js +38 -14
- package/dist/helpers/index.d.ts +3 -2
- package/dist/helpers/index.js +5 -3
- package/dist/helpers/opencode.d.ts +13 -0
- package/dist/helpers/opencode.js +202 -0
- package/dist/instructions/index.d.ts +2 -2
- package/dist/instructions/index.js +3 -3
- package/dist/server/approver.d.ts +4 -2
- package/dist/server/approver.js +27 -7
- package/dist/server/bell/antigravity.d.ts +10 -0
- package/dist/server/bell/antigravity.js +95 -0
- package/dist/server/bell/index.d.ts +2 -0
- package/dist/server/bell/index.js +2 -0
- package/dist/server/bell/listener.d.ts +43 -0
- package/dist/server/bell/listener.js +149 -0
- package/dist/server/dashboard/index.d.ts +10 -1
- package/dist/server/dashboard/index.js +6 -1
- package/dist/server/dashboard/news.d.ts +3 -1
- package/dist/server/dashboard/news.js +64 -10
- package/dist/server/mcp.d.ts +3 -2
- package/dist/server/mcp.js +11 -7
- package/dist/server/player-acts.d.ts +21 -1
- package/dist/server/player-acts.js +38 -2
- package/dist/server/route/front.d.ts +3 -0
- package/dist/server/route/front.js +97 -0
- package/dist/server/route/index.d.ts +3 -0
- package/dist/server/route/index.js +3 -0
- package/dist/server/route/notes.d.ts +8 -0
- package/dist/server/route/notes.js +50 -0
- package/dist/server/route/router.d.ts +31 -0
- package/dist/server/route/router.js +215 -0
- package/instructions/start.md +1 -1
- package/instructions/voices-opencode.md +1 -0
- package/package.json +3 -2
- package/plugins/opencode.js +174 -0
- package/dist/server/bell-listener.d.ts +0 -10
- package/dist/server/bell-listener.js +0 -52
package/dist/commands/image.js
CHANGED
|
@@ -5,6 +5,7 @@ import { appendLogEntry } from "../core/log.js";
|
|
|
5
5
|
import { defineCommand } from "../core/registry.js";
|
|
6
6
|
import { files, isInside } from "../core/store.js";
|
|
7
7
|
import { comparableText, withArticle } from "../core/text.js";
|
|
8
|
+
import { cleanSvg, svgIn } from "../helpers/index.js";
|
|
8
9
|
import { imageFileName, imageLink, imageOfBytes, imagesFolderName, largestImage, readImage } from "../images/index.js";
|
|
9
10
|
import { baseChain, findPage, isPartyMember, ownField, pageNamed, parsePageReference, writePage } from "../pages/index.js";
|
|
10
11
|
import { imageFile, ownImage } from "./shared/campaign/images.js";
|
|
@@ -17,7 +18,8 @@ export const image = defineCommand({
|
|
|
17
18
|
name: "image",
|
|
18
19
|
description: "Give a page its picture: a portrait for a character, an image for a creature, an item or a place, as the dashboard will show it in a round token. "
|
|
19
20
|
+ "It copies the file into the campaign and links it in the page's image field; a page without one shows the picture of the page it derives from, such as a wolf's icon. "
|
|
20
|
-
+ "Use it when the player gives you a picture, or after you made one with your own tools: its file,
|
|
21
|
+
+ "Use it when the player gives you a picture, or after you made one with your own tools: its file, url with the https address your tool gives, which the engine downloads, "
|
|
22
|
+
+ "or svg with the code you drew. "
|
|
21
23
|
+ "The player may drop pictures in the campaign's inbox folder: ask what each is for, give it, then delete it from the inbox. "
|
|
22
24
|
+ "For a place, a quest, a character or a creature of the campaign, describe instead of file has the picture made on this computer, as the campaign's pictures setting allows: "
|
|
23
25
|
+ "for the player character or a companion only when the player asks; for a creature once for each kind, whose copies show it. "
|
|
@@ -28,6 +30,7 @@ export const image = defineCommand({
|
|
|
28
30
|
page: z.string().describe("the page that gets the picture"),
|
|
29
31
|
file: z.string().optional().describe("the picture's file, PNG, JPEG, WebP or SVG up to 5 MB: its full path or one from the folder the command runs in; leave it and url out to remove the page's own picture"),
|
|
30
32
|
url: z.string().optional().describe("instead of file, the picture's https address, as an image tool gives it: the engine downloads it, the same formats up to 5 MB"),
|
|
33
|
+
svg: z.string().optional().describe("instead of file, the picture's SVG code, from <svg to </svg>, as you drew it from the brief image gave you: the engine cleans it and keeps it"),
|
|
31
34
|
describe: z.string().optional().describe("instead of file, in a few lines, never a victim or wounds: for a place, what the party sees arriving; for a quest, what the character knows of it; "
|
|
32
35
|
+ "for one of the party, their look, their people as this world has them and the rest as the player described it; for a character or a creature met, what the character sees of them, "
|
|
33
36
|
+ "a disguise as the disguise; never what the character does not know. The picture is made where it can be, and comes by itself"),
|
|
@@ -44,6 +47,13 @@ export const image = defineCommand({
|
|
|
44
47
|
}
|
|
45
48
|
const url = input.url?.trim() ?? "";
|
|
46
49
|
const file = input.file?.trim() ?? "";
|
|
50
|
+
const svg = input.svg?.trim() ?? "";
|
|
51
|
+
if (svg !== "") {
|
|
52
|
+
if (file !== "" || url !== "" || (input.describe ?? "").trim() !== "") {
|
|
53
|
+
throw new Error("Give svg alone: it is the picture you drew, and file, url and describe are other ways to give one. Nothing changed.");
|
|
54
|
+
}
|
|
55
|
+
return drawnImage(root, context, world, page, svg);
|
|
56
|
+
}
|
|
47
57
|
if (input.describe !== undefined && input.describe.trim() !== "") {
|
|
48
58
|
if (file !== "" || url !== "") {
|
|
49
59
|
throw new Error("Give file, url or describe, one of them: file and url are a picture you have, describe has one made. Nothing changed.");
|
|
@@ -63,7 +73,7 @@ export const image = defineCommand({
|
|
|
63
73
|
},
|
|
64
74
|
format(result) {
|
|
65
75
|
if (result.paint !== undefined) {
|
|
66
|
-
const how = result.askTool === true ? askToolText(result.page) : paintText(result.page, result.tool);
|
|
76
|
+
const how = result.draw === true ? drawText(result.page) : result.askTool === true ? askToolText(result.page) : paintText(result.page, result.tool);
|
|
67
77
|
return `${result.instead === undefined ? "" : `${result.instead} `}${how}\n\n${result.paint}`;
|
|
68
78
|
}
|
|
69
79
|
if (result.making === true) {
|
|
@@ -99,6 +109,19 @@ async function downloadedImage(root, context, world, page, url) {
|
|
|
99
109
|
});
|
|
100
110
|
return placeImage(root, context, world, page, imageOfBytes(bytes, "What the address gave"));
|
|
101
111
|
}
|
|
112
|
+
/**
|
|
113
|
+
* The picture the chat drew as SVG code (D-572), as OpenCode's, whose own writing is denied in a campaign: cleaned as Claude's drawing is, then taken as a file
|
|
114
|
+
* is; refused with how to draw it again when nothing usable is left.
|
|
115
|
+
*/
|
|
116
|
+
function drawnImage(root, context, world, page, code) {
|
|
117
|
+
const drawn = svgIn(code);
|
|
118
|
+
const clean = drawn === undefined ? undefined : cleanSvg(drawn);
|
|
119
|
+
if (clean === undefined) {
|
|
120
|
+
throw new Error("svg takes the picture's SVG code, and this is none the engine can use: give one <svg> root that closes, under 100 KB, with only shapes, groups, gradients, masks and blur, "
|
|
121
|
+
+ "no text, script, style or image; draw it again so, or go on without. Nothing changed.");
|
|
122
|
+
}
|
|
123
|
+
return placeImage(root, context, world, page, imageOfBytes(Buffer.from(clean), "The SVG"));
|
|
124
|
+
}
|
|
102
125
|
/** Writes a picture into the campaign's images folder and links it in the page, logging it; `from` is the file it was read from, if any. */
|
|
103
126
|
export function placeImage(root, context, world, page, picture, from) {
|
|
104
127
|
if ("problem" in picture) {
|
|
@@ -166,7 +189,7 @@ function madePicture(root, context, world, page, seen) {
|
|
|
166
189
|
// The chat paints it itself, with its own tool or one it names.
|
|
167
190
|
if (paint !== undefined) {
|
|
168
191
|
const instead = ready.instead === undefined ? {} : { instead: insteadText(page.name, ready.instead, false) };
|
|
169
|
-
const tool = ready.askTool === true ? { askTool: true } : ready.tool === undefined ? {} : { tool: ready.tool };
|
|
192
|
+
const tool = ready.draws === true ? { draw: true } : ready.askTool === true ? { askTool: true } : ready.tool === undefined ? {} : { tool: ready.tool };
|
|
170
193
|
return { page: page.name, changed: false, paint, ...tool, ...instead };
|
|
171
194
|
}
|
|
172
195
|
const making = context.pictures.make(subject).then((made) => {
|
|
@@ -204,7 +227,7 @@ function insteadText(name, instead, made) {
|
|
|
204
227
|
function paintText(page, tool) {
|
|
205
228
|
const give = giveText(page);
|
|
206
229
|
if (tool === undefined) {
|
|
207
|
-
return `Make ${page}'s picture yourself with your own image tool, from this brief, then ${give}; if your tool makes none, go on without.`;
|
|
230
|
+
return `Make ${page}'s picture yourself with your own image tool, from this brief, then ${give}; if your tool makes none, draw it as the brief's last line says, or go on without.`;
|
|
208
231
|
}
|
|
209
232
|
if (tool === "ElevenLabs") {
|
|
210
233
|
return `Make ${page}'s picture with your ElevenLabs image tool, from this brief: one picture (generations_count 1). Its view shows the player the progress, but the game needs the finished file: `
|
|
@@ -213,6 +236,10 @@ function paintText(page, tool) {
|
|
|
213
236
|
}
|
|
214
237
|
return `Make ${page}'s picture with ${tool}, from this brief, then ${give}; if it makes none, tell the player why and go on without.`;
|
|
215
238
|
}
|
|
239
|
+
/** How the master of a chat that draws itself makes a picture (D-572): as SVG code, from the brief, given back with svg. */
|
|
240
|
+
function drawText(page) {
|
|
241
|
+
return `Draw ${page}'s picture yourself as SVG code, from this brief, then give it with image, page ${page}, svg and the code; if you cannot, go on without.`;
|
|
242
|
+
}
|
|
216
243
|
/** What the master does where the player chose another image tool without naming it (D-572): asks which, writes it, then makes the picture with it. */
|
|
217
244
|
function askToolText(page) {
|
|
218
245
|
return `The player chose another image tool for the pictures and has not named it: ask them which, set its name with config pictures-by, then make ${page}'s picture with it from this brief `
|
|
@@ -22,7 +22,7 @@ interface ImportResult {
|
|
|
22
22
|
/** How many of the document's pages were read from their pictures, as it started (LIB-4). */
|
|
23
23
|
recognized?: number;
|
|
24
24
|
/** Begun now by a helper, named when known: the player hears whose plan reads the document, and under whose terms (D-493). */
|
|
25
|
-
helper?: "Claude Code" | "Codex" | "a helper";
|
|
25
|
+
helper?: "Claude Code" | "Codex" | "OpenCode" | "a helper";
|
|
26
26
|
}
|
|
27
27
|
export declare const importCommand: import("../../core/registry.ts").Command<z.ZodObject<{
|
|
28
28
|
document: z.ZodOptional<z.ZodString>;
|
|
@@ -374,6 +374,11 @@ function helperText(helper) {
|
|
|
374
374
|
if (helper === undefined) {
|
|
375
375
|
return "";
|
|
376
376
|
}
|
|
377
|
+
// OpenCode reads with the model the player chose in it, whose maker is the one the document goes to.
|
|
378
|
+
if (helper === "OpenCode") {
|
|
379
|
+
return "Tell the player in a few words that their own OpenCode reads it, with the model they last chose in it and on its plan or price, and that the whole document "
|
|
380
|
+
+ "goes to that model's provider, or stays on their computer with a local model, under the terms of their account, its choice on training included.";
|
|
381
|
+
}
|
|
377
382
|
const [program, company] = helper === "Codex" ? ["Codex", "OpenAI"] : helper === "Claude Code" ? ["Claude Code", "Anthropic"] : ["Claude Code or Codex", "Anthropic or OpenAI"];
|
|
378
383
|
return `Tell the player in a few words that their own ${program} reads it, on their plan and its limits, and that the whole document goes to ${company} `
|
|
379
384
|
+ "under the terms of their account, its choice on training included.";
|
package/dist/commands/init.d.ts
CHANGED
package/dist/commands/init.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { basename, resolve } from "node:path";
|
|
2
2
|
import { z } from "zod";
|
|
3
|
-
import { createCampaign, difficulties, lethalities, rememberChoice } from "../campaign/index.js";
|
|
3
|
+
import { createCampaign, difficulties, findCampaign, lethalities, refreshUserHostFiles, rememberChoice, updateHostFiles } from "../campaign/index.js";
|
|
4
4
|
import { appendLogEntry, newLogEntry } from "../core/log.js";
|
|
5
5
|
import { defineCommand } from "../core/registry.js";
|
|
6
6
|
import { hostInstructions } from "../instructions/index.js";
|
|
@@ -11,6 +11,7 @@ export const init = defineCommand({
|
|
|
11
11
|
name: "init",
|
|
12
12
|
description: "Create a new campaign. "
|
|
13
13
|
+ "It writes the settings, the log, the world's folders, and the .mcp.json, AGENTS.md and CLAUDE.md through which an AI host finds these tools. "
|
|
14
|
+
+ "Given the folder of a campaign that exists, it only brings those files up to date. "
|
|
14
15
|
+ "Use it once, when the player starts a new campaign, with master true when you, the AI, create it: the answer then says what is still to agree with the player, to set with config. "
|
|
15
16
|
+ 'Example: name "The Salt Isles", language en.',
|
|
16
17
|
group: "campaign",
|
|
@@ -26,23 +27,40 @@ export const init = defineCommand({
|
|
|
26
27
|
}),
|
|
27
28
|
run(input, context) {
|
|
28
29
|
const folder = resolve(context.folder, input.folder ?? ".");
|
|
30
|
+
// A campaign that exists keeps its settings: only the files through which the hosts find it are brought up to date.
|
|
31
|
+
if (findCampaign(folder) === folder) {
|
|
32
|
+
updateHostFiles(folder, context.platform, hostInstructions());
|
|
33
|
+
return { root: folder, name: "", note: "", already: true, app: refreshUserFiles(context) };
|
|
34
|
+
}
|
|
29
35
|
// Only an installed system (D-167), as it is installed.
|
|
30
36
|
const system = input.system === undefined ? undefined : installedSystemName(input.system, context, "init");
|
|
31
37
|
const settings = { name: input.name ?? basename(folder), language: input.language, system, difficulty: input.difficulty, lethality: input.lethality };
|
|
32
38
|
const root = createCampaign(folder, settings, context.platform, hostInstructions());
|
|
33
39
|
createWorld(root);
|
|
34
40
|
appendLogEntry(root, newLogEntry(context, "campaign-created", "public", settings));
|
|
41
|
+
const app = refreshUserFiles(context);
|
|
35
42
|
// What the next campaign's setup suggests (T-134).
|
|
36
43
|
rememberChoice(context.home, root, "difficulty", settings.difficulty);
|
|
37
44
|
rememberChoice(context.home, root, "lethality", settings.lethality);
|
|
38
|
-
return { root, name: settings.name, note: input.master === true ? campaignNote(root, context) : "" };
|
|
45
|
+
return { root, name: settings.name, note: input.master === true ? campaignNote(root, context) : "", already: false, app };
|
|
39
46
|
},
|
|
40
47
|
// The player reads it, who made the campaign in a terminal: what to do next. What the master still agrees with them only when the master made it (T-185).
|
|
41
48
|
format(result) {
|
|
49
|
+
// Antigravity's own settings, outside the campaign, said apart when they could not be written.
|
|
50
|
+
const app = result.app === undefined ? [] : [result.app];
|
|
51
|
+
if (result.already) {
|
|
52
|
+
// What could not be written is outside the folder: the line says only what is true.
|
|
53
|
+
return [`${result.root} is already a campaign: its files for Claude Code, Codex, Antigravity and OpenCode${app.length > 0 ? " in this folder" : ""} are up to date.`, ...app].join("\n");
|
|
54
|
+
}
|
|
42
55
|
return [
|
|
43
56
|
`Created the campaign "${result.name}" in ${result.root}.`,
|
|
44
|
-
"To play, open Claude Code, Codex or
|
|
57
|
+
"To play, open Claude Code, Codex, Antigravity or OpenCode in this folder and say hello: the master asks you the rest.",
|
|
58
|
+
...app,
|
|
45
59
|
...(result.note === "" ? [] : ["", `For the master: ${result.note}`]),
|
|
46
60
|
].join("\n");
|
|
47
61
|
},
|
|
48
62
|
});
|
|
63
|
+
/** The engine's files in the player's home, as Antigravity's app reads them (D-578), and what could not be written; none where the context has no home, as in the tests. */
|
|
64
|
+
function refreshUserFiles(context) {
|
|
65
|
+
return context.userHome === undefined ? undefined : refreshUserHostFiles(context.userHome, context.platform);
|
|
66
|
+
}
|
|
@@ -55,7 +55,7 @@ const problems = new Map();
|
|
|
55
55
|
/** What the engine writes again whenever it likes, or the player keeps on this computer alone: never in the repository. */
|
|
56
56
|
function alwaysIgnored() {
|
|
57
57
|
// .gemini/ of the campaigns made before D-493, which it leaves on the disk.
|
|
58
|
-
return [".agents/", ".claude/", ".codex/", ".gemini/", ".mcp.json", ...hostFileNames, `${inboxFolderName}/`, `${exportsFolderName}/`, `${importsFolderName}/`, installMarkName, `${savesFolderName}/*.txt`, portFileName];
|
|
58
|
+
return [".agents/", ".claude/", ".codex/", ".gemini/", ".opencode/", ".mcp.json", ...hostFileNames, `${inboxFolderName}/`, `${exportsFolderName}/`, `${importsFolderName}/`, installMarkName, `${savesFolderName}/*.txt`, portFileName];
|
|
59
59
|
}
|
|
60
60
|
function pushesTo(root) {
|
|
61
61
|
try {
|
|
@@ -21,9 +21,11 @@ export function picturesNote(root, context, world, place) {
|
|
|
21
21
|
? `you can make the pictures of places, quests and those met with ${ready.tool}`
|
|
22
22
|
: ready.askTool === true
|
|
23
23
|
? "you can make the pictures of places, quests and those met with the image tool the player names"
|
|
24
|
-
: ready.
|
|
25
|
-
? "you can
|
|
26
|
-
:
|
|
24
|
+
: ready.draws === true
|
|
25
|
+
? "you can draw the pictures of places, quests and those met yourself, as simple vector pictures"
|
|
26
|
+
: ready.maker === "Antigravity"
|
|
27
|
+
? "you can make the pictures of places, quests and those met with your own image tool"
|
|
28
|
+
: `this computer can make the pictures of places, quests and those met with the player's ${ready.maker === "Claude" ? "Claude Code" : "Codex"}`}, which spends their plan: ask them once whether they want one for each new place, quest and one met, only those they ask for, or none; then config pictures (new elements, on request or none).`
|
|
27
29
|
: undefined;
|
|
28
30
|
}
|
|
29
31
|
if (setting !== "new elements" || place === undefined || place.type !== "place" || shownImage(root, context, world, place) !== undefined) {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Context } from "../../../core/context.ts";
|
|
2
|
-
/** Whether the character agent voices the characters (D-490): in Claude Code, in a chat that has it, unless the master voices every character. */
|
|
2
|
+
/** Whether the character agent voices the characters (D-490): in Claude Code or OpenCode, in a chat that has it, unless the master voices every character. */
|
|
3
3
|
export declare function agentVoices(root: string, context: Context): boolean;
|
|
4
|
-
/** The part Voices, when and how to call the character agent, for a campaign in play; none where the agent does not voice the characters. */
|
|
4
|
+
/** The part Voices, when and how to call the character agent, for a campaign in play, with OpenCode's way of calling it there; none where the agent does not voice the characters. */
|
|
5
5
|
export declare function voicesPart(root: string, context: Context): string;
|
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
// Who voices the characters (D-490): the character agent, where the chat has it, or the master.
|
|
2
2
|
import { readSettings } from "../../../campaign/index.js";
|
|
3
3
|
import { voicesInstructions } from "../../../instructions/index.js";
|
|
4
|
-
// The
|
|
4
|
+
// The names Claude Code and OpenCode give themselves to the MCP server: the hosts whose campaign has the character agent as an agent (D-490).
|
|
5
5
|
const claudeCode = "claude-code";
|
|
6
|
-
|
|
6
|
+
const openCode = "opencode";
|
|
7
|
+
/** Whether the character agent voices the characters (D-490): in Claude Code or OpenCode, in a chat that has it, unless the master voices every character. */
|
|
7
8
|
export function agentVoices(root, context) {
|
|
8
|
-
|
|
9
|
+
const host = context.host?.();
|
|
10
|
+
const has = host === claudeCode ? context.characterAgents?.claudeCode : host === openCode ? context.characterAgents?.openCode : false;
|
|
11
|
+
return has === true && readSettings(root).voices !== "master";
|
|
9
12
|
}
|
|
10
|
-
/** The part Voices, when and how to call the character agent, for a campaign in play; none where the agent does not voice the characters. */
|
|
13
|
+
/** The part Voices, when and how to call the character agent, for a campaign in play, with OpenCode's way of calling it there; none where the agent does not voice the characters. */
|
|
11
14
|
export function voicesPart(root, context) {
|
|
12
|
-
return agentVoices(root, context) ? voicesInstructions(readSettings(root).voices ?? "auto") : "";
|
|
15
|
+
return agentVoices(root, context) ? voicesInstructions(readSettings(root).voices ?? "auto", context.host?.() === openCode) : "";
|
|
13
16
|
}
|
package/dist/core/context.d.ts
CHANGED
|
@@ -61,8 +61,11 @@ export interface Context {
|
|
|
61
61
|
files?: FileStore;
|
|
62
62
|
/** The parts of the instructions already given in this chat, which the MCP server keeps until instructions starts over (D-97); without it, every call gives them. */
|
|
63
63
|
told?: Set<string>;
|
|
64
|
-
/** Whether the
|
|
65
|
-
|
|
64
|
+
/** Whether the campaign had the character agent as the MCP server started, as Claude Code's agent and as OpenCode's subagent (D-490): the chat of that host then gets Voices. */
|
|
65
|
+
characterAgents?: {
|
|
66
|
+
claudeCode?: boolean;
|
|
67
|
+
openCode?: boolean;
|
|
68
|
+
};
|
|
66
69
|
/** The link of the player's dashboard, when the MCP server serves one (D-270); status gives it. */
|
|
67
70
|
dashboard?: string;
|
|
68
71
|
/** Whether another chat of the campaign, still open, serves the dashboard at that link, which this chat takes over once it closes (D-577). */
|
|
@@ -79,7 +82,7 @@ export interface Context {
|
|
|
79
82
|
pictures?: PictureMaker;
|
|
80
83
|
/** Lines for the master's next call, as of a picture that came after its call answered (D-572); MCP only. */
|
|
81
84
|
later?: LaterLines;
|
|
82
|
-
/** What writes text from a brief on this computer, outside the chat, as Codex or Claude Code with the player's login (D-406); missing where none can. */
|
|
85
|
+
/** What writes text from a brief on this computer, outside the chat, as Codex or Claude Code with the player's login, or OpenCode in its own chat (D-406); missing where none can. */
|
|
83
86
|
writer?: TextWriter;
|
|
84
87
|
/** A game system's pages translated on this computer as a player first reads them, where the system has no translation of its own (D-539); missing elsewhere. */
|
|
85
88
|
texts?: SystemTexts;
|
|
@@ -98,6 +101,8 @@ export interface Context {
|
|
|
98
101
|
importRunner?: (root: string) => void;
|
|
99
102
|
/** The folder of this player's data on this computer, apart from any campaign: the page's words translated on the fly (D-406). */
|
|
100
103
|
home?: string;
|
|
104
|
+
/** The user's own home on this computer, where an AI app keeps its settings for every folder, as Antigravity's (D-578); missing in tests. */
|
|
105
|
+
userHome?: string;
|
|
101
106
|
/** The folder of the dashboard's built page, whose i18n/ lists every phrase it has (D-423). */
|
|
102
107
|
pageFolder?: string;
|
|
103
108
|
/** Codex and Claude Code on this computer, installed and signed in with the player's yes (D-424); missing outside the MCP server, as in tests. */
|
|
@@ -223,11 +228,12 @@ export type HelperLogin = {
|
|
|
223
228
|
};
|
|
224
229
|
/**
|
|
225
230
|
* The chat of an MCP server, kept across its calls: the master's calls running now, the Codex thread of the last one, and what the dashboard does as each
|
|
226
|
-
* ends (D-495); whether status has already had the master offer the dashboard, as its first does (D-353).
|
|
231
|
+
* begins and ends (D-495); whether status has already had the master offer the dashboard, as its first does (D-353).
|
|
227
232
|
*/
|
|
228
233
|
export interface ChatState {
|
|
229
234
|
calls: number;
|
|
230
235
|
thread?: string;
|
|
236
|
+
beforeCall?: () => void;
|
|
231
237
|
afterCall?: () => void;
|
|
232
238
|
dashboardOffered?: boolean;
|
|
233
239
|
}
|
|
@@ -248,7 +254,7 @@ export interface TextWriter {
|
|
|
248
254
|
export interface DocumentReader {
|
|
249
255
|
ready(): boolean;
|
|
250
256
|
/** The program that would read now, which the player is told the document goes to (D-493). */
|
|
251
|
-
program?(): "Claude Code" | "Codex" | undefined;
|
|
257
|
+
program?(): "Claude Code" | "Codex" | "OpenCode" | undefined;
|
|
252
258
|
/** One run: the brief on its input, reading only in `folder` and writing only in its `writable` subfolders; its last words, or why it stopped. Stopped by `signal`. */
|
|
253
259
|
read(folder: string, brief: string, writable: string[], signal?: AbortSignal): Promise<{
|
|
254
260
|
said: string;
|
|
@@ -259,13 +265,14 @@ export interface DocumentReader {
|
|
|
259
265
|
/**
|
|
260
266
|
* Whether pictures can be made here, or why not, in words the master can tell the player, and in the player's own with the steps to have them, one a line,
|
|
261
267
|
* numbered, with the commands between backticks (D-341). Ready, who makes them, as Codex, Claude or Antigravity, and the master's own image tool it names, as
|
|
262
|
-
* ElevenLabs, or that the player is to name it (D-572).
|
|
268
|
+
* ElevenLabs, or that the player is to name it, or that the chat draws them itself as SVG code (D-572).
|
|
263
269
|
*/
|
|
264
270
|
export type PicturesReady = {
|
|
265
271
|
ready: true;
|
|
266
272
|
maker?: string;
|
|
267
273
|
tool?: string;
|
|
268
274
|
askTool?: true;
|
|
275
|
+
draws?: true;
|
|
269
276
|
instead?: PictureFallback;
|
|
270
277
|
} | {
|
|
271
278
|
ready: false;
|
|
@@ -406,3 +413,5 @@ export declare function defaultContext(folder?: string): Context;
|
|
|
406
413
|
export declare const engineSystemsFolder: string;
|
|
407
414
|
/** Where the engine installs the packages, with npm, on this computer (D-436): the player's local data, beside the programs it installs (D-425). */
|
|
408
415
|
export declare function packagesFolder(): string;
|
|
416
|
+
/** Where this player's data is kept on this computer (D-406): the folder the system gives a program's data. */
|
|
417
|
+
export declare function userDataFolder(): string;
|
package/dist/core/context.js
CHANGED
|
@@ -18,6 +18,7 @@ export function defaultContext(folder = process.cwd()) {
|
|
|
18
18
|
extensionFolders: [join(packagesFolder(), "node_modules")],
|
|
19
19
|
unpacked: join(packagesFolder(), "unpacked"),
|
|
20
20
|
home: userDataFolder(),
|
|
21
|
+
userHome: homedir(),
|
|
21
22
|
bookIndex: join(dirname(packagesFolder()), "library"),
|
|
22
23
|
// The built page is in dist/dashboard, two levels up from src/core/ and from dist/core/ alike.
|
|
23
24
|
pageFolder: fileURLToPath(new URL("../../dist/dashboard/", import.meta.url)),
|
|
@@ -36,7 +37,7 @@ export function packagesFolder() {
|
|
|
36
37
|
: join(process.env.XDG_DATA_HOME || join(home, ".local", "share"), "rpg-engine", "packages");
|
|
37
38
|
}
|
|
38
39
|
/** Where this player's data is kept on this computer (D-406): the folder the system gives a program's data. */
|
|
39
|
-
function userDataFolder() {
|
|
40
|
+
export function userDataFolder() {
|
|
40
41
|
const home = homedir();
|
|
41
42
|
if (process.platform === "win32") {
|
|
42
43
|
return join(process.env.APPDATA || join(home, "AppData", "Roaming"), "rpg-engine");
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: الدليل الكامل
|
|
3
3
|
|
|
4
4
|
يتيح لك **RPG Engine** لعب لعبة أدوار على الطاولة مع **ذكاء اصطناعي في دور مدير اللعبة**. تتحدث مع مدير اللعبة في **محادثة**. أما RPG Engine فيعمل خلف الكواليس: **يتذكر العالم**، و**يرمي النرد**، و**يمسك الحسابات**. بجانب المحادثة تُبقي صفحة مفتوحة في المتصفح، هي **لوحة التحكم**، وفيها ورقة شخصيتك والنرد والخرائط وسجلك.
|
|
@@ -64,12 +64,15 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 ربط الذكاء الاصطناعي
|
|
66
66
|
|
|
67
|
-
يعمل مدير اللعبة داخل **وكيل ذكاء اصطناعي**. هو تطبيق ذكاء اصطناعي، في الطرفية أو على سطح المكتب، يستطيع العمل مع الملفات على حاسوبك، مثل Claude Code أو Codex أو Antigravity. الدردشة العادية مثل claude.ai أو ChatGPT، أو تطبيق الهاتف، لا تكفي. فمدير اللعبة يحتاج إلى الوصول إلى ملفات الحملة على حاسوبك. لكل وكيل خطته وتسجيل دخوله: Claude Code يحتاج إلى خطة Claude مدفوعة، وCodex إلى تسجيل دخول ChatGPT، وAntigravity إلى حساب Google، وخطته المجانية حصتها الأسبوعية صغيرة. تثبّت الوكيل مرة واحدة، من صفحته: [Claude Code](https://code.claude.com/docs/en/setup)، [Codex](https://developers.openai.com/codex)، [Antigravity](https://antigravity.google).
|
|
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
69
|
- **Claude Code**: في مجلد الحملة اكتب `claude`. عندما يسأل هل تثق بالمجلد، اختر **Yes, I trust this folder**. انتبه: الجواب المحدد مسبقًا هو *No, exit*. في الحملة أيضًا خطّاف صغير، `rpg --listen`، لا يظهر في هذا السؤال. وهو يخبر مدير اللعبة فورًا حين تتصرف من لوحة المتابعة.
|
|
70
70
|
- **Codex**: في مجلد الحملة اكتب `codex`، ووافق عندما يسأل هل تثق بالمجلد. وفي تطبيقه المكتبي، تأكد من الإعدادات أن الذاكرة معطلة لدردشات اللعبة.
|
|
71
|
-
- **Antigravity**: في مجلد الحملة اكتب `agy`، ووافق إن سأل هل تثق بالمجلد. في الحملة
|
|
72
|
-
-
|
|
71
|
+
- **Antigravity**: في مجلد الحملة اكتب `agy`، ووافق إن سأل هل تثق بالمجلد. أو افتح مجلد الحملة من تطبيقه. وللتطبيق يضيف RPG Engine نفسه أيضًا إلى إعدادات Antigravity الخاصة، في الملف `.gemini/config/mcp_config.json` داخل مجلدك الشخصي. وهذه الإعدادات تسري على كل مجلد تفتحه، لا على مجلد الحملة وحده. أما خارج الحملة فلا يفعل شيئًا. في الحملة خطّافان صغيران: `rpg --approve` يتيح لمدير اللعبة استخدام أدوات RPG Engine دون أن يسألك في كل مرة، و`rpg --listen` يخبر مدير اللعبة فورًا حين تتصرف من لوحة المتابعة. ويرسم مدير اللعبة الصور في الدردشة نفسها. وإذا تعطلت أداة الصور لديه، رسم صورًا متجهية بسيطة، كما يفعل Claude. يحتفظ Antigravity بدردشاتك السابقة، ولا يمكن إيقاف ذاكرته. لذلك أُمر مدير اللعبة ألا يقرأها أبدًا. ما تكتبه يذهب إلى Google، وقد يقرؤه بشر. أبعد البيانات الشخصية عن اللعبة. RPG Engine ليس منتجًا من Google.
|
|
72
|
+
- **OpenCode**: في مجلد الحملة اكتب `opencode`. في الحملة إضافة صغيرة، `.opencode/plugins/rpg.js`، تخبر مدير اللعبة فورًا حين تتصرف من لوحة المتابعة. وفي الحملة يكتب مدير اللعبة الملفات عبر RPG Engine وحده: كتابة OpenCode الخاصة للملفات وتحريرها معطّلة هناك، ويسألك OpenCode قبل أن ينفّذ أي أمر. ويرسم مدير اللعبة الصور بنفسه، صورًا متجهية بسيطة، كما يفعل Claude. ويترجم OpenCode لديك، بالنموذج الذي اخترته فيه آخر مرة، لوحة المتابعة وقواعد اللعبة أيضًا، ويقرأ المستندات التي تستوردها، خارج الدردشة. وإن لم يكن لديه نموذج يستطيع استخدامه، فيتولى ذلك Codex أو Claude Code إن كانا لديك.
|
|
73
|
+
- **وكيل آخر**: شغّله في مجلد الحملة وأعطه خادم MCP بالأمر `rpg mcp`. RPG Engine خادم MCP قياسي، وأي وكيل يدعم MCP يمكن أن يكون مدير اللعبة، ومنه الوكلاء المحليون.
|
|
74
|
+
|
|
75
|
+
إذا قال مدير اللعبة إنه لا يجد أدوات RPG Engine، فاكتب `rpg init` في مجلد الحملة. في مجلد هو حملة أصلًا، لا يفعل هذا الأمر سوى تحديث هذه الملفات. ثم افتح دردشة جديدة.
|
|
73
76
|
|
|
74
77
|
نلعب ونختبر مع **Claude Code**. أما **Codex** و**Antigravity** فهما مربوطان ومفحوصان، لكن لم تُلعب معهما حملة كاملة بعد. تعطّل الحملة ذاكرة الوكيل الخاصة، فاللعبة تعيش في ملفاتها، وبذلك تعيدك العودة إلى نقطة حفظ إلى ما كانت عليه فعلًا.
|
|
75
78
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: kompletní průvodce
|
|
3
3
|
|
|
4
4
|
**RPG Engine** ti umožní hrát stolní hru na hrdiny s **AI jako Pánem jeskyně**. S Pánem jeskyně si povídáš v **chatu**. RPG Engine pracuje v pozadí: **pamatuje si svět**, **hází kostkami** a **vede účty**. Vedle chatu máš v prohlížeči otevřenou stránku, **dashboard**, s deníkem postavy, kostkami, mapami a kronikou.
|
|
@@ -64,13 +64,16 @@ Pán jeskyně kampaň za tebe vytvořit nemůže: před příkazem `init` nic ne
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Připojení AI
|
|
66
66
|
|
|
67
|
-
Pán jeskyně běží v **AI agentovi**: je to AI aplikace, v terminálu nebo na ploše, která umí pracovat se soubory v tvém počítači, například Claude Code, Codex nebo
|
|
67
|
+
Pán jeskyně běží v **AI agentovi**: je to AI aplikace, v terminálu nebo na ploše, která umí pracovat se soubory v tvém počítači, například Claude Code, Codex, Antigravity nebo OpenCode. Obyčejný chat jako claude.ai nebo ChatGPT, případně aplikace v telefonu, nestačí: Pán jeskyně se musí dostat k souborům kampaně v tvém počítači. Každý agent potřebuje vlastní tarif a přihlášení: Claude Code placený tarif Claude, Codex přihlášení do ChatGPT, Antigravity účet Google, jehož bezplatný tarif má malou týdenní kvótu. OpenCode funguje s modely, které mu zadáš, včetně lokálních. Nainstaluješ ho jednou, z jeho vlastní stránky: [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**: ve složce kampaně napiš `claude`. Když se zeptá, jestli složce důvěřuješ, zvol **Yes, I trust this folder**. Pozor, předvolená odpověď je *No, exit*. Kampaň má také malý hook, `rpg --listen`, který otázka neukazuje: okamžitě sdělí Pánu jeskyně, když něco uděláš na dashboardu.
|
|
70
70
|
- **Codex**: ve složce kampaně napiš `codex` a na otázku, jestli složce důvěřuješ, odpověz ano. V jeho desktopové aplikaci zkontroluj v nastavení, že jsou paměti pro chaty hry vypnuté.
|
|
71
|
-
- **Antigravity**: ve složce kampaně napiš `agy` a pokud se zeptá, jestli složce důvěřuješ, odpověz ano. Kampaň má
|
|
71
|
+
- **Antigravity**: ve složce kampaně napiš `agy` a pokud se zeptá, jestli složce důvěřuješ, odpověz ano; nebo v jeho aplikaci otevři složku kampaně. Pro aplikaci se RPG Engine také sám přidá do vlastního nastavení Antigravity, `.gemini/config/mcp_config.json` ve tvé domovské složce, které platí pro každou složku, kterou otevřeš, nejen pro složku kampaně: mimo kampaň nedělá nic. Kampaň má dva malé hooky: `rpg --approve` dovolí Pánu jeskyně používat nástroje RPG Engine, aniž by se tě na to pokaždé ptal, a `rpg --listen` okamžitě sdělí Pánu jeskyně, když něco uděláš na dashboardu. Obrázky v chatu maluje Pán jeskyně sám. Když selže jeho nástroj na obrázky, nakreslí jednoduché vektorové obrázky, stejně jako Claude. Antigravity uchovává tvoje dřívější chaty a jeho paměť nejde vypnout: Pán jeskyně má pokyn, aby je nikdy nečetl. Co napíšeš, jde do Googlu, kde to mohou číst lidé: nevkládej do hry osobní údaje. RPG Engine není produkt Googlu.
|
|
72
|
+
- **OpenCode**: ve složce kampaně napiš `opencode`. Kampaň má malý plugin, `.opencode/plugins/rpg.js`, který okamžitě sdělí Pánu jeskyně, když něco uděláš na dashboardu. V kampani Pán jeskyně zapisuje soubory jen přes RPG Engine: vlastní zapisování a úpravy souborů v OpenCode jsou tam vypnuté a před spuštěním příkazu se tě zeptá. Obrázky kreslí Pán jeskyně sám, jako jednoduché vektorové obrázky, stejně jako Claude. Tvůj OpenCode s modelem, který jsi v něm naposledy zvolil(a), také mimo chat překládá dashboard a pravidla hry a čte dokumenty, které importuješ. Pokud nemá model, který může použít, udělá to Codex nebo Claude Code, pokud je máš.
|
|
72
73
|
- **Jiný agent**: spusť ho ve složce kampaně a připoj k němu server MCP `rpg mcp`. RPG Engine je standardní server MCP: Pánem jeskyně může být každý agent, který MCP podporuje, i lokální.
|
|
73
74
|
|
|
75
|
+
Pokud Pán jeskyně řekne, že nemůže najít nástroje RPG Engine, napiš ve složce kampaně `rpg init`: ve složce, která už je kampaní, pouze aktualizuje tyto soubory. Potom otevři nový chat.
|
|
76
|
+
|
|
74
77
|
Hrajeme a testujeme s **Claude Code**. **Codex** a **Antigravity** jsou připojené a ověřené, ale zatím se s nimi neodehrála celá kampaň. Kampaň vypíná vlastní paměť agenta: hra žije v jeho souborech, aby návrat k uložené hře opravdu vrátil zpět.
|
|
75
78
|
|
|
76
79
|
### 2.5 První chat
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: den komplette guide
|
|
3
3
|
|
|
4
4
|
**RPG Engine** lader dig spille et bordrollespil med **en AI som spilleder**. Du taler med spillederen i en **chat**. RPG Engine arbejder i baggrunden: det **husker verdenen**, **slår med terningerne** og **fører regnskabet**. Ved siden af chatten har du en side åben i din browser, **dashboardet**, med dit karakterark, terningerne, kortene og din dagbog.
|
|
@@ -64,13 +64,16 @@ Spilleder kan ikke oprette en kampagne for dig: før `init` fortæller intet din
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Forbind din AI
|
|
66
66
|
|
|
67
|
-
Spillederen kører i en **AI-agent**: en AI-app i terminalen eller på skrivebordet, som kan arbejde med filerne på din computer, for eksempel Claude Code, Codex eller
|
|
67
|
+
Spillederen kører i en **AI-agent**: en AI-app i terminalen eller på skrivebordet, som kan arbejde med filerne på din computer, for eksempel Claude Code, Codex, Antigravity eller OpenCode. En almindelig chat som claude.ai eller ChatGPT eller en app på telefonen rækker ikke: spillederen skal kunne nå kampagnens filer på din computer. Hver agent kræver sit eget abonnement og login: Claude Code et betalt Claude-abonnement, Codex et ChatGPT-login, Antigravity en Google-konto, hvis gratis abonnement har en lille ugentlig kvote. OpenCode virker med de modeller, du giver den, også lokale. Du installerer den én gang fra dens egen side: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: skriv `claude` i kampagnemappen. Når den spørger, om du stoler på mappen, så vælg **Yes, I trust this folder**. Pas på: det svar, der er valgt på forhånd, er *No, exit*. Kampagnen har også en lille hook, `rpg --listen`, som spørgsmålet ikke viser: den fortæller straks spillederen, når du handler fra dashboardet.
|
|
70
70
|
- **Codex**: skriv `codex` i kampagnemappen, og sig ja, når den spørger, om du stoler på mappen. I dens desktop-app skal du under indstillinger tjekke, at hukommelser er slået fra for spillets chats.
|
|
71
|
-
- **Antigravity**: skriv `agy` i kampagnemappen, og sig ja, hvis den spørger, om du stoler på mappen. Kampagnen har
|
|
71
|
+
- **Antigravity**: skriv `agy` i kampagnemappen, og sig ja, hvis den spørger, om du stoler på mappen. Eller åbn kampagnemappen i dens app. Til appen tilføjer RPG Engine sig også selv til Antigravitys egne indstillinger, `.gemini/config/mcp_config.json` i din hjemmemappe. De gælder for hver mappe, du åbner, ikke kun kampagnens: uden for en kampagne gør RPG Engine ingenting. Kampagnen har to små hooks: `rpg --approve` lader spillederen bruge RPG Engines værktøjer uden at spørge dig hver gang, og `rpg --listen` fortæller straks spillederen, når du handler fra dashboardet. Spillederen maler billederne i selve chatten. Når spillederens billedværktøj fejler, tegner spillederen enkle vektorbilleder, som Claude gør. Antigravity gemmer dine tidligere chats, og dens hukommelse kan ikke slås fra: spillederen er blevet bedt om aldrig at læse dem. Det, du skriver, går til Google, som kan lade mennesker læse det: hold personlige oplysninger ude af spillet. RPG Engine er ikke et Google-produkt.
|
|
72
|
+
- **OpenCode**: skriv `opencode` i kampagnemappen. Kampagnen har et lille plugin, `.opencode/plugins/rpg.js`, som straks fortæller spillederen, når du handler fra dashboardet. I kampagnen skriver spillederen kun filer gennem RPG Engine: OpenCodes egen skrivning og redigering af filer er slået fra der, og den spørger dig, før den kører en kommando. Spillederen tegner billederne selv som enkle vektorbilleder, som Claude gør. Din OpenCode oversætter, med den model, du sidst har valgt i den, også dashboardet og spillets regler og læser de dokumenter, du importerer, uden for chatten. Har den ingen model, den kan bruge, gør Codex eller Claude Code det, hvis du har dem.
|
|
72
73
|
- **En anden agent**: start den i kampagnemappen, og giv den MCP-serveren `rpg mcp`. RPG Engine er en standard MCP-server: enhver agent, der understøtter MCP, kan være spilleder, også lokale.
|
|
73
74
|
|
|
75
|
+
Hvis spillederen siger, at den ikke kan finde RPG Engines værktøjer, så skriv `rpg init` i kampagnemappen. I en mappe, der allerede er en kampagne, opdaterer den kun disse filer. Åbn derefter en ny chat.
|
|
76
|
+
|
|
74
77
|
Vi spiller og tester med **Claude Code**. **Codex** og **Antigravity** er forbundet og kontrolleret, men der er endnu ikke spillet en hel kampagne med dem. Kampagnen slår agentens egen hukommelse fra: spillet bor i dets filer, så et gemt spil virkelig går tilbage i tiden.
|
|
75
78
|
|
|
76
79
|
### 2.5 Den første chat
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: der komplette Leitfaden
|
|
3
3
|
|
|
4
4
|
**RPG Engine** lässt dich ein Pen-&-Paper-Rollenspiel mit einer **KI als Spielleitung** spielen. Du sprichst mit der Spielleitung in einem **Chat**; RPG Engine arbeitet im Hintergrund: Es **merkt sich die Welt**, **würfelt** und **führt Buch**. Neben dem Chat hältst du im Browser eine Seite offen, das **Dashboard**, mit deinem Charakterbogen, den Würfeln, den Karten und deinem Tagebuch.
|
|
@@ -64,13 +64,16 @@ Die Spielleitung kann keine Kampagne für dich anlegen: Vor `init` sagt nichts d
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Deine KI verbinden
|
|
66
66
|
|
|
67
|
-
Die Spielleitung läuft in einem **KI-Agenten**: einer KI-App im Terminal oder auf dem Desktop, die mit den Dateien auf deinem Computer arbeiten kann, zum Beispiel Claude Code, Codex oder
|
|
67
|
+
Die Spielleitung läuft in einem **KI-Agenten**: einer KI-App im Terminal oder auf dem Desktop, die mit den Dateien auf deinem Computer arbeiten kann, zum Beispiel Claude Code, Codex, Antigravity oder OpenCode. Ein einfacher Chat wie claude.ai oder ChatGPT oder eine Handy-App reicht nicht: Die Spielleitung muss die Dateien der Kampagne auf deinem Computer erreichen können. Jeder Agent braucht seinen eigenen Tarif und sein eigenes Login: Claude Code einen bezahlten Claude-Tarif, Codex ein ChatGPT-Login, Antigravity ein Google-Konto, dessen kostenloser Tarif ein kleines Wochenkontingent hat. OpenCode funktioniert mit den Modellen, die du ihm gibst, auch mit lokalen. Du installierst ihn einmal, über seine eigene Seite: [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**: Schreibe im Kampagnenordner `claude`. Wenn es fragt, ob du dem Ordner vertraust, wähle **Yes, I trust this folder**. Vorsicht: Die vorausgewählte Antwort ist *No, exit*. Die Kampagne hat außerdem einen kleinen Hook, `rpg --listen`, den die Frage nicht zeigt: Er sagt der Spielleitung sofort Bescheid, wenn du im Dashboard etwas tust.
|
|
70
70
|
- **Codex**: Schreibe im Kampagnenordner `codex` und antworte mit Ja, wenn es fragt, ob du dem Ordner vertraust. Prüfe in der Desktop-App in den Einstellungen, dass die Erinnerungen für die Chats des Spiels ausgeschaltet sind.
|
|
71
|
-
- **Antigravity**: Schreibe im Kampagnenordner `agy` und antworte mit Ja, wenn es fragt, ob du dem Ordner vertraust. Die Kampagne hat
|
|
71
|
+
- **Antigravity**: Schreibe im Kampagnenordner `agy` und antworte mit Ja, wenn es fragt, ob du dem Ordner vertraust. Oder öffne in der App den Kampagnenordner. Für die App trägt sich RPG Engine außerdem in die eigenen Einstellungen von Antigravity ein, `.gemini/config/mcp_config.json` in deinem Home-Verzeichnis. Sie gelten für jeden Ordner, den du öffnest, nicht nur für den der Kampagne: Außerhalb einer Kampagne tut RPG Engine dann nichts. Die Kampagne hat zwei kleine Hooks: `rpg --approve` erlaubt der Spielleitung, die Werkzeuge von RPG Engine zu nutzen, ohne jedes Mal bei dir nachzufragen, und `rpg --listen` sagt der Spielleitung sofort Bescheid, wenn du im Dashboard etwas tust. Die Spielleitung malt die Bilder selbst im Chat. Wenn ihr Bildwerkzeug ausfällt, zeichnet sie einfache Vektorbilder, wie Claude es tut. Antigravity behält deine bisherigen Chats, und sein Speicher lässt sich nicht ausschalten: Die Spielleitung hat die Anweisung, sie nie zu lesen. Was du schreibst, geht an Google, wo es unter Umständen von Menschen gelesen wird: Gib keine persönlichen Daten ins Spiel ein. RPG Engine ist kein Produkt von Google.
|
|
72
|
+
- **OpenCode**: Schreibe im Kampagnenordner `opencode`. Die Kampagne hat ein kleines Plugin, `.opencode/plugins/rpg.js`, das der Spielleitung sofort Bescheid sagt, wenn du im Dashboard etwas tust. In der Kampagne schreibt die Spielleitung Dateien nur über RPG Engine: Das eigene Schreiben und Bearbeiten von Dateien ist in OpenCode dort ausgeschaltet, und es fragt dich, bevor es einen Befehl ausführt. Die Spielleitung zeichnet die Bilder selbst, als einfache Vektorbilder, wie Claude es tut. Dein OpenCode übersetzt außerdem mit dem Modell, das du zuletzt darin gewählt hast, das Dashboard und die Regeln des Spiels und liest die Dokumente, die du importierst, außerhalb des Chats. Hat es kein nutzbares Modell, übernehmen Codex oder Claude Code das, wenn du sie hast.
|
|
72
73
|
- **Ein anderer Agent**: Starte ihn im Kampagnenordner und gib ihm den MCP-Server `rpg mcp`. RPG Engine ist ein Standard-MCP-Server: Jeder Agent, der MCP unterstützt, kann die Spielleitung sein, auch lokale.
|
|
73
74
|
|
|
75
|
+
Wenn die Spielleitung sagt, dass sie die Werkzeuge von RPG Engine nicht finden kann, schreibe `rpg init` im Kampagnenordner: In einem Ordner, der schon eine Kampagne ist, bringt es nur diese Dateien auf den neuesten Stand. Öffne danach einen neuen Chat.
|
|
76
|
+
|
|
74
77
|
Wir spielen und testen mit **Claude Code**. **Codex** und **Antigravity** sind angebunden und geprüft, aber es wurde noch keine ganze Kampagne damit gespielt. Die Kampagne schaltet den eigenen Speicher des Agenten ab: Das Spiel lebt in seinen Dateien, damit die Rückkehr zu einem Spielstand wirklich zurückführt.
|
|
75
78
|
|
|
76
79
|
### 2.5 Der erste Chat
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: ο πλήρης οδηγός
|
|
3
3
|
|
|
4
4
|
Το **RPG Engine** σου επιτρέπει να παίξεις ένα επιτραπέζιο παιχνίδι ρόλων με μια **τεχνητή νοημοσύνη ως αφηγητή**. Μιλάς με τον αφηγητή σε μια **συνομιλία**. Το RPG Engine δουλεύει στο παρασκήνιο: **θυμάται τον κόσμο**, **ρίχνει τα ζάρια** και **κρατά τους λογαριασμούς**. Δίπλα στη συνομιλία κρατάς ανοιχτή μια σελίδα στον περιηγητή σου, τον **πίνακα ελέγχου**, με το φύλλο χαρακτήρα, τα ζάρια, τους χάρτες και το ημερολόγιό σου.
|
|
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Σύνδεση του AI
|
|
66
66
|
|
|
67
|
-
Ο αφηγητής τρέχει μέσα σε έναν **πράκτορα ΤΝ**: μια εφαρμογή ΤΝ, στο τερματικό ή στην επιφάνεια εργασίας, που μπορεί να δουλεύει με τα αρχεία του υπολογιστή σου, όπως το Claude Code, το Codex ή το
|
|
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
69
|
- **Claude Code**: στον φάκελο της καμπάνιας γράψε `claude`. Όταν ρωτήσει αν εμπιστεύεσαι τον φάκελο, διάλεξε **Yes, I trust this folder**· πρόσεξε, η απάντηση που είναι ήδη επιλεγμένη είναι *No, exit*. Η καμπάνια έχει και ένα μικρό hook, το `rpg --listen`, που η ερώτηση δεν το δείχνει: ενημερώνει αμέσως τον αφηγητή όταν κάνεις κάτι από το ταμπλό.
|
|
70
70
|
- **Codex**: στον φάκελο της καμπάνιας γράψε `codex` και απάντησε ναι όταν ρωτήσει αν εμπιστεύεσαι τον φάκελο. Στην εφαρμογή του για υπολογιστή, έλεγξε στις ρυθμίσεις ότι οι μνήμες είναι απενεργοποιημένες για τις συνομιλίες του παιχνιδιού.
|
|
71
|
-
- **Antigravity**: στον φάκελο της καμπάνιας γράψε `agy` και απάντησε ναι αν ρωτήσει αν εμπιστεύεσαι τον
|
|
71
|
+
- **Antigravity**: στον φάκελο της καμπάνιας γράψε `agy` και απάντησε ναι αν ρωτήσει αν εμπιστεύεσαι τον φάκελο· ή, στην εφαρμογή του, άνοιξε τον φάκελο της καμπάνιας. Για την εφαρμογή, το RPG Engine προσθέτει τον εαυτό του και στις δικές ρυθμίσεις του Antigravity, `.gemini/config/mcp_config.json` στον αρχικό σου φάκελο, που ισχύουν για κάθε φάκελο που ανοίγεις, όχι μόνο για της καμπάνιας: έξω από μια καμπάνια δεν κάνει τίποτα. Η καμπάνια έχει δύο μικρά hook: το `rpg --approve` επιτρέπει στον αφηγητή να χρησιμοποιεί τα εργαλεία του RPG Engine χωρίς να σε ρωτά κάθε φορά και το `rpg --listen` ενημερώνει αμέσως τον αφηγητή όταν κάνεις κάτι από το ταμπλό. Τις εικόνες τις ζωγραφίζει ο ίδιος ο αφηγητής μέσα στη συνομιλία· όταν το εργαλείο εικόνας του αποτυγχάνει, σχεδιάζει απλές διανυσματικές εικόνες, όπως κάνει το Claude. Το Antigravity κρατά τις προηγούμενες συνομιλίες σου και η μνήμη του δεν μπορεί να απενεργοποιηθεί: ο αφηγητής έχει εντολή να μην τις διαβάζει ποτέ. Ό,τι γράφεις πηγαίνει στη Google, που μπορεί να το διαβάζουν άνθρωποι: κράτα τα προσωπικά δεδομένα έξω από το παιχνίδι. Το RPG Engine δεν είναι προϊόν της Google.
|
|
72
|
+
- **OpenCode**: στον φάκελο της καμπάνιας γράψε `opencode`. Η καμπάνια έχει ένα μικρό πρόσθετο, το `.opencode/plugins/rpg.js`, που ενημερώνει αμέσως τον αφηγητή όταν κάνεις κάτι από το ταμπλό. Στην καμπάνια ο αφηγητής γράφει αρχεία μόνο μέσω του RPG Engine: η δική του εγγραφή και επεξεργασία αρχείων στο OpenCode είναι απενεργοποιημένη εκεί και σε ρωτά πριν εκτελέσει μια εντολή. Τις εικόνες τις σχεδιάζει ο ίδιος ο αφηγητής, ως απλές διανυσματικές εικόνες, όπως κάνει το Claude. Το OpenCode σου, με το μοντέλο που διάλεξες τελευταία σε αυτό, μεταφράζει επίσης το ταμπλό και τους κανόνες του παιχνιδιού και διαβάζει τα έγγραφα που εισάγεις, εκτός συνομιλίας· αν δεν υπάρχει μοντέλο που μπορεί να χρησιμοποιήσει, το κάνουν το Codex ή το Claude Code, αν τα έχεις.
|
|
72
73
|
- **Άλλος πράκτορας**: ξεκίνησέ τον στον φάκελο της καμπάνιας και δώσε του τον διακομιστή MCP `rpg mcp`. Το RPG Engine είναι ένας τυπικός διακομιστής MCP: κάθε πράκτορας που υποστηρίζει MCP μπορεί να γίνει αφηγητής, ακόμα και τοπικός.
|
|
73
74
|
|
|
75
|
+
Αν ο αφηγητής πει ότι δεν βρίσκει τα εργαλεία του RPG Engine, γράψε `rpg init` στον φάκελο της καμπάνιας: σε έναν φάκελο που είναι ήδη καμπάνια, απλώς ενημερώνει αυτά τα αρχεία· μετά άνοιξε μια νέα συνομιλία.
|
|
76
|
+
|
|
74
77
|
Εμείς παίζουμε και δοκιμάζουμε με το **Claude Code**· το **Codex** και το **Antigravity** είναι συνδεδεμένα και ελεγμένα, αλλά δεν έχει παιχτεί ακόμα ολόκληρη καμπάνια με αυτά. Η καμπάνια απενεργοποιεί τη δική της μνήμη του πράκτορα: το παιχνίδι ζει στα αρχεία του, ώστε η επιστροφή σε μια αποθήκευση να γυρίζει πραγματικά πίσω.
|
|
75
78
|
|
|
76
79
|
### 2.5 Η πρώτη συνομιλία
|
|
@@ -63,13 +63,16 @@ The master cannot create a campaign for you: before `init`, nothing tells your a
|
|
|
63
63
|
|
|
64
64
|
### 2.4 Connect your AI
|
|
65
65
|
|
|
66
|
-
The master runs in an **AI agent**: an AI app, in the terminal or on the desktop, that can work with the files on your computer, such as Claude Code, Codex or
|
|
66
|
+
The master runs in an **AI agent**: an AI app, in the terminal or on the desktop, that can work with the files on your computer, such as Claude Code, Codex, Antigravity or OpenCode. A plain chat such as claude.ai or ChatGPT, or a phone app, is not enough: the master needs to reach the campaign's files on your computer. Each agent needs its own plan and login: Claude Code a paid Claude plan, Codex a ChatGPT login, Antigravity a Google account, whose free plan has a small weekly quota; OpenCode works with the models you give it, local ones included. You install it once, from its own page: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
67
67
|
|
|
68
68
|
- **Claude Code**: in the campaign folder write `claude`. When it asks whether you trust the folder, choose **Yes, I trust this folder**; careful, the answer already selected is *No, exit*. The campaign also has a small hook, `rpg --listen`, which the question does not show: it tells the master at once when you act from the dashboard.
|
|
69
69
|
- **Codex**: in the campaign folder write `codex`, and say yes when it asks whether you trust the folder. In its desktop app, check in the settings that memories are off for the game's chats.
|
|
70
|
-
- **Antigravity**: in the campaign folder write `agy`, and say yes if it asks whether you trust the folder. The campaign has
|
|
70
|
+
- **Antigravity**: in the campaign folder write `agy`, and say yes if it asks whether you trust the folder; or, in its app, open the campaign folder. For the app, RPG Engine also adds itself to Antigravity's own settings, `.gemini/config/mcp_config.json` in your home, which hold for every folder you open, not only the campaign's: outside a campaign it does nothing. The campaign has two small hooks: `rpg --approve` lets the master use RPG Engine's tools without asking you each time, and `rpg --listen` tells the master at once when you act from the dashboard. The master paints the pictures in the chat itself; when its image tool fails, it draws simple vector pictures, as Claude does. Antigravity keeps your past chats, and its memory cannot be turned off: the master is told never to read them. What you write goes to Google, which may have people read it: keep personal data out of the game. RPG Engine is not a Google product.
|
|
71
|
+
- **OpenCode**: in the campaign folder write `opencode`. The campaign has a small plugin, `.opencode/plugins/rpg.js`, that tells the master at once when you act from the dashboard. In the campaign the master writes files only through RPG Engine: OpenCode's own writing and editing of files is turned off there, and it asks you before it runs a command. The master draws the pictures itself, as simple vector pictures, as Claude does. Your OpenCode, with the model you last chose in it, also translates the dashboard and the game's rules and reads the documents you import, outside the chat; without a model it can use, Codex or Claude Code do it if you have them.
|
|
71
72
|
- **Another agent**: start it in the campaign folder and give it the MCP server `rpg mcp`. RPG Engine is a standard MCP server: any agent that supports MCP can be the master, local ones included.
|
|
72
73
|
|
|
74
|
+
If the master says it cannot find RPG Engine's tools, write `rpg init` in the campaign folder: in a folder that is already a campaign it only brings these files up to date; then open a new chat.
|
|
75
|
+
|
|
73
76
|
We play and test it with **Claude Code**; **Codex** and **Antigravity** are connected and checked, but no whole campaign has been played with them yet. The campaign turns off the agent's own memory: the game lives in its files, so that going back to a save really goes back.
|
|
74
77
|
|
|
75
78
|
### 2.5 The first chat
|