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 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ỉ cần sử dụng, thì cài jre là đủ.

• MongoDB (khuyến khích 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 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/ nếu lưu lượng truy cập đi qua mitmproxy.

You can also use start.cmd to start servers and proxy daemons automatically, but you have to set up JAVA_HOME environment and configure the start_config.cmd file.

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, vui lòng 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... - Cài đặt proxy (proxy daemon) của bạn thường là vấn đề. Nếu bạn đang sử dụng Fiddler, hãy đổi port (cổng) mặc định khác 8888.
• Thứ tự cài đặt: MongoDB > Grasscutter > Proxy Daemon (mitmdump, fiddler, v.v.) > Game