# Ananta (Project Mugen) CBT 4229938 Private Server

> **สถานะ Go port:** ยังไม่เทียบเท่า C# เดิม การตรวจพบฟังก์ชันที่ยังเป็น stub 2,127 ตัวใน 223 ไฟล์ และ router ที่สร้างจาก transpiler ยังไม่เชื่อมกับ executable ดูบั๊กที่แก้แล้วและงานที่ยังขาดใน [GO_MIGRATION_AUDIT.md](docs/GO_MIGRATION_AUDIT.md) ก่อนอ้างอิงรายการฟีเจอร์ด้านล่าง

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

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

---

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

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

---

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

### 1. ติดตั้ง Root Certificate
คลิกขวาที่ไฟล์ `SETUP_CERTS.cmd` แล้วเลือก **Run as administrator** เพื่อติดตั้งใบรับรองความปลอดภัย Local Root CA:
```cmd
SETUP_CERTS.cmd
```

### 2. เปิดเซิร์ฟเวอร์
ดับเบิลคลิกเปิดใช้งานผ่าน:
```cmd
START.cmd
```
หรือรันผ่านคอมมานด์ไลน์:
```bash
.\ananta-server.exe
```

เมื่อขึ้นข้อความ `[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, Traffic, Police, Combat, Mini-games, Racing, Teleport
│   └── 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, Method Catalog
├── data/
│   ├── player_info_template.bin # เทมเพลตข้อมูลผู้เล่นและไอเทมเริ่มต้น
│   └── client_data/          # สถิติและคอนฟิกเกมเพลย์จาก Client CBT 4229938
├── certs/                    # SSL/TLS Root CA และ Server Certificates
├── public/                   # Patch Manifests และ Fastpatch Assets
├── config/                   # private-server.json คอนฟิกเซิร์ฟเวอร์
├── docs/                     # FEATURES.md (เอกสารฟีเจอร์และระบบทั้งหมด)
├── START.cmd                 # รัน Go Engine ทันทีในคลิกเดียว (คอมไพล์อัตโนมัติหากยังไม่มี exe)
├── SETUP_CERTS.cmd           # ติดตั้ง Root Certificate ด้วยคำสั่งเดียว
└── ananta-server.exe         # Single Native Binary Executable
```

---

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