nox-mod-admin-cli

CLI tạo các file zip từ resources và (tùy chọn) upload lên S3.

• Node.js >= 18
• Hỗ trợ: macOS, Linux, Windows

Cài đặt

npm install -g nox-mod-admin-cli

Hoặc chạy trực tiếp bằng npx (không cần cài):

npx nox-mod-admin-cli <resources_path> <package_name>

Lệnh

Build từ resources zip

nox-mod-admin <resources_path> <package_name> [aws-profile-name] [--production]

| Tham số | Bắt buộc | Mô tả | |--------|----------|--------| | resources_path | Có | Đường dẫn file .zip resources (vd: com.garena.game.kgvn.zip) | | package_name | Có | Loại server: vn, tw, id, th, eu, jp | | aws-profile-name | Không | Tên AWS profile để upload lên S3 sau khi tạo xong file | | --production | Không | Upload lên servers_prod; mặc định là servers_lib |

Ví dụ:

nox-mod-admin com.garena.game.kgvn.zip vn
nox-mod-admin ./resources.zip tw nms2
nox-mod-admin com.garena.game.kgvn.zip vn nms2 --production

Sinh constant từ folder (base paths)

nox-mod-admin --gen-base <path_to_folder>

Đọc toàn bộ file và thư mục trong folder, ghi ra src/base-paths.js (BASE_PATHS + BASE_DIRS). Dùng khi cập nhật danh sách file cho base.zip.

Ví dụ:

nox-mod-admin --gen-base base
nox-mod-admin --gen-base ./my-structure

File được tạo

Mỗi lần chạy dùng thư mục tạm (OS temp), tạo xong hoặc upload xong sẽ xóa. Các file zip tạo ra:

| File | Nội dung | |------|----------| | base.zip | File theo BASE_PATHS/BASE_DIRS từ files/Resources/{version}/ | | ages_{server}.zip | files/Resources/{version}/Ages/ | | assetbundle_{server}.zip | files/Resources/{version}/assetbundle/ | | prefab_characters_all.zip | files/Resources/{version}/Prefab_Characters/ | | databin_{server}.zip | files/Resources/{version}/Databin/ | | languages_{server}.zip | files/Resources/{version}/Languages/ | | fix_permission.zip | Ages, assetbundle, AssetRefs, Databin, Languages, Prefab_Characters, Thanos |

• {server} = giá trị package_name (vn, tw, id, …).
• {version} = thư mục version trong resources (vd: 1.61.1).
• Zip dùng nén store (không nén).

Upload S3

Khi truyền aws-profile-name:

• Bucket: nox-mod-skin-storage
• Prefix: servers_lib/{package_folder}/files hoặc servers_prod/{package_folder}/files nếu có --production
• Package folder (theo package_name):
  vn → com.garena.game.kgvn, tw → com.garena.game.kgtw, id → com.garena.game.kgid, th → com.garena.game.kgth, eu → com.ngame.allstar.eu, jp → com.tencent.ngjp

Upload gồm: file resources (input) + toàn bộ file zip vừa tạo.

Yêu cầu: Cài AWS CLI, cấu hình profile tương ứng. CLI dùng endpoint S3 mặc định (cấu hình trong code).

Development

git clone <repo>
cd nox-mod-admin-cli
npm install
node bin/cli.js com.garena.game.kgvn.zip vn

License

MIT