Grasscutter/docs/README_vi-VN.md

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP | IT | VI

Chú ý: Chúng tôi luôn chào đón những người đóng góp cho dự án. Trước khi đóng góp, xin vui lòng đọc kỹ "các quy tắc" (Code of Conduct) của chúng tôi .

Các tính năng hiện tại

• Đăng nhập
• Chiến đấu, giao tranh
• Danh sách bạn bè
• Dịch chuyển
• Hệ thống cầu nguyện (gacha)
• Một phần của tính năng chơi chung (co-op)
• Gọi ra quái vật từ bảng điều khiển (console)
• Vật phẩm/Nhân vật (nhận vật phẩm/nhân vật, nâng cấp vật phẩm/nhân vật)

Hướng dẫn cài đặt nhanh

Ghi chú: Để được hỗ trợ, vui lòng tham gia Discord.

Phần mềm cần thiết

• Java SE - 17 hoặc cao hơn

  Ghi chú: Nếu bạn chỉ muốn sử dụng, vậy thì cài đặt jre là đủ.

• MongoDB (khuyến khích sử dụng phiên bản từ 4.0 trở lên)

• Proxy Daemon: mitmproxy (nên sử dụng mitmdump), Fiddler Classic, v.v.

Chạy chương trình (server)

Ghi chú: Nếu bạn đã cập nhật từ phiên bản cũ hơn, hãy xóa config.json để tạo lại.

1. Tải grasscutter.jar
   • Tài về từ releases (bản phát hành) hoặc actions (các hoạt động) hoặc tự tạo của chính bạn.
2. Tạo một thư mục resources trong cùng thư mục với Grasscutter.jar và chuyển các thư mục BinOutput, ExcelBinOutput, Readables, Scripts, Subtitle, TextMap của bạn đến resources (Xem wiki để biết cách lấy các thư mục đó)
3. Chạy Grasscutter với câu lệnh java -jar grasscutter.jar. Hãy chắc rằng mongodb của bạn đã được chạy

Kết nối với game (client)

½. Tạo một tài khoản từ bảng điều khiển máy chủ (server console), sử dụng câu lệnh (command).

1. Chương trình chuyển hướng lưu lượng truy cập: (chỉ sử dụng 1)

   • mitmdump: mitmdump -s proxy.py -k

     • Chứng chỉ CA tin cậy:

       • Chứng chỉ CA thường được lưu trữ trong %USERPROFILE%\.mitmproxy, click đúp mitmproxy-ca-cert.cer để cài đặt hoặc...

       • Sử dụng với command line (cmd) (yêu cầu quyền quản trị viên)

         certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
         

   • Fiddler Classic: Mở Fiddler Classic, bật tùy chọn Decrypt HTTPS traffic trong (Tools -> Options -> HTTPS) và thay đổi cổng (port) mặc định (Tools -> Options -> Connections) khác 8888, chạy script này (sao chép và dán script vào trong FiddlerScript) và bấm Save Script.

   • Hosts file

2. Cài đặt network proxy thành 127.0.0.1:8080 hoặc cổng proxy mà bạn đã chỉ định.

• Với mitmproxy: Sau khi thiết lập proxy và cài đặt chứng chỉ, hãy kiểm tra http://mitm.it/ để xem liệu lưu lượng có đang thông qua mitmproxy hay không.

Bạn cũng có thể sử dụng start.cmd để tự động khởi động máy chủ (servers) và proxy daemons, nhưng trước đó bạn phải thiết lập biến môi trường JAVA_HOME và cấu hình tệp start_config.cmd.

Tự tạo server (Building)

Grasscutter sử dụng Gradle để xử lý các phần phụ thuộc và xây dựng.

Phần mềm cần thiết:

• Java SE Development Kits - 17 hoặc cao hơn
• Git

Windows

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Thiết lập môi trường (Setting up environments)
.\gradlew jar # Biên dịch (Compile)

Linux

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Biên dịch (Compile)

Bạn có thể tìm thấy tệp jar đã được biên dịch tại thư mục gốc của dự án.

Các câu lệnh (commands) đã được chuyển đến wiki!

Khắc phục nhanh các sụ cố

• Nếu quá trình biên dịch (compile) không thành công, hãy kiểm tra cài đặt JDK của bạn (Đảm bảo rằng JDK phải từ phiên bản 17 trở lên và PATH của JDK đã được cài đặt).
• Không thể kết nối, không thể đăng nhập, 4206, v.v. - Vấn đề thường là do cài đặt proxy (proxy daemon) của bạn. Nếu bạn đang sử dụng Fiddler, hãy đổi cổng (port) mặc định sang bất cứ cổng nào khác 8888.
• Thứ tự khởi động: MongoDB > Grasscutter > Proxy Daemon (mitmdump, fiddler, v.v.) > Game