rpg-engine 0.22.0 → 0.24.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 +5 -5
- package/dist/campaign/create-campaign.d.ts +6 -1
- package/dist/campaign/create-campaign.js +41 -13
- package/dist/campaign/find-campaign.d.ts +5 -0
- package/dist/campaign/find-campaign.js +20 -5
- package/dist/campaign/host-files.d.ts +14 -4
- package/dist/campaign/host-files.js +193 -36
- package/dist/campaign/index.d.ts +2 -2
- package/dist/campaign/index.js +2 -2
- package/dist/campaign/settings.d.ts +3 -3
- package/dist/campaign/settings.js +5 -4
- package/dist/cli/cli.js +28 -7
- package/dist/commands/config/config.js +1 -1
- package/dist/commands/config/dashboard.js +28 -6
- package/dist/commands/config/words.js +2 -1
- package/dist/commands/image.d.ts +3 -0
- package/dist/commands/image.js +32 -5
- package/dist/commands/import/import.d.ts +3 -1
- package/dist/commands/import/import.js +16 -3
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +21 -3
- package/dist/commands/instructions.js +1 -1
- package/dist/commands/shared/campaign/git.js +1 -1
- package/dist/commands/shared/campaign/images.js +6 -3
- package/dist/commands/shared/campaign/mode.js +1 -1
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +9 -6
- package/dist/commands/shared/sheet/sheet.d.ts +2 -2
- package/dist/commands/shared/sheet/sheet.js +3 -3
- package/dist/core/context.d.ts +21 -6
- package/dist/core/context.js +2 -1
- package/dist/dashboard/acts/acts.js +39 -11
- package/dist/dashboard/acts/head.js +7 -0
- package/dist/dashboard/acts/names.js +4 -2
- package/dist/dashboard/acts/sending.js +23 -22
- package/dist/dashboard/acts/sheet.js +7 -149
- package/dist/dashboard/acts/strip.js +10 -14
- package/dist/dashboard/acts/talk.js +51 -0
- package/dist/dashboard/acts/thing.js +169 -0
- package/dist/dashboard/app.js +3 -3
- package/dist/dashboard/guide/ar.md +17 -14
- package/dist/dashboard/guide/cs.md +15 -12
- package/dist/dashboard/guide/da.md +15 -12
- package/dist/dashboard/guide/de.md +14 -11
- package/dist/dashboard/guide/el.md +14 -11
- package/dist/dashboard/guide/en.md +13 -10
- package/dist/dashboard/guide/es.md +14 -11
- package/dist/dashboard/guide/fi.md +14 -11
- package/dist/dashboard/guide/fr.md +14 -11
- package/dist/dashboard/guide/he.md +14 -11
- package/dist/dashboard/guide/hi.md +14 -11
- package/dist/dashboard/guide/hu.md +14 -11
- package/dist/dashboard/guide/is.md +14 -11
- package/dist/dashboard/guide/it.md +57 -54
- package/dist/dashboard/guide/ja.md +14 -11
- package/dist/dashboard/guide/ko.md +15 -12
- package/dist/dashboard/guide/nb.md +14 -11
- package/dist/dashboard/guide/nl.md +16 -13
- package/dist/dashboard/guide/pl.md +14 -11
- package/dist/dashboard/guide/pt.md +14 -11
- package/dist/dashboard/guide/ro.md +15 -12
- package/dist/dashboard/guide/ru.md +14 -11
- package/dist/dashboard/guide/sv.md +15 -12
- package/dist/dashboard/guide/tr.md +15 -12
- package/dist/dashboard/guide/uk.md +15 -12
- package/dist/dashboard/guide/zh.md +15 -12
- package/dist/dashboard/i18n/ar.json +28 -11
- package/dist/dashboard/i18n/cs.json +28 -11
- package/dist/dashboard/i18n/da.json +28 -11
- package/dist/dashboard/i18n/de.json +28 -11
- package/dist/dashboard/i18n/el.json +28 -11
- package/dist/dashboard/i18n/es.json +28 -11
- package/dist/dashboard/i18n/fi.json +28 -11
- package/dist/dashboard/i18n/fr.json +28 -11
- package/dist/dashboard/i18n/he.json +28 -11
- package/dist/dashboard/i18n/hi.json +28 -11
- package/dist/dashboard/i18n/hu.json +28 -11
- package/dist/dashboard/i18n/is.json +28 -11
- package/dist/dashboard/i18n/it.json +104 -87
- package/dist/dashboard/i18n/ja.json +28 -11
- package/dist/dashboard/i18n/ko.json +28 -11
- package/dist/dashboard/i18n/nb.json +28 -11
- package/dist/dashboard/i18n/nl.json +28 -11
- package/dist/dashboard/i18n/pl.json +28 -11
- package/dist/dashboard/i18n/pt.json +28 -11
- package/dist/dashboard/i18n/ro.json +28 -11
- package/dist/dashboard/i18n/ru.json +28 -11
- package/dist/dashboard/i18n/sv.json +28 -11
- package/dist/dashboard/i18n/tr.json +28 -11
- package/dist/dashboard/i18n/uk.json +28 -11
- package/dist/dashboard/i18n/zh.json +28 -11
- package/dist/dashboard/packages/packages.js +1 -1
- package/dist/dashboard/parts/icons.js +2 -0
- package/dist/dashboard/parts/labels.js +2 -1
- package/dist/dashboard/parts/layout.js +34 -0
- package/dist/dashboard/parts/widgets.js +6 -2
- package/dist/dashboard/settings/language-choice.js +1 -1
- package/dist/dashboard/settings/settings.js +73 -39
- package/dist/dashboard/settings/tabs.js +14 -0
- package/dist/dashboard/sheet/sheet.js +54 -33
- package/dist/dashboard/shell/notices.js +2 -2
- package/dist/dashboard/style.css +135 -52
- package/dist/helpers/antigravity.d.ts +47 -0
- package/dist/helpers/antigravity.js +434 -0
- package/dist/helpers/briefs.d.ts +4 -0
- package/dist/helpers/briefs.js +13 -0
- package/dist/helpers/chosen.d.ts +15 -7
- package/dist/helpers/chosen.js +96 -45
- package/dist/helpers/index.d.ts +4 -2
- package/dist/helpers/index.js +6 -3
- package/dist/helpers/opencode.d.ts +13 -0
- package/dist/helpers/opencode.js +295 -0
- package/dist/helpers/programs.d.ts +8 -0
- package/dist/helpers/programs.js +35 -2
- package/dist/helpers/stop.d.ts +2 -0
- package/dist/helpers/stop.js +20 -1
- package/dist/helpers/svg.d.ts +4 -1
- package/dist/helpers/svg.js +16 -4
- package/dist/instructions/index.d.ts +4 -2
- package/dist/instructions/index.js +6 -3
- package/dist/server/approver.d.ts +4 -2
- package/dist/server/approver.js +27 -7
- package/dist/server/bell/antigravity.d.ts +15 -0
- package/dist/server/bell/antigravity.js +113 -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 +154 -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/fence.d.ts +21 -0
- package/dist/server/fence.js +69 -0
- package/dist/server/mcp.d.ts +3 -2
- package/dist/server/mcp.js +37 -7
- package/dist/server/player-acts.d.ts +21 -1
- package/dist/server/player-acts.js +39 -3
- 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/dist/server/subagent.d.ts +4 -0
- package/dist/server/subagent.js +30 -0
- package/instructions/start.md +1 -1
- package/instructions/voices-antigravity.md +1 -0
- package/instructions/voices-codex.md +1 -0
- 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
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
|
|
2
|
+
import { useEffect, useRef, useState } from "preact/hooks";
|
|
3
|
+
import { sectionAddress } from "../address.js";
|
|
4
|
+
import { readView } from "../api.js";
|
|
5
|
+
import { Icon } from "../parts/icons.js";
|
|
6
|
+
import { fieldLabel, phraseLabel, shownText } from "../parts/labels.js";
|
|
7
|
+
import { Markdown } from "../parts/markdown.js";
|
|
8
|
+
import { PlaceMap } from "../place/view.js";
|
|
9
|
+
import { t } from "../text.js";
|
|
10
|
+
import { actPeople, actSentence, actTitle, spokenBy, targetMode, verbLabel, withoutFullStop } from "./acts.js";
|
|
11
|
+
import { ActHead } from "./head.js";
|
|
12
|
+
// A click this soon after a verb asks to confirm is the rest of a double click, never the confirmation (milliseconds).
|
|
13
|
+
const doubleClick = 400;
|
|
14
|
+
/** The card of a thing of the sheet: what it is, then its verbs, each a sentence to the master (D-493 (1)); how it goes as `reply` says. */
|
|
15
|
+
export function ThingSheet({ start, self, place, scene, companions, reply, onSend, onClose }) {
|
|
16
|
+
const dialog = useRef(null);
|
|
17
|
+
const list = useRef(null);
|
|
18
|
+
const verbsBar = useRef(null);
|
|
19
|
+
const go = useRef(null);
|
|
20
|
+
const closer = useRef(null);
|
|
21
|
+
// The verb whose on whom is being chosen, in the card's second step; the verb without anyone that asks to confirm, and since when.
|
|
22
|
+
const [verb, setVerb] = useState();
|
|
23
|
+
const [confirming, setConfirming] = useState();
|
|
24
|
+
const confirmedAt = useRef(0);
|
|
25
|
+
const [target, setTarget] = useState();
|
|
26
|
+
const [square, setSquare] = useState("");
|
|
27
|
+
const [problem, setProblem] = useState();
|
|
28
|
+
const [sending, setSending] = useState(false);
|
|
29
|
+
const sendingNow = useRef(false);
|
|
30
|
+
// The text of the thing's page: undefined while it is read, empty for a page of data alone, null when the character knows no page of it.
|
|
31
|
+
const [about, setAbout] = useState();
|
|
32
|
+
// What the page says of the thing as data, as damage and weight, or a spell's range (D-573, D-581).
|
|
33
|
+
const [data, setData] = useState([]);
|
|
34
|
+
const map = place?.map;
|
|
35
|
+
// With a map at the place, on whom is chosen on it too, by a click.
|
|
36
|
+
const mapShown = map !== undefined && place !== undefined && verb !== undefined;
|
|
37
|
+
const people = actPeople(place, scene, companions, self);
|
|
38
|
+
const chosen = chosenTarget(target, square);
|
|
39
|
+
// While the master waits for an answer, the verbs wait (D-581): talking answers in words.
|
|
40
|
+
const waiting = reply === "answer";
|
|
41
|
+
// With more than one player character the sentence starts with who acts (D-480 (8)).
|
|
42
|
+
const sentence = (one, on = "none") => spokenBy(actSentence(one, start.item, on), self);
|
|
43
|
+
const facts = verb === undefined ? start.facts ?? [] : [];
|
|
44
|
+
// A modal dialog lies over everything on the page and closes with Escape by itself; the thing's page is read once, when it opens.
|
|
45
|
+
useEffect(() => {
|
|
46
|
+
dialog.current?.showModal();
|
|
47
|
+
(verbsBar.current?.querySelector("a, button") ?? closer.current)?.focus();
|
|
48
|
+
let live = true;
|
|
49
|
+
readView(start.page ?? start.item).then((page) => {
|
|
50
|
+
if (live) {
|
|
51
|
+
setAbout(page.kind === "page" ? page.text.trim() : null);
|
|
52
|
+
setData(page.kind === "page" ? page.sheet.flatMap((group) => group.values) : []);
|
|
53
|
+
}
|
|
54
|
+
}, () => live && setAbout(null));
|
|
55
|
+
return () => {
|
|
56
|
+
live = false;
|
|
57
|
+
};
|
|
58
|
+
}, []);
|
|
59
|
+
// On whom is the next choice: the focus on the first of the list.
|
|
60
|
+
useEffect(() => {
|
|
61
|
+
if (verb !== undefined) {
|
|
62
|
+
list.current?.querySelector("input[type=radio]")?.focus();
|
|
63
|
+
}
|
|
64
|
+
}, [verb]);
|
|
65
|
+
const verbButton = (one) => verbsBar.current?.querySelector(`button[data-verb="${one ?? ""}"]`);
|
|
66
|
+
const tell = async (words) => {
|
|
67
|
+
sendingNow.current = true;
|
|
68
|
+
setSending(true);
|
|
69
|
+
const failed = await onSend(words);
|
|
70
|
+
sendingNow.current = false;
|
|
71
|
+
setSending(false);
|
|
72
|
+
if (failed === undefined) {
|
|
73
|
+
dialog.current?.close();
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
// Failed, the verb is as before the first click, the problem under the verbs.
|
|
77
|
+
const was = confirming;
|
|
78
|
+
setConfirming(undefined);
|
|
79
|
+
setProblem(failed);
|
|
80
|
+
requestAnimationFrame(() => (verb === undefined ? verbButton(was)?.focus() : go.current?.focus()));
|
|
81
|
+
};
|
|
82
|
+
// A verb with someone to act on leads to on whom; one without asks to confirm on its button, and a second click, not part of a double one, sends it.
|
|
83
|
+
const press = (one) => {
|
|
84
|
+
if (waiting || sending) {
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (targetMode(one) !== "none") {
|
|
88
|
+
setVerb(one);
|
|
89
|
+
setTarget(undefined);
|
|
90
|
+
setSquare("");
|
|
91
|
+
setConfirming(undefined);
|
|
92
|
+
setProblem(undefined);
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
if (confirming !== one) {
|
|
96
|
+
setConfirming(one);
|
|
97
|
+
confirmedAt.current = performance.now();
|
|
98
|
+
setProblem(undefined);
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
if (performance.now() - confirmedAt.current >= doubleClick) {
|
|
102
|
+
void tell(sentence(one));
|
|
103
|
+
}
|
|
104
|
+
};
|
|
105
|
+
// Leaving the button leaves the confirmation, except while it goes to the master.
|
|
106
|
+
const leave = (one) => {
|
|
107
|
+
if (!sendingNow.current) {
|
|
108
|
+
setConfirming((now) => (now === one ? undefined : now));
|
|
109
|
+
}
|
|
110
|
+
};
|
|
111
|
+
// The first Escape leaves the confirmation; the next closes the card.
|
|
112
|
+
const cancel = (event) => {
|
|
113
|
+
if (confirming !== undefined) {
|
|
114
|
+
event.preventDefault();
|
|
115
|
+
setConfirming(undefined);
|
|
116
|
+
}
|
|
117
|
+
};
|
|
118
|
+
// Back to the thing, the focus on the verb that was chosen.
|
|
119
|
+
const back = () => {
|
|
120
|
+
const was = verb;
|
|
121
|
+
setVerb(undefined);
|
|
122
|
+
setProblem(undefined);
|
|
123
|
+
requestAnimationFrame(() => verbButton(was)?.focus());
|
|
124
|
+
};
|
|
125
|
+
const choose = (one) => {
|
|
126
|
+
setTarget(one);
|
|
127
|
+
setProblem(undefined);
|
|
128
|
+
};
|
|
129
|
+
const submit = (event) => {
|
|
130
|
+
event.preventDefault();
|
|
131
|
+
if (verb !== undefined && chosen !== undefined && !sending) {
|
|
132
|
+
void tell(sentence(verb, chosen));
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
// Enter on a choice of the list takes the player to the button that sends.
|
|
136
|
+
const toButton = (event) => {
|
|
137
|
+
if (event.key === "Enter") {
|
|
138
|
+
event.preventDefault();
|
|
139
|
+
go.current?.focus();
|
|
140
|
+
}
|
|
141
|
+
};
|
|
142
|
+
const close = () => dialog.current?.close();
|
|
143
|
+
const personChosen = typeof target === "object" && "person" in target ? target.person : undefined;
|
|
144
|
+
const option = (key, one, label, kind = "") => (_jsxs("label", { class: ["act-who-one", kind].filter((name) => name !== "").join(" "), children: [_jsx("input", { type: "radio", name: "act-who", checked: sameTarget(target, one), onChange: () => choose(one), onKeyDown: toButton }), label] }, key));
|
|
145
|
+
const confirmLabel = (one) => t("Confirm: {sentence}", { sentence: withoutFullStop(sentence(one)) });
|
|
146
|
+
return (_jsxs("dialog", { ref: dialog, class: mapShown ? "map-sheet act-sheet wide" : "map-sheet act-sheet", "aria-labelledby": "act-sheet-title", "aria-describedby": facts.length > 0 ? "act-facts" : undefined, onCancel: cancel, onClose: onClose, children: [_jsx(ActHead, { title: verb === undefined ? start.item : actTitle(verb, start.item), facts: facts, closer: closer, ...(verb === undefined ? {} : { onBack: back }), onClose: close }), verb === undefined && (_jsxs(_Fragment, { children: [data.length > 0 && (_jsx("dl", { class: "act-data", children: data.map((value) => (_jsxs("div", { children: [_jsx("dt", { class: "eyebrow", children: fieldLabel(value.field) }), _jsx("dd", { children: dataText(value) })] }, value.field))) })), about !== undefined && about !== "" && (about !== null || data.length === 0) && (_jsx("div", { class: "act-about", children: about === null ? _jsx("p", { class: "browse-none", children: t("Your character knows its name, and nothing more yet.") }) : _jsx(Markdown, { text: about }) })), (start.verbs.length > 0 || start.document === true) && (_jsxs("div", { class: "act-verbs", children: [waiting && start.verbs.length > 0 && (_jsxs("p", { id: "act-wait", class: "act-note", children: [_jsx(Icon, { name: "bell" }), t("The master is waiting for your answer: answer that first.")] })), _jsxs("div", { ref: verbsBar, class: "act-buttons", role: "group", "aria-label": t("What you do"), children: [start.document === true && (_jsx("a", { class: "map-sheet-go act-go", href: sectionAddress("world", "documents", start.page ?? start.item), onClick: close, children: t("Read it") })), start.verbs.map((one, index) => {
|
|
147
|
+
const primary = confirming === undefined ? index === 0 && start.document !== true : confirming === one;
|
|
148
|
+
return (_jsx("button", { type: "button", "data-verb": one, class: confirming === one ? "map-sheet-go act-go says confirming" : primary ? "map-sheet-go act-go" : "act-cancel", disabled: sending && confirming === one, "aria-disabled": waiting ? "true" : undefined, "aria-describedby": waiting ? "act-wait" : undefined, onClick: () => press(one), onBlur: () => leave(one), children: confirming === one ? confirmLabel(one) : verbLabel(one) }, one));
|
|
149
|
+
})] }), problem && _jsx("p", { class: "act-problem", role: "alert", children: problem }), _jsx("p", { class: "visually-hidden", role: "status", children: confirming === undefined ? "" : t("Press again to tell the master.") })] }))] })), verb !== undefined && (_jsxs(_Fragment, { children: [_jsxs("div", { class: "act-body", children: [_jsxs("fieldset", { ref: list, class: "act-who", children: [_jsx("legend", { class: "eyebrow", children: t("On whom") }), people.map((person, index) => option(`person ${index}`, { person: person.name }, _jsxs(_Fragment, { children: [_jsxs("span", { class: "act-who-name", children: [person.name, person.count !== undefined && _jsx("span", { class: "count", children: ` ×${person.count}` })] }), person.square !== undefined && _jsx("span", { class: "lm-key-square", children: person.square })] }), [person.role, person.hostile === true ? "hostile" : ""].filter((name) => name !== "").join(" "))), option("self", "self", _jsx("span", { class: "act-who-name", children: t("Myself") }), "plain"), option("none", "none", _jsx("span", { class: "act-who-name", children: t("No one in particular") }), "plain"), mapShown && option("square", "square", _jsx("span", { class: "act-who-name", children: t("A square…") }), "plain"), target === "square" && mapShown && (_jsx("input", { type: "text", class: "act-square", value: square, maxLength: 5, placeholder: "E4", "aria-label": t("The square, such as E4"), onInput: (event) => setSquare(event.currentTarget.value), onKeyDown: toButton }))] }), mapShown && (_jsx(PlaceMap, { map: map, place: place.name, bare: true, self: self, choosing: { selected: personChosen, onChoose: (name) => choose(name === undefined ? "self" : { person: name }) }, ...(target === "square" ? { picking: { selected: square.trim().toUpperCase(), onSelect: setSquare } } : {}) }))] }), _jsxs("form", { class: "act-bar", onSubmit: submit, children: [problem && _jsx("p", { class: "act-problem", role: "alert", children: problem }), _jsxs("div", { class: "act-buttons", children: [_jsx("button", { type: "button", class: "act-cancel", onClick: close, children: t("Cancel") }), _jsxs("button", { ref: go, type: "submit", class: "map-sheet-go act-go says", disabled: sending || chosen === undefined, children: [chosen === undefined ? t("Choose on whom") : withoutFullStop(sentence(verb, chosen)), chosen !== undefined && _jsx(Icon, { name: "send" })] })] })] })] }))] }));
|
|
150
|
+
}
|
|
151
|
+
/** On whom the player chose: undefined while nothing is, or a square not yet written. */
|
|
152
|
+
function chosenTarget(target, square) {
|
|
153
|
+
if (target !== "square") {
|
|
154
|
+
return target;
|
|
155
|
+
}
|
|
156
|
+
return square.trim() === "" ? undefined : { square: square.trim().toUpperCase() };
|
|
157
|
+
}
|
|
158
|
+
/** Whether two choices of the list are the same. */
|
|
159
|
+
function sameTarget(target, other) {
|
|
160
|
+
if (typeof target === "object" && typeof other === "object") {
|
|
161
|
+
return "person" in target && "person" in other && target.person === other.person;
|
|
162
|
+
}
|
|
163
|
+
return target === other;
|
|
164
|
+
}
|
|
165
|
+
/** A value of a thing's data as its card reads it: yes or no for true and false, else its text with a capital. */
|
|
166
|
+
function dataText(value) {
|
|
167
|
+
const text = value.text.trim().toLowerCase();
|
|
168
|
+
return text === "true" ? t("Yes") : text === "false" ? t("No") : phraseLabel(shownText(value.text, value.kind));
|
|
169
|
+
}
|
package/dist/dashboard/app.js
CHANGED
|
@@ -461,7 +461,7 @@ function App() {
|
|
|
461
461
|
const lead = playerNamed(shown.party, shown.foreground) ?? players[0];
|
|
462
462
|
const actor = member?.role === "pc" ? member : lead;
|
|
463
463
|
// The player's sentences to the master (D-495); read() sets the acts and the verbs it reads, by setters that never change.
|
|
464
|
-
const { setActs, setActions, playerActs, acting, actsElsewhere, actPlace, reply, answering: answeringQuestion, strip, actProblem, sendAct, closeAct, withdraw,
|
|
464
|
+
const { setActs, setActions, playerActs, acting, actsElsewhere, actPlace, reply, answering: answeringQuestion, strip, actProblem, sendAct, closeAct, withdraw, sayAgain, dismissAct, bell: actsBell } = useActs({
|
|
465
465
|
read,
|
|
466
466
|
live,
|
|
467
467
|
asked: shown.asked,
|
|
@@ -558,7 +558,7 @@ function App() {
|
|
|
558
558
|
cards: shown.cards,
|
|
559
559
|
version: shown.version,
|
|
560
560
|
onRoll: throwFromSheet,
|
|
561
|
-
} })), address.section === "world" && _jsx(WorldView, { version: shown.version, lead: lead, players: many ? players : undefined, tab: address.tab, item: address.name }), address.section === "settings" && _jsx(SettingsView, { version: shown.version, several: many }), address.section === "saves" && _jsx(SavesView, { version: shown.version, campaign: shown.campaign, several: many }), address.section === "packages" && (_jsx(PackagesPage, { version: shown.version, tab: address.tab, item: address.name, layers: shown.layers, sceneOpen: shown.openScene !== undefined, onChanged: () => void read() })), address.section === "pkg" && _jsx(PackagePage, { name: address.tab, page: address.name, modulesRead: modulesRead }), address.section === "choices" && (_jsx(ChoicesPage, { who: address.tab, open: address.name, choices: shown.choices, member: shown.party.find((one) => one.name === address.tab), version: shown.version, flying: thrown !== undefined && thrown.id !== landed ? thrown : undefined, onChanged: (choices) => setShown((before) => ({ ...before, choices })) })), address.section === "journal" && _jsx(JournalView, { version: shown.version, campaign: shown.campaign, tab: address.tab, item: address.name }), address.section === "party" && member && (_jsx(PlayerActsContext.Provider, { value: member.role === "pc" || playerActs === undefined ? playerActs : { ...playerActs, actions: {} }, children: _jsx(MemberSheet, { member: member, headline: shown.headline, layered: shown.layered === true, sheet: shown.sheet, cards: shown.cards, text: shown.text, knownBy: shown.knownBy, story: shown.story, version: shown.version, onRoll: throwFromSheet, scene: shown.openScene, choices: choicesOf(shown.choices, member.name) }, member.name) }))] }), table
|
|
561
|
+
} })), address.section === "world" && _jsx(WorldView, { version: shown.version, lead: lead, players: many ? players : undefined, tab: address.tab, item: address.name }), address.section === "settings" && _jsx(SettingsView, { version: shown.version, tab: address.tab, several: many }), address.section === "saves" && _jsx(SavesView, { version: shown.version, campaign: shown.campaign, several: many }), address.section === "packages" && (_jsx(PackagesPage, { version: shown.version, tab: address.tab, item: address.name, layers: shown.layers, sceneOpen: shown.openScene !== undefined, onChanged: () => void read() })), address.section === "pkg" && _jsx(PackagePage, { name: address.tab, page: address.name, modulesRead: modulesRead }), address.section === "choices" && (_jsx(ChoicesPage, { who: address.tab, open: address.name, choices: shown.choices, member: shown.party.find((one) => one.name === address.tab), version: shown.version, flying: thrown !== undefined && thrown.id !== landed ? thrown : undefined, onChanged: (choices) => setShown((before) => ({ ...before, choices })) })), address.section === "journal" && _jsx(JournalView, { version: shown.version, campaign: shown.campaign, tab: address.tab, item: address.name }), address.section === "party" && member && (_jsx(PlayerActsContext.Provider, { value: member.role === "pc" || playerActs === undefined ? playerActs : { ...playerActs, actions: {} }, children: _jsx(MemberSheet, { member: member, headline: shown.headline, layered: shown.layered === true, sheet: shown.sheet, cards: shown.cards, text: shown.text, knownBy: shown.knownBy, story: shown.story, version: shown.version, onRoll: throwFromSheet, scene: shown.openScene, choices: choicesOf(shown.choices, member.name) }, member.name) }))] }), table
|
|
562
562
|
? (_jsxs(PlayTable, { entering: tableMoved, onFold: () => {
|
|
563
563
|
setTableMoved(true);
|
|
564
564
|
setTableAway(true);
|
|
@@ -579,7 +579,7 @@ function App() {
|
|
|
579
579
|
}, onFree: (roll) => {
|
|
580
580
|
setFree((before) => withFree(shown.campaign, before, roll));
|
|
581
581
|
setFresh((before) => new Set([...before, roll.id]));
|
|
582
|
-
} }), acting !== undefined && (_jsx(ActSheet, { start: acting.start, self: several ? member?.name : undefined, place: actsElsewhere === undefined ? shown.place : actPlace?.who === actsElsewhere ? actPlace.place : undefined, scene: shown.openScene, companions: shown.party.filter((one) => one.role === "companion").map((one) => one.name), reply: reply, asked: answeringQuestion, onSend: sendAct, onClose: closeAct })), _jsx(ActStrip, { entries: strip, problem: actProblem, onWithdraw: (id) => void withdraw(id),
|
|
582
|
+
} }), acting !== undefined && (_jsx(ActSheet, { start: acting.start, self: several ? member?.name : undefined, place: actsElsewhere === undefined ? shown.place : actPlace?.who === actsElsewhere ? actPlace.place : undefined, scene: shown.openScene, companions: shown.party.filter((one) => one.role === "companion").map((one) => one.name), reply: reply, asked: answeringQuestion, onSend: sendAct, onClose: closeAct })), _jsx(ActStrip, { entries: strip, problem: actProblem, onWithdraw: (id) => void withdraw(id), bell: actsBell, live: live, onSayAgain: (id) => void sayAgain(id), onDismiss: dismissAct })] }) }) }) }) }) }));
|
|
583
583
|
}
|
|
584
584
|
// The theme the player picked before, from the start (D-300); the tooltips over everything (T-228).
|
|
585
585
|
restoreTheme();
|
|
@@ -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,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: الدليل الكامل
|
|
3
3
|
|
|
4
4
|
يتيح لك **RPG Engine** لعب لعبة أدوار على الطاولة مع **ذكاء اصطناعي في دور مدير اللعبة**. تتحدث مع مدير اللعبة في **محادثة**. أما RPG Engine فيعمل خلف الكواليس: **يتذكر العالم**، و**يرمي النرد**، و**يمسك الحسابات**. بجانب المحادثة تُبقي صفحة مفتوحة في المتصفح، هي **لوحة التحكم**، وفيها ورقة شخصيتك والنرد والخرائط وسجلك.
|
|
@@ -64,14 +64,17 @@ 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
|
-
- **Claude Code**: في مجلد الحملة اكتب `claude`. عندما يسأل هل تثق بالمجلد، اختر **Yes, I trust this folder**. انتبه: الجواب المحدد مسبقًا هو *No, exit*. في الحملة أيضًا خطّاف صغير، `rpg --listen`، لا يظهر في هذا السؤال. وهو يخبر مدير اللعبة فورًا حين تتصرف من لوحة
|
|
70
|
-
- **Codex**: في مجلد الحملة اكتب `codex`، ووافق عندما يسأل هل تثق بالمجلد. وفي تطبيقه المكتبي، تأكد من الإعدادات أن الذاكرة معطلة لدردشات اللعبة.
|
|
71
|
-
- **Antigravity**: في مجلد الحملة اكتب `agy`، ووافق إن سأل هل تثق بالمجلد. في الحملة
|
|
72
|
-
-
|
|
69
|
+
- **Claude Code**: في مجلد الحملة اكتب `claude`. عندما يسأل هل تثق بالمجلد، اختر **Yes, I trust this folder**. انتبه: الجواب المحدد مسبقًا هو *No, exit*. في الحملة أيضًا خطّاف صغير، `rpg --listen`، لا يظهر في هذا السؤال. وهو يخبر مدير اللعبة فورًا حين تتصرف من لوحة التحكم.
|
|
70
|
+
- **Codex**: في مجلد الحملة اكتب `codex`، ووافق عندما يسأل هل تثق بالمجلد. في اللحظات المهمة تتكلم الشخصية عبر وكيل خاص بها، `.codex/agents/rpg-character.toml`، لا يعرف إلا ما تعرفه الشخصية. وفي تطبيقه المكتبي، تأكد من الإعدادات أن الذاكرة معطلة لدردشات اللعبة.
|
|
71
|
+
- **Antigravity**: في مجلد الحملة اكتب `agy`، ووافق إن سأل هل تثق بالمجلد. أو افتح مجلد الحملة من تطبيقه. وللتطبيق يضيف RPG Engine نفسه أيضًا إلى إعدادات Antigravity الخاصة، في الملف `.gemini/config/mcp_config.json` داخل مجلدك الشخصي. وهذه الإعدادات تسري على كل مجلد تفتحه، لا على مجلد الحملة وحده. أما خارج الحملة فلا يفعل شيئًا. في الحملة خطّافان صغيران: `rpg --approve` يتيح لمدير اللعبة استخدام أدوات RPG Engine دون أن يسألك في كل مرة، و`rpg --listen` يخبر مدير اللعبة فورًا حين تتصرف من لوحة التحكم. يرسم مدير اللعبة الصور في الدردشة نفسها، مع خطة Google مدفوعة. وفي الخطة المجانية تفشل أداة الصور لديه، فيرسم صورًا متجهية بسيطة، كما يفعل Claude. في اللحظات المهمة تتكلم الشخصية عبر وكيل خاص بها، `.agents/agents/rpg-character.md`: يكتب مدير اللعبة سطرًا من القصة، ويأتي جواب الشخصية بعد لحظة. ويترجم Antigravity لديك لوحة التحكم وقواعد اللعبة أيضًا، ويقرأ المستندات التي تستوردها، خارج الدردشة، من حصة حساب Google الخاص بك. يشغّله RPG Engine بمعزل عن دردشاتك الخاصة، فلا يترك أثرًا بينها. يحتفظ Antigravity بدردشاتك السابقة، ولا يمكن إيقاف ذاكرته. لذلك أُمر مدير اللعبة ألا يقرأها أبدًا. ما تكتبه يذهب إلى Google، وقد يقرؤه بشر. أبعد البيانات الشخصية عن اللعبة. RPG Engine ليس منتجًا من Google.
|
|
72
|
+
- **OpenCode**: في مجلد الحملة اكتب `opencode`. في الحملة إضافة صغيرة، `.opencode/plugins/rpg.js`، تخبر مدير اللعبة فورًا حين تتصرف من لوحة التحكم. وفي الحملة يكتب مدير اللعبة الملفات عبر RPG Engine وحده: كتابة OpenCode الخاصة للملفات وتحريرها معطّلة هناك، ويسألك OpenCode قبل أن ينفّذ أي أمر. ويرسم مدير اللعبة الصور بنفسه، صورًا متجهية بسيطة، كما يفعل Claude. في اللحظات المهمة تتكلم الشخصية عبر وكيل خاص بها، `.opencode/agents/rpg-character.md`: يكتب مدير اللعبة سطرًا من القصة، ويأتي جواب الشخصية بعد لحظة. وقد لا يستدعيه نموذج محلي صغير. ويترجم OpenCode لديك، بالنموذج الذي اخترته فيه آخر مرة، لوحة التحكم وقواعد اللعبة أيضًا، ويقرأ المستندات التي تستوردها، خارج الدردشة. وإن لم يكن لديه نموذج يستطيع استخدامه، فيتولى ذلك Codex أو Claude Code إن كانا لديك.
|
|
73
|
+
- **وكيل آخر**: شغّله في مجلد الحملة وأعطه خادم MCP بالأمر `rpg mcp`. RPG Engine خادم MCP قياسي، وأي وكيل يدعم MCP يمكن أن يكون مدير اللعبة، ومنه الوكلاء المحليون.
|
|
73
74
|
|
|
74
|
-
|
|
75
|
+
إذا قال مدير اللعبة إنه لا يجد أدوات RPG Engine، فاكتب `rpg init` في مجلد الحملة. في مجلد هو حملة أصلًا، لا يفعل هذا الأمر سوى تحديث هذه الملفات. ثم افتح دردشة جديدة.
|
|
76
|
+
|
|
77
|
+
نلعب ونختبر مع **Claude Code**. أما **Codex** و**Antigravity** و**OpenCode** فهي مربوطة ومفحوصة، لكن لم تُلعب معها حملة كاملة بعد. تعطّل الحملة ذاكرة الوكيل الخاصة، فاللعبة تعيش في ملفاتها، وبذلك تعيدك العودة إلى نقطة حفظ إلى ما كانت عليه فعلًا.
|
|
75
78
|
|
|
76
79
|
### 2.5 الدردشة الأولى
|
|
77
80
|
|
|
@@ -127,7 +130,7 @@ rpg init "The Salt Isles"
|
|
|
127
130
|
|
|
128
131
|
أنت تقول ما تحاوله، ومدير اللعبة يقول ما يحدث. لا يقرر مدير اللعبة أبدًا عن شخصيتك، ولا يتحدث عن المحرّك. يمكنك أن تسأل مدير اللعبة عن طريقة استخدام لوحة التحكم.
|
|
129
132
|
|
|
130
|
-
**التصرف من لوحة التحكم**: انقر على اسم في ورقة الشخصية، مثل سلاح أو تعويذة أو شيء تحمله، فتقول بطاقته ما هو. اختر ما تفعله
|
|
133
|
+
**التصرف من لوحة التحكم**: انقر على اسم في ورقة الشخصية، مثل سلاح أو تعويذة أو شيء تحمله، فتقول بطاقته ما هو. تُفتح الحقيبة بسهمها، وتعرض أيقونة ⓘ بطاقتها. اختر ما تفعله به. ما لا يحتاج إلى أحد، مثل **تجهيز**، يطلب منك التأكيد على الزر نفسه، *تأكيد: أجهّز الدرع*: اضغطه مرة أخرى فيذهب إلى مدير اللعبة. وما يُفعل بشخص، مثل **هجوم**، يسألك عن الهدف، في القائمة أو بنقرة على الخريطة. عندها يقول الزر الجملة كاملة، *أهاجم قاطع الطريق المقنّع 1 بالصولجان*، وبنقرة واحدة تُرسل. وإن أردت قولها بطريقتك، فانقر على شخص لتتحدث إليه، أو اكتب في الدردشة. يسمعها مدير اللعبة كما لو قيلت في الدردشة، ويحكم فيها كما في أي كلام آخر، ويسألك بأزرار عمّا أغفلته. وإن لم يكن في تطبيق الذكاء الاصطناعي لديك ما ينبّه مدير اللعبة، قرأها مدير اللعبة حين تكتب في الدردشة بعد ذلك. وإن كانت الدردشة مغلقة قبلها، فـ**إعادة القول** ترسلها مرة أخرى.
|
|
131
134
|
|
|
132
135
|
### 3.2 الرميات
|
|
133
136
|
|
|
@@ -195,7 +198,7 @@ rpg init "The Salt Isles"
|
|
|
195
198
|
|
|
196
199
|
### 3.11 الصور
|
|
197
200
|
|
|
198
|
-
يستطيع RPG Engine رسم صور للأماكن التي تبلغها، والمهمات التي تتولاها، ومن تقابلهم، بحسب إعداد **الصور**، ورسم بورتريه لشخصيتك حين تطلب.
|
|
201
|
+
يستطيع RPG Engine رسم صور للأماكن التي تبلغها، والمهمات التي تتولاها، ومن تقابلهم، بحسب إعداد **الصور**، ورسم بورتريه لشخصيتك حين تطلب. يصنعها تطبيق الذكاء الاصطناعي الخاص بك بوسائله، بتسجيل دخولك، وعلى خطتك وحدودها: يرسمها **Claude** صورًا متجهية، ويرسمها **Codex** و**Antigravity** بالألوان، ويرسم **OpenCode** صورًا متجهية بسيطة في الدردشة. في **الإعدادات > الحملة > الصور** يمكنك أن تجعل Codex أو Antigravity يرسمها حتى حين يكون مدير اللعبة تطبيقًا آخر. وإن عجز الذي اخترته، صنعتها دردشتك. وتخبرك **الإعدادات** إن كان هذا الحاسوب قادرًا على صنعها، وكيف تهيّئه إن لم يكن. ويمكنك دائمًا أن تعطي صورة من عندك، لشخصيتك أو لأي صفحة تراها: مرّر المؤشر فوق إحدى صورها فيظهر زر صغير للصورة في زاويتها (وبلوحة المفاتيح أيضًا، ودائمًا على الهاتف). وفي **العالم** تجد في الصفحة التي تفتحها **تغيير الصورة…**، أو **إضافة صورة…** ما دامت بلا صورة. وتحل صورتك محل الصورة الموجودة. أو ضع الملف في مجلد **inbox** داخل مجلد الحملة، وقل لمدير اللعبة لأي صفحة هو.
|
|
199
202
|
|
|
200
203
|
### 3.12 الأمان: الخطوط الحمراء والأستار والإيقاف
|
|
201
204
|
|
|
@@ -216,7 +219,7 @@ rpg init "The Salt Isles"
|
|
|
216
219
|
- **السجل**: المهمات، والقصة كتابًا، وخطها الزمني، ويوميات رفاقك، وملاحظاتك.
|
|
217
220
|
- **العالم**: خريطة العالم، وما تعرفه شخصيتك، والمستندات التي عُثر عليها، والتقويم.
|
|
218
221
|
- **صينية النرد**: اختر النرد والمُعدِّل، ثم ارمِ. زر ×2 يضاعف النرد ولا يضاعف المُعدِّل، كما في الضربة الحرجة.
|
|
219
|
-
- **نقاط الحفظ** و**المساعدة** و**الإعدادات** و**حول**: أيقونات في نهاية الصف. وتضم **الإعدادات**
|
|
222
|
+
- **نقاط الحفظ** و**المساعدة** و**الإعدادات** و**حول**: أيقونات في نهاية الصف. وتضم **الإعدادات** أيضًا، تحت **هذه الصفحة**، تفضيلات الصفحة نفسها: السمة، وصوت النرد، ومجموعة النرد، و**أسلوب اللعبة**، أي ألوان الصفحة ووجوهها وصورها. وقد يكون أسلوب نظام اللعبة، أو سمة أضفتها من Packages › Add عبر الكتالوج، أو رابط GitHub، أو ملف .zip، أو مجلد، أو أسلوب الصفحة نفسها. إن جعل ملف الأنماط الخاص بسمة ما الصفحة صعبة القراءة، فأوقف **نمط السمة الخاص** هناك: فالإعدادات تظهر دائمًا من دونه، على عنوان الصفحة مع `#/settings/page` في آخره.
|
|
220
223
|
|
|
221
224
|
حين يسألك مدير اللعبة شيئًا، يبقى شريطه في أعلى الصفحة، في أي قسم كنت.
|
|
222
225
|
|
|
@@ -260,15 +263,15 @@ rpg init "The Salt Isles"
|
|
|
260
263
|
|
|
261
264
|
### 7.1 ثلاث طرق للحصول على عالم
|
|
262
265
|
|
|
263
|
-
- **يُصنع أثناء اللعب**: من
|
|
266
|
+
- **يُصنع أثناء اللعب**: من فكرتك، يبني مدير اللعبة كل مكان وشخص وحبكة قبل أن تحتاج إليه مباشرة، ويحتفظ به.
|
|
264
267
|
- **يُحضَّر في البداية**: الشيء نفسه، لكن يُبنى العالم قبل اللعب.
|
|
265
|
-
- **من مغامرتك أو كتابك**: أعطِ مدير اللعبة ملفه، *[استورد هذه المغامرة كحملتنا: D:\Books\adventure.pdf. لا تخبرني بأي شيء فيها.]* يقرؤها بأفضل صورة نصًا، أو EPUB، أو مستند Word، أو PDF يمكن تحديد نصه. أما PDF الممسوح ضوئيًا فيُقرأ من صور صفحاته، في Windows فقط، ببطء ومع بعض الأخطاء. يقرؤه
|
|
268
|
+
- **من مغامرتك أو كتابك**: أعطِ مدير اللعبة ملفه، *[استورد هذه المغامرة كحملتنا: D:\Books\adventure.pdf. لا تخبرني بأي شيء فيها.]* يقرؤها بأفضل صورة نصًا، أو EPUB، أو مستند Word، أو PDF يمكن تحديد نصه. أما PDF الممسوح ضوئيًا فيُقرأ من صور صفحاته، في Windows فقط، ببطء ومع بعض الأخطاء. يقرؤه تطبيق الذكاء الاصطناعي الخاص بك خارج الدردشة، وإلا فمدير اللعبة في الدردشة، على خطتك: في Claude Code أو Codex يقرؤه أحد هذين، وفي Antigravity يقرؤه Antigravity لديك، وفي OpenCode يقرؤه النموذج الذي اخترته فيه آخر مرة. يذهب المستند كله إلى الجهة التي صنعت ما يقرؤه، بشروط حسابك واختيارك بشأن التدريب. تعرض لوحة التحكم مدى التقدم. ومن رواية، يقترح مدير اللعبة من أين تبدأ. ثم يكتب الأماكن والشخصيات والأسرار.
|
|
266
269
|
|
|
267
270
|
تُلعب الحملة مرة واحدة: للعب المغامرة نفسها من جديد، أنشئ حملة جديدة.
|
|
268
271
|
|
|
269
272
|
### 7.2 اللغات
|
|
270
273
|
|
|
271
|
-
لغة واحدة لكل حملة، هي لغة مدير اللعبة، وتتبعها لوحة التحكم. تأتي لوحة التحكم بـ 26 لغة. وأي لغة أخرى يترجمها Codex أو Claude Code
|
|
274
|
+
لغة واحدة لكل حملة، هي لغة مدير اللعبة، وتتبعها لوحة التحكم. تأتي لوحة التحكم بـ 26 لغة. وأي لغة أخرى يترجمها على حاسوبك تطبيق الذكاء الاصطناعي الخاص بك خارج الدردشة (Codex أو Claude Code. وفي Antigravity وOpenCode، وكيلاهما الخاص)، أو، إن لم يستطع أي منها، مدير اللعبة في الدردشة. مصطلحات الطبعة الخامسة بالإيطالية تأتي من SRD الإيطالي الرسمي. يبقى نص القواعد بالإنجليزية، ويرويه مدير اللعبة بلغتك.
|
|
272
275
|
|
|
273
276
|
---
|
|
274
277
|
|
|
@@ -320,7 +323,7 @@ rpg init "The Salt Isles"
|
|
|
320
323
|
|
|
321
324
|
**يتذكر مدير اللعبة شيئًا ألغيته.** افتح محادثة جديدة واضغط **فتحت محادثة جديدة** في نقاط الحفظ.
|
|
322
325
|
|
|
323
|
-
**لا تظهر صور.** الإعدادات > الصور تبيّن هل يستطيع هذا الحاسوب صنعها، وكيف.
|
|
326
|
+
**لا تظهر صور.** الإعدادات > الحملة > الصور تبيّن هل يستطيع هذا الحاسوب صنعها، وكيف.
|
|
324
327
|
|
|
325
328
|
**يفشل التثبيت، أو لا يبدأ `rpg`.** يجب أن يعرض `node --version` الإصدار 24 أو أحدث. إذا ظهر في Windows أن تشغيل السكربتات معطّل، فراجع [2.1](#21-what-you-need). في Windows، أبقِ RPG Engine وحملاتك بعيدًا عن المسارات التي تحتوي على `&`.
|
|
326
329
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: 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,14 +64,17 @@ 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
|
-
- **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á
|
|
70
|
+
- **Codex**: ve složce kampaně napiš `codex` a na otázku, jestli složce důvěřuješ, odpověz ano. V klíčových chvílích mluví postava přes vlastního agenta, `.codex/agents/rpg-character.toml`, který ví jen to, co ví ona. 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; 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, s placeným tarifem Google. V bezplatném tarifu jeho nástroj na obrázky selže a Pán jeskyně kreslí jednoduché vektorové obrázky, stejně jako Claude. V klíčových chvílích mluví postava přes vlastního agenta, `.agents/agents/rpg-character.md`: Pán jeskyně napíše větu příběhu a odpověď postavy přijde o chvíli později. Tvůj Antigravity také mimo chat překládá dashboard a pravidla hry a čte dokumenty, které importuješ, a to z kvóty tvého účtu Google: RPG Engine ho spouští odděleně od tvých vlastních chatů, takže mezi nimi nic nezanechá. 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ě OpenCode zeptá. Obrázky kreslí Pán jeskyně sám, jako jednoduché vektorové obrázky, stejně jako Claude. V klíčových chvílích mluví postava přes vlastního agenta, `.opencode/agents/rpg-character.md`: Pán jeskyně napíše větu příběhu a odpověď postavy přijde o chvíli později; malý lokální model ho nemusí zavolat. Tvůj OpenCode s modelem, který sis v něm naposledy vybral, 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
|
|
|
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
|
+
|
|
77
|
+
Hrajeme a testujeme s **Claude Code**. **Codex**, **Antigravity** a **OpenCode** 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
|
|
77
80
|
|
|
@@ -127,7 +130,7 @@ Když chceš mluvit mimo příběh, napiš `[OOC: …]` (out of character): *[OO
|
|
|
127
130
|
|
|
128
131
|
Ty říkáš, o co se pokoušíš. Pán jeskyně říká, co se stane. Pán jeskyně nikdy nerozhoduje za tvou postavu a nikdy nemluví o enginu. Můžeš se ho zeptat, jak se používá dashboard.
|
|
129
132
|
|
|
130
|
-
**Jednání z dashboardu**: klikni na jméno v deníku postavy, třeba na zbraň, kouzlo nebo předmět, který neseš: karta řekne, co to je. Vyber, co s tím chceš dělat, třeba **
|
|
133
|
+
**Jednání z dashboardu**: klikni na jméno v deníku postavy, třeba na zbraň, kouzlo nebo předmět, který neseš: karta řekne, co to je. Brašna se otevře šipkou a její ⓘ ukáže její kartu. Vyber, co s tím chceš dělat. Věc, která nikoho nepotřebuje, třeba **Vybavit**, chce potvrzení na stejném tlačítku, *Potvrdit: Vybavím Štít*: stiskni ho znovu a jde to Pánu jeskyně. Věc, která se dělá někomu, třeba **Zaútočit**, se zeptá na koho, v seznamu nebo kliknutím na mapě. Pak tlačítko řekne celou větu, *Zaútočím palcátem na Zakuklený bandita 1*, a jedno kliknutí ji odešle. Chceš-li to říct po svém, klikni na osobu, se kterou chceš mluvit, nebo piš do chatu. Pán jeskyně to slyší, jako by to bylo řečeno v chatu, rozhodne o tom jako o každé jiné věci a tlačítky se zeptá na to, co jsi vynechal(a). Pokud tvoje AI aplikace nemá zvonek, Pán jeskyně si to přečte, jakmile příště napíšeš do chatu. Pokud byl chat předtím zavřený, **Říct znovu** to pošle ještě jednou.
|
|
131
134
|
|
|
132
135
|
### 3.2 Hody
|
|
133
136
|
|
|
@@ -195,7 +198,7 @@ Robot nahoře na dashboardu je Pán jeskyně. Jeho tvář sleduje tón příběh
|
|
|
195
198
|
|
|
196
199
|
### 3.11 Obrázky
|
|
197
200
|
|
|
198
|
-
RPG Engine může nechat vytvořit obrázky míst, kam dojdeš, úkolů, které přijmeš, i postav, které potkáš, podle nastavení **Obrázky**, a také portrét tvé postavy, když o něj požádáš.
|
|
201
|
+
RPG Engine může nechat vytvořit obrázky míst, kam dojdeš, úkolů, které přijmeš, i postav, které potkáš, podle nastavení **Obrázky**, a také portrét tvé postavy, když o něj požádáš. Tvoje vlastní AI aplikace je vytváří svými prostředky, s tvým přihlášením, na tvém tarifu a v jeho limitech: **Claude** je kreslí jako vektorové obrázky, **Codex** a **Antigravity** je malují, **OpenCode** kreslí v chatu jednoduché vektorové obrázky. V **Nastavení > Kampaň > Obrázky** můžeš nechat Codex nebo Antigravity malovat obrázky i tehdy, když je tvým Pánem jeskyně jiná aplikace: tam, kde ta, kterou sis vybral(a), nemůže, je vytvoří tvůj chat. **Nastavení** ukazuje, zda je tento počítač umí vytvářet, a jak to případně nastavit. Vlastní obrázek můžeš dát vždy, své postavě i kterékoli stránce, kterou vidíš: najeď ukazatelem na některý její obrázek a v rohu se ukáže malé tlačítko s obrázkem (jde to i klávesnicí a na telefonu je vidět vždy). Ve **Světě** má otevřená stránka také **Změnit obrázek…**, nebo **Přidat obrázek…**, dokud žádný nemá. Tvůj obrázek nahradí ten, který stránka má. Nebo soubor vlož do složky **inbox** v kampani a řekni Pánu jeskyně, pro kterou stránku je.
|
|
199
202
|
|
|
200
203
|
### 3.12 Bezpečí: hranice, závoje a stop
|
|
201
204
|
|
|
@@ -216,7 +219,7 @@ Stránka na tvém počítači, kterou otevřeš jen v prohlížeči na tomto po
|
|
|
216
219
|
- **Kronika**: úkoly, příběh jako kniha, jeho časová osa, deníky tvých společníků a tvé poznámky.
|
|
217
220
|
- **Svět**: mapa světa, co tvá postava ví, nalezené dokumenty a kalendář.
|
|
218
221
|
- **Podnos na kostky**: vyber kostky a opravu a hoď. ×2 zdvojnásobí kostky, nikdy ne opravu, jako při kritickém zásahu.
|
|
219
|
-
- **Uložené hry**, **Nápověda**, **Nastavení** a **O aplikaci**: ikony na konci řady. V **Nastavení** najdeš také vlastní předvolby stránky: motiv, zvuk kostek, sadu kostek a **Styl hry**, tedy barvy, podoby a obrázky stránky. Může to být styl herního systému, motiv přidaný v Packages › Add z katalogu, z odkazu na GitHub, ze souboru .zip nebo ze složky, anebo vlastní styl stránky. Pokud kvůli vlastnímu stylu motivu není stránka dobře čitelná, vypni tam **Vlastní styl motivu**. Nastavení se vždy zobrazí bez něj, na adrese stránky s `#/settings` na konci.
|
|
222
|
+
- **Uložené hry**, **Nápověda**, **Nastavení** a **O aplikaci**: ikony na konci řady. V **Nastavení** najdeš pod **Tato stránka** také vlastní předvolby stránky: motiv, zvuk kostek, sadu kostek a **Styl hry**, tedy barvy, podoby a obrázky stránky. Může to být styl herního systému, motiv přidaný v Packages › Add z katalogu, z odkazu na GitHub, ze souboru .zip nebo ze složky, anebo vlastní styl stránky. Pokud kvůli vlastnímu stylu motivu není stránka dobře čitelná, vypni tam **Vlastní styl motivu**. Nastavení se vždy zobrazí bez něj, na adrese stránky s `#/settings/page` na konci.
|
|
220
223
|
|
|
221
224
|
Když se tě Pán jeskyně na něco zeptá, jeho nápis zůstane nahoře, ať jsi v jakékoli části.
|
|
222
225
|
|
|
@@ -260,15 +263,15 @@ Rozšíření přidá do kampaně něco navíc k jejímu hernímu systému: nap
|
|
|
260
263
|
|
|
261
264
|
### 7.1 Tři cesty ke světu
|
|
262
265
|
|
|
263
|
-
- **Vytvářený za pochodu**: z
|
|
266
|
+
- **Vytvářený za pochodu**: z tvého námětu Pán jeskyně buduje každé místo, osobu i zápletku těsně předtím, než je potřebuješ, a uchovává je.
|
|
264
267
|
- **Připravený na začátku**: totéž, ale svět se postaví před hrou.
|
|
265
|
-
- **Z tvého vlastního dobrodružství nebo knihy**: dej Pánu jeskyně její soubor, *[Naimportuj toto dobrodružství jako naši kampaň: D:\Books\adventure.pdf. Neříkej mi nic z toho, co v něm je.]* Nejlépe se čte jako text, EPUB, dokument Word nebo PDF s textem, který lze označit. Naskenované PDF se čte z obrázků stránek, jen ve Windows, pomalu a s několika chybami.
|
|
268
|
+
- **Z tvého vlastního dobrodružství nebo knihy**: dej Pánu jeskyně její soubor, *[Naimportuj toto dobrodružství jako naši kampaň: D:\Books\adventure.pdf. Neříkej mi nic z toho, co v něm je.]* Nejlépe se čte jako text, EPUB, dokument Word nebo PDF s textem, který lze označit. Naskenované PDF se čte z obrázků stránek, jen ve Windows, pomalu a s několika chybami. Čte ho tvoje vlastní AI aplikace mimo chat, jinak Pán jeskyně v chatu, v rámci tvého tarifu: v Claude Code nebo Codexu ho čte jeden z těchto dvou, v Antigravity tvůj Antigravity, v OpenCode model, který sis v něm naposledy vybral. Celý dokument jde tvůrci toho, kdo ho čte, podle podmínek tvého účtu a jeho nastavení ohledně trénování. Dashboard ukazuje, jak daleko to je. U románu Pán jeskyně navrhne, kde začít. Napíše místa, postavy a tajemství.
|
|
266
269
|
|
|
267
270
|
Kampaň se hraje jednou: chceš-li hrát totéž dobrodružství znovu, vytvoř novou kampaň.
|
|
268
271
|
|
|
269
272
|
### 7.2 Jazyky
|
|
270
273
|
|
|
271
|
-
Jeden jazyk na kampaň, ten Pána jeskyně, kterým se řídí i dashboard. Dashboard se dodává ve 26 jazycích. Jakýkoli jiný přeloží na tvém počítači Codex nebo Claude Code, nebo
|
|
274
|
+
Jeden jazyk na kampaň, ten Pána jeskyně, kterým se řídí i dashboard. Dashboard se dodává ve 26 jazycích. Jakýkoli jiný přeloží na tvém počítači tvoje vlastní AI aplikace mimo chat (Codex nebo Claude Code; v Antigravity a OpenCode jejich vlastní), nebo, pokud to žádná neumí, Pán jeskyně v chatu. Italské názvy pojmů páté edice pocházejí z oficiálního italského SRD, text pravidel zůstává anglicky a Pán jeskyně ho převypráví ve tvém jazyce.
|
|
272
275
|
|
|
273
276
|
---
|
|
274
277
|
|
|
@@ -320,7 +323,7 @@ Každý příkaz, který Pán jeskyně používá, jde spustit i ve složce kamp
|
|
|
320
323
|
|
|
321
324
|
**Pán jeskyně si pamatuje něco, co jsem vrátil(a) zpět.** Otevři nový chat a v Uložených hrách stiskni **Nový chat otevřen**.
|
|
322
325
|
|
|
323
|
-
**Neobjevují se žádné obrázky.** Nastavení > Obrázky říká, jestli je tento počítač umí vytvářet, a jak.
|
|
326
|
+
**Neobjevují se žádné obrázky.** Nastavení > Kampaň > Obrázky říká, jestli je tento počítač umí vytvářet, a jak.
|
|
324
327
|
|
|
325
328
|
**Instalace selže, nebo `rpg` nechce začít.** `node --version` musí hlásit 24 nebo novější. Pokud Windows odpoví, že spouštění skriptů je zakázané, viz [2.1](#21-what-you-need). Ve Windows nech RPG Engine a své kampaně mimo cesty, které obsahují `&`.
|
|
326
329
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: den 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,14 +64,17 @@ 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
|
-
- **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
|
|
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
|
|
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 giver straks spillederen besked, når du handler fra dashboardet.
|
|
70
|
+
- **Codex**: skriv `codex` i kampagnemappen, og sig ja, når den spørger, om du stoler på mappen. I de afgørende øjeblikke taler en karakter gennem en agent, der er helt sin egen, `.codex/agents/rpg-character.toml`, som kun ved det, karakteren selv ved. 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. 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` giver straks spillederen besked, når du handler fra dashboardet. Spillederen maler billederne i selve chatten, med et betalt Google-abonnement. På det gratis abonnement fejler billedværktøjet, og spillederen tegner i stedet enkle vektorbilleder, som Claude gør. I de afgørende øjeblikke taler en karakter gennem en agent, der er helt sin egen, `.agents/agents/rpg-character.md`: spillederen skriver en replik i historien, og karakterens svar kommer et øjeblik senere. Din Antigravity oversætter også dashboardet og spillets regler og læser de dokumenter, du importerer, uden for chatten, på din Google-kontos kvote. RPG Engine starter den adskilt fra dine egne chats, så den efterlader intet iblandt dem. 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 giver spillederen besked, 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. I de afgørende øjeblikke taler en karakter gennem en agent, der er helt sin egen, `.opencode/agents/rpg-character.md`: spillederen skriver en replik i historien, og karakterens svar kommer et øjeblik senere. En lille lokal model kalder den måske ikke. 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
|
|
|
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
|
+
|
|
77
|
+
Vi spiller og tester med **Claude Code**. **Codex**, **Antigravity** og **OpenCode** 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
|
|
77
80
|
|
|
@@ -127,7 +130,7 @@ Når du taler uden for historien, skriv `[OOC: …]` (out of character): *[OOC:
|
|
|
127
130
|
|
|
128
131
|
Du siger, hvad du prøver på. Spillederen siger, hvad der sker. Spillederen bestemmer aldrig noget for din karakter og taler aldrig om motoren. Du kan spørge spillederen, hvordan dashboardet bruges.
|
|
129
132
|
|
|
130
|
-
**Handl fra dashboardet**: Klik på et navn på dit karakterark, for eksempel et våben, en besværgelse eller noget, du bærer. Dets kort fortæller, hvad det er. Vælg, hvad du gør med det, for eksempel **
|
|
133
|
+
**Handl fra dashboardet**: Klik på et navn på dit karakterark, for eksempel et våben, en besværgelse eller noget, du bærer. Dets kort fortæller, hvad det er. En taske åbnes med sin pil, og dens ⓘ viser dens kort. Vælg, hvad du gør med det. Noget, der ikke kræver nogen anden, for eksempel **Udstyr**, beder dig bekræfte på selve knappen, *Bekræft: Jeg udstyrer Shield*. Tryk på den igen, så går den til spillederen. Noget, du gør mod nogen, for eksempel **Angrib**, spørger, hvem det gælder, i listen eller med et klik på kortet. Så siger knappen hele sætningen, *Jeg angriber Hooded Bandit 1 med Mace*, og ét klik sender den. Vil du sige det på din egen måde, så klik på en person for at tale med vedkommende, eller skriv i chatten. Spillederen hører det som sagt i chatten, afgør det som alt andet og spørger dig med knapper om det, du udelod. Hvis din AI-app ikke kan give besked med det samme, læser spillederen det, så snart du næste gang skriver i chatten. Var chatten lukket før, sender **Sig det igen** det en gang til.
|
|
131
134
|
|
|
132
135
|
### 3.2 Slag
|
|
133
136
|
|
|
@@ -195,7 +198,7 @@ Robotten øverst på dashboardet er spillederen. Dens ansigt følger historiens
|
|
|
195
198
|
|
|
196
199
|
### 3.11 Billeder
|
|
197
200
|
|
|
198
|
-
RPG Engine kan få lavet billeder af de steder, du når frem til, de missioner, du tager på dig, og de personer, du møder, som indstillingen **Billeder** angiver, og din karakters portræt, når du beder om det.
|
|
201
|
+
RPG Engine kan få lavet billeder af de steder, du når frem til, de missioner, du tager på dig, og de personer, du møder, som indstillingen **Billeder** angiver, og din karakters portræt, når du beder om det. Din egen AI-app laver dem med sine egne midler, med dit login, på dit abonnement og inden for dets grænser: **Claude** tegner dem som vektorbilleder, **Codex** og **Antigravity** maler dem, **OpenCode** tegner enkle vektorbilleder i chatten. Under **Indstillinger > Kampagne > Billeder** kan du lade Codex eller Antigravity male dem, også når din spilleder er en anden app. Hvor den, du har valgt, ikke kan, laver din chat dem. **Indstillinger** viser, om denne computer kan lave dem, og hvordan du sætter det op, hvis ikke. Du kan altid give et billede, du selv har, til din karakter eller til en hvilken som helst side, du ser: Før markøren hen over et af dens billeder, så vises en lille billedknap i hjørnet (det virker også med tastaturet og er altid synligt på en telefon). I **Verden** har den side, du åbner, også **Skift billedet…**, eller **Tilføj et billede…**, mens den ikke har nogen. Dit billede træder i stedet for det, siden har. Du kan også lægge filen i kampagnens mappe **inbox** og sige til spillederen, hvilken side den er til.
|
|
199
202
|
|
|
200
203
|
### 3.12 Sikkerhed: linjer, slør og stop
|
|
201
204
|
|
|
@@ -216,7 +219,7 @@ En side på din egen computer, som kun kan åbnes i den computers browser, og so
|
|
|
216
219
|
- **Dagbog**: missioner, historien som en bog, dens tidslinje, dine følgesvendes dagbøger og dine noter.
|
|
217
220
|
- **Verden**: verdenskortet, det din karakter ved, de dokumenter, I har fundet, og kalenderen.
|
|
218
221
|
- **Terningbakken**: vælg terninger og en modifikator, og slå. ×2 fordobler terningerne, aldrig modifikatoren, som ved et kritisk slag.
|
|
219
|
-
- **Gemte spil**, **Hjælp**, **Indstillinger** og **Om** som ikoner for enden af rækken. Indstillinger
|
|
222
|
+
- **Gemte spil**, **Hjælp**, **Indstillinger** og **Om** som ikoner for enden af rækken. Under **Denne side** i Indstillinger finder du også sidens egne valg: tema, terningelyd, terningesæt og **Spillets stil**. Det er sidens farver, ansigter og billeder: spilsystemets egne, et tema, du har tilføjet under Packages › Add fra kataloget, med et GitHub-link, en .zip eller en mappe, eller sidens egne. Hvis et temas egen stilark gør siden svær at læse, kan du slå **Temaets egen stil** fra der. Indstillinger vises altid uden den, på sidens adresse med `#/settings/page` til sidst.
|
|
220
223
|
|
|
221
224
|
Når spillederen spørger dig om noget, bliver spillederens banner øverst, uanset hvilken sektion du er i.
|
|
222
225
|
|
|
@@ -262,13 +265,13 @@ En udvidelse tilføjer noget til en kampagne oveni dens spilsystem: en funktion
|
|
|
262
265
|
|
|
263
266
|
- **Lavet undervejs**: ud fra din præmis bygger spillederen hvert sted, hver person og hvert plot lige før, du får brug for det, og husker det.
|
|
264
267
|
- **Forberedt i starten**: det samme, men med verdenen bygget før spillet.
|
|
265
|
-
- **Fra dit eget eventyr eller din egen bog**: giv spillederen filen, *[Importér dette eventyr som vores kampagne: D:\Books\adventure.pdf. Fortæl mig ikke noget af det, der står i det.]* Den læser bedst som tekst, en EPUB, et Word-dokument eller en PDF, hvor teksten kan markeres. En indscannet PDF læses ud fra billederne af siderne, kun på Windows, langsomt og med nogle fejl. Din egen
|
|
268
|
+
- **Fra dit eget eventyr eller din egen bog**: giv spillederen filen, *[Importér dette eventyr som vores kampagne: D:\Books\adventure.pdf. Fortæl mig ikke noget af det, der står i det.]* Den læser bedst som tekst, en EPUB, et Word-dokument eller en PDF, hvor teksten kan markeres. En indscannet PDF læses ud fra billederne af siderne, kun på Windows, langsomt og med nogle fejl. Din egen AI-app læser den uden for chatten, ellers spillederen i chatten, på dit abonnement: i Claude Code eller Codex læser en af de to den, i Antigravity din Antigravity, i OpenCode den model, du sidst har valgt i den. Hele dokumentet går til udvikleren af det, der læser det, under vilkårene for din konto og dens valg om træning. Dashboardet viser, hvor langt den er nået. Ud fra en roman foreslår spillederen, hvor I skal starte. Spillederen skriver stederne, karaktererne og hemmelighederne.
|
|
266
269
|
|
|
267
270
|
En kampagne spilles én gang: for at spille det samme eventyr igen skal du oprette en ny kampagne.
|
|
268
271
|
|
|
269
272
|
### 7.2 Sprog
|
|
270
273
|
|
|
271
|
-
Ét sprog per kampagne, spillederens, som dashboardet følger. Dashboardet leveres på 26 sprog. Ethvert andet oversættes på din computer af Codex eller Claude Code, eller,
|
|
274
|
+
Ét sprog per kampagne, spillederens, som dashboardet følger. Dashboardet leveres på 26 sprog. Ethvert andet oversættes på din computer af din egen AI-app uden for chatten (Codex eller Claude Code; i Antigravity og OpenCode deres egne), eller, hvor ingen kan, af spillederen i chatten. Femte udgaves termer på italiensk kommer fra den officielle italienske SRD. Regelteksten forbliver på engelsk, og spillederen fortæller den på dit sprog.
|
|
272
275
|
|
|
273
276
|
---
|
|
274
277
|
|
|
@@ -320,7 +323,7 @@ Alle kommandoer, spillederen bruger, kan også køres i kampagnemappen: `rpg --h
|
|
|
320
323
|
|
|
321
324
|
**Spillederen husker noget, jeg fortrød.** Åbn en ny chat, og tryk på **Jeg har åbnet en ny chat** under Gemte spil.
|
|
322
325
|
|
|
323
|
-
**Der kommer ingen billeder.** Indstillinger > Billeder viser, om denne computer kan lave dem, og hvordan.
|
|
326
|
+
**Der kommer ingen billeder.** Indstillinger > Kampagne > Billeder viser, om denne computer kan lave dem, og hvordan.
|
|
324
327
|
|
|
325
328
|
**Installationen fejler, eller `rpg` vil ikke starte.** `node --version` skal vise 24 eller nyere. Hvis Windows svarer, at det er slået fra at køre scripts, så se [2.1](#21-what-you-need). På Windows skal du holde RPG Engine og dine kampagner ude af stier, der indeholder `&`.
|
|
326
329
|
|