Desert notes after retiring the alternative renders; mod documentation

This commit is contained in:
cthangover committed 2026-10-29 09:26:13 +01:00
1 parent c2a5074337
commit 36882e50cf
40 files changed
+1867 -70

No files matched your search

+115
View File
@@ -0,0 +1,115 @@
# RPG Plus — một RPG rừng rậm dựng từ các mod
RPG Plus là một trò RPG nhỏ mà hoàn chỉnh: phần mở đầu kiểu tiểu thuyết tương tác để bạn chọn quá khứ của anh hùng, rồi một làng và khu rừng trên bản đồ ô vuông, bí ẩn về ánh sáng lạc mất của khu rừng, nhiệm vụ phụ, bàn chế tạo, thương nhân, một hoang mạc phía tây và chiến đấu theo lượt. Trò chơi chỉ gồm tệp dữ liệu và kịch bản; còn luật chơi — chỉ số, trang bị, phép kiểm, chiến đấu, chế tạo — đến từ những mod riêng mà trò chơi khác cũng dùng được.
Chơi từ **Chơi → RPG Plus → Trò chơi mới**.
![Phần mở đầu ở ngã ba: tấm biển chỉ đường bên con đường rừng và câu hỏi “Trước khi đến đây, ngươi là ai?” với ba câu trả lời: lính, đệ tử pháp sư, kẻ phiêu bạt.](assets/prologue.jpg)
## Cốt truyện và cách chơi
1. **Ngã ba.** Chọn quá khứ của bạn: **lính** (chiến binh), **đệ tử pháp sư** (pháp sư) hay **kẻ phiêu bạt** (rogue). Lựa chọn quyết định chỉ số và trang bị khởi đầu. Bạn bắt đầu với 25 đồng xu.
2. **Ngôi làng bên Rừng Xám.** Đi lại bằng WASD hoặc phím mũi tên, chạy bằng Shift, dùng E hoặc F để nói chuyện và tương tác. **Nhật ký** luôn ghi rõ bước cụ thể tiếp theo của bạn.
3. **Trưởng làng** hỏi về ánh sáng biến mất, hoặc phái bạn đi ngay theo con sói ở hang phía đông.
4. **Khu rừng.** Hái củi và nấm; slime rơi ra nhựa sống và đồng xu. Con sói luôn rơi trái tim hổ phách và đủ lông để may một chiếc áo choàng.
5. **Bàn chế tạo bên giếng.** Làm thuốc mỡ rừng (nấm + nhựa), áo choàng người canh rừng (2 lông + 2 nhựa) hoặc đèn lồng hộ mệnh (hổ phách + 2 nhựa + 2 củi). Mang áo choàng từ túi đồ: nó thay đổi con số chiến đấu thật của bạn.
6. **Bà thuốc** ở hàng rào phía tây cần thuốc mỡ; giúp bà dẫn tới người đưa thư mất tích trong rừng phương nam.
7. **Đền thờ.** Xách đèn qua hang động phía sau con sói tới đền thờ hoang tàn. Trả ánh sáng cho khu rừng, hoặc lập khế ước cho ngôi làng. Cả hai kết thúc đều khép lại cuộc phiêu lưu, và lời cuối của trưởng làng sẽ theo lựa chọn của bạn.
Một số người khác trong làng: **võ sư** dẫn bạn ra bãi tập (kinh nghiệm một lần, kèm phép kiểm Sức mạnh để nhấc khúc gỗ), và **bà thầy bói** đọc vận may của bạn. Lò sưởi bên giếng hồi máu và mana. Phần thưởng không nhận lại được lần thứ hai.
![Bàn chế tạo bên giếng với ba công thức: Thuốc mỡ rừng, Áo choàng người canh rừng và Đèn lồng hộ mệnh, nguyên liệu bạn có và cần, cùng nút Chế tạo.](assets/workbench.jpg)
![Đền thờ hoang trong rừng, “Khu rừng nhớ”, anh hùng đang xách đèn.](assets/shrine.jpg)
### Hoang mạc
Từ làng, đi theo con đường chính về phía tây, ra khỏi mép bản đồ là tới **Vùng Biên Khô**: cát, một ngôi nhà bằng đất nặn, chỗ trú của đoàn thương xa, một tòa tháp hoang, cây cọ và xương rồng. Năm con bọ cạp và bọ hung chờ được đánh, và các thùng tiếp tế cất phần thưởng nhỏ một lần. Mép đông dẫn về lại làng.
![Vùng Biên Khô: cát với chỗ trú của đoàn thương xa, xương rồng, cây cọ, thùng hàng, bọ cạp và bọ hung; anh hùng tới bằng con đường từ phía đông.](assets/desert.jpg)
## Anh hùng của bạn
Mở **bảng nhân vật** từ thanh công cụ để xem class, cấp và kinh nghiệm, các chỉ số (Sức mạnh, Nhanh nhẹn, Trí tuệ, Sinh lực, Sức hút, May mắn), giá trị chiến đấu và trang bị trong ba ô vũ khí, thân thể và phụ kiện. Trang bị lấy từ túi đồ.
![Bảng nhân vật của một rogue cấp 2: chỉ số, máu và mana, tấn công có +3 từ trang bị, các ô trang bị trống.](assets/character-sheet.jpg)
Trận đánh dùng lối chiến đấu ra lệnh (FF), sát thương tính theo công thức. Một số lựa chọn hội thoại đem chỉ số ra thử với một lần gieo d20, ví dụ **[Sức mạnh 12]** của võ sư.
![Trận đánh với con sói: anh hùng ở dưới bên trái, con sói cùng máu, tấn công và phòng thủ ở phía trên, nhật ký chiến đấu bên phải.](assets/battle.jpg)
## Trò chơi được ghép thế nào
RPG Plus là bộ sưu tập **RPG Plus**. Các khối của nó:
```text
Cốt truyện rpg_plus_game (mod này)
Làng và rừng rpg_demo_game: bản đồ, con người và vật phẩm mà trò này mở rộng
Tài nguyên và luật village_pack (hình ảnh), classic_rpg_pack (chỉ số, class, trang bị)
Chỉ số và phép kiểm stats_base, stat_checks
Thế giới ô vuông rpg
Vật phẩm, trang bị, mua bán items_base, equipment, trading, crafting
Engine 2D shell2d_base, dialog_base, characters_base, audio_base
Chiến đấu turn_battle_base, ff_battle, battle_formulas
Chiến đấu thẻ bài card_battle (tùy chọn)
Giao diện ui_base, menu_base
Trình soạn bản đồ ô rpg_editor (tùy chọn)
Trình soạn dữ liệu schema_tools, items_editor, characters_editor (tùy chọn)
Bộ dựng ô tile tile_topdown_base, tile_isometric_base
```
Cấu hình của bộ sưu tập: `battle.core` là `ff_battle`, phép kiểm gieo `d20`, hình anh hùng trên bản đồ là `village/hero`, bản đồ vẽ nhìn từ trên xuống. Đổi trong **Mods & Collections → Bộ sưu tập → RPG Plus → Sửa sơ đồ**.
## Dành cho tác giả: đổi nội dung không cần mã
```filestree
rpg_plus_game/
├── scenarios/rpg_plus/ phần mở đầu, training_yard, events/ (võ sư, thầy bói), woodland/, desert/
├── map_events/<map>/ người mới, bàn chế tạo, cửa hang, thùng hàng; id trùng sẽ thay của rpg_demo_game
├── maps/ rpg_woodland_shrine.json, rpg_desert.json
├── scenes/ ngã ba, bãi tập, đền thờ, hoang mạc
├── quests/woodland.json các chặng nhật ký
├── items/, recipes/, stations/ nguyên liệu, sản phẩm, trình đơn của bàn chế tạo
├── patches/character.json chiến lợi phẩm thêm cho quái của rpg_demo_game
├── patches/shop.json thêm hàng cho thương nhân trong làng
└── characters/, charsets/, backgrounds/, locale/
```
**Hãy mở rộng mod của người khác thay vì copy nó.** Làng, nhà và rừng vẫn đến từ `rpg_demo_game`. Sự kiện trùng id với sự kiện ở đó sẽ thay thế nó (trưởng làng nhận hội thoại mới); id mới thêm người. Các bản vá thêm chiến lợi phẩm cho quái và thêm hàng cho cửa hàng của nó.
**Phép kiểm và điều kiện trong kịch bản.** Bà thầy bói thử May mắn rồi nhìn trang bị của bạn:
```scenario
text "“Muốn biết điều gì đang chờ ngươi? Đưa tay đây. Không phải tay đó — tay không dùng để trộm ấy.”" key=rpg_plus/seer/hello
check luk 14 who=rpg_hero else=fail -> :ok
:ok
text "“Con sói ở hang sợ lửa hơn thép. Và hãy đánh vào chỗ nó không có khiên. Phần này miễn phí. Phần còn lại thì không.”" key=rpg_plus/seer/fortune
when "!equipped(rpg_hero, 'classic/clover_charm')" -> :charm
end
```
`when "item('rpg_plus/salve') >= 1"` nhìn vào túi đồ, `level(rpg_hero) >= 3` nhìn cấp của anh hùng; nhờ các cờ mà phần thưởng một lần không bị nhận hai lần. Các câu viết bằng tiếng Nga, mỗi câu một `key=`; bản dịch nằm trong `locale/scenarios_<lang>.properties`.
**Một công thức** là dữ liệu trong `recipes/woodland.json`:
```json
{
"Id": "rpg_plus/salve",
"Name": "rpg_plus/recipe/salve/name",
"Type": "Cooking",
"Input": [
{ "Id": "rpg_demo/mushroom", "Count": 1 },
{ "Id": "rpg_plus/resin", "Count": 1 }
],
"Output": [{ "Id": "rpg_plus/salve", "Count": 1 }]
}
```
**Trình soạn bản đồ ô** tùy chọn vẽ nền, va chạm và sự kiện, còn **Trình soạn dữ liệu** sửa vật phẩm, công thức và nhân vật. Bật chúng trong sơ đồ của trò chơi.
## Nếu có trục trặc
1. **Hổ phách của con sói thiếu trong bản lưu cũ.** Ra chỗ con sói bên hang và nhấn E/F: nếu bạn chưa có hổ phách cũng như đèn, có thể nhặt nó ở đó một lần.
2. **Chưa biết làm gì tiếp.** Mở nhật ký.
3. **Một lựa chọn hội thoại mất tích.** Một số lựa chọn chỉ xuất hiện sau một chặng nhiệm vụ nhất định hoặc khi có vật phẩm nhất định.