Ananta-ps/README.md

# Ananta (Project Mugen) CBT 4229938 Private Server & Proxy Engine

เซิร์ฟเวอร์ส่วนตัว (Private Server) และระบบ HTTPS/SNI Proxy สำหรับเกม **Ananta (Project Mugen / 代号：无限大)** ไคลเอนต์เวอร์ชัน **CBT 4229938** พัฒนาขึ้นมาทั้งในรูปแบบ **High-Performance Native Go Engine (`ananta-server.exe`)** และ Clean Architecture C# .NET 8 ร่วมกับ Node.js Proxy เพื่อจำลองการเชื่อมต่อและเล่นเกมในโหมด Sandbox / Free-Roam ได้อย่างสมบูรณ์แบบ รองรับทั้งการเข้าเล่นผ่าน PC และ Mobile APK

> 📖 **รายการระบบและฟีเจอร์ทั้งหมดของเซิร์ฟเวอร์ (36+ ระบบ)**: ดูรายละเอียดเชิงลึกและสถานะฟีเจอร์ทั้งหมดได้ที่ [docs/FEATURES.md](docs/FEATURES.md)

---

## 🛠️ ความต้องการของระบบ (Prerequisites)

### สำหรับ Go Native Engine (แนะนำ - รันได้ทันทีโดยไม่ต้องลงรันไทม์เพิ่ม):
1. **Windows 10 / 11 (64-bit)**
2. ตัวเกม **Ananta / Project Mugen (CBT Client build 4229938 หรือ Mobile APK 4063976)**
3. (ตัวเลือกเสริมสำหรับการพัฒนา) **Go 1.22+**: [ดาวน์โหลดที่นี่](https://go.dev/dl/)

### สำหรับ C# / Node.js Engine ดั้งเดิม:
1. **.NET 8.0 SDK** & **Node.js (v18+)**

---

## 🚀 วิธีติดตั้งและเปิดใช้งานเซิร์ฟเวอร์

### 1. ติดตั้ง Certificate & Hosts
รันคำสั่งด้วย PowerShell (Administrator) เพื่อชี้โดเมน NetEase เข้าหาเซิร์ฟเวอร์เครื่องคุณ (`127.0.0.1`):
```powershell
powershell -ExecutionPolicy Bypass -File .\Ananta.Proxy\SETUP_PROXY_AS_ADMIN.ps1
```

### 2. เปิดเซิร์ฟเวอร์ด้วย Go Engine (รวดเร็ว, น้ำหนักเบา, รวมทุกระบบในไบนารีเดียว)
ดับเบิลคลิกเปิดใช้งานผ่าน:
```cmd
START-GO.cmd
```
หรือรันผ่านคอมมานด์ไลน์:
```bash
.\ananta-server.exe
```

*(หรือหากต้องการใช้งาน C# Engine ดั้งเดิม สามารถดับเบิลคลิก `START.cmd` ได้เช่นกัน)*

เมื่อขึ้นข้อความ `[READY]` แสดงว่าระบบพร้อมทำงาน:
* **HTTPS Gateway Proxy**: พอร์ต 443 (TLS SNI) / 80 (HTTP) และ Mobile Dispatch พอร์ต 5801
* **Game Server**: Login Ports 5200, 5201 และ World Port 5202
* **GM Admin Web Panel**: พอร์ต 17888
* **Debug WebUI Panel**: พอร์ต 5809

### 3. เข้าเล่นเกม
* **PC:** เปิดไฟล์ `Ananta.exe` แล้วกดเริ่มเกม ตัวเกมจะทำการบายพาสล็อกอินและนำตัวละครเข้าสู่โลก Sandbox ทันที
* **Mobile (APK):** ชี้เกตเวย์หรือรันผ่าน Wi-Fi Proxy มายัง IP เครื่องเซิร์ฟเวอร์ (พอร์ต 5801/443)

### 4. แผงควบคุมผ่านเว็บเบราว์เซอร์
* **GM Admin Panel**: [http://127.0.0.1:17888/](http://127.0.0.1:17888/) — จัดการไอเทม, วาร์ปพิกัด, สลับตัวละคร, และระบบโลก
* **Debug WebUI Panel**: [http://127.0.0.1:5809/](http://127.0.0.1:5809/) — มอนิเตอร์การเชื่อมต่อ, เซสชันแบบ Real-Time, และ RPC Inspector

---

## 📁 โครงสร้างโปรเจกต์ (Project Structure)

```text
Ananta-ps/
├── cmd/
│   └── ananta-server/        # Go Server Entrypoint (รวม Gateway + Login + Game + Web ใน binary เดียว)
├── internal/
│   ├── config/               # ตัวโหลดคอนฟิก private-server.json
│   ├── gateway/              # HTTPS/SNI Proxy (443), HTTP (80) และ Mobile Dispatch (5801)
│   ├── logingate/            # Login & Gate TCP Server (พอร์ต 5200, 5201)
│   ├── gameserver/           # World Entry (V7 handoff), Combat, Movement, Switching (5202)
│   └── web/                  # GM Admin Panel (17888) และ Debug WebUI (5809)
├── pkg/
│   ├── crypto/chacha8/       # NetEase UXChaCha8 Custom Sigma Stream Cipher
│   └── protocol/             # Binary Serializer/Deserializer, Frame Codec, Key Exchange
├── data/
│   └── player_info_template.bin # เทมเพลตข้อมูลผู้เล่นและไอเทมเริ่มต้น
├── config/                   # private-server.json และตารางพิกัดมินิเกม/การจราจร
├── docs/                     # FEATURES.md (ฟีเจอร์แมทริกซ์ 36 ระบบ)
├── START-GO.cmd              # รัน Go Engine ทันทีในคลิกเดียว
└── ananta-server.exe         # Single Native Binary Executable
```

---

## ⚖️ ข้อกำหนดและเงื่อนไข (Disclaimer)
โปรเจกต์นี้จัดทำขึ้นเพื่อการศึกษาด้าน Reverse Engineering, Network Protocol Emulation และการอนุรักษ์ซอฟต์แวร์ (Software Preservation) เท่านั้น ไม่มีส่วนเกี่ยวข้องกับ NetEase Games หรือ Naked Rain แต่อย่างใด ห้ามนำไปใช้ในเชิงพาณิชย์