Add mod documentation in seven languages

This commit is contained in:
cthangover committed 2026-10-29 09:25:50 +01:00
1 parent f11f4e0e02
commit 2bd588fb77
19 files changed
+615 -3

No files matched your search

+86
View File
@@ -0,0 +1,86 @@
# Crafting — мастерские, превращающие материалы в предметы
Crafting добавляет станции, на которых игрок что-то мастерит: верстак, стол алхимика, швейный набор. Станция предлагает фиксированный список рецептов; каждый рецепт берёт из сумки одни предметы и выдаёт другие. Всё это данные — станция, рецепты и обычные предметы — а станцию открывает одна строка сценария. Работает в любой игре: из ответа в диалоге визуальной новеллы, щелчка по объекту или события на тайловой карте.
## В игре
В RPG Plus у деревенского колодца стоит верстак. Игрок собрал две серебристые шерсти и три живые смолы и выбирает плащ лесного стража:
![Окно верстака у колодца поверх карты деревни: слева три рецепта — Woodland salve, Warden mantle (выбран), Ward lantern; справа — картинка и описание плаща, INGREDIENTS · owned / needed: Silver wolf fur 2 / 2, Living resin 3 / 2; PRODUCTS: Warden mantle × 1; кнопка Craft; внизу — "Ingredients are consumed only when you craft. Esc closes."](assets/workbench.jpg)
- **Рецепты** слева; щёлкните по одному, чтобы рассмотреть.
- **Ингредиенты** показывают, сколько у вас есть и сколько нужно.
- **Изготовить** доступно, только когда всё на месте.
После **Изготовить**:
![Та же панель после изготовления: Silver wolf fur 0 / 2, Living resin 1 / 2 и надпись "Done. The product is in your bag."](assets/crafted.jpg)
Сумка до и после — шерсть ушла, осталась одна смола, плащ прибыл:
![Два ряда ячеек сумки. До: гриб, монеты ×25, смола ×3, волчья шерсть ×2. После: гриб, монеты ×25, смола, Warden mantle.](assets/bag-before-after.jpg)
Изготовление занимает время: игровые часы уходят вперёд на `Time` рецепта, в минутах — для плаща это 10. Сам плащ — экипировка (см. Equipment), носить его можно сразу.
## Станция и её рецепты
Верстак из RPG Plus:
```json
{
"Kind": "craft_station",
"Items": [
{
"Id": "rpg_plus/workbench",
"Name": "rpg_plus/station/name",
"Recipes": [ "rpg_plus/salve", "rpg_plus/mantle", "rpg_plus/lantern" ]
}
]
}
```
и один из его рецептов:
```json
{
"Kind": "recipe",
"Items": [
{
"Id": "rpg_plus/mantle",
"Name": "rpg_plus/recipe/mantle/name",
"Description": "rpg_plus/recipe/mantle/desc",
"Time": 10,
"Input": [ { "Id": "rpg_plus/wolf_pelt", "Count": 2 }, { "Id": "rpg_plus/resin", "Count": 2 } ],
"Output": [ { "Id": "rpg_plus/fur_mantle", "Count": 1 } ]
}
]
}
```
- Станция перечисляет рецепты по id, в порядке показа; рецептами можно делиться между станциями.
- `Input` берётся из сумки, `Output` в неё добавляется; `Time` — в игровых минутах.
- Имена и описания — ключи переводов вашего мода.
Учить эти рецепты заранее не нужно: станция предлагает все свои.
## Открытие станции
Событие верстака на карте деревни запускает сценарий:
```scenario
ptext "На верстаке лежит инструкция: «Не пробовать. Не нюхать.»" key=rpg_plus/woodland/workbench/1
action craft.open station=rpg_plus/workbench
end
```
Пока окно открыто, игрок не может ходить; Esc его закрывает.
## Сначала проверка, потом изменения
Изготовление проверяется целиком до того, как что-то меняется: каждый ингредиент и продукт должны существовать, количества должны быть положительными, а в сумке всего должно хватать. Если что-то не так — не берётся ничего. Созданные предметы — обычные предметы, поэтому они сохраняются вместе с сумкой.
## Если что-то пошло не так
1. **«Изготовить» серое.** Не хватает ингредиента; числа «есть / нужно» показывают, какого.
2. **Рецепта нет в окне.** Станция называет в `Recipes` id, на который не откликается ни один рецепт.
3. **Окно не открывается.** id в `station=` не совпадает ни с одной станцией; проверьте лог.