rpg-engine 0.0.0-stage → 0.1.0

package/dist/dashboard/free-rolls.js

@@ -0,0 +1,41 @@
+// Where the browser keeps them, and how many at most.
+const freeKey = "rpg-engine.free-rolls.1";
+const mostFree = 30;
+export function readFree(campaign) {
+    try {
+        const kept = JSON.parse(localStorage.getItem(`${freeKey}:${campaign ?? ""}`) ?? "[]");
+        return Array.isArray(kept) ? kept.filter(isPageRoll) : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** The free rolls with one more, the oldest left out past the most kept; kept in the browser. */
+export function withFree(campaign, rolls, roll) {
+    const kept = [...rolls, roll].slice(-mostFree);
+    writeFree(campaign, kept);
+    return kept;
+}
+export function writeFree(campaign, rolls) {
+    try {
+        if (rolls.length === 0) {
+            localStorage.removeItem(`${freeKey}:${campaign ?? ""}`);
+        }
+        else {
+            localStorage.setItem(`${freeKey}:${campaign ?? ""}`, JSON.stringify(rolls));
+        }
+    }
+    catch {
+        // The page forgets them at the next reload.
+    }
+}
+/** Whether what the browser kept is a free roll whole, as the page writes one: a field missing or of another kind leaves it out. */
+function isPageRoll(kept) {
+    if (typeof kept !== "object" || kept === null) {
+        return false;
+    }
+    const roll = kept;
+    const isDie = (die) => typeof die === "object" && die !== null && typeof die.value === "number" && (typeof die.sides === "number" || die.sides === "F");
+    return roll.free === true && typeof roll.id === "string" && typeof roll.at === "string" && !Number.isNaN(Date.parse(roll.at)) && typeof roll.notation === "string"
+        && typeof roll.text === "string" && typeof roll.total === "number" && Array.isArray(roll.dice) && roll.dice.every(isDie);
+}

package/dist/dashboard/game-words.js

@@ -0,0 +1,164 @@
+import { fieldLabel, phraseLabel } from "./labels.js";
+import { isolated, listText, systemWord, t } from "./text.js";
+/** A game date in the page's language: day 3, 06:00, or day 3; any other text as it is. */
+export function gameDateLabel(date) {
+    const read = readDate(date);
+    return read === undefined ? date : read.time === undefined ? t("day {day}", read) : t("day {day}, {time}", read);
+}
+// A date within a phrase is put in it by its day and hour, which each language bends as the phrase needs: до дня 3, jusqu'au jour 3.
+/** Until a game date, in the page's language: until day 3, 06:00. */
+export function untilDateLabel(date) {
+    const read = readDate(date);
+    return read === undefined ? t("until {date}", { date }) : read.time === undefined ? t("until day {day}", read) : t("until day {day}, {time}", read);
+}
+/** By a game date, as a deadline: by day 3, 06:00. */
+export function byDateLabel(date) {
+    const read = readDate(date);
+    return read === undefined ? t("by {date}", { date }) : read.time === undefined ? t("by day {day}", read) : t("by day {day}, {time}", read);
+}
+/** Since a game date: since day 1, 18:00. */
+export function sinceDateLabel(date) {
+    const read = readDate(date);
+    return read === undefined ? t("since {when}", { when: date }) : read.time === undefined ? t("since day {day}", read) : t("since day {day}, {time}", read);
+}
+/** When an effect ends, in the page's language: until day 1, 18:01, until the scene ends, until the next long rest, as the game system says it. */
+export function effectEndLabel(end) {
+    if ("date" in end) {
+        return untilDateLabel(end.date);
+    }
+    if ("round" in end) {
+        return t("until {name}'s turn in round {round}", { name: nameLabel(end.turn), round: end.round });
+    }
+    return "scene" in end ? t("until the scene ends") : systemWord("words", `until ${end.occasion}`) ?? t("until {occasion}", { occasion: systemWord("words", end.occasion) ?? end.occasion });
+}
+/** An effect in the page's language, with its end: Benedizione until day 1, 18:01. */
+export function effectLabel(effect) {
+    return effect.end === undefined ? effect.name : `${effect.name} ${effectEndLabel(effect.end)}`;
+}
+/** Where a place is from the party, in the page's language: 12 km north-east, Here; the length as `length` writes it in the player's units. */
+export function fromLabel(from, length) {
+    return from.direction === undefined ? t("Here") : t("{distance} {direction}", { distance: length(from.km), direction: directionLabel(from.direction) });
+}
+/** A point of the compass in the page's language: north-east. */
+export function directionLabel(direction) {
+    const labels = {
+        "north": t("north"),
+        "north-north-east": t("north-north-east"),
+        "north-east": t("north-east"),
+        "east-north-east": t("east-north-east"),
+        "east": t("east"),
+        "east-south-east": t("east-south-east"),
+        "south-east": t("south-east"),
+        "south-south-east": t("south-south-east"),
+        "south": t("south"),
+        "south-south-west": t("south-south-west"),
+        "south-west": t("south-west"),
+        "west-south-west": t("west-south-west"),
+        "west": t("west"),
+        "west-north-west": t("west-north-west"),
+        "north-west": t("north-west"),
+        "north-north-west": t("north-north-west"),
+    };
+    return labels[direction] ?? direction;
+}
+/** What the points say of the levels, in the page's language: 1200 to level 4, level 4 due, at least 900 at level 3. */
+export function levelNeedLabel(need) {
+    if ("least" in need) {
+        return t("at least {points} at level {level}", { points: need.least, level: need.level });
+    }
+    return "due" in need ? t("level {level} due", { level: need.due }) : t("{points} to level {level}", { points: need.needs, level: need.level });
+}
+/** What the sheet shows beside a value: what the points say of the levels, in the page's language, else the engine's text, as +2 beside a score. */
+export function besideLabel(value) {
+    return value.levelNeed === undefined ? value.beside : levelNeedLabel(value.levelNeed);
+}
+/** Where someone of the party is: the places that hold them, the nearest first; elsewhere, or in the open. */
+export function memberPlaceLabel(place) {
+    return Array.isArray(place) ? place.map(isolated).join(" › ") : place === "open" ? t("In the open") : t("Elsewhere");
+}
+/** A region's terrain in the page's language, as the game system says it: difficult terrain. */
+export function terrainLabel(terrain) {
+    return systemWord("words", `${terrain} terrain`) ?? t("{terrain} terrain", { terrain: systemWord("words", terrain) ?? terrain });
+}
+/** A name of the story as the character knows it, in the page's language: someone, a creature, somewhere for those it does not know. */
+export function nameLabel(name) {
+    const labels = { someone: t("someone"), creature: t("a creature"), somewhere: t("somewhere") };
+    return labels[name] ?? name;
+}
+/** A fact of the story in the page's language, as a sentence: Ettore: PF 14 → 12. */
+export function factLabel(fact) {
+    const told = (() => {
+        switch (fact.kind) {
+            case "counter":
+                return t("{who}: {field} {before} → {after}", { who: subjectLabel(fact.who), field: fieldLabel(fact.field), before: fact.before, after: fact.after });
+            case "time":
+                return fact.from === undefined
+                    ? storyStartLabel(fact.to)
+                    : t("Time passes: {from} → {to}", { from: gameDateLabel(fact.from), to: gameDateLabel(fact.to) });
+            case "moved":
+                return fact.to === undefined
+                    ? t("{who} to the open", { who: listText(fact.who.map((name, index) => (index === 0 ? subjectLabel(name) : nameLabel(name)))) })
+                    : t("{who} to {place}", { who: listText(fact.who.map((name, index) => (index === 0 ? subjectLabel(name) : nameLabel(name)))), place: nameLabel(fact.to) });
+            case "learned":
+                return t("{who} learned: {what}", { who: fact.who, what: listText(fact.what.map((link) => link.replace("#", " › "))) });
+            case "effect":
+                return t("{who}: {effect}", { who: subjectLabel(fact.who), effect: effectLabel(fact) });
+            case "effect-ended":
+                return t("{who}: {effect} ended", { who: subjectLabel(fact.who), effect: fact.effect });
+            case "back":
+                return t("Back to save {save}: what came after it is gone", { save: fact.save });
+            case "quest":
+                return fact.status === "open" ? t("Quest taken: {quest}", { quest: fact.quest }) : fact.status === "done" ? t("Quest completed: {quest}", { quest: fact.quest }) : t("Quest failed: {quest}", { quest: fact.quest });
+        }
+    })();
+    return told;
+}
+/** When the story starts: on day 1, 18:00. */
+function storyStartLabel(date) {
+    const read = readDate(date);
+    return read === undefined ? t("The story starts on {date}", { date }) : read.time === undefined ? t("The story starts on day {day}", read) : t("The story starts on day {day}, {time}", read);
+}
+/** A game date's day and hour as the engine writes them, day 3, 06:00; undefined for any other text. */
+function readDate(date) {
+    const read = /^day\s+(\d+)(?:\s*,\s*(\d{1,2}:\d{2}))?$/i.exec(date.trim());
+    return read === null ? undefined : { day: read[1], ...(read[2] === undefined ? {} : { time: read[2] }) };
+}
+/** Who does something, opening a fact: Someone and A creature with their capital, a name as it is written, as al-Mansur. */
+function subjectLabel(name) {
+    return name === "someone" || name === "creature" ? phraseLabel(nameLabel(name)) : name;
+}
+/** A notation in words, in the page's language: 2d20, keep the highest, +5 (D-292); none for none. */
+export function notationLabel(parts) {
+    return parts?.map((part) => ("add" in part ? part.add : [part.dice, ...diceRuleLabels(part)].join(", "))).join(", ");
+}
+/** What dice do past rolling them, in the page's language: keep, drop, reroll, explode, count successes. */
+function diceRuleLabels(part) {
+    const { keep, drop, rerollOnce, explode, success } = part;
+    return [
+        keep === undefined
+            ? undefined
+            : keep.count === 1
+                ? keep.which === "highest" ? t("keep the highest") : t("keep the lowest")
+                : keep.which === "highest"
+                    ? t("keep the {count} highest", { count: keep.count })
+                    : t("keep the {count} lowest", { count: keep.count }),
+        drop === undefined
+            ? undefined
+            : drop.count === 1
+                ? drop.which === "highest" ? t("drop the highest") : t("drop the lowest")
+                : drop.which === "highest"
+                    ? t("drop the {count} highest", { count: drop.count })
+                    : t("drop the {count} lowest", { count: drop.count }),
+        rerollOnce === undefined ? undefined : t("reroll once {condition}", { condition: conditionLabel(rerollOnce) }),
+        explode === undefined
+            ? undefined
+            : explode.compound
+                ? t("add a die to the die {condition}", { condition: conditionLabel(explode.condition) })
+                : t("roll one more {condition}", { condition: conditionLabel(explode.condition) }),
+        success === undefined ? undefined : t("count the dice {condition}", { condition: conditionLabel(success) }),
+    ].filter((rule) => rule !== undefined);
+}
+function conditionLabel({ operator, value }) {
+    const labels = { "=": t("on {value}", { value }), "<=": t("on {value} or less", { value }), ">=": t("on {value} or more", { value }), "<": t("below {value}", { value }), ">": t("above {value}", { value }) };
+    return labels[operator];
+}

package/dist/dashboard/glass.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+// The glass over a token on a map (D-326): a low lens over the picture, which shows to the edge; never written into it. Its flat top takes the light in a
+// band with a crisp edge, as flat glass does; only over its outer fifth it rounds off into the edge, soft, with no line where it begins: a little lighter at
+// the top left, a little darker at the bottom right, a soft gleam where the light catches it. No border of its own; and the token's shadow falls on the paper.
+/** The gradients, the rim's mask and the shadow of the glass, once in a drawing's defs, their ids starting with `prefix`. */
+export function GlassDefs({ prefix }) {
+    return (_jsxs(_Fragment, { children: [_jsxs("linearGradient", { id: `${prefix}-sheen`, x1: "0", y1: "0", x2: "1", y2: "1", children: [_jsx("stop", { offset: "0", "stop-color": "#fff", "stop-opacity": "0.3" }), _jsx("stop", { offset: "0.44", "stop-color": "#fff", "stop-opacity": "0.08" }), _jsx("stop", { offset: "0.45", "stop-color": "#fff", "stop-opacity": "0" }), _jsx("stop", { offset: "0.6", "stop-color": "#fff", "stop-opacity": "0" }), _jsx("stop", { offset: "0.61", "stop-color": "#fff", "stop-opacity": "0.05" }), _jsx("stop", { offset: "0.68", "stop-color": "#fff", "stop-opacity": "0" })] }), _jsxs("linearGradient", { id: `${prefix}-rim`, x1: "0.15", y1: "0.1", x2: "0.85", y2: "0.9", children: [_jsx("stop", { offset: "0", "stop-color": "#fff", "stop-opacity": "0.32" }), _jsx("stop", { offset: "0.45", "stop-color": "#fff", "stop-opacity": "0" }), _jsx("stop", { offset: "0.55", "stop-color": "#000", "stop-opacity": "0" }), _jsx("stop", { offset: "1", "stop-color": "#000", "stop-opacity": "0.26" })] }), _jsxs("radialGradient", { id: `${prefix}-gleam`, cx: "0.27", cy: "0.24", r: "0.42", children: [_jsx("stop", { offset: "0", "stop-color": "#fff", "stop-opacity": "0.6" }), _jsx("stop", { offset: "1", "stop-color": "#fff", "stop-opacity": "0" })] }), _jsxs("radialGradient", { id: `${prefix}-rim-fade`, children: [_jsx("stop", { offset: "0.78", "stop-color": "#fff", "stop-opacity": "0" }), _jsx("stop", { offset: "0.84", "stop-color": "#fff", "stop-opacity": "0.1" }), _jsx("stop", { offset: "0.9", "stop-color": "#fff", "stop-opacity": "0.4" }), _jsx("stop", { offset: "0.95", "stop-color": "#fff", "stop-opacity": "0.75" }), _jsx("stop", { offset: "1", "stop-color": "#fff", "stop-opacity": "1" })] }), _jsx("mask", { id: `${prefix}-rim-mask`, maskContentUnits: "objectBoundingBox", children: _jsx("circle", { cx: "0.5", cy: "0.5", r: "0.5", fill: `url(#${prefix}-rim-fade)` }) }), _jsxs("filter", { id: `${prefix}-drop`, x: "-40%", y: "-40%", width: "180%", height: "180%", children: [_jsx("feDropShadow", { dx: "0", dy: "1", stdDeviation: "0.5", "flood-color": "#2a1d10", "flood-opacity": "0.45" }), _jsx("feDropShadow", { dx: "0", dy: "2.5", stdDeviation: "1.8", "flood-color": "#2a1d10", "flood-opacity": "0.4" })] })] }));
+}
+/** The glass over a token of radius `r` centred at x, y: its flat top's sheen, then its rim rounding off into the edge, with the gleam at the top left. */
+export function Glass({ x = 0, y = 0, r, prefix }) {
+    return (_jsxs("g", { class: "glass", "pointer-events": "none", children: [_jsx("circle", { cx: x, cy: y, r: r, fill: `url(#${prefix}-sheen)` }), _jsxs("g", { mask: `url(#${prefix}-rim-mask)`, children: [_jsx("circle", { cx: x, cy: y, r: r, fill: `url(#${prefix}-rim)` }), _jsx("circle", { cx: x, cy: y, r: r, fill: `url(#${prefix}-gleam)` })] })] }));
+}

package/dist/dashboard/guide/ar.md

@@ -0,0 +1,306 @@
+<!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 2020efdb f4fdeebb 80a7cfb9 23c5f59b b8f80c05 8c9f41da 0b4a6ef8 4eb17899 728ca4a5 e2839149. Change the English, then run it again. -->
+# RPG Engine: الدليل الكامل
+
+يتيح لك **RPG Engine** لعب لعبة أدوار على الطاولة مع **ذكاء اصطناعي في دور مدير اللعبة**. تتحدث مع مدير اللعبة في **محادثة**. أما RPG Engine فيعمل خلف الكواليس: **يتذكر العالم**، و**يرمي النرد**، و**يمسك الحسابات**. بجانب المحادثة تُبقي صفحة مفتوحة في المتصفح، هي **لوحة التحكم**، وفيها ورقة شخصيتك والنرد والخرائط وسجلك.
+
+هذا الدليل للاعبين: لا تحتاج إلى معرفة البرمجة.
+
+## البدء السريع <!-- icon: send -->
+
+1. ثبّت **Node.js** من [nodejs.org](https://nodejs.org) (نسخة LTS).
+2. ثبّت **وكيل ذكاء اصطناعي**، وهو البرنامج الذي يعمل فيه مدير اللعبة، وسجّل الدخول: مثل Claude Code أو Codex ([2.4](#24-connect-your-ai)).
+3. في الطرفية، ثبّت RPG Engine: `npm install -g rpg-engine`.
+4. أنشئ حملة: `rpg init "The Salt Isles"`.
+5. ادخل المجلد الجديد بالأمر `cd "The Salt Isles"`، ثم شغّل وكيلك فيه: `claude` لـ Claude Code، و`codex` لـ Codex. أجب بنعم عندما يسأل هل تثق بالمجلد ([2.4](#24-connect-your-ai))، ثم اكتب *مرحبًا! لنبدأ.* يرد مدير اللعبة برابط لوحة التحكم.
+
+## 1. ما هو RPG Engine <!-- icon: about -->
+
+| من | ماذا يفعل |
+|---|---|
+| **أنت** | تلعب شخصيتك: ما تفعله وتقوله وتحاوله. |
+| **مدير اللعبة** (الذكاء الاصطناعي) | يروي القصة، ويؤدي دور كل الآخرين، ويقرر ما يحدث، ويطلب الرميات. |
+| **RPG Engine** | يحفظ العالم في ملفات، ويرمي النرد، ويحسب نقاط الصحة والمال والوقت والمسافات، ويُبقي الأسرار مخفية حتى تكتشفها. |
+
+يبقى العالم كما هو من أمسية إلى أخرى، حتى في محادثة جديدة، وحتى مع ذكاء اصطناعي مختلف:
+
+- **ما قيل يبقى صحيحًا.** الشرير الذي مات يبقى ميتًا.
+- **النرد حقيقي.** لا يستطيع مدير اللعبة التلاعب به، إلا في أسهل مستوى صعوبة، إن اخترته.
+- **الأسرار تبقى أسرارًا.** لا يخبرك مدير اللعبة بما لا تعرفه شخصيتك.
+- **العالم يتحرك.** تتقدم التهديدات أثناء الراحة أو السفر، وترى علاماتها.
+- **الحملة مجلد** على حاسوبك: توقف متى شئت، واستأنف لاحقًا.
+
+يلعب RPG Engine اليوم نظام لعبة واحدًا، هو **الإصدار الخامس**، من وثيقة مرجع النظام الحرة SRD 5.1. وستأتي أنظمة أخرى ([قريبًا](#9-coming-later)).
+
+---
+
+## 2. البداية <!-- icon: path -->
+
+### 2.1 ما تحتاج إليه
+
+- حاسوب بنظام Windows أو macOS أو Linux، ومتصفح ويب.
+- **Node.js 22** أو أحدث، من [nodejs.org](https://nodejs.org). يأتي معه `npm`، الذي يثبّت RPG Engine.
+- **طرفية**: في Windows، Terminal أو PowerShell. وفي macOS، Terminal. لفتح طرفية داخل مجلد، انقر بزر الفأرة الأيمن على المجلد واختر **Open in Terminal** (في Windows) أو **Services > New Terminal at Folder** (في macOS).
+- **وكيل ذكاء اصطناعي** لمدير اللعبة ([2.4](#24-connect-your-ai))، مع **أكبر نموذج** يقدمه: النموذج الصغير يسهل إقناعه بكشف الأسرار أو بتجاوز القواعد.
+
+### 2.2 التثبيت
+
+```text
+npm install -g rpg-engine
+```
+
+الأمر `rpg --version` يتحقق من نجاح التثبيت. تستخدم `rpg` مرة واحدة لكل حملة، لإنشائها. بعد ذلك يشغّل وكيلك RPG Engine بنفسه.
+
+### 2.3 إنشاء حملة
+
+افتح طرفية في المجلد الذي تحفظ فيه ألعابك ([2.1](#21-what-you-need) يشرح الطريقة):
+
+```text
+rpg init "The Salt Isles"
+```
+
+ينشئ هذا المجلد `The Salt Isles` وفيه حملة جديدة. ادخله بالأمر `cd "The Salt Isles"`. تذكّر مكانه: ستعود إليه في كل مرة تلعب. تختار كل شيء آخر لاحقًا، في المحادثة أو في لوحة التحكم. الأمر `rpg init --help` يعرض الخيارات التي يمكن اختيارها الآن، مثل `--language it` أو `--difficulty hard`.
+
+لا يستطيع مدير اللعبة إنشاء الحملة عنك: قبل `init` لا يوجد ما يدل وكيلك على مكان RPG Engine.
+
+### 2.4 ربط الذكاء الاصطناعي
+
+يعمل مدير اللعبة في **وكيل ذكاء اصطناعي**: تطبيق ذكاء اصطناعي، في الطرفية أو على سطح المكتب، يستطيع التعامل مع الملفات على حاسوبك، مثل Claude Code أو Codex. المحادثة العادية مثل claude.ai أو ChatGPT، أو تطبيق الهاتف، لا تكفي: يحتاج مدير اللعبة إلى الوصول إلى ملفات الحملة على حاسوبك. لكل وكيل خطته وتسجيل دخوله: Claude Code يحتاج خطة Claude مدفوعة، وCodex يحتاج تسجيل دخول ChatGPT. تثبّته مرة واحدة، من صفحته: [Claude Code](https://code.claude.com/docs/en/setup)، [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: في مجلد الحملة اكتب `claude`. عندما يسأل هل تثق بالمجلد، اختر **Yes, I trust this folder**. انتبه: الجواب المحدد مسبقًا هو *No, exit*.
+- **Codex**: في مجلد الحملة اكتب `codex`، وأجب بنعم عندما يسأل هل تثق بالمجلد. في تطبيقه المكتبي، تأكد من الإعدادات أن الذكريات معطلة لمحادثات اللعبة.
+- **وكيل آخر**: شغّله في مجلد الحملة وأعطه خادم MCP بالأمر `rpg mcp`. RPG Engine خادم MCP قياسي: أي وكيل يدعم MCP يمكنه أن يكون مدير اللعبة، بما في ذلك الوكلاء المحليون.
+
+نلعب ونختبر مع **Claude Code**. أما **Codex** فمربوط ومفحوص، لكن لم تُلعب به حملة كاملة بعد. كما يهيّئ `init` أيضًا **Gemini CLI**. تُطفئ الحملة ذاكرة الوكيل الخاصة: اللعبة تعيش في ملفاتها، حتى تكون العودة إلى نقطة حفظ عودة حقيقية.
+
+### 2.5 المحادثة الأولى
+
+اكتب أي شيء، مثل *مرحبًا! لنبدأ.* في أول رد في كل محادثة يعطيك مدير اللعبة **رابط لوحة التحكم**، يشبه `http://127.0.0.1:4750`. افتحه وأبقه بجانب المحادثة.
+
+بين رسائل مدير اللعبة يعرض وكيلك الأدوات التي يستخدمها. لا تفتح تفاصيلها (في Claude Code، ctrl+o)، فقد تكشف أسرارًا.
+
+تمر الحملة الجديدة بثلاث مراحل، تظهر في أعلى لوحة التحكم: **1 الإعدادات** (كيف تريد أن تلعب)، **2 الجلسة صفر** (تصنع شخصيتك، داخل اللعب)، **3 اللعب**.
+
+### 2.6 الإعدادات: اختيار طريقة اللعب
+
+يسأل مدير اللعبة فقط عما ما زال ناقصًا، بضعة أسئلة في كل مرة. وخطوة **الإعدادات** في لوحة التحكم تعرض الأسئلة نفسها على شكل بطاقات. اكتب "قرّر أنت" فيختار مدير اللعبة. يمكن تغيير كل شيء لاحقًا، في المحادثة أو في **الإعدادات**.
+
+| الإعداد | ما يحدده | القيم |
+|---|---|---|
+| **المرشد** | مقدار ما يعلّمك مدير اللعبة من القواعد | إيقاف، تلميحات، شرح تعليمي |
+| **الصعوبة** | مدى قسوة العالم | قصة، سهل، عادي، صعب، وحشي |
+| **الفتك** | معنى السقوط في القتال | سردي (لا موت أبدًا)، ملحمي (فقط عندما يهم)، بالنرد |
+| **نقاط الحفظ** | متى يمكنك العودة | موت دائم، نقطة تفتيش، حر ([3.8](#38-saves-and-going-back)) |
+| **الصرامة** | مدى التزام الطعام والضوء والسفر بالقواعد | سلس، قواعد، محاكاة |
+| **النرد** | من يرمي نردك | رقمي، فعلي |
+| **وحدات القياس** | المسافات والأوزان | متري، إمبراطوري |
+| **الرفاق** | من يسافر معك | لا أحد، يُصنعون معك، يصنعهم مدير اللعبة، تلتقي بهم في اللعب |
+| **الصور** | صور الأماكن والمهام ومن تلتقي بهم | بلا صور، عند الطلب، أماكن جديدة، المهام ومن تلتقي بهم ([3.11](#311-pictures)) |
+| **خطوط حمراء** و**أستار** | ما لا يظهر أبدًا، وما يحدث خارج الشاشة فقط | قوائم |
+| **اللغة** | لغة اللعبة ولوحة التحكم | أي لغة |
+
+يضيف الإصدار الخامس **التقدم**: نقاط الخبرة أو المعالم.
+
+إن لم يكن هناك عالم مكتوب، يسأل مدير اللعبة أيضًا عن **الفكرة** (النوع والنبرة وبعض العناصر، بكلماتك) وعن **الإعداد**: بناء العالم أثناء اللعب شيئًا فشيئًا، أو كله في البداية.
+
+**أسلوب مدير اللعبة** لا يُسأل عنه أبدًا، لكن يمكنك تغييره في المحادثة أو في **الإعدادات**: **النثر** (بسيط، أدبي، شعبي، ساخر)، و**القصص** التي يبتكرها (مواقف، أقواس، حلقات، لغز)، وكاتب **يكتب على طريقته**، أو أي شيء آخر **بكلماتك**.
+
+### 2.7 الجلسة صفر: شخصيتك
+
+تصنع شخصيتك مع مدير اللعبة، كما على الطاولة. كل خيار لك، إلا إذا طلبت من مدير اللعبة أن يختار. تعال بفكرة كاملة، أو غامضة، أو بلا شيء. يخبرك مدير اللعبة كيف تُصنع قيم القدرات قبل رمي أي نرد. قصتك ليست مطلوبة أبدًا. وإن أعطيتها، يكتبها مدير اللعبة بكلماتك. ثم يطلب مدير اللعبة صورة لشخصيتك ([3.7](#37-your-characters-story-and-picture)). يحسب RPG Engine ورقة الشخصية: لا تقوم أنت بأي عملية حسابية.
+
+---
+
+## 3. اللعب <!-- icon: chat -->
+
+### 3.1 التحدث مع مدير اللعبة
+
+اكتب ما تفعله شخصيتك أو تقوله، بكلماتك:
+
+> أسأل صاحب النزل من الذي مرّ هنا الليلة أيضًا.
+
+للخروج من القصة، اكتب بين قوسين مربعين: *[كيف تعمل المصارعة؟]* يرد مدير اللعبة بين قوسين أيضًا.
+
+أنت تقول ما تحاوله، ومدير اللعبة يقول ما يحدث. لا يقرر مدير اللعبة أبدًا عن شخصيتك، ولا يتحدث عن المحرك. يمكنك أن تسأله كيف تستخدم لوحة التحكم.
+
+### 3.2 الرميات
+
+يطلب مدير اللعبة رمية فقط عندما تكون النتيجة غير مؤكدة ومهمة، ويقول أولًا ما الذي على المحك. بعد ذلك:
+
+- **على لوحة التحكم**، تعرض لافتة زرًّا لكل اختبار، مثل *Acrobatics +4 · with advantage*. انقر عليه: يسقط النرد على الصفحة ويسمع مدير اللعبة النتيجة. يمكنك أيضًا النقر على سطر ورقة شخصيتك المضيء، أو رمي النرد من الصينية، أو كتابة شيء آخر في اللافتة.
+- **يدويًا**، من زاوية اللافتة أو من **الإعدادات**: تخبرك اللافتة بما ترميه، وترميه من ورقة الشخصية أو من الصينية.
+- **النرد الفعلي**، حين يكون إعداد النرد على فعلي: تكتب الأوجه التي رميتها، *[رميت 14.]*، ويضيف RPG Engine مُعدِّلاتك.
+
+**الرميات الحرة**: انقر على أي رقم في ورقة الشخصية، أو افتح الصينية، لترمي للتسلية. لا تُحسب أبدًا ولا يراها مدير اللعبة.
+
+**رميات مدير اللعبة** تظهر في عمود الرميات عندك، عدا السرية منها. يمكنك دائمًا أن تسأل *[هل كانت تلك الرمية حقيقية؟]*: وفي الرمية السرية يعطيك مدير اللعبة بصمة تثبت أنها أُجريت قبل أن تسأل.
+
+### 3.3 المشاهد والقتال
+
+تسير القصة في **مشاهد**: قتال، حوار، استكشاف، سفر، راحة. في نهاية كل مشهد تُحفظ اللعبة تلقائيًا، ويدخل المشهد في سجلك.
+
+في القتال يروي مدير اللعبة كل دور ليس دورك، ويتوقف عند النقطة التي تقرر فيها. يعرض قسم **القتال** ترتيب الأدوار ونقاط صحة فريقك وكيف يبدو الأعداء مصابين، بالكلمات. وإذا سقطت شخصيتك، تظهر رميات الحفظ من الموت كبيرة على الصفحة.
+
+### 3.4 الوقت والسفر والعالم المتحرك
+
+يحتفظ RPG Engine بالتاريخ، ولا يمر وقت بين الجلسات. قل إنك تستريح، *نأخذ راحة طويلة*، فتعيد الراحة ما يجب أن تعيده. قل إلى أين تذهب، *نسلك الطريق شمالًا إلى Rocca*، فيحسب RPG Engine الطريق والمسافة والأيام، ويتوقف عندما يحدث شيء في الطريق. يُحسب المال بعملات اللعبة، مع الباقي.
+
+للأشرار خطط ذات مواعيد نهائية. في كل يوم جديد يحرّك مدير اللعبة التهديدات التي تقدّم بها الوقت، وترى علاماتها، لا الساعة نفسها.
+
+### 3.5 الخرائط
+
+**العالم** يعرض الأماكن التي تعرفها شخصيتك، والطرق بينها، والمسار الذي سلكته، مع ضباب فوق الباقي. **المشهد** يعرض خريطة المكان الذي أنت فيه، إن كانت له خريطة، مع من يقف أين. وفي القتال، في دورك، تُحجب المربعات التي لا تستطيع بلوغها. عندما يسألك مدير اللعبة أين تتحرك، المس مربعًا أو اكتبه، مثل *E4*.
+
+### 3.6 المهام والسجل والملاحظات
+
+المهمة التي تتولاها شخصيتك تصبح مهمة في **السجل**، مع أهدافها وموعدها النهائي وما تقيسه. ضع عليها نجمة لتبقى ظاهرة في أعلى المشهد. يروي السجل أيضًا **قصتك**، مشهدًا بمشهد، ويحفظ **ملاحظاتك**: خاصة، إلا إذا **شاركت** إحداها، فيسمعها مدير اللعبة على أنها ما تفكر فيه، لا على أنها حقيقة.
+
+### 3.7 قصة شخصيتك وصورتها
+
+في ورقة شخصيتك، تحتوي بطاقة **الوصف** على خانة لقصة شخصيتك: يكتبها فيها مدير اللعبة بعد أن توافق. وللصورة، أعطِ مدير اللعبة ملفًا (PNG أو JPEG أو WebP أو SVG، حتى 5 ميغابايت) مع مكانه على حاسوبك، أو اطلب صنع بورتريه ([3.11](#311-pictures)): *[اصنع لي بورتريه: شعر رمادي مجدول، وندبة على الذقن.]*
+
+### 3.8 نقاط الحفظ والعودة
+
+يحفظ RPG Engine الحملة كلها في نهاية كل مشهد. وإعداد **نقاط الحفظ** يحدد الباقي:
+
+| نقاط الحفظ | الحفظ متى شئت | العودة |
+|---|---|---|
+| **موت دائم** | لا | أبدًا |
+| **نقطة تفتيش** | لا | إلى آخر نقطة حفظ، فقط عندما تموت شخصيتك |
+| **حر** | نعم | إلى أي نقطة حفظ |
+
+في كل الأنماط يمكنك **البدء من جديد**، من بداية اللعب أو من الجلسة صفر. افعل ذلك في المحادثة أو في **نقاط الحفظ**.
+
+بعد العودة، **افتح محادثة جديدة**: المحادثة القديمة تتذكر ما أُلغي. اكتب *تابع* في المحادثة الجديدة، ثم اضغط **فتحت محادثة جديدة** في نقاط الحفظ.
+
+### 3.9 الجلسات: التوقف والعودة
+
+توقف متى شئت: *[لنتوقف هنا هذه الليلة.]* كل شيء محفوظ أصلًا في الملفات. وللعودة، شغّل وكيلك في مجلد الحملة واكتب *تابع*: يعطيك مدير اللعبة ملخصًا قصيرًا ويواصل.
+
+### 3.10 مزاج مدير اللعبة
+
+الروبوت في أعلى لوحة التحكم هو مدير اللعبة: يتبع وجهه نبرة القصة، ولا يكشف أبدًا ما لا تعرفه بعد. وعندما تُغلق المحادثة، ينام.
+
+### 3.11 الصور
+
+يستطيع RPG Engine صنع صور للأماكن التي تبلغها، وللمهام التي تتولاها، ولمن تلتقي بهم، كما يحدد إعداد **الصور**، وبورتريه لشخصيتك عندما تطلب. يستخدم ما هو موجود على حاسوبك، مع تسجيل دخولك أنت: **Codex** يرسمها، وإلا فـ**Claude Code** يرسمها. تخبرك **الإعدادات** هل يستطيع هذا الحاسوب صنعها، وكيف تهيئه إن لم يستطع. ويمكنك دائمًا أن تعطي مدير اللعبة صورة من عندك.
+
+### 3.12 الأمان: الخطوط الحمراء والأستار والإيقاف
+
+**الخطوط الحمراء** لا تظهر أبدًا في اللعبة، و**الأستار** تحدث خارج الشاشة فقط. في أي لحظة اكتب *[stop]*: يترك مدير اللعبة ذلك المحتوى فورًا ويضيفه إلى خطوطك الحمراء.
+
+### 3.13 تغيير رأيك
+
+يمكن تغيير كل إعداد، في المحادثة أو في **الإعدادات**. والحكم الذي يصدره مدير اللعبة دون الكتاب يصبح **سابقة**، فيحصل السؤال نفسه على الجواب نفسه في المرة القادمة.
+
+---
+
+## 4. لوحة التحكم <!-- icon: party -->
+
+صفحة على حاسوبك أنت، لا تُفتح إلا في متصفح هذا الحاسوب، وتبقى حية ما دامت المحادثة مفتوحة. عندما تُغلق المحادثة تعرض *Not connected*، وتعود من نفسها مع المحادثة التالية.
+
+- **الفريق**: ورقة شخصيتك وأوراق رفاقك. انقر على رقم لترميه، وضع المؤشر عليه لترى مصدره. بجانبه الرميات.
+- **المشهد**: أين أنت، وصورته وخريطته، ومن هناك، وما الذي يجري.
+- **القتال**: في القتال فقط: الأدوار والمقاتلون وما بين يديك.
+- **السجل**: المهام والقصة وملاحظاتك.
+- **العالم**: خريطة العالم كما تعرفه شخصيتك.
+- **صينية النرد**: اختر النرد ومُعدِّلًا، وارمِ.
+- **نقاط الحفظ** و**المساعدة** و**الإعدادات** و**حول**، على شكل أيقونات في نهاية الصف. تضم الإعدادات أيضًا تفضيلات الصفحة نفسها: السمة وصوت النرد ومجموعة النرد.
+
+عندما يسألك مدير اللعبة شيئًا، تبقى لافتته في الأعلى، في أي قسم كنت.
+
+---
+
+## 5. أنظمة اللعب والقواعد المنزلية <!-- icon: dice -->
+
+### 5.1 ما نظام اللعب
+
+بيانات لعبة واحدة: ورقة شخصيتها وأرقامها ومخلوقاتها وأغراضها وتعاويذها ونص قواعدها. تلعب كل حملة نظامًا واحدًا. يحسب RPG Engine ورقة الشخصية وما يُنفق وما يعود. أما كيف تعمل ميزة ما، فيقرأ مدير اللعبة القواعد ويقرر، كما على الطاولة.
+
+### 5.2 الإصدار الخامس، مضمّن
+
+الأعراق والأصناف والأصناف الفرعية، وخلفية واحدة وموهبة واحدة من SRD 5.1؛ و319 تعويذة، والأسلحة والدروع والأغراض السحرية والوحوش؛ وفصول القواعد التي يقرؤها مدير اللعبة بنصها الدقيق؛ وورقة الشخصية الكاملة، محسوبة.
+
+يمكنك أيضًا لعب محتوى لا يتضمنه SRD، من كتاب تملكه: يكتبه مدير اللعبة على شكل صفحات في حملتك، ويعامله RPG Engine كأنه من عنده. يشحن RPG Engine المحتوى المفتوح فقط؛ أما ما يعرفه مدير اللعبة فليس محدودًا.
+
+### 5.3 القواعد المنزلية وإضافاتك الخاصة
+
+اطلب من مدير اللعبة: *[قاعدة منزلية: الرقم الطبيعي 1 في الهجوم يعني أن تُسقط سلاحك.]* يحفظها اتفاقًا على الطاولة، أو يكتب صفحة أو رقمًا في ورقة الشخصية عند الحاجة. القواعد المنزلية المكتوبة أصلًا يمكن وضعها كملفات نصية في مجلد `rules` من الحملة.
+
+### 5.4 إضافة نظام لعب خاص بك أو استيراده
+
+ليس بعد: يلعب RPG Engine اليوم الإصدار الخامس فقط ([قريبًا](#9-coming-later)).
+
+---
+
+## 6. الإضافات <!-- icon: plus -->
+
+ليس بعد. ستضيف الإضافة شيئًا إلى الحملة فوق نظام لعبها: عالمًا، أو مغامرة، أو ميزة مثل الطقس، أو قواعد منزلية للمشاركة.
+
+---
+
+## 7. من أين تأتي الحملة، ولغتها <!-- icon: world -->
+
+### 7.1 ثلاث طرق للحصول على عالم
+
+- **يُصنع أثناء اللعب**: انطلاقًا من فكرتك، يبني مدير اللعبة كل مكان وشخص وحبكة قبل أن تحتاج إليه مباشرة، ويحفظه.
+- **يُعدّ في البداية**: الشيء نفسه، لكن العالم يُبنى قبل اللعب.
+- **من مغامرتك أنت**: أعطِ مدير اللعبة نصًا أو ملف PDF واطلب منه إعدادها، *[أعدّ هذه المغامرة حملةً لنا. لا تخبرني بأي شيء فيها.]* يكتب الأماكن والشخصيات والأسرار. لا يوجد زر استيراد بعد.
+
+تُلعب الحملة مرة واحدة: للعب المغامرة نفسها مرة أخرى، أنشئ حملة جديدة.
+
+### 7.2 اللغات
+
+لغة واحدة لكل حملة، هي لغة مدير اللعبة، وتتبعها لوحة التحكم. تأتي لوحة التحكم بـ26 لغة. وأي لغة أخرى يترجمها على حاسوبك Codex أو Claude Code، وإن لم يتوفرا فمدير اللعبة في المحادثة. مصطلحات الإصدار الخامس بالإيطالية تأتي من SRD الإيطالية الرسمية؛ ونص القواعد يبقى بالإنجليزية، ويرويه مدير اللعبة بلغتك.
+
+---
+
+## 8. للفضوليين: مجلد الحملة <!-- icon: list -->
+
+لا تحتاج إلى فتحه أبدًا، وهو يحوي أسرار حملتك. فيه `campaign.yaml` (إعداداتك)، و`state.yaml` (حيث بلغت اللعبة)، و`world/` (صفحة markdown لكل شخصية ومكان ومهمة وغيرها)، و`rules/` (قواعدك المنزلية)، و`images/`، و`log.jsonl` (كل تغيير)، و`.saves/`، و`.player/` (ملاحظاتك)، والملفات الصغيرة التي تدل وكلاء الذكاء الاصطناعي على مكان RPG Engine. تستخدم الصفحات صيغة Obsidian. إذا غيّرت صفحة يدويًا، يعلم مدير اللعبة بذلك عند رده التالي.
+
+كل أمر يستخدمه مدير اللعبة يمكن تشغيله في مجلد الحملة أيضًا: `rpg --help` يعرضها. كثير منها يطبع أسرار الحملة.
+
+---
+
+## 9. قريبًا <!-- icon: hourglass -->
+
+- **أنت في دور مدير اللعبة**، والذكاء الاصطناعي يلعب الفريق.
+- **وضع المؤلف**: اكتب مغامرة مع الذكاء الاصطناعي، ثم صدّرها وشاركها.
+- **عدة لاعبين على الحاسوب نفسه**، لكل منهم شخصيته، يتناوبون في المحادثة نفسها.
+- **الإضافات**: إعدادات ومغامرات وميزات وقواعد منزلية.
+- **استيراد** كتبك ومغامراتك.
+- **ألعاب أخرى**: مزيد من أنظمة اللعب، وأنظمتك أنت.
+
+---
+
+## 10. أسئلة ومشكلات <!-- icon: info -->
+
+### أسئلة
+
+**هل أحتاج إلى معرفة القواعد؟** لا. اختر المرشد التعليمي، واسأل بين قوسين متى شئت.
+
+**هل يستطيع مدير اللعبة الغش؟** لا يستطيع تغيير رمية أجراها RPG Engine، إلا في صعوبة القصة، ولا الوقائع المقررة أصلًا.
+
+**هل يكلّف شيئًا؟** RPG Engine مجاني. ويعمل مدير اللعبة على خطة وكيلك، أو على حاسوبك بنموذج محلي. أمسية اللعب محادثة طويلة: في أصغر الخطط قد تبلغ حد الخطة قبل انتهاء الأمسية. الصور والترجمات تستخدم الخطة نفسها.
+
+**هل أستطيع اللعب على هاتفي؟** لا: يعمل مدير اللعبة على حاسوبك، ولا تُفتح لوحة التحكم إلا هناك.
+
+**هل أستطيع اللعب مع الأصدقاء؟** ليس بعد: اليوم لاعب واحد وشخصية واحدة، مع الرفاق ([قريبًا](#9-coming-later)).
+
+**هل أستطيع استخدام ذكاء اصطناعي مختلف في المرة القادمة؟** نعم: افتح الحملة في وكيل آخر واكتب *تابع*.
+
+### مشكلات
+
+**لا تُفتح لوحة التحكم.** اسأل مدير اللعبة: `[ما رابط لوحة التحكم؟]`. تعمل فقط ما دامت محادثة مفتوحة في تلك الحملة، بعد أول رد من مدير اللعبة.
+
+**لا يبدو أن مدير اللعبة يعرف اللعبة.** لم يحمّل وكيلك RPG Engine. تأكد أنك شغّلته في مجلد الحملة ووثقت به. في Claude Code، اكتب `/mcp` وأعد ربط `rpg`. في Codex، يجب أن يعرض `codex mcp list` في مجلد الحملة `rpg`. وإذا لم يُعثر على `rpg --version`، فثبّت RPG Engine من جديد ([2.2](#22-install)).
+
+**التحديث.** شغّل `npm install -g rpg-engine` مرة أخرى، ثم افتح محادثة جديدة: مدير اللعبة العامل يحتفظ بالنسخة التي بدأ بها.
+
+**مدير اللعبة يتذكر شيئًا ألغيته.** افتح محادثة جديدة واضغط **فتحت محادثة جديدة** في نقاط الحفظ.
+
+**لا تظهر أي صور.** الإعدادات > الصور تخبرك هل يستطيع هذا الحاسوب صنعها، وكيف.
+
+**يفشل التثبيت، أو لا يبدأ `rpg`.** يجب أن يعرض `node --version` الرقم 22 أو أحدث. في Windows، أبقِ RPG Engine وحملاتك بعيدًا عن المسارات التي تحوي `&`.
+
+**تغيّر رابط لوحة التحكم.** أخذ برنامج آخر العنوان المعتاد؛ يعطيك مدير اللعبة الرابط الجديد.