Võ lâm truyền kỳ Offline

JXLinux 8.x Offline (Võ lâm truyền kỳ 1)

Các mã nguồn scripts được chỉnh sửa và phát triển bởi nhóm Eurofun phân phối lại theo giấy phép GNU GPL.

1. Thông tin cơ bản

Tên mã: JxOnline 1

Tiếng Trung: 剑侠情缘 (SWORDSMAN Online)

Tiếng Việt: Võ lâm truyền kỳ 1 - JXLinux Offline

Phiên bản: 8.x

Cấu trúc thư mục

• client: Thư mục chứa mã nguồn scripts và các tập tin cần thiết chạy game client.
• server
  • jxser: Thư mục chứa scripts và các tập tin cần thiết chạy game server trên nền Centos.
• requirements.txt: yêu cầu cấu hình tối thiểu cho phần cứng cũng như phần mềm để vận hành hệ thống game.
• revision.log: ghi chú các thay đổi qua từng phiên bản.

2. Hướng dẫn đóng góp

2.1. Tạo branch và pull request (PR)

• Bước 1: Tạo branch trên máy tính cá nhân với lệnh:

   git checkout -b <tên-nhánh>
  

• Bước 2: Chỉnh sửa, viết script thoải mái trên máy cá nhân

• Bước 3: Commit và push toàn bộ nội dung chỉnh sửa lên git server (đưa lên nhánh vừa tạo ở bước 1)

   git add .
   git commit -m "ghi chú commit"
   git push --set-upstream origin <tên nhánh cần push>
  

• Bước 4: Từ giao diện web github, tạo PR từ nhánh vừa đưa lên git server. Git sẽ có gợi ý sẵn, bấm vào đó nó tạo PR cho mình luôn hoặc tự tạo PR bằng cách chọn "New pull request": #5 (comment)

• Bước 5: Nếu có thay đổi chỉnh sửa gì trên nhánh/PR này. Mọi thao tác sẽ thực hiện trên nhánh đấy trong máy cá nhân, tức là thực hiện lại thao tác từ bước 1 đến bước 4.

2.2. Quy ước đặt tên nhánh

Khi đặt tên nhánh cần tuân theo quy ước như sau:

• Tên nhánh và tên PR được viết thường không dấu, cách nhau bởi dấu gạch ngang (-) và có tiếp đầu ngữ. Ví dụ: lua-them-kim-ma-lenh-khi-danh quai-9x. Trong đó:
  • lua: là tiếp đầu ngữ
  • them-kim-ma-lenh: là tên ngắn gọn của nhánh hoặc PR phản ánh được nội dung của phần chỉnh sửa, trong ví dụ này là thêm kim mã lệnnh khi đánh quái 9x.
• Tiếp đầu ngữ được quy ước cụ thể như sau:
  • doc: chỉnh sửa bao gồm các ghi chú, tài liệu hướng dẫn.
  • bin: chỉnh sửa bao gồm các công cụ hỗ trợ, các tập tin nhị phân trong client, server.
  • lua: chỉnh sửa bao gồm các tập tin scripts và tập tin cấu hình ini, txt.

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

• Bước 1: Tải dữ liệu gốc

  • data: Tải 7 phần dữ liệu từ một trong các nhà cung cấp dịch vụ lưu trữ bên dưới
    • Mediafire: Phần 1 Phần 2 Phần 3 Phần 4 Phần 5 Phần 6 Phần 7
    • Mega: Phần 1 Phần 2 Phần 3 Phần 4 Phần 5 Phần 6 Phần 7
  • music: Tải dữ liệu âm thanh từ một trong các nhà cung cấp dịch vụ lưu trữ bên dưới
    • Mediafire: Tải về
    • Mega: Tải về

• Bước 2: Tải máy chủ ảo VMWare WinXP và CentOS server.7z.

  Chọn một trong các nhà cung cấp dịch vụ lưu trữ bên dưới

  • Mediafire: Tải về
  • Mega: Tải về

• Bước 3: Tải mã nguồn các scripts và tập tin thực cần thiết chạy game.

  • Trên giao diện Github, bấm vào nút Code màu xanh lá.
  • Trên hộp thoại hiển thị, chọn Download ZIP để tải về tập tin jx1offline-main.zip.

• Bước 4: Cài đặt

  • Giải nén jx1offline-main.zip vào nơi bạn muốn lưu trữ hệ thống game. Giả sử bạn lưu ở ổ D:\. Sau khi giải nén bạn sẽ có 2 thư mục D:\client và D:\server.
  • Giải nén các máy chủ ảo server.7z vào thư mục server (D:\server\). Nếu giải nén thành công, bạn sẽ có thêm 2 thư mục Win và CentOS bên trong thư mục server.
  • Dữ liệu gốc gồm 2 phần là data và music:
    • data: sau khi tải xong dữ liệu gốc trên máy bạn sẽ có 7 tập tin bao gồm data-2.224.7z.001, data-2.224.7z.002, data-2.224.7z.003, data-2.224.7z.004, data-2.224.7z.005, data-2.224.7z.006 và data-2.224.exe. Chạy tập tin data-2.224.exe để nhận được thư mục data hoàn chỉnh. Copy hoặc cut thư mục data dán đè lên thư mục data có sẵn bên trong thư mục client (D:\client).
    • music: sau khi tải dữ liệu âm thanh về bạn sẽ thu được tập tin music.7z. Giải nén tập tin này để lấy thư mục music. Chép đè vào thư mục music có sẵn trong client (D:\client).

• Bước 5: Triển khai

  • Vận hành máy chủ

    Mở thư mục D:\server chạy lần lượt các máy ảo

    • server\CentOS\CentOS16-EuroFun.vmx
    • server\Win\JXWindows-EuroFun.vmx

    Nhớ chọn I moved it ở lần đầu chạy máy ảo.

  • Cập nhật jxser

    Sử dụng WinSCP kết nối vào máy chủ CentOS, sau đó chép toàn bộ thư mục jxser lên máy chủ này.

  • Sau khi cả 2 máo ảo đều khởi động xong, cần khởi động các dịch vụ trên máy chủ CentOS.

    • Bấm lần lượt Bước 1, Bước 2 và Bước 3 nằm trên màn hình Desktop máy ảo JXWindows-EuroFun.

    • Ở Bước 3, trên ứng dụng SecureCRT, bấm Kết nối.

      Chờ đến khi dấu nhắc lệnh xuất hiện trên màn hình đen của ứng dụng SecureCRT.

      Trên thanh truy xuất nhanh SecureCRT, bạn sẽ tìm thấy các nút shortcut 1, 2, 3, S1 và Nâng cấp (các nút tròn xanh lá). Do bạn vừa chép jxser lên máu chủ CentOS, cần bấm shortcut Nâng cấp ở góc phải cùng để thực hiện ghi nhận cập nhật thư mục script mới. Những lần khởi động sau không cần phải bấm nút này nữa.

      Cuối cùng, bấm lần lượt các shortcut 1, 2, 3 và S1 trên các tab khác nhau của SecureCRT để khởi động máy chủ.

      Hoàn tất.

4. Công cụ hỗ trợ phát triển

4.1 JXStudio 20212

Công cụ đa dụng hỗ trợ biên tập Lua scripts hiển thị tiếng Việt TCVN3, chỉnh sửa nhanh tài khoản, v.v...

Mega: Tải về

Mediafire: Tải về

4.2 JXLuaEditor 1.0

Công cụ hỗ trợ biên tập Lua scripts hiển thị tiếng Việt TCVN3, không phá vỡ cấu trúc chữ gốc tiếng Trung. Đồng thời hỗ trợ chuyển ngữ nhanh với tổ hợp phím Ctrl + Shift + T.

Mega: Tải về

Mediafire: Tải về

4.3 WinSCP

Công cụ chép scripts, và các tập tin khác lên game server.

Mega: Tải về

Mediafire: Tải về