diff --git a/README.md b/README.md
index d2a57b8..978c825 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@
 
 โปรเจกต์อยู่ระหว่างพัฒนา โดยกำลังตรวจการใช้งานกับ Client **4.6.53 OS** ตารางคำสั่งและ handler ที่แก้ล่าสุดอ้างอิง PearlSR commit `005d2c12db4781071f4b5b68e8f364587886a710` รายละเอียดอยู่ใน [บันทึกอัปเดต protocol](docs/protocol-update.md) การตรงกันของ schema ไม่ได้ยืนยันว่าเกมทุกระบบทำงานครบ
 
+[เอกสารประกอบ](docs/) • [วิธีเริ่มใช้งาน](#เริ่มใช้งานบน-windows) • [การตั้งค่า](#config-และกฎห้าม-hardcode) • [Credits & Acknowledgments](#-credits--acknowledgments)
+
 ## CW — กำลังพัฒนา
 
 เริ่มพอร์ต CW จาก [Currency-War-SR ของ xaodev](https://gaytea.cod-algieba.ts.net/xaodev/Currency-War-SR) แล้ว: เพิ่ม factory ของ Encounter หลัง Supply, ตารางตัวเลือก/ความยากที่ revision ตรงกัน และ EXP ตามโหมด/บท/Boss โดยยังรักษาเส้นทาง Battle ที่จับไว้เดิม งานนี้ยังเป็นการพอร์ตบางส่วนและยังไม่ได้ยืนยันเส้นทางใหม่ใน Client อ่านสถานะ ผลทดสอบ และงานส่งต่อใน [CW xaodev handoff](docs/CW-XAODEV-CLAUDE-HANDOFF.md)
@@ -489,3 +491,74 @@ Runtime table captures and current verification limits are recorded in `docs/off
   ผู้ใช้ยืนยันว่าเลือก Protagonist ได้แล้ว ส่วน 6900 ตอน Battle ที่ตามมาพบว่าเป็นตัวพิเศษ CW ซึ่งไม่มีใน Adventure roster เพิ่ม resolver ตาม `SpecialAvatarID` และแถว SpecialAvatar ตรงรุ่นแล้ว ขณะนี้ capture ครอบคลุม fake-avatar trial ที่ world level ตาม resource ที่ใช้ โดยยังรอผล Battle จาก Client การปลดตัวใน Adventure ไม่ใช่เงื่อนไขของตัวพิเศษนี้
 
 CW ล่าสุด: ผู้ใช้ยืนยัน Battle ห้อง 1-2 หลังเลือก Protagonist ผ่านแล้ว เพิ่ม handler เลือก Supply แจกตัว/อุปกรณ์จาก offer จริงพร้อมรวมดาวและเซฟก่อน sync; ยังรอผล Supply ใน Client ส่วน EliteBranch/การสร้างศัตรูตาม camp และโหมดตลอดรอบยังทำไม่ครบ
+
+---
+
+## 💖 Credits & Acknowledgments
+
+GaC-hkrpg-go is built upon the collective research, tools, and pioneering reverse-engineering efforts of the open-source and Star Rail research communities. We extend our deepest gratitude and recognition to all original authors, upstream projects, and researchers:
+
+<details open>
+<summary><b>🏛️ Base Lineage & Core Server Architecture</b></summary>
+
+- **GaC-hkrpg-ps / GaC-hkrpg-rust ([CAtlas0784](https://github.com/CAtlas0784)):** Original predecessor server architectures, XLua injection runtime, live battle analytics, and companion tooling (`GaC-srtool`) foundational to this Go port.
+- **PearlSR ([HonkaiSlopRail/pearl-sr](https://git.xeondev.com/HonkaiSlopRail/pearl-sr)):** Reference Go server emulator providing protocol command ID mappings, handler structures, and base dispatch patterns.
+- **FreeSR Team:** Pioneer private server emulator for Honkai: Star Rail — established the foundational player JSON schemas (`freesr-data.json`), roster format, and initial game loop conventions.
+- **Grasscutter Community ([Grasscutters/Grasscutter](https://github.com/Grasscutters/Grasscutter)):** Groundbreaking anime-game server emulation project that established modern dispatch gateway patterns and packet handler conventions worldwide.
+- **amizing & RobinSR Team:** Pioneer in-game network hooking DLL (`version.dll`), proxy-less redirection, and KCP dispatch foundations on NeonTeam Git.
+
+</details>
+
+<details>
+<summary><b>🎮 Protocol Oracles, Endgame & Simulation Engines</b></summary>
+
+- **xaodev ([Currency-War-SR](https://gaytea.cod-algieba.ts.net/xaodev/Currency-War-SR)):** Complete 4.6.53 Grid Fight autochess simulation engine, traits/bonds matrix, and extraction toolchains inspiring our Currency Wars implementation.
+- **minatoSR:** Reference server implementation for Challenge Peak "AA" [40 nodes, seasons 10–11 arenas/NPCs], recommended lineups, and battle college.
+- **LunarCore ([Melledy/LunarCore](https://github.com/Melledy/LunarCore)):** Pioneering Java-based Star Rail server emulator by Melledy and contributors — the industry-standard reference for battle mechanics, packet definitions, and gacha probability curves.
+- **March7thHoney ([Mar7thLover/March7thHoney-OpenSource](https://github.com/Mar7thLover/March7thHoney-OpenSource)):** High-performance C#/.NET server oracle for gacha pull flows, pity math, SQLite models, shop mechanics, and Muip admin interfaces.
+- **DanhengServer & FireflyServer Communities:** Open-source server protocol research, packet definition verifications, and collaborative community testing.
+
+</details>
+
+<details>
+<summary><b>📦 Game Data, Localization & Resource Repositories</b></summary>
+
+- **Dimbreath ([DimbreathBot/TurnBasedGameData](https://github.com/DimbreathBot/TurnBasedGameData)):** Canonical master Excel game tables, TextMap localization dictionaries, and hash references.
+- **StarRailRes ([Mar-7th/StarRailRes](https://github.com/Mar-7th/StarRailRes)):** Community icon assets, avatar indices, relic/item metadata, and stat translation tables.
+- **Prydwen Institute ([Prydwen.gg](https://www.prydwen.gg/star-rail/)):** Authoritative community endgame builds, character tier rankings, and recommended battle team compositions.
+
+</details>
+
+<details>
+<summary><b>🧬 Reverse Engineering, Metadata & Protocol Toolchains</b></summary>
+
+- **Perfare ([Perfare/Il2CppDumper](https://github.com/Perfare/Il2CppDumper)):** The legendary original IL2CPP metadata extraction tool that established the foundation for modern Unity reversing.
+- **yarik0chka ([yarik0chka/hg-metadata-dumper](https://github.com/yarik0chka/hg-metadata-dumper)):** High-performance global-metadata.dat dumper for Unity and miHoYo titles.
+- **gatokeeper ([gatokeeper/FireflyProtoc](https://github.com/gatokeeper/FireflyProtoc)):** Custom Protocol Buffer compiler with extended syntax support, enum bounds expansion, and recursive scope type resolution.
+- **AzenKain ([AzenKain/honkai-dumper](https://github.com/AzenKain/honkai-dumper) • [AzenKain/Firefly-Static-Parser](https://github.com/AzenKain/Firefly-Static-Parser)):** Method offset dumper, static IL2CPP metadata parsing, XOR decryption, and Protobuf schema reconstruction.
+- **Hiro420 ([Hiro420/StaticCmdIdDumper](https://github.com/Hiro420/StaticCmdIdDumper) • [Hiro420/Dumpcs2Protobuf](https://github.com/Hiro420/Dumpcs2Protobuf)):** Static CmdId extractor and obfuscated protobuf generator from dump.cs.
+- **ex-RushiaLover:** Groundbreaking research and tooling for automated IL2CPP Protobuf schema recovery and reflection dumping.
+- **Kabeidon-Lee:** In-game live IL2CPP reflection memory dumper (`hsr-dumping-skull`) and runtime object inspection.
+
+</details>
+
+<details>
+<summary><b>🛠️ Telemetry, Analytics & Client Enhancement Tools</b></summary>
+
+- **GaC-Srtool ([CAtlas0784/GaC-Srtool](https://github.com/CAtlas0784)):** GM command console, live unstuck controller, telemetry inspector, and battle monitoring web application.
+- **Frida Core Team ([Frida](https://frida.re)):** Dynamic binary instrumentation toolkit used for bounded, read-only runtime validation.
+- **Scighost ([Scighost/Starward](https://github.com/Scighost/Starward)):** Game client manager and launcher design reference.
+- **lgou2w ([lgou2w/HoYo.Gacha](https://github.com/lgou2w/HoYo.Gacha)):** Chromium disk-cache gacha record extraction, SQLite parsing, and statistical probability analysis.
+
+</details>
+
+<details>
+<summary><b>⚙️ Go Ecosystem, Networking & Cryptographic Libraries</b></summary>
+
+- **xtaci ([xtaci/kcp-go](https://github.com/xtaci/kcp-go)):** Production-grade, low-latency Reliable UDP (KCP) networking library for Go.
+- **Google Protocol Buffers ([protocolbuffers/protobuf-go](https://github.com/protocolbuffers/protobuf-go)):** Official Go language bindings and runtime for Protocol Buffers v3.
+- **Gin Web Framework ([gin-gonic/gin](https://github.com/gin-gonic/gin)):** High-performance HTTP web framework powering the REST API and SDK dispatch endpoints.
+- **Gorilla WebSocket ([gorilla/websocket](https://github.com/gorilla/websocket)):** WebSocket implementation for real-time live battle diagnostics and console streaming.
+- **Mersenne Twister (MT19937):** Pseudorandom number generator algorithm powering the game's initial handshake stream cipher.
+
+</details>