23 — World Map & Hub (bản đồ thế giới Xứ Vọng & Tháp Chuông Gãy)

Xứ Vọng là khối núi hình chuông úp: chân = đồi làng, sườn = đầm + mỏ đồng, đỉnh = vực + kinh đô treo + Đại Chuông. Sông Tro chảy vòng chân núi (sông vành): bờ trong = Xứ Vọng, bờ ngoài = Bờ Lặng (B6). Kênh Dẫn Hồn chảy từ đỉnh xuống, đổ ra Sông Tro ngay cạnh hub. Run đi từ vành vào tâm, thấp lên cao.

1.1 Sơ đồ (nhìn từ trên, Bắc lên trên; không theo tỉ lệ)

                         .-----------------------------.
                        /   [B5] ĐỈNH CHUÔNG CÂM        \
                       /    sân tròn r260 dưới miệng     \
                      /     Đại Chuông · ngai Mũ Chuông   \
                     |  ......... Cầu Xích Vua ........... |
                     |  [B4] THÀNH CHUÔNG TREO             |
                     |   kinh đô treo xích qua Vực Vọng    |
                     |   tháp cờ hiệu · chuồng rồng tro    |
                     |                 ║                   |
            mỏ đồng  |  [B3] LÒ ĐÚC CÂM ║  Lò Mẹ           |
            (sườn Tây)|  băng chuyền khuôn║ kho chuông câm  |
                     |                 ║ Kênh Dẫn Hồn      |
                     |  [B2] ĐẦM VẢI LIỆM (đò ngược kênh)  |
                     |   Rừng Đước Liệm · Bến Đò Lật       |
                     |                 ║                   |
                     |  [B1] ĐỒI MỘ TRO ║                  |
                     |   Làng Gặt · Nhà Nguyện Chuông Đá   |
                      \  Sân Hầm Tro    ║                 /
   ~~~~~~~~~~~~~~~~~~~~\~~[HUB] THÁP CHUÔNG GÃY ═╝~~~~~~~/~~~~~~~~~~~~~~~
   ~~~~~~~~~~~~~~~~~~~~ SÔNG TRO (sông vành, chảy Đông → Tây) ~~~~~~~~~~~~
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   ░░░░░░░░░░░░░░░░ [B6] BỜ LẶNG — bờ ngoài, Bãi Gương ░░░░░░░░░░░░░░░░░░
   ║ = Kênh Dẫn Hồn (đỉnh → sông) · ═╝ = cửa kênh đổ ra sông cạnh hub

1.2 Vùng

1.3 Luật thế giới áp cho mọi bản đồ

• Tro rơi như tuyết B1–B4, dày dần theo độ cao (hub = 40% mật độ B1); B5 tro lơ lửng/rơi ngược; B6 không tro.
• Không mặt trời: trăng tro xám là nguồn chung, đặt cố định trên-trái; ánh ấm chỉ ở lửa người sống (hub có nhiều nhất).
• Chuông có ở mọi vùng. Chuông phe địch câm/nứt/đục; tiếng ngân trong trẻo chỉ của mảnh lưỡi hero và chuông tháp hub (Chuông Thử 196 Hz, GD5 chuông lớn).
• Nước: hub sông/kênh xám-lam trôi; B2 nước nông; B6 gương phẳng không phản chiếu, không tiếng vọng.

 HUB ──(ST_DOCK: chọn mode, cảnh 6 s)──► B1 Hồi I (R1…R5 → R6 BOS BS_B1)
                                            │ DOCK ≤ 20 s (đò ngược Kênh Dẫn Hồn)
                                            ▼
                                         B2 Hồi II (+ Act Mutator) → BS_B2
                                            │ DOCK
                                            ▼
                                         B3 Hồi III → BS_B3
                                            │ DOCK
                                            ▼
                                         B4 Hồi IV → BS_B4
                                            │ DOCK + leo Cầu Xích Vua (20 s)
                                            ▼
                                         B5 Kết: ải 60 s → BS_FINAL ──► ENDING
                                            │ chỉ khi FLAG_SHORE_OPEN: đò cuối xuôi kênh 15 s
                                            ▼
                                         B6 Bí mật: ải 45 s → BS_TRUE ──► END_QUIET_SHORE
 chết ở bất kỳ đâu / thắng ──► SUMMARY ──► mảnh lưỡi kéo về Lửa Canh ──► HUB (thức dậy ST_HEARTH)

Nút DOCK dùng chung 1 phòng: Boong Đò Calla (nút DOCK) RM_HUB_ferry_deck (480 × 540 px sàn, camera cố định 480×270). Nền = parallax 3 lớp của biome Hồi kế (0.2× / 0.5× / 0.8×) trượt Tây → Đông 24 px/s; nước kênh tint LUT biome kế. Biome B1–B5 chỉ cung cấp 3 lớp parallax ENV_<Bn>_dock_bg_far|mid|near (đề xuất cho agent biome); nếu thiếu → dùng parallax mặc định sương tro của hub.

Bến (DOCK) của B1–B5 ở doc 20 (Bậc Đá Bến Kênh, Bến Calla, Bến Cống Xỉ, Bến Chân Cầu Xích…) = nơi đò rời bờ, chỉ hiện qua parallax ENV_<Bn>_dock_bg_far|mid|near của phòng Boong Đò Calla (nút DOCK) RM_HUB_ferry_deck; không có phòng DOCK riêng trong biomes/<Bn>.json.

1 scene Hub_BellTower + 1 sub-scene Hub_TowerLoft. 0 quái · 0 hazard · 0 sát thương (trừ đòn hero vào bù nhìn Sân Tập). Đi bộ tốc hero gốc; dịch chuyển nhanh MAP (Back/Tab) → danh sách trạm đã mở → mờ 0.25 s (FastTravel (MAP → chọn trạm): t=0 ở chỗ cũ, t=0.25 ở trạm đích VFX_ENV_HUB_fast_travel) → đứng trước trạm. Trong r24 px của trạm → nhắc INTERACT (A/E).

3.1 Lưới & quy đổi toạ độ

3.2 Sơ đồ đầy đủ (1 ký tự = 1 ô 16 px màn; Bắc lên trên)

##^^^^^^^^^^^^^^^^^^^^^^^^^^::::^^^^^^^^^^^^^^^^^^^^^^^%%%##
##^^^^^^^^^^^^^^^^^^^^^^^^^^:||:^^^^^^^^^^^^^^^^^^^^^^^%%%##
##^^^^^^^^^^^^^^^^^^^^^^^^^^::::^^^^^^^^^^^^^^^^^^^^^^^%%%##
##.......................s..::::...s..................-%%%##
##...........................GGG......................-%%%##
##....................s...............s...............-%%%##
##............................B.......................-%%%##
##....................................................-%%%##
##....................s....TTTTTTTT...s...............-%%%##
##..............#####......TTTTTTTT.W...#####.........-%%%##
##..............#####......TTTTTTTT./...#####.........-%%%##
##...............FFF.......TTTTTTTT./....LLL..........-%%%##
##...............FFF.......TTTTTTTT/.....LLL..........-%%%##
##............................:.......................-%%%##
##...........................HHH.............e.e.e.e.e-%%%##
##........................o.......o...................-%%%##
##............................S..............e.e.e.e.e-%%%##
##............................:.......................-%%%##
##......::::::::::::o:::::::::::::::::::o::::::::::...-%%%##
##............................:...........o,,,,,,,,,,o-%%%##
##............................:...........,,,,,,,,,,,,-%%%##
##............................:...........,,,,,,,,,,,,-%%%##
##.........#######............:...........,,,,,,,,,,,,-%%%##
##...........MMM..............:...........,,,,,YYY,,,,-%%%##
##...........MMM..............:...........,,,,,YYY,,,,-%%%##
##............................:...........,,,,,,,,,,,,-%%%##
##..........................=====.........,,,,,,,,,,,,-%%%##
##.........................o=====o........,,,,,,,,,,,,-%%%##
##..........................=====.........o,,,,,,,,,,o-%%%##
##,,,,,,,,,,,,,,,,,,,,,,,,,,=====,,,,,,,,,,,,,,,,,,,,,-%%%##
##----r-----r-------r-------=====-----r-------r----r--.%%%##
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~DDD~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~DDD~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

3.3 Trạm, NPC, prop (vị trí khoá; ô theo doc 18 §1.1)

• Trạm chưa mở: prop có mặt, phủ vải xám (biến thể 0), không đèn, không nhắc INTERACT; NPC chưa xuất hiện (trừ Lem). Mở lần đầu → StationUnlocked (lần đầu trạm mở: FORGE/LEDGER sau run 1, MARKET run … VFX_ENV_HUB_station_unveil + StationUnlocked SFX_ENV_HUB_station_unveil + camera pan 0.6 s tới trạm rồi trả.
• NPC không bao giờ chắn lối: va chạm NPC = elip r8, đứng ngoài lối :; bark ≤ 1 dòng khi hero đi qua r48 (cooldown 30 s/NPC) + BarkShown speaker=NPC_* (1 lần khi bark mở) SFX_HUB_npc_murmur.
• Trang trí đặt được (doc 18 §8): 6 bệ tượng sân trên · 3 kệ hộp nhạc + 10 khung tranh trong loft · nến trên bia.

3.4 Khu/phòng (rooms[] trong HUB.json)

• Schema bắt objectives ≥ 1 và node_types ≥ 1 cho mọi phòng: phòng hub ghi ["TRIAL"] / ["DOCK"] làm giá trị giữ chỗ. RoomPicker của nút DOCK chỉ được chọn Boong Đò Calla (nút DOCK) RM_HUB_ferry_deck; mọi RM_HUB_* khác chỉ dùng trong scene hub; MapGen/Director bỏ qua file HUB.
• spawn_edges ở hub = hướng người chơi đi vào khu (không có quái spawn).

Mood: nơi nghỉ duy nhất — ấm, chậm, buồn không tuyệt vọng. Thời điểm: đêm vĩnh viễn, trăng tro sau mây, tro rơi mỏng 40% B1.

4.1 Nguồn sáng

• Color grading LUT_HUB: shadow nâng về #23212a, highlight +3% R, bão hoà ×0.95. V sàn base: GD0 0.17 → +0.02/GĐ → GD5 0.27 (luôn < V hero / 1.35).
• Vũng sáng động tối đa trong hub: 12 (≤ trần 24, doc 31 §6.1).

4.2 Ramp (token → hex; mọi màu S ≤ 40%)

Cấm (forbidden hues): vàng tell hue 32–62° S ≥ 45% (chỉ #ffd84a) · tím tell 260–290° S ≥ 45% (chỉ #b14cff) · đỏ thẫm 340–10° S > 30% · mọi pixel môi trường S > 40% · tâm slot 12 hero ±10° với S > 30% trên đèn/prop phát sáng · vòng chấm #e8e4f0 + gạch chéo trên tile/decal · #f2ead8 (dành ◆ Tro Nhớ).

• Phá huỷ: hub không có vật phá được, không rơi đồ, không tiền. Tương tác chỉ qua INTERACT (trạm, bia, bệ, chuông gãy, kệ hộp nhạc) hoặc chạm (lau sậy, bụi khô rung + HeroOverlap ENV_HUB_river_reeds / ENV_HUB_ash_shrub (+ là spot) SFX_ENV_HUB_reed_rustle).
• Ngoại lệ chiều cao: Thân Tháp Chuông Gãy 176 px (LMK_HUB_bell_tower), ô (27–34, 8–12). 6 … ENV_HUB_tower_body 176 px (hub không là sân đấu → trần 64 px doc 30 §6.2 không áp); che hero → α 0.45 + x-ray.
• Hazard: 0 (schema HZ_ chỉ cho B1–B6). Lý do: hub là nơi an toàn tuyệt đối; tương tác môi trường thay hazard = prop phản ứng (lau sậy, bụi, chuông gãy, dummy).

• Cấm trong hub: âm tell (chuông đục 1 tiếng, "tinh", rít tím) ngoài Sân Tập; reverb > 1.2 s; tiếng ngân trong ngoài TestBellStruck (INTERACT Chuông Thử, đổi Nến Canh, buộc Khăn Tang) SFX_HUB_test_bell (196 Hz), ForgeUnlock (rèn mở hero): 3 nhát cách 0.3 s + tôi nước t=0.9 s SFX_HUB_forge_unlock (đuôi mảnh lưỡi), GD5 cảnh treo chuông (t=6 s) SFX_ENV_HUB_bell_raise, hum GD5 98 Hz.

• Mỗi GĐ = 1 lớp prop + 1 đèn (α ≤ 0.25) + 1 lớp ambience + 1 stem; KHÔNG 5 bộ art (Bible §3). Cảnh GĐ: giàn restore_scaffold 4 s + RestoreStageBought GD1–GD5 (cảnh 6–12 s, VFX chạy 0–4 s) VFX_ENV_HUB_restore_stage + RestoreStageBought GD1–GD5 (t=0 cảnh) SFX_HUB_restore_stage (biến thể n = GĐ n).

1. Hàng Bia 10 bia gỗ: 8 tên Kẻ Thức đã ngã trước người chơi + 2 bia trống Hol để sẵn.
2. Chuông Gãy 13 vết khía vành = 13 mảnh lưỡi; vết 13 sâu hơn.
3. Bến Đò 4 cọc, 3 gãy; chỉ cọc của Calla còn dây mới.
4. Dây lời trăng trối tăng theo GĐ; sau kết thật trống trơn (Mott trả lại hết).
5. Bát cháo của Lem luôn đầy, nguội — em không ăn; gương loft không phản chiếu Lem.
6. Mũ sắt của Răm khắc tên Đời Một không khớp Sổ Tang (không giải ở 1.0).
7. Dấu chân tro trên bậc Cổng Đồi: +1 cặp/run, tối đa 24.
8. Bờ kia chỉ là dải sương phẳng không phản chiếu; có Run sau mở B6 sau BS_FINAL (BS_TRUE). FLAG_SHORE_OPEN → 1 đốm bạc nhợt nhấp nháy 0.25 Hz.
9. Giá Khăn Tang số dải = Độ Tang đang buộc / 3.

• Mọi VFX hub: owner_class ENV, tint BIOME, dirs 1, không hitbox, LOD L1 (khí quyển) / L2 (trạm), act_fog never. Cấm vòng/elip sàn viền 2 px và sóng vòng (Chuông Thử = vạch rung dọc).
• Hub không có encounter, wave script, event EVT_: encounter_scripts/encounters/events để trống có chủ ý.

1. Hub = 0 quái, 0 hazard, 0 sát thương, 0 rơi đồ. Không thêm combat vào hub (trừ đòn hero vào Bù Nhìn Răm NPC_RAM, không thưởng).
2. Vị trí trạm/NPC dùng đúng ô §3.3; đổi ô = sửa doc 18 §1.1 + doc này + HUB.json cùng lượt.
3. Tiến hoá hub chỉ bằng lớp cộng dồn (prop + đèn α ≤ 0.25 + 1 lớp ambience + 1 stem nhạc) theo FLAG_*; cấm làm bộ art thứ 2 cho tháp.
4. Mọi pixel môi trường hub S ≤ 40%; không vàng/tím tell, không đỏ thẫm, không vòng chấm/gạch chéo; chạy inv01_check.py --kind env = 0 lỗi trước art-style-reviewer.
5. Tiếng chuông trong trẻo chỉ ở 4 nguồn (§6); mọi chuông khác trong hub câm.
6. RoomPicker nút DOCK chỉ chọn Boong Đò Calla (nút DOCK) RM_HUB_ferry_deck; MapGen/HordeDirector không đọc biomes/HUB.json.
7. Id mới của hub: VFX/SFX VFX_ENV_HUB_<slug> / SFX_ENV_HUB_<slug>; 13 id SFX_HUB_* canon doc 32 §7.2 giữ nguyên tên và cũng nằm trong av/ENV_HUB.json.
8. Tham chiếu chéo trong HUB.json chỉ tới ENV_HUB_*, VFX/SFX_ENV_HUB_*, SFX_HUB_*, SHARED/UI, HUB · HUB_BELL_TOWER Tháp Chuông Gãy (mọi trạm ST_*) · S0 + stem GĐ Phục Dựng đã mở (GD1–… MUS_hub_bell_tower.
9. Thêm prop hub → thêm env_assets trong av/ENV_HUB.json + id vào HUB.json props + validate cả 2 file.
10. Ô hub (x, y) ↔ px theo §3.1; không trộn ô 16 px với tile FLOOR 32×16.