rpg-engine 0.9.0 → 0.10.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.
Files changed (115) hide show
  1. package/dist/adventures/source.js +6 -5
  2. package/dist/commands/find.d.ts +1 -0
  3. package/dist/commands/find.js +3 -2
  4. package/dist/commands/package.d.ts +3 -3
  5. package/dist/commands/package.js +72 -35
  6. package/dist/commands/rules.js +4 -2
  7. package/dist/commands/shared/adventures.js +20 -11
  8. package/dist/commands/shared/library.js +13 -5
  9. package/dist/commands/shared/packages/catalog.d.ts +2 -0
  10. package/dist/commands/shared/packages/catalog.js +1 -0
  11. package/dist/commands/shared/rules.js +29 -5
  12. package/dist/commands/view/place.d.ts +2 -0
  13. package/dist/commands/view/place.js +8 -2
  14. package/dist/core/context.d.ts +2 -0
  15. package/dist/core/refusal.d.ts +12 -0
  16. package/dist/core/refusal.js +17 -0
  17. package/dist/dashboard/api.js +37 -81
  18. package/dist/dashboard/app.js +10 -3
  19. package/dist/dashboard/asked.js +6 -3
  20. package/dist/dashboard/assets/master.svg +1 -2
  21. package/dist/dashboard/card.js +1 -1
  22. package/dist/dashboard/dice/load.js +6 -1
  23. package/dist/dashboard/dice/throw.js +5 -1
  24. package/dist/dashboard/dice/tray.js +5 -1
  25. package/dist/dashboard/footer.js +2 -2
  26. package/dist/dashboard/game-words.js +32 -32
  27. package/dist/dashboard/guide/ar.md +5 -5
  28. package/dist/dashboard/guide/cs.md +7 -7
  29. package/dist/dashboard/guide/da.md +5 -5
  30. package/dist/dashboard/guide/de.md +5 -5
  31. package/dist/dashboard/guide/el.md +7 -7
  32. package/dist/dashboard/guide/en.md +2 -2
  33. package/dist/dashboard/guide/es.md +6 -6
  34. package/dist/dashboard/guide/fi.md +5 -5
  35. package/dist/dashboard/guide/fr.md +6 -6
  36. package/dist/dashboard/guide/he.md +7 -7
  37. package/dist/dashboard/guide/hi.md +6 -6
  38. package/dist/dashboard/guide/hu.md +7 -7
  39. package/dist/dashboard/guide/is.md +7 -7
  40. package/dist/dashboard/guide/it.md +5 -5
  41. package/dist/dashboard/guide/ja.md +7 -7
  42. package/dist/dashboard/guide/ko.md +9 -9
  43. package/dist/dashboard/guide/nb.md +6 -6
  44. package/dist/dashboard/guide/nl.md +7 -7
  45. package/dist/dashboard/guide/pl.md +7 -7
  46. package/dist/dashboard/guide/pt.md +5 -5
  47. package/dist/dashboard/guide/ro.md +8 -8
  48. package/dist/dashboard/guide/ru.md +7 -7
  49. package/dist/dashboard/guide/sv.md +6 -6
  50. package/dist/dashboard/guide/tr.md +8 -8
  51. package/dist/dashboard/guide/uk.md +6 -6
  52. package/dist/dashboard/guide/zh.md +8 -8
  53. package/dist/dashboard/help/blocks.js +6 -0
  54. package/dist/dashboard/help/help.js +15 -3
  55. package/dist/dashboard/help/markdown.js +2 -1
  56. package/dist/dashboard/i18n/ar.json +53 -1
  57. package/dist/dashboard/i18n/cs.json +53 -1
  58. package/dist/dashboard/i18n/da.json +53 -1
  59. package/dist/dashboard/i18n/de.json +53 -1
  60. package/dist/dashboard/i18n/el.json +53 -1
  61. package/dist/dashboard/i18n/es.json +53 -1
  62. package/dist/dashboard/i18n/fi.json +53 -1
  63. package/dist/dashboard/i18n/fr.json +53 -1
  64. package/dist/dashboard/i18n/he.json +53 -1
  65. package/dist/dashboard/i18n/hi.json +53 -1
  66. package/dist/dashboard/i18n/hu.json +53 -1
  67. package/dist/dashboard/i18n/is.json +53 -1
  68. package/dist/dashboard/i18n/it.json +56 -4
  69. package/dist/dashboard/i18n/ja.json +53 -1
  70. package/dist/dashboard/i18n/ko.json +53 -1
  71. package/dist/dashboard/i18n/nb.json +53 -1
  72. package/dist/dashboard/i18n/nl.json +53 -1
  73. package/dist/dashboard/i18n/pl.json +53 -1
  74. package/dist/dashboard/i18n/pt.json +53 -1
  75. package/dist/dashboard/i18n/ro.json +53 -1
  76. package/dist/dashboard/i18n/ru.json +53 -1
  77. package/dist/dashboard/i18n/sv.json +53 -1
  78. package/dist/dashboard/i18n/tr.json +53 -1
  79. package/dist/dashboard/i18n/uk.json +53 -1
  80. package/dist/dashboard/i18n/zh.json +53 -1
  81. package/dist/dashboard/icons.js +2 -2
  82. package/dist/dashboard/journal.js +9 -4
  83. package/dist/dashboard/labels.js +5 -4
  84. package/dist/dashboard/language-choice.js +3 -3
  85. package/dist/dashboard/markdown.js +11 -4
  86. package/dist/dashboard/notes.js +4 -2
  87. package/dist/dashboard/notices.js +2 -2
  88. package/dist/dashboard/packages/ask-card.js +1 -1
  89. package/dist/dashboard/packages/packages.js +14 -10
  90. package/dist/dashboard/packages/page-code.js +11 -3
  91. package/dist/dashboard/packages/widgets.js +5 -5
  92. package/dist/dashboard/pages.js +3 -3
  93. package/dist/dashboard/place/map-sheet.js +4 -3
  94. package/dist/dashboard/place/map-view.js +17 -5
  95. package/dist/dashboard/refusals.js +61 -0
  96. package/dist/dashboard/rolls.js +3 -3
  97. package/dist/dashboard/settings.js +19 -5
  98. package/dist/dashboard/sheet.js +26 -7
  99. package/dist/dashboard/status.js +19 -13
  100. package/dist/dashboard/style.css +113 -16
  101. package/dist/dashboard/text.js +6 -2
  102. package/dist/dashboard/top.js +7 -9
  103. package/dist/dashboard/turns.js +7 -2
  104. package/dist/dashboard/world/lore.js +16 -15
  105. package/dist/dashboard/world/map.js +43 -1
  106. package/dist/dashboard/world/world.js +50 -15
  107. package/dist/extensions/extension.js +4 -1
  108. package/dist/packages/npm.js +4 -2
  109. package/dist/packages/tarball.js +8 -4
  110. package/dist/rules/rule-book.d.ts +2 -0
  111. package/dist/rules/search.d.ts +4 -1
  112. package/dist/rules/search.js +8 -2
  113. package/dist/server/dashboard/writes.js +22 -13
  114. package/dist/systems/system-code.js +5 -0
  115. package/package.json +1 -1
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine:完全ガイド
3
3
 
4
4
  **RPG Engine**では、**AIをGM**にして、テーブルトークRPGを遊べます。GMとは**チャット**で会話します。RPG Engineは裏側で動き、**世界を記憶し**、**ダイスを振り**、**数値を管理**します。チャットの横にはブラウザーのページ、**ダッシュボード**を開いておきます。キャラクターシート、ダイス、マップ、ジャーナルが並びます。
@@ -240,9 +240,9 @@ GMに頼みます。*[ハウスルール:攻撃で出目1が出たら、武器
240
240
 
241
241
  ---
242
242
 
243
- ## 6. 拡張 <!-- icon: plus -->
243
+ ## 6. 拡張機能 <!-- icon: plus -->
244
244
 
245
- まだありません。拡張は、ゲームシステムの上に、キャンペーンへ何かを加えるものになる予定です。世界、アドベンチャー、天候のような機能、共有できるハウスルールなどです。
245
+ 拡張機能は、ゲームシステムに加えて、キャンペーンに何かを足すものです。たとえば、夜明けごとに変わる天気や、ダイスで行う鍵開けなどの機能があります。追加するには、パッケージ › 追加を開きます。一覧から選ぶか、npm 上の名前、フォルダ、ファイルで指定できます。公式以外の拡張機能にはコードが含まれます。追加できるのは、コンピューターに表示されるウィンドウで許可した場合だけです。ほかのゲームシステム向けの拡張機能には、対象のシステムが表示され、追加はできません。パッケージ › インストール済みでは、拡張機能の更新や削除ができます。頼めば、GMが追加することもできます。
246
246
 
247
247
  ---
248
248
 
@@ -274,11 +274,11 @@ GMが使うコマンドは、すべてキャンペーンフォルダーでも実
274
274
 
275
275
  ## 9. 今後の予定 <!-- icon: hourglass -->
276
276
 
277
- - **GMを自分で務める**:AIがパーティを演じます。
278
- - **作者モード**:AIと一緒にアドベンチャーを書き、書き出して共有します。
277
+ - **プレイヤーがGMになる遊び方**:AIがパーティを演じます。
278
+ - **作者モード**:AIと一緒に冒険を書き、書き出して共有できます。
279
279
  - **同じコンピューターで複数人が遊ぶ**:それぞれが自分のキャラクターを持ち、同じチャットで順番に遊びます。
280
- - **拡張**:設定、アドベンチャー、機能、ハウスルール。
281
- - **ほかのゲーム**:ゲームシステムの追加と、独自のシステム。
280
+ - **さらに多くの拡張機能**:ワールド、機能、ハウスルールを共有できます。
281
+ - **ほかのゲーム**:ゲームシステムを増やし、自作もできるようにします。
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: 전체 가이드
3
3
 
4
4
  **RPG Engine**은 **AI 게임 마스터**와 함께 테이블탑 롤플레잉 게임을 즐길 수 있게 해 줘요. **채팅**으로 GM과 대화해요. RPG Engine은 뒤에서 **세계를 기억하고**, **주사위를 굴리고**, **계산을 맡아요**. 채팅 옆에는 브라우저에 페이지를 하나 열어 두어요. 바로 **대시보드**예요. 캐릭터 시트, 주사위, 지도, 일지가 있어요.
@@ -240,9 +240,9 @@ GM에게 부탁해 보세요. *[하우스 룰: 공격에서 내추럴 1이 나
240
240
 
241
241
  ---
242
242
 
243
- ## 6. 확장 <!-- icon: plus -->
243
+ ## 6. 확장 기능 <!-- icon: plus -->
244
244
 
245
- 아직 없어요. 확장은 게임 시스템 위에서 캠페인에 무언가를 더해 줄 거예요. 세계, 모험, 날씨 같은 기능, 함께 쓰는 하우스 룰 같은 것들이에요.
245
+ 확장 기능은 게임 시스템 위에 캠페인에 필요한 요소를 더해 줘요. 새벽마다 바뀌는 날씨나 주사위로 자물쇠를 따는 기능이 그 예예요. 확장 기능은 패키지 › 추가에서 목록으로 추가하거나, npm 이름, 폴더, 파일로 추가해요. 우리가 만들지 않은 확장 기능은 코드를 포함하고 있어서, 컴퓨터에 뜨는 창에서 허락해야만 추가돼요. 다른 게임 시스템용으로 만든 확장 기능은 어떤 시스템용인지 알려 주고, 추가되지 않아요. 패키지 › 설치됨에서 확장 기능을 업데이트하거나 삭제할 수 있어요. 원하면 GM이 직접 추가해 주기도 해요.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ GM이 쓰는 모든 명령은 캠페인 폴더에서 직접 실행할 수도 있
272
272
 
273
273
  ---
274
274
 
275
- ## 9. 나중에 추가될 기능 <!-- icon: hourglass -->
275
+ ## 9. 앞으로 추가될 기능 <!-- icon: hourglass -->
276
276
 
277
- - **GM이 되는 나**: AI가 파티를 맡아요.
278
- - **작가 모드**: AI와 함께 모험을 쓰고, 내보내서 공유해요.
279
- - **한 컴퓨터에서 여러 플레이어**: 각자 자기 캐릭터로 같은 채팅에서 차례를 번갈아 플레이해요.
280
- - **확장**: 설정, 모험, 기능, 하우스 룰.
281
- - **다른 게임**: 더 많은 게임 시스템, 그리고 직접 만든 시스템.
277
+ - **GM이 되어 보기**: AI가 파티를 맡아 플레이해요.
278
+ - **제작자 모드**: AI와 함께 모험을 쓰고, 내보내서 공유해요.
279
+ - **한 컴퓨터에서 여러 명이 함께 플레이**: 각자 자기 캐릭터로, 같은 채팅에서 차례를 나눠 플레이해요.
280
+ - **더 많은 확장 기능**: 공유할 수 있는 세계관, 기능, 하우스 룰을 만나 보세요.
281
+ - **다른 게임**: 더 많은 게임 시스템과 직접 만든 시스템을 지원해요.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: den komplette veiledningen
3
3
 
4
4
  **RPG Engine** lar deg spille et rollespill rundt bordet med en **AI som spilleder**. Du snakker med spillederen i en **chat**. RPG Engine jobber bak kulissene: det **husker verden**, **kaster terningene** og **fører regnskapet**. Ved siden av chatten har du en side åpen i nettleseren, **dashbordet**, med karakterarket, terningene, kartene og dagboken din.
@@ -242,7 +242,7 @@ Et spillsystem er en pakke: spilleder installerer en fra npm, en mappe eller en
242
242
 
243
243
  ## 6. Utvidelser <!-- icon: plus -->
244
244
 
245
- Ikke ennå. En utvidelse vil legge til noe i en kampanje oppå spillsystemet: en verden, et eventyr, en funksjon som været, husregler å dele.
245
+ En utvidelse legger til noe i en kampanje, oppå spillsystemet: en funksjon som været, som endrer seg hver daggry, eller å dirke opp en lås med terninger. Du legger til en under Packages › Add, fra listen eller med navnet på npm, en mappe eller en fil. En utvidelse som ikke er vår, har med kode, og kommer bare med ditt ja, i et vindu på datamaskinen din. En utvidelse laget for et annet spillsystem sier hvilket, og blir ikke lagt til. Under Packages › Installed oppdaterer du en utvidelse eller fjerner den. Spilleder kan også legge til en, når du ber om det.
246
246
 
247
247
  ---
248
248
 
@@ -274,10 +274,10 @@ Hver kommando spilleder bruker, kan også kjøres i kampanjemappen: `rpg --help`
274
274
 
275
275
  ## 9. Kommer senere <!-- icon: hourglass -->
276
276
 
277
- - **Du som spilleder**, mens AI-en spiller gruppen.
278
- - **Forfattermodus**: skriv et eventyr sammen med AI-en, og eksporter og del det.
279
- - **Flere spillere på samme datamaskin**, hver med sin egen karakter, som bytter på i den samme chatten.
280
- - **Utvidelser**: innstillinger, eventyr, funksjoner og husregler.
277
+ - **Du som spilleder**, med AI-en som spiller gruppen.
278
+ - **Forfattermodus**: skriv et eventyr sammen med AI-en, eksporter det og del det.
279
+ - **Flere spillere på samme datamaskin**, hver med sin egen karakter, som bytter på å skrive i den samme chatten.
280
+ - **Flere utvidelser**: verdener, funksjoner og husregler å dele.
281
281
  - **Andre spill**: flere spillsystemer, og dine egne.
282
282
 
283
283
  ---
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: de complete handleiding
3
3
 
4
4
  **RPG Engine** laat je een tafelrollenspel spelen met een **AI als spelleider**. Je praat met de spelleider in een **chat**; RPG Engine werkt op de achtergrond: het **onthoudt de wereld**, **gooit de dobbelstenen** en **houdt de cijfers bij**. Naast de chat houd je een pagina open in je browser, het **dashboard**, met je karakterblad, de dobbelstenen, de kaarten en je dagboek.
@@ -242,7 +242,7 @@ Een spelsysteem is een pakket: de spelleider installeert er een uit npm, een map
242
242
 
243
243
  ## 6. Extensies <!-- icon: plus -->
244
244
 
245
- Nog niet. Een extensie voegt iets toe aan een campagne, bovenop het spelsysteem: een wereld, een avontuur, een functie zoals het weer, huisregels om te delen.
245
+ Een extensie voegt iets toe aan een campagne, bovenop het spelsysteem: een functie zoals het weer, dat bij elke dageraad verandert, of een slot openbreken met dobbelstenen. Voeg een extensie toe via Packages › Add, uit de lijst of met de naam op npm, een map of een bestand. Een extensie van een ander bevat code en komt er alleen met jouw ja, in een venster van je computer. Een extensie die voor een ander spelsysteem is gemaakt, geeft aan voor welk systeem, en wordt niet toegevoegd. Via Packages › Installed werk je een extensie bij of haal je die weg. De spelleider kan ook een extensie toevoegen, als jij erom vraagt.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ Elke opdracht die de spelleider gebruikt, kun je ook in de campagnemap uitvoeren
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Komt later <!-- icon: hourglass -->
275
+ ## 9. Binnenkort <!-- icon: hourglass -->
276
276
 
277
- - **Jij als spelleider**, met de AI als de groep.
277
+ - **Jij als spelleider**, met de AI die de groep speelt.
278
278
  - **Auteursmodus**: schrijf een avontuur met de AI, exporteer het en deel het.
279
- - **Meerdere spelers op dezelfde computer**, elk met een eigen personage, om de beurt in dezelfde chat.
280
- - **Extensies**: instellingen, avonturen, functies en huisregels.
281
- - **Andere spellen**: meer spelsystemen, en je eigen.
279
+ - **Meerdere spelers op dezelfde computer**, elk met een eigen personage, die om de beurt in dezelfde chat spelen.
280
+ - **Meer extensies**: werelden, functies en huisregels om te delen.
281
+ - **Andere spellen**: meer spelsystemen, en je eigen systeem.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: pełny przewodnik
3
3
 
4
4
  **RPG Engine** pozwala grać w tradycyjną grę fabularną z **AI w roli Mistrza Gry**. Rozmawiasz z Mistrzem Gry na **czacie**. RPG Engine pracuje w tle: **pamięta świat**, **rzuca kośćmi** i **prowadzi rachunki**. Obok czatu trzymasz otwartą w przeglądarce stronę, czyli **dashboard**, z kartą postaci, kośćmi, mapami i dziennikiem.
@@ -242,7 +242,7 @@ System gry to pakiet: Mistrz Gry instaluje go z npm, z folderu lub z pliku, a pa
242
242
 
243
243
  ## 6. Rozszerzenia <!-- icon: plus -->
244
244
 
245
- Jeszcze nie. Rozszerzenie doda coś do kampanii na wierzchu jej systemu gry: świat, przygodę, funkcję taką jak pogoda, zasady domowe do udostępniania.
245
+ Rozszerzenie dodaje do kampanii coś ekstra, ponad system gry: na przykład pogodę, która zmienia się z każdym świtem, albo otwieranie zamków za pomocą kości. Dodasz je w Packages › Add: z listy albo przez nazwę w npm, folder lub plik. Rozszerzenie spoza naszej oferty zawiera kod, więc działa tylko za Twoją zgodą, w oknie na Twoim komputerze. Rozszerzenie stworzone dla innego systemu gry informuje o tym i nie zostanie dodane. W Packages › Installed aktualizujesz rozszerzenia lub je usuwasz. Mistrz Gry też może dodać rozszerzenie, gdy o to poprosisz.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ Każde polecenie, którego używa Mistrz Gry, można też uruchomić w folderze
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Wkrótce <!-- icon: hourglass -->
275
+ ## 9. Plany na przyszłość <!-- icon: hourglass -->
276
276
 
277
277
  - **Ty jako Mistrz Gry**, a AI gra drużyną.
278
- - **Tryb autora**: napisz przygodę z AI, a potem wyeksportuj ją i udostępnij.
279
- - **Kilku graczy na jednym komputerze**, każdy z własną postacią, na zmianę w tym samym czacie.
280
- - **Rozszerzenia**: ustawienia, przygody, funkcje i zasady domowe.
281
- - **Inne gry**: więcej systemów gry i własne.
278
+ - **Tryb autora**: piszesz przygodę z AI, a potem ją eksportujesz i udostępniasz.
279
+ - **Kilka osób na jednym komputerze**, każda z własną postacią, na zmianę w tym samym czacie.
280
+ - **Więcej rozszerzeń**: światy, funkcje i zasady domowe do udostępniania.
281
+ - **Inne gry**: kolejne systemy gier i własne.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: o guia completo
3
3
 
4
4
  **RPG Engine** permite que você jogue um jogo de RPG de mesa com uma **IA como mestre**. Você conversa com o mestre em um **chat**; o RPG Engine trabalha nos bastidores: ele **lembra do mundo**, **rola os dados** e **faz as contas**. Ao lado do chat, você mantém aberta uma página no navegador, o **painel**, com sua ficha, os dados, os mapas e seu diário.
@@ -242,7 +242,7 @@ Um sistema de jogo é um pacote: o mestre instala um a partir do npm, de uma pas
242
242
 
243
243
  ## 6. Extensões <!-- icon: plus -->
244
244
 
245
- Ainda não. Uma extensão vai acrescentar algo a uma campanha além do sistema de jogo: um mundo, uma aventura, um recurso como o clima, regras da casa para compartilhar.
245
+ Uma extensão acrescenta algo a uma campanha, além do sistema de jogo: um recurso como o clima, que muda a cada amanhecer, ou arrombar uma fechadura com dados. Para adicionar uma, vá em Packages › Add. Você pode escolher na lista ou informar o nome no npm, uma pasta ou um arquivo. Uma extensão que não é nossa traz código e só entra com o seu sim, em uma janela do seu computador. Uma extensão feita para outro sistema de jogo avisa qual é e não é adicionada. Em Packages › Installed, você atualiza ou remove uma extensão. O mestre também pode adicionar uma, quando você pedir.
246
246
 
247
247
  ---
248
248
 
@@ -274,10 +274,10 @@ Todo comando que o mestre usa também pode ser executado na pasta da campanha: `
274
274
 
275
275
  ## 9. Em breve <!-- icon: hourglass -->
276
276
 
277
- - **Você como mestre**, com a IA jogando o grupo.
277
+ - **Você como mestre**, com a IA jogando como o grupo.
278
278
  - **Modo autor**: escreva uma aventura com a IA, depois exporte e compartilhe.
279
- - **Vários jogadores no mesmo computador**, cada um com seu personagem, alternando a vez no mesmo chat.
280
- - **Extensões**: configurações, aventuras, recursos e regras da casa.
279
+ - **Vários jogadores no mesmo computador**, cada um com seu próprio personagem, alternando as vezes no mesmo chat.
280
+ - **Mais extensões**: mundos, recursos e regras da casa para compartilhar.
281
281
  - **Outros jogos**: mais sistemas de jogo, e os seus próprios.
282
282
 
283
283
  ---
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: ghidul complet
3
3
 
4
4
  **RPG Engine** îți permite să joci un joc de rol de masă cu o **IA în rolul de maestru de joc**. Vorbești cu maestrul de joc într-un **chat**; RPG Engine lucrează în spate: **își amintește lumea**, **aruncă zarurile** și **ține socotelile**. Lângă chat ții deschisă în browser o pagină, **dashboardul**, cu fișa ta, zarurile, hărțile și jurnalul.
@@ -240,9 +240,9 @@ Un sistem de joc este un pachet: maestrul de joc instalează unul din npm, dintr
240
240
 
241
241
  ---
242
242
 
243
- ## 6. Extensii <!-- icon: plus -->
243
+ ## 6. Extensiile <!-- icon: plus -->
244
244
 
245
- Încă nu. O extensie va adăuga ceva unei campanii, peste sistemul ei de joc: o lume, o aventură, o funcție precum vremea, reguli de casă de împărțit.
245
+ O extensie adaugă ceva unei campanii, peste sistemul ei de joc: o funcție precum vremea, care se schimbă la fiecare răsărit, sau forțarea unei încuietori cu zaruri. Adaugi o extensie din Packages › Add, alegând din listă sau după numele de pe npm, un folder ori un fișier. Una care nu este a noastră aduce cod și vine doar cu acordul tău, într-o fereastră a computerului. Dacă o extensie este făcută pentru alt sistem de joc, îți spune care, și nu este adăugată. În Packages › Installed poți actualiza o extensie sau o poți scoate. Maestrul de joc poate adăuga și el una, când îi ceri.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ Fiecare comandă folosită de maestrul de joc poate fi rulată și în folderul
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Vine mai târziu <!-- icon: hourglass -->
275
+ ## 9. Ce urmează <!-- icon: hourglass -->
276
276
 
277
- - **Tu ca maestru de joc**, cu AI-ul în rolul grupului.
277
+ - **Tu ca maestru de joc**, cu AI-ul jucând grupul.
278
278
  - **Modul autor**: scrie o aventură cu AI-ul, apoi exportă-o și împarte-o cu alții.
279
- - **Mai mulți jucători pe același calculator**, fiecare cu propriul personaj, pe rând în același chat.
280
- - **Extensii**: setări, aventuri, trăsături și reguli ale casei.
281
- - **Alte jocuri**: mai multe sisteme de joc și ale tale.
279
+ - **Mai mulți jucători pe același computer**, fiecare cu personajul lui, pe rând în același chat.
280
+ - **Mai multe extensii**: lumi, funcții și reguli ale casei de împărțit cu alții.
281
+ - **Alte jocuri**: mai multe sisteme de joc, și ale tale.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: полное руководство
3
3
 
4
4
  **RPG Engine** позволяет играть в настольную ролевую игру с **ИИ в роли мастера**. Ты общаешься с мастером в **чате**, а RPG Engine работает за кулисами: он **помнит мир**, **бросает кубики** и **ведёт учёт**. Рядом с чатом в браузере открыта страница, **панель управления**: на ней лист персонажа, кубики, карты и журнал.
@@ -242,7 +242,7 @@ RPG Engine умеет создавать картинки мест, до кот
242
242
 
243
243
  ## 6. Расширения <!-- icon: plus -->
244
244
 
245
- Пока нет. Расширение будет добавлять что-то к кампании поверх её игровой системы: мир, приключение, особенность вроде погоды, домашние правила, которыми можно делиться.
245
+ Расширение добавляет в кампанию что-то новое поверх игровой системы: например, погоду, которая меняется с каждым рассветом, или взлом замка с помощью кубиков. Добавить расширение можно в разделе Пакеты › Добавить: выбери его из списка или укажи название на npm, папку или файл. Чужое расширение приносит с собой код, поэтому оно устанавливается только с твоего «да» в окне на твоём компьютере. Если расширение сделано для другой игровой системы, оно сообщит об этом, и добавить его не получится. В разделе Пакеты › Установленные расширение можно обновить или удалить. Мастер тоже может добавить расширение, если ты его попросишь.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ RPG Engine остаётся в этой папке: он читает и зап
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Скоро появится <!-- icon: hourglass -->
275
+ ## 9. Что будет позже <!-- icon: hourglass -->
276
276
 
277
277
  - **Ты в роли мастера**, а ИИ играет за отряд.
278
- - **Режим автора**: пиши приключение вместе с ИИ, затем экспортируй его и делись им.
279
- - **Несколько игроков на одном компьютере**, у каждого свой персонаж, а ходят они по очереди в одном чате.
280
- - **Расширения**: настройки, приключения, возможности и домашние правила.
281
- - **Другие игры**: больше игровых систем и твоя собственная.
278
+ - **Режим автора**: напиши приключение вместе с ИИ, затем экспортируй его и поделись им.
279
+ - **Несколько игроков за одним компьютером**: у каждого свой персонаж, а ходят все по очереди в одном чате.
280
+ - **Больше расширений**: миры, возможности и домашние правила, которыми можно делиться.
281
+ - **Другие игры**: новые игровые системы и твои собственные.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: den kompletta guiden
3
3
 
4
4
  **RPG Engine** låter dig spela ett bordsrollspel med en **AI som spelledare**. Du pratar med spelledaren i en **chatt**. RPG Engine arbetar i bakgrunden: det **minns världen**, **slår tärningarna** och **för räkenskaperna**. Bredvid chatten har du en sida öppen i webbläsaren, **dashboarden**, med ditt rollformulär, tärningarna, kartorna och din dagbok.
@@ -242,7 +242,7 @@ Ett spelsystem är ett paket. Spelledaren installerar ett från npm, en mapp ell
242
242
 
243
243
  ## 6. Tillägg <!-- icon: plus -->
244
244
 
245
- Inte än. Ett tillägg kommer att lägga till något i en kampanj ovanpå dess spelsystem: en värld, ett äventyr, en funktion som vädret, husregler att dela.
245
+ Ett tillägg lägger till något i en kampanj, ovanpå dess spelsystem: en funktion som vädret, som ändras vid varje gryning, eller att dyrka upp ett lås med tärningar. Lägg till ett under Packages › Add, från listan eller med namnet på npm, en mapp eller en fil. Ett tillägg som inte kommer från oss innehåller kod. Det läggs bara till om du säger ja, i ett fönster på din dator. Ett tillägg som är gjort för ett annat spelsystem säger vilket, och läggs inte till. Under Packages › Installed uppdaterar du ett tillägg eller tar bort det. Spelledaren kan också lägga till ett, när du ber om det.
246
246
 
247
247
  ---
248
248
 
@@ -274,10 +274,10 @@ Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg
274
274
 
275
275
  ## 9. Kommer senare <!-- icon: hourglass -->
276
276
 
277
- - **Du som spelledare**, medan AI:n spelar gruppen.
278
- - **Författarläge**: skriv ett äventyr med AI:n, exportera det och dela det.
279
- - **Flera spelare på samma dator**, var och en med sin egen rollperson, som turas om i samma chatt.
280
- - **Tillägg**: inställningar, äventyr, funktioner och hemregler.
277
+ - **Du som spelledare**, med AI:n som spelar gruppen.
278
+ - **Författarläge**: skriv ett äventyr tillsammans med AI:n, exportera det och dela det.
279
+ - **Flera spelare vid samma dator**, var och en med sin egen rollperson, som turas om i samma chatt.
280
+ - **Fler tillägg**: världar, funktioner och egna regler att dela.
281
281
  - **Andra spel**: fler spelsystem, och dina egna.
282
282
 
283
283
  ---
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: eksiksiz kılavuz
3
3
 
4
4
  **RPG Engine**, masa başı rol yapma oyununu **yapay zekâ oyun yöneticisiyle** oynamanı sağlar. Oyun yöneticisiyle bir **sohbette** konuşursun; RPG Engine ise arka planda çalışır: **dünyayı hatırlar**, **zarları atar** ve **hesapları tutar**. Sohbetin yanında tarayıcında bir sayfa açık tutarsın: **gösterge paneli**. Orada karakter kağıdın, zarların, haritaların ve günlüğün durur.
@@ -242,7 +242,7 @@ Oyun sistemi bir pakettir. Oyun yöneticisi onu npm'den, bir klasörden ya da bi
242
242
 
243
243
  ## 6. Eklentiler <!-- icon: plus -->
244
244
 
245
- Henüz değil. Bir eklenti, oyun sisteminin üstüne kampanyaya bir şey ekleyecek: bir dünya, bir macera, hava durumu gibi bir özellik, paylaşılacak ev kuralları.
245
+ Eklenti, bir kampanyaya oyun sisteminin üstüne yeni bir şey katar. Örneğin her şafakta değişen hava durumu ya da zarlarla kilit açma gibi bir özellik olabilir. Eklentiyi Paketler › Ekle bölümünden eklersin. Listeden seçebilir, npm üzerindeki adını yazabilir, bir klasör ya da dosya gösterebilirsin. Bizim yapmadığımız bir eklenti kod getirir. Bu yüzden yalnızca senin onayınla, bilgisayarında açılan bir pencerede eklenir. Başka bir oyun sistemi için yapılmış eklenti hangi sistem için olduğunu söyler ve eklenmez. Paketler › Yüklü bölümünde bir eklentiyi güncelleyebilir ya da kaldırabilirsin. İstersen oyun yöneticisi de bir eklenti ekleyebilir.
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Daha sonra gelecekler <!-- icon: hourglass -->
275
+ ## 9. Yakında <!-- icon: hourglass -->
276
276
 
277
- - **Oyun yöneticisi olarak sen**, grubu ise yapay zekâ oynar.
278
- - **Yazar modu**: yapay zekâyla bir macera yaz, sonra dışa aktar ve paylaş.
279
- - **Aynı bilgisayarda birkaç oyuncu**: her biri kendi karakteriyle, aynı sohbette sırayla oynar.
280
- - **Eklentiler**: ayarlar, maceralar, özellikler ve ev kuralları.
281
- - **Başka oyunlar**: daha fazla oyun sistemi ve kendi sistemin.
277
+ - **Oyun yöneticisi sen olursun**, grubu yapay zekâ oynar.
278
+ - **Yazar modu**: Yapay zekâyla bir macera yaz, sonra dışa aktar ve paylaş.
279
+ - **Aynı bilgisayarda birden fazla oyuncu**: Her oyuncunun kendi karakteri olur ve hepsi aynı sohbette sırayla oynar.
280
+ - **Daha fazla eklenti**: Paylaşabileceğin dünyalar, özellikler ve ev kuralları.
281
+ - **Başka oyunlar**: Daha fazla oyun sistemi ve kendi oyun sistemin.
282
282
 
283
283
  ---
284
284
 
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine: повний посібник
3
3
 
4
4
  **RPG Engine** дає змогу грати в настільну рольову гру, де **майстром є ШІ**. Ти спілкуєшся з майстром у **чаті**, а RPG Engine працює за лаштунками: він **пам'ятає світ**, **кидає кубики** і **веде облік**. Поруч із чатом у браузері відкрита сторінка, **панель керування**, де є твій аркуш персонажа, кубики, мапи та журнал.
@@ -242,7 +242,7 @@ RPG Engine може створювати зображення місць, до
242
242
 
243
243
  ## 6. Розширення <!-- icon: plus -->
244
244
 
245
- Ще ні. Розширення додаватиме до кампанії щось поверх її ігрової системи: світ, пригоду, можливість, як-от погоду, домашні правила, якими можна ділитися.
245
+ Розширення додає до кампанії щось поверх ігрової системи: наприклад, погоду, що змінюється на кожному світанку, або зламування замків за допомогою кубиків. Додай розширення в Packages › Add: зі списку, за назвою на npm, з теки або з файла. Розширення не від нас містить код, тому додається лише з твоєї згоди, у вікні на твоєму комп'ютері. Якщо розширення створене для іншої ігрової системи, воно покаже, для якої саме, і не додасться. У Packages › Installed ти оновлюєш розширення або видаляєш його. Майстер теж може додати розширення, якщо ти попросиш.
246
246
 
247
247
  ---
248
248
 
@@ -272,12 +272,12 @@ RPG Engine лишається в цій теці: він читає й запи
272
272
 
273
273
  ---
274
274
 
275
- ## 9. Що з'явиться згодом <!-- icon: hourglass -->
275
+ ## 9. Незабаром <!-- icon: hourglass -->
276
276
 
277
277
  - **Ти в ролі майстра**, а ШІ грає за загін.
278
- - **Режим автора**: пишеш пригоду разом із ШІ, потім експортуєш її та ділишся нею.
279
- - **Кілька гравців на одному комп'ютері**, кожен зі своїм персонажем, по черзі в одному чаті.
280
- - **Розширення**: налаштування, пригоди, можливості та домашні правила.
278
+ - **Режим автора**: напиши пригоду разом із ШІ, потім експортуй її й поділися нею.
279
+ - **Кілька гравців на одному комп'ютері**: кожен зі своїм персонажем, по черзі в одному чаті.
280
+ - **Більше розширень**: світи, функції та домашні правила, щоб ділитися ними.
281
281
  - **Інші ігри**: більше ігрових систем і твоя власна.
282
282
 
283
283
  ---
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 8c9f41da 17577253 f699a840 241f6611 59c1a762. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef 4c5cd093 019e9516 8e136927 7da791ae 423af5fa 17577253 f699a840 2731ea0e 59c1a762. Change the English, then run it again. -->
2
2
  # RPG Engine:完整指南
3
3
 
4
4
  **RPG Engine** 让你和一位 **AI 主持人**一起玩桌面角色扮演游戏。你在**聊天**里和主持人交谈;RPG Engine 在幕后工作:它**记住世界**,**掷骰子**,**记账**。聊天旁边,你在浏览器里开着一个页面,也就是**仪表盘**,上面有你的角色卡、骰子、地图和日志。
@@ -242,7 +242,7 @@ RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务
242
242
 
243
243
  ## 6. 扩展 <!-- icon: plus -->
244
244
 
245
- 暂不支持。扩展将在游戏系统之上为战役增加内容:一个世界、一场冒险、天气这样的功能、可分享的家规。
245
+ 扩展可以在游戏系统之外,为战役增添新内容:比如每天黎明都会变化的天气,或者用骰子撬锁。在“扩展包 › 添加”中添加:可以从列表里选,也可以输入它在 npm 上的名称,或选择一个文件夹或文件。不是我们制作的扩展会带有代码,只有你同意后才会添加,同意要在电脑弹出的窗口里确认。为其他游戏系统制作的扩展会注明适用的系统,不能添加。在“扩展包 › 已安装”中,你可以更新或移除扩展;你提出要求时,主持人也可以添加扩展。
246
246
 
247
247
  ---
248
248
 
@@ -272,13 +272,13 @@ RPG Engine 只待在这个文件夹里:它只在这里读写游戏,绝不会
272
272
 
273
273
  ---
274
274
 
275
- ## 9. 后续计划 <!-- icon: hourglass -->
275
+ ## 9. 敬请期待 <!-- icon: hourglass -->
276
276
 
277
- - **由你担任主持人**,由 AI 扮演队伍。
278
- - **作者模式**:与 AI 一起编写冒险,然后导出并分享。
279
- - **同一台电脑上的多名玩家**,各有自己的角色,在同一个聊天中轮流行动。
280
- - **扩展**:设置、冒险、功能和房规。
281
- - **其他游戏**:更多游戏系统,以及你自己的系统。
277
+ - **由你担任主持人**,AI 扮演队伍。
278
+ - **作者模式**:和 AI 一起编写冒险,然后导出并分享。
279
+ - **同一台电脑上的多名玩家**,各自操作自己的角色,在同一个聊天里轮流行动。
280
+ - **更多扩展**:可供分享的世界、功能和自定规则。
281
+ - **其他游戏**:更多游戏系统,也可以用你自己的。
282
282
 
283
283
  ---
284
284
 
@@ -57,6 +57,12 @@ export function markdownBlocks(text) {
57
57
  export function anchorOf(heading) {
58
58
  return heading.trim().toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s/g, "-");
59
59
  }
60
+ /** A part's preview: the plain words of its first paragraph or list item, and of the next when it ends in a colon. */
61
+ export function previewOf(blocks) {
62
+ const texts = blocks.flatMap((block) => (block.kind === "paragraph" ? [block.text] : block.kind === "list" ? block.items : [])).map((text) => plainText(text).trim());
63
+ const [first = "", next] = texts;
64
+ return first.endsWith(":") && next !== undefined ? `${first} ${next}` : first;
65
+ }
60
66
  /** A line's text without its marks, as a card's preview says it. */
61
67
  export function plainText(text) {
62
68
  return text.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/\*\*|\*|`/g, "");
@@ -2,12 +2,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
2
2
  // Help (D-409, D-413): the complete guide, in the page's language, as its markdown file has it (guide/<code>.md): what it is, an index of chips, and each of
3
3
  // its parts a card that folds, the first two open. Its anchors are the English guide's, so that a link finds its heading in every language. At its end, how to
4
4
  // tell us what went wrong: the page's own words, so that the guide's translations stay as they are.
5
- import { useEffect, useMemo, useState } from "preact/hooks";
5
+ import { useEffect, useMemo, useRef, useState } from "preact/hooks";
6
+ import { readAddress, sectionAddress } from "../address.js";
6
7
  import { CardHead, CardHeader } from "../card.js";
7
8
  import { Icon, iconPath, isIconName } from "../icons.js";
8
9
  import { PageHead } from "../pages.js";
9
10
  import { pageLanguageOf, t } from "../text.js";
10
- import { anchorOf, markdownBlocks, plainText } from "./blocks.js";
11
+ import { anchorOf, markdownBlocks, previewOf } from "./blocks.js";
11
12
  import { Blocks, Inline } from "./markdown.js";
12
13
  /** How to play with RPG Engine: the guide, from installing it to the campaign's folder. */
13
14
  export function Help() {
@@ -26,8 +27,19 @@ export function Help() {
26
27
  if (index >= 0) {
27
28
  setOpen((before) => new Set([...before, index]));
28
29
  setSought(anchor);
30
+ // The chapter in the address, so that it can be sent or opened again: #/help/2-play.
31
+ history.replaceState(null, "", sectionAddress("help", anchor));
29
32
  }
30
33
  };
34
+ // A chapter the address names, once the guide is read.
35
+ const arrived = useRef(false);
36
+ useEffect(() => {
37
+ const wanted = readAddress(location.hash).tab;
38
+ if (!arrived.current && wanted !== undefined && parts.length > 0) {
39
+ arrived.current = true;
40
+ go(wanted);
41
+ }
42
+ }, [parts]);
31
43
  useEffect(() => {
32
44
  if (sought === undefined) {
33
45
  return;
@@ -47,7 +59,7 @@ export function Help() {
47
59
  }
48
60
  focused?.focus({ preventScroll: true });
49
61
  }, [sought]);
50
- return (_jsxs("section", { class: "page-stack help", "aria-labelledby": "help-title", children: [_jsx(PageHead, { section: "help", id: "help-title" }), _jsx("div", { class: "help-lead", children: _jsx(Blocks, { blocks: lead, anchors: anchors, go: go }) }), _jsx("nav", { class: "help-index", "aria-label": t("Contents"), children: parts.map((part) => (_jsxs("button", { type: "button", class: "help-chip", onClick: () => go(anchors.get(part.heading) ?? ""), children: [_jsx(Icon, { name: iconOf(part.heading) }), _jsx(Inline, { text: part.heading.text, go: go })] }, part.heading.text))) }), _jsx("div", { class: "help-cards", children: parts.map((part, index) => (_jsxs("details", { id: anchors.get(part.heading), class: "group help-card", open: open.has(index), children: [_jsx(CardHeader, { icon: iconPath(iconOf(part.heading)), title: _jsx("h3", { children: part.heading.text }), preview: plainText(part.blocks.find((block) => block.kind === "paragraph")?.text ?? ""), open: open.has(index), onToggle: (event) => toggle(index, event) }), _jsx("div", { class: "guide", children: _jsx(Blocks, { blocks: part.blocks, anchors: anchors, go: go }) })] }, part.heading.text))) }), _jsx(ReportCard, {})] }));
62
+ return (_jsxs("section", { class: "page-stack help", "aria-labelledby": "help-title", children: [_jsx(PageHead, { section: "help", id: "help-title" }), _jsx("div", { class: "help-lead", children: _jsx(Blocks, { blocks: lead, anchors: anchors, go: go }) }), _jsx("nav", { class: "help-index", "aria-label": t("Contents"), children: parts.map((part) => (_jsxs("button", { type: "button", class: "help-chip", onClick: () => go(anchors.get(part.heading) ?? ""), children: [_jsx(Icon, { name: iconOf(part.heading) }), _jsx(Inline, { text: part.heading.text, go: go })] }, part.heading.text))) }), _jsx("div", { class: "help-cards", children: parts.map((part, index) => (_jsxs("details", { id: anchors.get(part.heading), class: "group help-card", open: open.has(index), children: [_jsx(CardHeader, { icon: iconPath(iconOf(part.heading)), title: _jsx("h3", { children: part.heading.text }), preview: previewOf(part.blocks), open: open.has(index), onToggle: (event) => toggle(index, event) }), _jsx("div", { class: "guide", children: _jsx(Blocks, { blocks: part.blocks, anchors: anchors, go: go }) })] }, part.heading.text))) }), _jsx(ReportCard, {})] }));
51
63
  }
52
64
  /** Where the issues of RPG Engine are reported, as its README says. */
53
65
  export const issuesLink = "https://github.com/stefanocaronia/rpg-engine/issues";
@@ -1,4 +1,5 @@
1
1
  import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-runtime";
2
+ import { sectionAddress } from "../address.js";
2
3
  /** Blocks drawn as the page's elements: headings one level under the card's, each with the anchor given by its place among them; a link to an anchor calls go. */
3
4
  export function Blocks({ blocks, anchors, go }) {
4
5
  return _jsx(_Fragment, { children: blocks.map((block, index) => _jsx(BlockView, { block: block, anchors: anchors, go: go }, index)) });
@@ -54,7 +55,7 @@ function BlockView({ block, anchors, go }) {
54
55
  /** A link: to a heading of the guide, which go brings into sight; to a page of the web, in a new tab. */
55
56
  function LinkView({ label, target, go }) {
56
57
  if (target.startsWith("#")) {
57
- return (_jsx("a", { href: target, onClick: (event) => {
58
+ return (_jsx("a", { href: sectionAddress("help", target.slice(1)), onClick: (event) => {
58
59
  event.preventDefault();
59
60
  go(target.slice(1));
60
61
  }, children: _jsx(Inline, { text: label, go: go }) }));