Files
Ananta-ps/README.md
T

84 lines
6.8 KiB
Markdown

# 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 แต่อย่างใด ห้ามนำไปใช้ในเชิงพาณิชย์