32 — Audio Bible (âm thanh & nhạc, bản 1.0)

Mục đích: hợp đồng âm thanh đủ để 1 agent/nhà làm âm thanh tìm nguồn, sản xuất, mix và nối vào Unity MỌI sound/nhạc của Bladewake 1.0 mà không cần hỏi lại. Phụ thuộc: GDD/Full/docs/00-Design-Bible.md + GDD/Full/data/_bible.json (canon: INV-02 tell, §5 hero, §7 biome/quái, §10.3 ngân sách, §11 ID) · demo GDD/07-Game-Feel.md §7 · skill .claude/skills/create-sfx/ (synth + Freesound + QA) · MCP bf-sfx. Được dùng bởi: agent audio (nguồn/synth/mix), dev code Audio* (mixer, hook, nhạc thích nghi), VFX/anim (frame kích SFX), QA (test tai + LUFS), loc (phụ đề tell, text bark), sản xuất (thuê ngoài nhạc 4 PM + SFX 4 PM).

• Canon thắng doc này: id, số lượng (SFX ~880 sự kiện = 336 + 195 + 104 + 245, DEC-2026-11-07-17, chi tiết §4.4/§13; nhạc 18 bản + 4 bộ stem 120 BPM H12), tempo/nhạc cụ biome trong _bible.json biomes[].theme.
• Doc này sở hữu: luật timbre, cấu trúc nhạc thích nghi, mixer, giới hạn voice, LUFS, mẫu spec, thư viện SFX_SHARED_*, hook sự kiện → id, quy trình nguồn.
• Không có trong 1.0 (canon §13): voice có nghĩa (lời thoại đọc), video cutscene, nhịp theo nhạc ngoài bộ stem H12, middleware âm thanh ngoài Unity AudioMixer.
• Nền tảng mix: PC Steam (loa ngoài + tai nghe) → Steam Deck (loa nhỏ, tai nghe) cùng 1 bản mix + preset "Loa nhỏ" (§5.8). Port console sau dùng nguyên bus/snapshot.

2.1 Tell — 3 lớp INV-02 (khoá, mọi hero/quái/boss/hazard/Khăn Tang/mutator/Tro Nhớ)

Luật sở hữu phổ (tương đương INV-01 cho âm; mã AUD-01..AUD-04):

• AUD-01 Dải "tinh": âm không phải tell vàng KHÔNG được có partial tonal kim loại 2.2–3.6 kHz decay > 60 ms với mức ≥ −12 dB so với đỉnh của chính âm đó. Áp cho: chuông H03, đe H05, xu H09, chũm chọe H12, chuông hazard B1/B4, chuông mục tiêu BELLS, UI. Đồng xu/chũm chọe = nhiễu (noise) hoặc decay ≤ 60 ms → hợp lệ.
• AUD-02 Dải "ù": âm không phải tell tím KHÔNG được là swell đảo ngược/tăng dần có năng lượng chính < 140 Hz dài > 0.25 s. Âm trầm khác phải có transient (thump) hoặc mức ổn định (drone không phồng).
• AUD-03 Tell không bị bóp: bus EnemyTell miễn mọi trần đám đông, mọi duck, mọi snapshot bóp (kể cả BS_TRUE P2 "Nuốt Tiếng"); pitch không theo slow-mo (luôn 1.0); không ngẫu nhiên pitch > ±1%.
• AUD-04 Chỉ kẻ thật phát tell: ảnh giả MB_B4_2, bóng sàn không thật, hình nhân trang trí → 0 âm tell. Token (INV-08) quyết định ai được windup → số voice tell tối đa = 4 cận chiến + 3 loạt đạn + 5 tím = 12 (§5.4).
• Trợ năng meta.accessibility: "âm tell theo vị trí" bật → tell pan đầy ±1.0 theo x màn + cao độ "tinh" +2 bán cung khi nguồn ngoài màn; "phụ đề tell" → chữ [tinh ↖] / [ù ↓] ở mép màn theo hướng.

2.2 Bảng timbre theo phe

2.3 Bảng timbre 12 hero (chất liệu chủ không trùng; AP5)

Mỗi hero: 1 chất liệu chủ (vũ khí) + 1 chất liệu tài nguyên + âm ĐÁP riêng xếp trên lớp chung HeroAnswerSuccess (lớp chung dưới SFX_{H}_answer) + send Answer SFX_SHARED_answer_core (người chơi học: lớp chung = thành công; lớp riêng = hero). Motif hero dùng ở chọn hero, Ult, thẻ kết (§3.3).

Luật hero: (1) swing phát ở frame CUT kể cả đánh hụt; trúng là âm riêng (§6). (2) ≥ 3 biến thể cho mọi âm lặp; pitch ±6%, volume ±1.5 dB. (3) Dạng Rèn AS2/AS3 đổi vũ khí → đổi bộ swing/hit (cùng hero, 6 sự kiện swap, tính trong 28 sự kiện/hero qua biến thể). (4) Skin = cùng âm (LUT chỉ đổi màu).

2.4 Bảng timbre kẻ địch theo biome

Boss & mini — giọng chữ ký (1 giọng/boss, không lời):

3.1 Hướng chung

• Bảng nhạc cụ gốc: dây cung trầm (cello/bass bowed, méo nhẹ), trống khung/trống da, đe & chiêng (decay ngắn ở combat), kèn dăm kép, sáo trúc/xương, đàn gẩy một dây & dây buông, hợp xướng nguyên âm "a/o" (không lời có nghĩa, không trích kinh), drone bễ/harmonium trầm.
• Cấm toàn game: chiptune sóng vuông làm lead, wobble/dubstep bass, nhạc điện tử EDM drop, giai điệu dân ca/tôn giáo có thật trích nguyên, lời hát có nghĩa, piano trữ tình kiểu phim.
• Nhạc không theo slow-mo World (giữ tốc, chỉ lọc); không bị hitstop; pitch luôn 1.0.
• Mọi cue combat nằm trong 1 lưới tempo cố định, stem dài bằng nhau, lặp mẫu-chính-xác (§11.3). Key gốc của game = D (Hồi I và Kết cùng D → vòng tròn truyện).

3.2 Bảng hướng nhạc theo khu (bpm/meter/key/nhạc cụ khoá)

H12 Ambrin: B1–B4 thay bằng 4 bộ stem 120 BPM EXPLORE/COMBAT · Hồi I B1 KHI CHƠI H12 Ambrin (thay MUS_b1_grave_hill; biomes[].music.h12… MUS_b1_grave_hill_h12 … EXPLORE/COMBAT · Hồi IV B4 khi chơi H12 (thay MUS_b4_hanging_city) · 7/8 → 4/4 120, giữ a… MUS_b4_hanging_city_h12 (canon). Mọi boss cue + mini + finale = 120 BPM nên dùng chung với máy nhịp, không cần bộ riêng (§3.6).

3.3 Leitmotif (nốt chuẩn; hoà âm/nhạc cụ tự do trong luật §3.1)

Luật motif: ≤ 6 nốt; nhận ra trong 2 s; không nhạc cụ trùng giữa 2 motif hero; motif hero không dùng nhạc cụ có partial 2.2–3.6 kHz decay dài (AUD-01).

3.4 Hệ nhạc thích nghi (class MusicDirector)

Stem chuẩn mỗi cue combat (biome/boss/mini/finale) — 5 stem, dài bằng nhau, cùng điểm lặp:

Tham số cường độ I (0–1), tính mỗi 0.25 s (Hero clock): I_raw = clamp01(0.50·D + 0.25·T + 0.15·E + 0.10·H)

• D = min(alive_view, 200) / 200 — quái sống trong khung 480×270 art px quanh camera.
• T = 0.5·(melee_tokens_used / 4) + 0.5·(proj_tokens_used / 3) — token INV-08 đang dùng.
• E = 1 nếu Tinh Anh/mini/boss sống trong khung, else 0.
• H = 1 nếu HP hero < 35%, else 0.
• Làm mượt: lên τ_up = 1.0 s, xuống τ_down = 4.0 s (EMA). Ví dụ: 120 quái, 4/4 token cận chiến, 1/3 đạn, 1 Tinh Anh, HP 80% → 0.5·0.6 + 0.25·(0.5·1 + 0.5·0.333) + 0.15·1 + 0 = 0.30 + 0.167 + 0.15 = 0.617 → bật S0–S3, S4 chưa (ngưỡng 0.70) nhưng E = 1 ép S4 (bảng dưới).

Bảng lớp (hysteresis; đổi lớp chỉ ở vạch ô nhịp kế; vào 1 ô fade, ra 2 ô fade):

Trạng thái nhạc (máy trạng thái):

Chuyển cảnh (đều lượng tử hoá theo vạch ô nhịp, đồng hồ DSP AudioSettings.dspTime):

• Cùng cue: bật/tắt stem tại vạch ô kế (≤ 1 ô trễ: ≤ 1.82 s ở 132 BPM, ≤ 2.0 s ở 120 BPM).
• Khác cue cùng tempo: crossfade ở vạch ô kế, dài 1 ô.
• Khác tempo: stinger thoát (≤ 2 ô) → cue mới bắt đầu ô 1 mẫu 0; không bao giờ trộn 2 tempo > 1 ô.
• Vào BOSS: im 0.5 s (khoảnh khắc thở) → stinger boss_intro của cue boss đồng bộ với khung giới thiệu tên boss → S0+S1 vòng P1.

Stinger (asset con của cue, <cueId>__stg_<slug>; bus Music_Stinger; luôn đúng key cue; dài ≤ 4 ô):

Boss — cue theo pha (mọi boss Hồi; finale/quiet_shore theo cột riêng):

• FINALE · B5 Đỉnh Chuông Câm (Kết, act V): ải 60 s trộn quái 4 Hồi (lớp theo I) + BS_FINAL… MUS_finale_crown: ải 60 s = S0–S3 theo I; BS_FINAL P1 = S0+S1+S3 + LM_DRAVOS; P2 = S2 bật + S4 phát motif của boss bóng đang gọi (4 biến thể S4: b1/b2/b3/b4 ở D); P3 Mũ Chuông Nứt = toàn dàn + LM_H01 + motif hero đang chơi (S4h, 12 biến thể); đòn cuối Hồi Chuông → cắt nhạc, chỉ còn tiếng chuông thật ngân 8 s → MUS_end_*.
• SECRET · B6 Bờ Lặng (Bí mật, act VI, cần FLAG_SHORE_OPEN): ải 45 s quanh Tiếng Câm EN_B6_… MUS_quiet_shore: ải 45 s = S0 (drone + nước) ≤ −34 LUFS-I; BS_TRUE P1 = S0 + nhịp tim trầm S1 (60 BPM, chỉ thump, AUD-02); P2 Nuốt Tiếng = nhạc tắt hẳn, chỉ tell + phụ đề; P3 Gương Lặng = S4 = motif hero đang chơi chơi ngược phách, rất nhỏ.

3.5 Đồng bộ H12 Ambrin (120 BPM)

• Máy nhịp chạy trên đồng hồ Hero (canon); nhạc chạy DSP. Nguồn sự thật = DSP: beatPhase = ((dspTime − musicStartDsp) mod 0.5 s); máy nhịp đọc beatPhase + audioOffsetMs (hiệu chỉnh trễ, Thương Xót).
• Khi H12 chơi: cue biome = bộ _h12; boss/mini/finale vốn 120 BPM → khoá pha với máy nhịp. EXPLORE/DOCK/DRAFT: máy nhịp tiếp tục, nhạc giữ lưới 120 (DOCK DOCK · Bến Giữa Hồi (nút DOCK sau boss Hồi I–IV, ≤ 20 s, Sạp Rong + chở đò Calla sang Hồi… MUS_dock_crossing 84 BPM → khi H12 thay bằng S0 của cue biome kế dạng _h12). SECRET · B6 Bờ Lặng (Bí mật, act VI, cần FLAG_SHORE_OPEN): ải 45 s quanh Tiếng Câm EN_B6_… MUS_quiet_shore không nhịp → máy nhịp phát click (biến thể click của HeroResource heroId=H12 kind=gain (Nhịp +1/+2) · nhạc công Trống Sóng… SFX_H12_res_gain) −18 LUFS trong B6.
• Đúng phách ±0.12 s (Thương Xót ±0.16 s) tính theo DSP; âm đánh hero KHÔNG lượng tử hoá (giữ AP4); chỉ nốt kèn "đúng/lạc" chọn cao độ theo hợp âm ô hiện tại (bảng hợp âm theo ô trong file cue).
• Tuỳ chọn "click nhịp H12": mặc định tắt; tự bật khi thanh Music = 0.
• Bộ _h12 (4): B1 132 → 120 (4/4, giữ hình trống khung); B2 6/8 96 → 12/8 chấm đen = 120; B3 140 → 120 (hi-hat kép); B4 7/8 → 4/4 120, giữ accent 3+3+2 trên 8 móc. Mỗi bộ đủ 5 stem + stinger như cue gốc.

3.6 Mẫu cue nhạc (FINAL) — mỗi cue 1 khối trong GDD/Full/data/audio_music.json (agent audio tạo; khoá field)

Ví dụ đủ field — EXPLORE/COMBAT · Hồi I B1 Đồi Mộ Tro · bản đồ + mọi nút CMB/ELT/CHL/RSC/EVT/SHP/RST/SEC c… MUS_b1_grave_hill: context COMBAT/EXPLORE Hồi I B1 · 132 · 4/4 · D Phrygian, chords: i–♭II–i–♭VII lặp 4 ô · intro 2 ô (3.64 s) · loop 32 ô = 58.18 s = 2.565.818 mẫu · S0 dây cung trầm + hợp xướng "a" + drone bễ; S1 trống khung phách 1–3; S2 tom + đe phách 2–4 + trống khung 16 nốt; S3 dây staccato + đàn gẩy 16 nốt; S4 dây cung méo/kèn swell, LM_BELL vỡ (D–A–G, thiếu nốt D cuối) · adaptive chuẩn · stingers elite_in (2 ô), surge (1 ô), room_clear (2 ô), ash_read (1 ô, cắt S2–S4 trong 1 ô) · quantize bar, vào 1 ô, ra 2 ô, exit_to BOSS · nút BOS Hồi I · BS_B1 Người Gác Chuông · stem theo pha (không theo I) · P3 "Chuông… MUS_boss_b1_bell_warden qua im 0.5 s · banned: lead sóng vuông, hợp xướng có lời · mix −16 LUFS-I full, ducked_by ĐÁP −4 dB 0.4 s, stinger boss −6 dB 1 s · files Assets/_Project/Audio/Music/MUS_b1_grave_hill/MUS_b1_grave_hill__S0.ogg…__S4.ogg, __intro.ogg, __stg_elite_in.ogg.

3.7 Danh sách cue 1.0 (18 bản canon + 4 bộ stem H12) — 1 dòng/cue

id · state · bpm/meter/key · intro + loop (ô = giây) · stem · stinger · ghi chú

1. TITLE · màn tiêu đề + menu chính (Cài đặt/Credits mở từ đây giữ nguyên cue dưới SN_DRAFT)… MUS_title_mute_night · TITLE · 66 tự do / D Aeolian · loop 90 s (không lưới) · S0 + S4 · — · cũng dùng teaser MS01 "Đêm Câm".
2. 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 · HUB · 72 3/4 / F Lydian (GD5 → D) · loop 40 ô = 100.0 s · S0 + 5 stem GĐ (GD1 hộp nhạc LM_LEM, GD2 đàn nguyệt chợ, GD3 kèn bầu, GD4 dây, GD5 chuông LM_BELL) · depart, hero_H01..H12 · 18 hộp nhạc (Nến Canh) = phát lại 18 cue này ở hub.
3. DOCK · Bến Giữa Hồi (nút DOCK sau boss Hồi I–IV, ≤ 20 s, Sạp Rong + chở đò Calla sang Hồi… MUS_dock_crossing · DOCK · 84 6/8 (chấm đen = 84) / D Dorian · loop 16 ô = 22.86 s · S0–S2 · — · crossfade 8 s sang cue Hồi kế.
4. EXPLORE/COMBAT · Hồi I B1 Đồi Mộ Tro · bản đồ + mọi nút CMB/ELT/CHL/RSC/EVT/SHP/RST/SEC c… MUS_b1_grave_hill · EXPLORE/COMBAT B1 · 132 4/4 / D Phrygian · 2 + 32 ô = 58.18 s · S0–S4 · elite_in, surge, room_clear, ash_read · ví dụ §3.6.
5. EXPLORE/COMBAT · Hồi II B2 Đầm Vải Liệm · bản đồ + mọi nút chiến/tiện ích B2 · lớp theo I MUS_b2_shroud_marsh · B2 · 96 6/8 (chấm đen = 96) / E Aeolian · 2 + 48 ô = 60.0 s · S0–S4 · như B1 · LM_CALLA đảo trên S4.
6. EXPLORE/COMBAT · Hồi III B3 Lò Đúc Câm · bản đồ + mọi nút chiến/tiện ích B3 · lớp theo I MUS_b3_mute_foundry · B3 · 140 4/4 / C Phrygian dominant · 2 + 32 ô = 54.86 s · S0–S4 · như B1 · đe ở S2 decay ≤ 150 ms (AUD-01).
7. EXPLORE/COMBAT · Hồi IV B4 Thành Chuông Treo · bản đồ + mọi nút chiến/tiện ích B4 · lớp t… MUS_b4_hanging_city · B4 · 7/8 đen = 120 (2+2+3) / B Aeolian · 2 + 32 ô = 56.0 s · S0–S4 · như B1 · chuông trầm ≤ 600 Hz.
8. BOSS · nút BOS Hồi I · BS_B1 Người Gác Chuông · stem theo pha (không theo I) · P3 "Chuông… MUS_boss_b1_bell_warden · BOSS BS_B1 · 120 4/4 / D Phrygian · 1 + 32 ô = 64.0 s · S0–S4 + S3b · boss_intro, phase2, phase3, ash_read, victory · P3 "Chuông Vỡ Hẳn".
9. BOSS · nút BOS Hồi II · BS_B2 Lão Lái Đò Không Bến · stem theo pha · P3 "Nước Dâng": S0 t… MUS_boss_b2_ferryman · BOSS BS_B2 · 120 12/8 (chấm đen = 120) / E Aeolian · 1 + 32 ô = 64.0 s · S0–S4 + S3b · như #8 · P3 Nước Dâng: S0 thêm sóng nước.
10. BOSS · nút BOS Hồi III · BS_B3 Thợ Cả Đúc Chuông · stem theo pha · S2 có 3 biến thể theo … MUS_boss_b3_founder · BOSS BS_B3 · 120 4/4 / C Phrygian dominant · 1 + 32 ô = 64.0 s · S0–S4 + S2 3 biến thể (búa/xích/giáo theo Rèn Phản) · như #8.
11. BOSS · nút BOS Hồi IV · BS_B4 Thống Lĩnh Yvra & Rồng Khàn · stem theo pha · P2 tách thân:… MUS_boss_b4_yvra · BOSS BS_B4 · 120 4/4 accent 3+3+2 / B Aeolian · 1 + 32 ô = 64.0 s · S0–S4 + S3b · như #8 · P2 tách thân: S4 tách 2 bè (Yvra kèn / rồng khàn mẫu).
12. GATE_MINI · nút MBS (Cổng) mọi biome · mọi MB_ (MB_B1_1, MB_B2_1, MB_B2_2, MB_B3_1, MB_B3… MUS_miniboss_gate · GATE_MINI · 120 4/4 / 4 bộ key D/E/C/B · 1 + 16 ô = 32.0 s · S0–S3 × 4 key · room_clear, victory · dùng cho mọi MB_.
13. FINALE · B5 Đỉnh Chuông Câm (Kết, act V): ải 60 s trộn quái 4 Hồi (lớp theo I) + BS_FINAL… MUS_finale_crown · B5 ải + BS_FINAL · 120 4/4 / D Aeolian → D Dorian · 2 + 32 ô = 64.0 s · S0–S3 + S4 (LM_DRAVOS) + S4b1..b4 + S4h01..h12 · boss_intro, phase2, phase3, ash_read, victory · đòn cuối = chuông thật ngân 8 s.
14. SECRET · B6 Bờ Lặng (Bí mật, act VI, cần FLAG_SHORE_OPEN): ải 45 s quanh Tiếng Câm EN_B6_… MUS_quiet_shore · B6 + BS_TRUE · không nhịp / drone A · loop 120 s · S0, S1 (tim 60 BPM), S4h01..h12 (P3) · boss_intro, phase2, phase3 · P2 tắt nhạc.
15. DEATH · hết Lửa Gửi trong run (mọi biome, mọi mode) · bắt đầu đồng bộ thẻ recap INV-16 = … MUS_death_epitaph · DEATH · 60 4/4 / D Aeolian · loop 12 ô = 48.0 s · S0 + S4 · — · bắt đầu đồng bộ thẻ recap INV-16.
16. ENDING · END_BELL_TOLL Hồi Chuông (Gióng chuông sau BS_FINAL) · phần tuyến tính 180 s = f… MUS_end_bell_toll · ENDING END_BELL_TOLL · 76 4/4 / D major · 180 s tuyến tính + credit loop 32 ô = 101.05 s · stereo full · — · chuông thật mở bài.
17. ENDING · END_QUIET_SHORE Bến Bình Yên (hạ BS_TRUE ở B6) · 210 s tuyến tính đi cùng 12 thẻ… MUS_end_quiet_shore · ENDING END_QUIET_SHORE · 64 3/4 / D Lydian · 210 s tuyến tính · 12 lớp nhạc cụ hero vào lần lượt · — · đi cùng 12 thẻ kết theo hero.
18. ENDING · END_ASH_CROWN Mũ Tro (chọn "Giữ lõi" ở BS_FINAL) · 120 s tuyến tính: hero đội Mũ… MUS_end_ash_crown · ENDING END_ASH_CROWN · 56 4/4 / D Locrian · 120 s tuyến tính · stereo full · — · chuông câm "thịch" thay chuông thật.

19–22. EXPLORE/COMBAT · Hồi I B1 KHI CHƠI H12 Ambrin (thay MUS_b1_grave_hill; biomes[].music.h12… MUS_b1_grave_hill_h12 · EXPLORE/COMBAT · Hồi II B2 khi chơi H12 (thay MUS_b2_shroud_marsh) · 6/8 96 → 12/8 chấm đ… MUS_b2_shroud_marsh_h12 · EXPLORE/COMBAT · Hồi III B3 khi chơi H12 (thay MUS_b3_mute_foundry) · 140 → 120, hi-hat k… MUS_b3_mute_foundry_h12 · EXPLORE/COMBAT · Hồi IV B4 khi chơi H12 (thay MUS_b4_hanging_city) · 7/8 → 4/4 120, giữ a… MUS_b4_hanging_city_h12 · B1–B4 khi chơi H12 · 120 (B2 12/8 chấm đen = 120; B4 4/4 accent 3+3+2) / key như gốc · 2 + 32 ô = 64.0 s · S0–S4 + stinger như gốc · không tính vào 18 bản (canon "+ 4 bộ stem").

4.1 Đặt tên (canon §11)

• Sự kiện: SFX_<ownerId>_<slug>; ownerId = id chủ (Varek H01, Hàng Cọc Tro H01_SK03, Trăng Máu H01_UL1, Quỷ Rãnh EN_B1_02, Vồ EN_B1_02_A01, Thợ Cả Đúc Chuông BS_B3, Sương Giá STS_FROST, Mưa Chuông MUT03, Tro Sống MRN15) hoặc UI / HUB / SHARED; sự kiện môi trường trong data/av/ENV_*.json dùng owner ENV_B1…ENV_B6 / ENV_HUB (vd HazardTrigger hazardId=HZ_B6_mirror_shallows phase=state: bước chân h… SFX_ENV_B6_hz_wade, ownerGroup World), bed/hazard lõi giữ owner biome cũ (HazardTrigger hazardId=HZ_B1_open_grave (nắp bật cuối ấn tro 0.6 s; n… SFX_B1_hz_open_grave, BiomeEnter biome=B3 (vào phòng B3, fade 1.0 s) SFX_B3_amb_bed); slug snake_case thường. Ví dụ: UltActivate ultId=H01_UL1 (H01_UL1_BLINK 8 nhát + H01_UL1_BURST trăng… SFX_H01_UL1_moon, SFX_EN_B1_02_A01_swing, DraftPick rarity=COMMON|RARE|EPIC (biến thể 01 COMMON, 02 RARE, 03 EP… SFX_UI_card_pick.
• File: <eventId>_<nn>.ogg (nn = biến thể 01..), lớp thứ 2: <eventId>__<layer>_<nn>.ogg. Thư mục: Assets/_Project/Audio/SFX/<ownerGroup>/<ownerId>/ (ownerGroup = Heroes Enemies Bosses Shared UI Hub World).
• Không đặt 2 sự kiện cho cùng 1 âm: sự kiện khác chủ dùng âm chung → field asset_ref trỏ tới SFX_SHARED_* (tính "dùng lại").
• Map tên demo → 1.0: tell_gold → EnemyWindupStart tellClass=Y → lịch PlayScheduled đỉnh transient đúng… SFX_SHARED_tell_y_tinh · tell_violet → EnemyWindupStart tellClass=P (cả hazard/Khăn Tang/mutator P); chọn bả… SFX_SHARED_tell_p_swell · swing_l1/l2/swing_heavy → HeroAttackCut heroId=H01 moveIndex=1 (H01_COMBO_A_1; H01_UL3_ECHO dư … SFX_H01_a1_swing/a2_swing/a3_swing · hit_blade/hit_heavy → HeroHitBatch heroId=H01 (HordeAudio §6.1 gộp mỗi frame; + hit_heavy c… SFX_H01_hit / HeroHitBatch hasHeavyTarget=true (Tinh Anh/mini/boss trong cụm) + đòn… SFX_SHARED_hit_heavy · parry_1/2 → HeroAnswerSuccess heroId=H01 (H01_ANSWER Gạt + H01_ANSWER_REFLECT; lớ… SFX_H01_answer · perfect → HeroAnswerSuccess (lớp chung dưới SFX_{H}_answer) + send Answer SFX_SHARED_answer_core · riposte → SFX_H01_riposte · block → SFX_H01_hold_block · dash → HeroDash frame 0 (lớp chung dưới SFX_{H}_dash) SFX_SHARED_dash_base · crescent/leap → SkillCast skillId=H01_SK01 rank=I|II|III (+ lớp __impact khi trúng; H… SFX_H01_SK01_cast/SkillCast skillId=H01_SK02 rank=I|II|III (H01_SK02_LEAP bật nhảy + H0… SFX_H01_SK02_cast · slam → nguồn reuse: nện đất/tiếp đất nặng (hero, Tinh Anh, boss) SFX_SHARED_slam_ground · ult → UltActivate ultId=H01_UL1 (H01_UL1_BLINK 8 nhát + H01_UL1_BURST trăng… SFX_H01_UL1_moon · surge → SFX_H01_res_surge · bell → SFX_BS_B1_* · roar → EliteSpawn (+ SFX_{E}_vocal + stinger elite_in); biến thể theo EM01–E… SFX_SHARED_elite_affix/boss intro · cast/reflect → EnemyProjectileFire (enemyId=EN_B1_03, attackId=EN_B1_03_A01) — khung… SFX_EN_B1_03_A01_cast / EnemyProjectileReflected (đạn bị ĐÁP dội, lõi trắng) SFX_SHARED_proj_reflect · boom → nguồn reuse: Xác Trương EN_B1_05, bom, Đinh nổ; ≤ 3/80 ms, dư cộng +2… SFX_SHARED_explode_s · break → PoiseBroken (Vỡ Thế Tinh Anh/mini/boss) SFX_SHARED_poise_break · hurt → HeroDamaged (kèm SFX_{H}_vo_hurt) SFX_SHARED_hero_hurt_impact · death1/2 → EnemyKilledBatch (HordeAudio cửa sổ trượt 100 ms, doc 32 §6.2) SFX_SHARED_kill_crunch · pickup chest card levelup resonance → PickupCollected type=xp (chuỗi 0.5 s: pitch +1 bán cung mỗi nhặt, tối… SFX_SHARED_xp_pickup relic_chest / DraftPick rarity=COMMON|RARE|EPIC (biến thể 01 COMMON, 02 RARE, 03 EP… SFX_UI_card_pick / LevelUp (trước DraftOpen; nhạc stinger level_up của MusicDirector) SFX_SHARED_level_up resonance · music_drums → bỏ (thay §3) · amb_dungeon → RunStart/ActChanged biome=B1 + RoomStart B1 (phòng ngoài trời) SFX_B1_amb_bed (§10). 9 file chưa có credit (chest, hurt, levelup, pickup, resonance, riposte, roar, swing_enemy, ult) → thay mới hoặc xác minh nguồn trước MS02.

4.2 Mẫu spec SFX (FINAL) — 1 hàng/sự kiện trong GDD/Full/data/audio_sfx.csv (agent audio tạo; khoá cột)

Ví dụ đủ field — HeroAttackCut heroId=H01 moveIndex=1 (H01_COMBO_A_1; H01_UL3_ECHO dư … SFX_H01_a1_swing: owner H01 · hook HeroAttackCut move=A1 · frame cut (cả khi hụt) · kind swing · layers: transient 4 ms cạo thép sáng 3–6 kHz / body 120 ms whoosh bandpass 400–1.800 Hz quét xuống / tail 80 ms ngân sống lưỡi ~2.4 kHz ở −18 dB (decay ≤ 60 ms → hợp lệ AUD-01) · 220 ms · 4 biến thể, ±6%, ±1.5 dB (A2 = gốc +4%; A3 = HeroAttackCut heroId=H01 moveIndex=3 (H01_COMBO_A_3, H01_HEAVY_1 Bổ C… SFX_H01_a3_swing riêng) · priority 40, max 2, cooldown 60 ms, steal oldest · center · clock World · bus HeroAttack · ducked_by send Answer · −19 LUFS mmax · loop no · tell none · source freesound · brief "lưỡi liềm thép mỏng chém không khí, nhanh, nhẹ; KHÔNG nghe như dao phay nặng, quạt máy, tiếng zip hoạt hình" · query "sword whoosh swing fast blade", license cc0, max_duration 0.6, single_event, sort rating_desc, min_num_ratings 5 · synth fallback dash_whoosh --element neutral --tint metal · status final · verdict pending.

4.3 Mục tiêu độ to theo loại (PC; momentary-max, trước bus fader)

4.4 Khuôn sự kiện theo chủ (sinh audio_sfx.csv từ khuôn; số khớp canon §10.3)

Hero — 28 sự kiện/hero × 12 = 336 (slug cố định, Hxx thay id):

• Dạng Rèn AS2/AS3 đổi vũ khí → bộ biến thể thay cho #1–#4 (+8 file/hero), không thêm id. Đòn Vọng (BS_TRUE/EN_B6_01) = âm kỹ năng hero + lọc đảo (§5.6 fx_reverse_tint), 0 âm mới.

Quái thường + Tinh Anh — 5 sự kiện × 39 = 195: atk (thân đòn không phải tell; mỗi đòn _Ann 1 lớp con __A01…) · impact (đạn/đòn trúng) · vocal (aggro/idle, cooldown 250 ms toàn loài) · hurt (chỉ Tinh Anh phát mỗi lần; quái thường gộp vào hit của hero) · death (Tinh Anh riêng; quái thường = asset_ref → kill_* + lớp chất liệu biome). Tell luôn là asset chung (AUD-03). Mini/boss/kết — 8 sự kiện × 13 = 104: intro · move_loop · sig_a · sig_b · sig_c (3 đòn chữ ký; đòn khác = lớp con __Ann) · phase · broken (Vỡ Thế) · death. BS_B3 sig_a có 3 lớp búa/xích/giáo; BS_FINAL sig_c = Hồi Chuông thật; BS_TRUE phase = nuốt âm. Nhóm khác — lõi canon 95: hệ thống SFX_SHARED_* nhóm S (27, §8) · UI 29 (§7) · HUB 13 (§7.2) · hazard 14 (§10.2) · trạng thái 6 loop SFX_STS_<NAME>_loop · ambience 6 bed RunStart/ActChanged biome=B1 + RoomStart B1 (phòng ngoài trời) SFX_B1_amb_bed…BiomeEnter biome=B6 (cảnh đò giây 9) → loop tới BS_TRUE P2; fader bus… SFX_B6_amb_bed (hub bed trong HUB). Nhóm khác — mở rộng theo data AV (2026-11-07) +150 → 245: UI +8 (§7.1, data/av/UI.json) · HUB +16 (§7.2, ENV_HUB.json) · hazard +32 (§10.2, tổng 46) · bed hầm B1 +1 (§10.1) · spot ambience biome 29 (§10.1) · đạo cụ/mục tiêu/phòng/cảnh biome 64 (§10.3). Tổng: 336 + 195 + 104 + 245 = 880 = canon ~880 (DEC-2026-11-07-17; nhóm khác = lõi 95 + 150 mở rộng). Nhóm R của SHARED (30 asset, §8) là nguồn "dùng lại" của sự kiện hero/quái, không cộng thêm id. Ngoài 880 (không phải sự kiện SFX): nhạc 18 + 4 bộ H12 · stinger nhạc (asset con); click máy nhịp H12 = biến thể click của HeroResource heroId=H12 kind=gain (Nhịp +1/+2) · nhạc công Trống Sóng… SFX_H12_res_gain.

5.1 Cây bus (Assets/_Project/Audio/Mixer/BW_Main.mixer, 1 AudioMixer; fader mặc định)

Ghi chú: Unity không có fader trên send-receive riêng; Duck Volume cài: threshold −30 dB, ratio 4:1 (mức giảm đích ở §5.6 đạt bằng attenuation của từng duck), attack 5 ms, release theo bảng §5.6.

• Luật B6 Bờ Lặng (2026-11-07, từ biomes/B6.json): khi hero ở B6 (act VI), fader HeroAttack và HeroSkill = −6 dB so với mặc định (đặt thẳng exposed param qua AudioSettingsService, chuyển 1.0 s khi vào/ra; không thêm snapshot); cộng dồn với SN_WEDGE/SN_MUTE_SKILL nếu chúng bật. HeroDefense (ĐÁP) và EnemyTell giữ nguyên mức (INV-02, AUD-03). Đi kèm: send reverb mọi bus = 0 ở B6 (§10.1). [ASSUMED, khớp codex Bờ Lặng CDX_b6 "nhỏ hơn một nửa"].
• Giá trị bus trong data AV (enum schema) → group mixer: Tell → EnemyTell · Stinger → Music_Stinger · EnemyHorde → EnemyCrowd · Boss → EnemyHeavy · Hero → HeroAttack · các giá trị trùng tên (Master Music SFX HeroAttack HeroDefense Enemy World Ambience UI VO) → group cùng tên. Kỹ năng hero vào HeroSkill theo hook SkillCast/UltActivate (§12.2), không theo field bus.

5.2 Snapshot (chuyển 0.15 s trừ khi ghi khác)

5.3 Ưu tiên (Unity priority, 0 = cao) & giới hạn voice (Project Settings › Audio: Real Voices 64, Virtual 256, DSP buffer Best latency = 256 mẫu)

Trần nhóm cộng = 77 > 64 (cố ý): khi đầy, Unity ảo hoá nguồn priority cao số nhất trước (Pickup → Status → Ambience → EnemyCrowd). Tổng chỗ dành: 7 + 5 + 2 + 3 + 12 = 29 voice không bao giờ bị cướp; còn 35 cho phần còn lại; mục tiêu p95 voice thật ≤ 56 khi 250 quái + Ult (AP2). Pool AudioSource: 48 one-shot + 12 music + 4 ambience (thay 24 nguồn round-robin của demo).

5.4 Ngân sách tell đồng thời (từ token INV-08)

Cận chiến ≤ 4 windup nhắm hero (≤ 2 khi Elite/Boss windup) + ≤ 3 loạt đạn → ≤ 7 "tinh" chồng; tím sàn ≤ 5 tổng. Hai "tinh" trong 40 ms → phát cả hai nhưng cái sau −3 dB và +1 bán cung (không gộp: mỗi tell là 1 thông tin). Đòn Y×n: mỗi nhịp 1 "tinh" riêng (INV-02).

5.5 Suy giảm khoảng cách (góc 3/4, không 3D)

• spatialBlend = 0 cho mọi nguồn; pan bằng panStereo; không Doppler, không reverb theo vị trí.
• Khoảng cách d đo trên mặt sàn (x, z) bằng art px từ hero (người nghe = hero, không phải camera, để tâm luôn đúng nhân vật). Màn 480×270 art px; tầm sàn nửa ngang 240.
• Pan: pan = clamp((x_src − x_hero) / 240, −1, 1) × 0.6 (screen_pan); × 1.0 khi screen_pan_full.
• Gain: d ≤ 120 → 0 dB · 120 < d ≤ 300 → tuyến tính dB tới −12 dB · d > 300 (ngoài màn) → −18 dB và CHỈ phát nếu priority ≤ 40; tell ngoài màn: −6 dB tối đa (không bao giờ dưới), pan đầy, "tinh" +2 bán cung (trợ năng bật).
• Trục dọc màn bị nén 0.5 (screenY = z·0.5): khoảng cách tính bằng z thật, nên quái trên/dưới cách 60 px màn = 120 px sàn → đúng cảm giác 3/4.
• Hero và UI: center, không suy giảm.

5.6 Ducking / sidechain

• fx_reverse_tint (Đòn Vọng của bóng hero/Gương Lặng): âm kỹ năng hero phát qua Enemy + Lowpass 2.5 kHz + pitch −2 bán cung; tell của đòn đó vẫn dùng asset tell chung.

5.7 Đồng hồ & slow-mo

• clock = World: pitch = max(0.75, 0.5 + 0.5 × worldScale) (World 25% Né Hoàn Hảo → 0.625 → kẹp 0.75); hitstop KHÔNG đổi pitch.
• clock = Hero / UI / Music / VO / EnemyTell: pitch 1.0 cố định.
• Lịch tell: PlayScheduled(dspNow + (t_impact − 0.12 − t_now)/worldScale − outputLatency − audioOffsetMs); tính lại mỗi frame nếu worldScale đổi trong windup.
• Tạm dừng: mọi nguồn World/Hero pause; UI ignoreListenerPause = true; nhạc tiếp tục dưới SN_DRAFT.

5.8 Độ to chương trình & tuỳ chọn người chơi

Tuỳ chọn: Master/Music/SFX/Ambience/UI/VO 0–100% (bước 5) · Âm tell 50–150% (sàn −6 dB) · Dải động: Rộng / Thường (mặc định) / Hẹp (= SN_SMALL_SPEAKER) · Mono · Âm tell theo vị trí · Phụ đề tell · Click nhịp H12 · Hiệu chỉnh trễ âm −100..+100 ms (màn gõ theo nhịp 8 lần, lấy trung vị) · Tắt âm khi cửa sổ mất focus (mặc định bật).

6.1 Gộp cú trúng của hero (mỗi frame, mỗi nguồn sát thương)

n = số mục tiêu hero trúng trong frame từ 1 đòn/1 sóng VFX (sóng lan §6.1 demo: đếm theo frame mặt sóng chạm).

• Throttle sau gộp: ≤ 3 lần phát hit / 50 ms toàn cục (demo canon); vượt → cộng n vào lần kế (không mất cảm giác "nặng").
• INV-10: frame có ≥ 1 cú trúng của hero mà bị throttle → lần phát kế dời ≤ 1 frame, không bỏ hẳn.

6.2 Kill-crunch (cửa sổ trượt 100 ms)

k = số quái thường chết trong 100 ms gần nhất.

• Cao độ kill_crunch: ngẫu nhiên ±8%; khi chuỗi gặt liên tục ≥ 2 s (≥ 12 kill/100 ms mỗi lần) → kill_reap lên +1 bán cung mỗi 2 s, tối đa +3, về 0 sau 1.5 s không gặt (thưởng cảm giác dọn bầy, P2 canon).
• Tinh Anh/mini chết: luôn phát death riêng (không gộp) + EnemyKilled Tinh Anh+/mini (tan dither 0.4 s, sau death riêng) SFX_SHARED_corpse_dissolve.
• Xác Trương EN_B1_05 nổ dây chuyền: gộp như explode — ≤ 3 explode_s / 80 ms, còn lại cộng mức +2 dB vào lần kế.

6.3 Âm quái thường trong bầy

• Bước chân: KHÔNG có âm từng con. HordeAudio mỗi frame: crossfade 4 lớp theo alive_view 0–20/20–80/80–1… SFX_SHARED_crowd_bed (loop 4 lớp: ít/vừa/đông/rất đông) crossfade theo alive_view: 0–20 / 20–80 / 80–160 / 160–250, mỗi biome 1 lớp chất liệu (bảng §2.4), bus EnemyCrowd −30 → −22 LUFS.
• vocal aggro/idle: mỗi loài ≤ 1 / 250 ms toàn cục, ≤ 3 voice tổng; chọn con gần hero nhất trong khung.
• atk (thân đòn không tell): chỉ con đang giữ token mới phát (token = đúng những con nguy hiểm) → ≤ 7 + quái không token im.
• hurt quái thường: không phát (cú trúng của hero đã đủ).
• Spawn: spawn_ash ≤ 2 voice; ≥ 6 ấn spawn trong 0.3 s → 1 lần spawn_ash +3 dB (đợt TIDE nghe như 1 đợt sóng).

6.4 Ngẫu nhiên & chống lặp

• Biến thể: chọn ngẫu nhiên không lặp lại biến thể vừa phát (round-robin xáo trộn, "shuffle bag").
• Pitch ±6% / vol ±1.5 dB mặc định; quái thường ±8% / ±2 dB; tell ±1% / 0 dB; UI 0%.
• Lệch thời gian (micro-offset) cho lớp gộp: 0–20 ms ngẫu nhiên để 2 lớp không trùng pha.
• Seed: dùng RNG riêng âm thanh (không dùng RNG gameplay → không ảnh hưởng seed DAILY).

6.5 Kiểm hiệu năng âm (Lát Chịu Tải MS01b)

Kịch bản MS01b (250 quái + H01 Ult + 1 Tinh Anh + MESO) trên Steam Deck: CPU audio thread ≤ 1.0 ms/frame p95 · voice thật p95 ≤ 56 · 0 clipping Master (đỉnh ≤ −1 dBTP) · HordeAudio ≤ 0.10 ms/frame main thread · 0 cấp phát GC/frame.

7.1 UI (37 sự kiện SFX_UI_* = 29 lõi + 8 thêm 2026-11-07; bus UI; clock UI; chất liệu giấy/gỗ/đồng nhỏ, AUD-01; spec đủ field ở data/av/UI.json)

Luật UI: không âm UI nào > 300 ms trừ unlock/mastery_rank/achievement/card_pick_legend/linchpin/evo_fuse (≤ 2.0 s); điều hướng nhanh liên tục → nav_move cooldown 40 ms; đọc thẻ < 3 s (P5) → âm thẻ không che giọng đọc màn hình.

7.2 Hub (29 sự kiện = 13 lõi SFX_HUB_* + 16 SFX_ENV_HUB_* thêm 2026-11-07; bus World/Ambience; spec đủ field ở data/av/ENV_HUB.json)

SceneLoaded Hub_BellTower (phát suốt; lớp GD1–GD5 bật theo FLAG Phục … SFX_HUB_amb_bed (lửa canh lép bép + sông + gió qua tháp gãy; lớp GD1–GD5 cộng dồn: đèn chuông thử, chợ đông, lò rèn xa, vải tủ áo, chuông treo lại hum 98 Hz) · HubWake: hero ngồi dậy cạnh Lửa Canh (t=0 frame 0 clip wake) SFX_HUB_hearth_wake (thức dậy: hít sâu + lửa bùng) · GremStrike (idle 6–9 s, nhịp 3+3+2 = LM_GREM) SFX_HUB_forge_strike (Grem rèn, LM_GREM 3+3+2) · 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 (rèn mảnh hero: 3 nhát + tôi nước) · DepartConfirmed ở ST_DOCK (t=0 cảnh 6 s) SFX_HUB_dock_depart (đò rời bến, mái chèo) · LedgerPageTurn (Hol idle 8–12 s; đổi tab/trang Sổ Tang) SFX_HUB_ledger_page (Sổ Tang lật trang) · TestBellStruck (INTERACT Chuông Thử, đổi Nến Canh, buộc Khăn Tang) SFX_HUB_test_bell (Chuông Thử gõ — chuông trầm 196 Hz, AUD-01) · MarketPurchase + Mott idle đếm tiền (10–14 s) SFX_HUB_market (Bà Mott đếm tiền giấy + ghế kẽo kẹt) · YardDummyHit (đòn hero trúng NPC_RAM) SFX_HUB_yard_dummy (bù nhìn rơm trúng đòn, biến thể Y/P cho bài tập dùng đúng asset tell) · WardrobeOpen / SkinEquipped SFX_HUB_wardrobe (vải tang giũ) · RestoreStageBought GD1–GD5 (t=0 cảnh) SFX_HUB_restore_stage (Phục Dựng GĐ: 4 s, gỗ dựng + lửa + LM_BELL 1 nốt thêm mỗi GĐ) · FastTravel t=0 (rời chỗ cũ) SFX_HUB_fast_travel (tro cuốn) · BarkShown speaker=NPC_* (1 lần khi bark mở) SFX_HUB_npc_murmur (giọng không lời, 7 bộ biến thể = 7 NPC, §9).

• Ambience hub (8, bus Ambience): spot AmbienceSpot hub (1 spot / 6–14 s chung nhóm, pan ±0.6): AmbienceSpot hub (1 spot/6–14 s chung cho cả nhóm spot hub, pan ngẫu … SFX_ENV_HUB_river_lap (sông vỗ) · AmbienceSpot hub SFX_ENV_HUB_tower_creak (tháp gãy kẽo kẹt) · AmbienceSpot hub SFX_ENV_HUB_ash_gust (gió cuốn tro) · AmbienceSpot hub SFX_ENV_HUB_rope_knock (dây neo gõ cọc) · HeroOverlap ENV_HUB_river_reeds / ENV_HUB_ash_shrub (+ là spot) SFX_ENV_HUB_reed_rustle (cả HeroOverlap sậy/bụi tro) · AmbienceSpot hub, ưu tiên khi hero trong r160 Lửa Canh SFX_ENV_HUB_fire_pop (ưu tiên khi hero trong r160 Lửa Canh) · AmbienceSpot hub (chỉ trước GD5; sau GD5 thay bằng lớp hum 98 Hz tron… SFX_ENV_HUB_far_bell_hum (chỉ trước GD5; sau GD5 thay bằng lớp hum 98 Hz trong bed); loop vị trí Positional loop tại ENV_HUB_canal_sluice (suy giảm r 320 px) SFX_ENV_HUB_canal_flow (cống kênh, suy giảm r320 px).
• Sự kiện hub (8, bus World/Music_Stinger): Loop khi đò chạy (RM_HUB_departure, RM_HUB_ferry_deck) — gắn VFX_ENV_… SFX_ENV_HUB_ferry_creak (loop đò chạy, Cảnh Xuất Phát RM_HUB_departure/Boong Đò Calla (nút DOCK) RM_HUB_ferry_deck) · HubArrive t=0 (mảnh lưỡi kéo về lửa) SFX_ENV_HUB_blade_return (HubArrive: mảnh lưỡi kéo về lửa) · ScarCleansed SFX_ENV_HUB_scar_cleanse (ScarCleansed) · StationUnlocked SFX_ENV_HUB_station_unveil (StationUnlocked) · EpitaphCandleLit SFX_ENV_HUB_candle_light (EpitaphCandleLit) · StatuePlaced / PaintingHung / MusicBoxPlaced SFX_ENV_HUB_plinth_place (StatuePlaced/PaintingHung/MusicBoxPlaced) · GD5 cảnh treo chuông (t=6 s) SFX_ENV_HUB_bell_raise (GD5 treo chuông t = 6 s, Stinger −14) · Chuyển cảnh màn tro (VFX_ENV_HUB_act_fog) t=0 SFX_ENV_HUB_act_fog (màn tro chuyển cảnh).

10.1 Bed ambience (1 loop stereo ≥ 60 s/biome, SFX_<Bn>_amb_bed, bus Ambience, −30 LUFS-I) + spot ngẫu nhiên (sự kiện amb_spot riêng theo data/av/ENV_*.json, AmbienceSpot chọn 1 spot / 6–14 s, pan ngẫu nhiên ±0.6)

Id bed + spot (7 bed + 29 spot; spec đủ field ở data/av/ENV_<Bn>.json):

Spot: cấm partial tonal 2.2–3.6 kHz decay > 60 ms (AUD-01) và swell < 140 Hz (AUD-02).

10.2 Hazard (46 sự kiện = 14 lõi + 32 thêm 2026-11-07 theo data/av/ENV_*.json; theo INV-18: dùng đúng Y/P/N, nhịp ≥ 1.0 s, trúng cả quái)

• Cột "Âm riêng" của 32 hàng thêm: số cuối = lufs_mmax (§4.3); spec đủ field ở data/av/ENV_<Bn>.json. Lớp tell_class P/Y ở đây chỉ là lớp phụ ≤ −12 dB (§4.2), tell thật luôn là SFX_SHARED_tell_* trên bus EnemyTell.
• B2: bed + 3 hazard lõi trong data/av/ENV_B2.json dùng đúng id BiomeEnter B2 (mọi phòng B2 trừ cảnh tiện ích có bed riêng nhẹ hơn −3… SFX_B2_amb_bed / FootstepHero/FootstepEnemyCluster khi chân trong ô HZ_B2_water / HZ_B… SFX_B2_hz_wade / HazardTrigger (phase windup → impact) HZ_B2_gas / wisp_pocket / wisp_… SFX_B2_hz_gas_pocket / HazardTrigger (phase impact) HZ_B2_bridge / HZ_B2_bamboo_bridge; lớp … SFX_B2_hz_bamboo_collapse (owner = biome, như B1/B3–B6); hazard thêm của B2 dùng SFX_ENV_B2_*.
• Mutator MUT01–MUT12 & Khăn Tang MRN: 0 sự kiện riêng; dùng asset tell + hazard có sẵn (vd MUT03 Mưa Chuông = tell_p_swell + HazardTrigger hazardId=HZ_B4_pendulum phase=impact t = 0 (lớp phụ ≤ −… SFX_B4_hz_pendulum_bell lớp va chạm; MRN15 Tro Sống vũng = zone_n_loop, nổ P r30 = tell_p_swell + explode_s).
• Trạng thái 6 loop: SFX_STS_EMBER_loop lửa lép bép · SFX_STS_FROST_loop băng nứt khẽ · SFX_STS_SHOCK_loop tia lách tách nhiễu · SFX_STS_ROT_loop bọt sủi · SFX_STS_BIND_loop xích siết · SFX_STS_DREAD_loop thở run; đều −30 LUFS, ≤ 3 voice (gần hero nhất).

10.3 Đạo cụ, mục tiêu, phòng & cảnh theo biome (64 sự kiện SFX_ENV_<Bn>_*, thêm 2026-11-07; spec đủ field ở data/av/ENV_<Bn>.json; bus World trừ ghi khác; hook theo §12.2)

Đọc _slug = SFX_ENV_<Bn>_slug cùng hàng. B3: cú trúng đạo cụ chưa vỡ dùng HeroHitBatch hasHeavyTarget=true (Tinh Anh/mini/boss trong cụm) + đòn… SFX_SHARED_hit_heavy. Mọi âm bảng này qua quét AUD-01/AUD-02.

11.1 Thang nguồn SFX (đúng thứ tự, theo skill create-sfx)

• Tell (tell_y_*, tell_p_*, tell_feint) = synth bậc 3 bắt buộc, recipe khoá trong .sfx.json, seed cố định → không bao giờ đổi âm giữa các bản build (người chơi đã học).
• Nhạc: chỉ thuê/soạn (bậc 5) hoặc soạn nội bộ; KHÔNG lấy nhạc từ thư viện mẫu hay Freesound làm cue (được dùng mẫu CC0 đơn lẻ làm chất liệu).
• Cấm: âm thanh/nhạc do AI sinh, API âm thanh trả phí, mẫu có giấy phép NonCommercial/ND/SA, trích âm từ game/phim khác.
• Brief viết trước khi tìm (field brief); chọn theo khớp nguồn (đúng vật/chất liệu) trước, số đo sau (freesound.md §3 của skill).
• Freesound: tuân hạn mức 60 yêu cầu/phút, 2.000/ngày; chỉ tải thứ game dùng.
• Nghe duyệt: agent không nghe được → mọi âm vào hàng pending; dev nghe theo lô (make_sfx.py pending --audition → verdict ok|redo); tell + ĐÁP + Ult phải ok bởi người trước MS tương ứng.

11.2 Định dạng & mastering

• Sample rate file 44.1 kHz; Project Settings › Audio: System Sample Rate = 0 (theo thiết bị), Speaker Mode Stereo.
• Loop mẫu-chính-xác: file loop = đúng loop_samples, điểm 0 và cuối nối pha (zero-crossing không bắt buộc vì nối liền), không fade; intro tách file __intro. Phát nhạc bằng 2 AudioSource xen kẽ + PlayScheduled theo dspTime (không dùng loop = true cho stem streaming để tránh hở khe Vorbis); one-shot loop ngắn dùng loop = true.
• Mastering mỗi file tới lufs_mmax bảng §4.3 (BS.1770, cửa sổ 400 ms), đỉnh ≤ −1 dBTP, DC 0, onset ≤ 12 ms, đuôi về −60 dB trước khi hết file (QA create-sfx: LOUDNESS CLICK_START CUT_TAIL LATE_ONSET TOO_LONG SILENT LOOP_SEAM phải PASS; PHONE_WEAK đọc là "Deck loa yếu").
• Thư mục: Assets/_Project/Audio/{Music,SFX,Mixer}/… (khác đường mặc định mobile của skill → luôn truyền --out Assets/_Project/Audio/SFX/<ownerGroup>/<ownerId>). Credit gộp: Assets/_Project/Audio/sfx-credits.json → màn Credits.

11.3 Bộ nhớ & dung lượng (Steam Deck là trần)

• SFX thường trú/Hồi ≤ 40 MB đã giải nén: hero đang chơi (~3 MB) + quái/Tinh Anh/mini/boss biome (~8 MB) + SHARED + UI (~10 MB) + hazard/ambience spot (~4 MB); dỡ biome trước khi vào Hồi kế (trong DOCK).
• Nhạc streaming: ≤ 12 luồng, bộ đệm ≤ 6 MB.
• Dung lượng cài đặt âm thanh 1.0 ≤ 400 MB (nhạc ~240 MB, SFX ~120 MB, giọng ~20 MB) [ASSUMED].

12.1 Kiến trúc runtime (thay Systems/Sfx.cs demo)

Sự kiện dùng EasyEventManager với hằng EventName (rule third-party); gameplay chỉ bắn sự kiện, KHÔNG gọi thẳng AudioSource.

12.2 Bảng hook (EventName → id; {H} = hero đang chơi, {E} = enemy id, {B} = biome, {BOSS} = id mini/boss)

Tên hook trong data/av/ENV_*.json chưa đồng nhất; quy về EventName bảng này (2026-11-07): PropBreak / PropHit / PropTrigger → PropBroken · ObjectiveBellRing / ObjectiveCocoonShake / ObjectiveCarrierAlive → ObjectiveState · ObjectiveNestBreak → ObjectiveProgress · RoomEnter / RoomTransition → RoomStart · RoomClear → RoomCleared · GateLock → RoomLock · GateOpen → ExitOpened · BiomeAmbience → BiomeEnter · HazardFire / HazardImpact / HazardState → HazardTrigger (payload thêm phase = windup/impact/state). Luật hook: 1 EventName có thể phát nhiều id, 1 id không bị 2 EventName cùng phát trong 1 frame (khử trùng theo id/frame); payload thiếu → log Debug.LogWarning, không phát.

• ENV biome = mọi sự kiện data/av/ENV_<Bn>.json của biome đã có (bed + spot §10.1 · hazard §10.2 · đạo cụ/mục tiêu/phòng §10.3): B1 30 · B2 26 · B3 26 · B4 23 · B5 24 · B6 17 = 146; cộng dồn theo biome mở ở mốc. HUB: MS02 16 = 8 lõi (như bản trước) + 8 ambience hub §7.2 [ASSUMED], MS03+ đủ 29. UI 37 đủ từ MS02.
• Canon: _bible.json sfx_events ~880 (DEC-2026-11-07-17: ~730 → ~880 do data AV thêm 150 sự kiện = UI +8, HUB +16, hazard +32, bed +1, spot 29, ENV khác 64). Data AV là nguồn đơn; bảng MS07 khớp canon.
• File: SFX ~2.550 .ogg (880 sự kiện × ~2.9 biến thể TB) [ASSUMED] · nhạc ~281 file (stem + intro + stinger: biome 40, _h12 40, boss 50, mini 28, finale 27, quiet_shore 17, hub 19, ult stinger 48, còn lại 12) · giọng không lời ~264 file · ~45 phút nhạc soạn [ASSUMED].
• Người-tháng (canon §10.1): âm thanh 6 PM nội bộ (gồm 0.5 PM/hero trong dòng hero) + thuê ngoài nhạc 4 PM + SFX 4 PM. Thứ tự cắt khi trễ: theo cut-line canon §10.2 (cắt nội dung thì âm của nó cắt theo); không bao giờ cắt tell, ĐÁP, gộp bầy, bộ _h12.

• Đọc 00-Design-Bible.md INV-02/08/10/11/15/18 trước mọi việc âm thanh; số/id lấy theo _bible.json.
• Tell chỉ dùng 6 asset SFX_SHARED_tell_*; không tạo âm tell riêng cho quái/boss/hazard; không ngẫu nhiên pitch tell; không cho tell vào bus khác EnemyTell.
• Mọi âm mới qua quét AUD-01/AUD-02 trước khi merge; vi phạm = sửa âm, không xin ngoại lệ.
• Không gọi AudioSource từ gameplay: bắn EventName (§12.2); thêm id = thêm hàng audio_sfx.csv theo mẫu §4.2, đủ field.
• Âm lặp ≥ 3 biến thể + cooldown; mọi gộp bầy qua HordeAudio, không phát âm/quái.
• Nhạc: tempo/key/stem đúng §3.2/§3.7; stem dài bằng nhau đúng loop_samples; đổi lớp chỉ ở vạch ô nhịp; nhạc không theo slow-mo.
• Nguồn theo thang §11.1; chỉ CC0/CC BY; ghi credit cùng lượt; bỏ ứng viên Freesound có tên/tag nhắc tên game/thương hiệu (vừa tránh âm bắt chước, vừa giữ repo sạch từ cấm).
• Không AI sinh âm/nhạc/giọng; không lời thoại đọc; không ngôn ngữ bịa.
• Tên id/file ASCII, snake_case slug, không đổi id sau khi ship (đổi file, giữ id + GUID .meta).
• Không viết tên game/studio/thương hiệu có thật vào brief, query lưu repo, tên file, ghi chú; mô tả bằng vật liệu/hành động.
• Báo cáo mỗi lô âm: bậc nguồn, LUFS, QA, và "chưa ai nghe — đang chờ pending" cho tới khi dev verdict ok.