Greenbox Studio

Ứng dụng web tĩnh dùng trực tiếp trong trình duyệt để quay, dựng và xuất nội dung Greenbox.

Chạy trên máy

python3 -m http.server 8080

Sau đó mở http://localhost:8080.

Triển khai

Repository được cấu hình để tự động triển khai lên GitHub Pages khi có thay đổi trên nhánh main.

Các tab

• Overlay gameplay / Lái xe / Gacha: nằm trong Greenbox-Cockpit.html.

• Hậu kỳ › Gắn SFX: trang riêng sfx-bench.html, được nhúng vào Cockpit bằng iframe và chỉ tải khi mở tab lần đầu. Mở trực tiếp sfx-bench.html vẫn chạy độc lập.

• Thư viện của SFX nằm trong vendor/ (mp4box.all.min.js, fflate.umd.js, mp4-muxer-5.1.3.js), không phụ thuộc CDN.

• 3D · Gắn xương: thư mục rig3d/ là bản build của Mesh2Motion (code MIT, asset CC0, giấy phép đi kèm trong rig3d/LICENSE-MIT.MD và rig3d/LICENSE-CC0.MD). Greenbox thêm 2 file: rig3d/gb-base.js (cho app chạy được trong thư mục con) và rig3d/gb-i18n.js (giao diện VI / EN / KO theo ngôn ngữ của Cockpit).

  • Greenbox có sửa mã nguồn Mesh2Motion để thêm Chế độ dễ (tự khớp cỡ + vị trí khung xương vào model, quét chọn nhiều khớp, kéo cả nhóm, chọn nhanh tay/chân/thân/đầu). Bản vá nằm ở rig3d/greenbox-easyrig.patch.
  • Cập nhật Mesh2Motion: git clone repo đó, git apply rig3d/greenbox-easyrig.patch, npm ci && npm run build, chép dist/ đè vào rig3d/ (bỏ *.map), rồi gắn lại 2 dòng <script> gb-base / gb-i18n vào create.html, index.html, retarget/index.html.

• Greenbox 3D – mã nguồn riêng của Greenbox: rig3d-src/greenbox/ (bản sao để đọc; bản build nằm trong rig3d/):

  • rig/ chế độ dễ, quét cơ thể (cả tay giơ ra trước kiểu zombie), phím kiểu Blender (G/X/Y/Z, 1/3/7, F, A), giảm số xương (BoneReduce.ts: tắt khớp → gộp vào khớp cha, bake animation, chỉ áp vào bản skin/export)
  • skin/ lồng giải phẫu (chỉ cho người; thú dùng trọng lượng gốc của Mesh2Motion), chỉnh độ dày từng bộ phận, xem vùng da theo màu (CageRegions.ts)
  • export/ tên xương Rigify, script Rigify cho Blender: tự đặt meta-rig, generate rig, gắn model (bộ "Rigify kit" = GLB + .py)
  • vehicle/ 23 khung có sẵn (bánh, trống lu, cửa các kiểu, tháp pháo, nòng, lưỡi ủi, cần, tay máy xúc, gầu, móc, cáp, chân vịt, rotor, radar, bồn trộn, piston, thang, ăng-ten); chọn vùng bằng mảnh / khung / lasso / pen / cọ; loại xe car / truck / tracked / roller có bộ animation riêng
  • playtest/ tab Chơi thử (WASD, nhảy, lộn, combo, đỡ, cúi, leo gờ, bấm-đất-để-đi kiểu mobile, quay video), map: thả GLB làm vật thể, kéo/xoay/phóng to, đi trên vật thể; thú; lái xe rig từ tab Xe cộ
  • common/ViewButtons.ts 4 góc camera (Trước / Ngang / Trên / 3D)
  • mocap/ video → animation (MediaPipe Pose, Apache-2.0, chạy trong trình duyệt; file ở rig3d/vendor/mediapipe-pose/)
  • common/ ngôn ngữ, chuyển file giữa các tab, ma-nơ-canh

• AI chat + MCP: thư mục gb-ai/ (xem gb-ai/README.md).

• Tạo dáng IK / FK (tab Dùng model, sau Hoàn tất): mỗi tay / chân có công tắc IK ⇄ FK, đổi không làm nhảy dáng (rig/PoseControls.ts). Dáng tự đi kèm sang Blender (clip Greenbox_Pose) và rig Rigify có bảng Greenbox IK / FK y hệt (Blender: phím N → tab Greenbox; code ở export/greenbox_controls.py, lưu trong file .blend).

• Nút ‹ › ở mép bảng bên phải: ẩn / hiện bảng điều khiển để khung 3D rộng hơn (nhớ theo từng trang).

• Rigify: nút 🚀 Mở thẳng trong Blender (khi mở bằng Mo-Greenbox) lưu bộ file vào exports/ rồi tự mở Blender chạy script — không cần tải về, không cần vào Scripting. Không tìm thấy Blender thì đặt biến môi trường GREENBOX_BLENDER = đường dẫn tới Blender.

• Tab 3D bị ẩn trong Cockpit chỉ vẽ 4 khung/giây (đỡ lag); nền sao của Cockpit ngừng vẽ khi đang mở tab 3D / SFX. Ctrl+C trong cửa sổ Mo-Greenbox tắt server ngay, không báo lỗi.

• Mỗi tab 3D có nút ⟳ (tải lại tab đó) và ? (hướng dẫn từng bước, tự chạy lần đầu mở trang / mỗi bước của Dùng model; nằm trong rig3d/gb-base.js).

• Các tab 3D trong Cockpit giữ nguyên trạng thái khi chuyển qua lại; nút ← trên thanh 3D để quay lại tab trước.

Cập nhật 02/11/2026 — nút PLAY NOW tuỳ biến tự do

Áp dụng cho Endcard carousel (Cockpit › Gacha) và End card đơn giản (hpbar.html), vì cả hai dùng chung gb-endcard.js. Chọn tab Nút trong bảng End card:

• Kiểu nút (preset): Xanh lá, Cam, Xanh dương, Đỏ, Tím, Vàng, Trắng, Phẳng bo góc, Chỉ viền. Bấm xong vẫn chỉnh tiếp được mọi thông số.
• Kích thước: Rộng nút / Cao nút riêng (20–200 % / 20–250 %), Bo góc 0–100 % (0 = vuông, 100 = viên thuốc), độ đậm cả nút.
• Màu nền: chuyển màu + vệt sáng (tự pha sáng/tối từ màu nút, hoặc tự chọn màu trên/dưới), một màu, không nền (chỉ viền), hoặc ảnh PNG của bạn làm nền nút (chọn "Ảnh của bạn" rồi bấm ⬆).
• Viền: bật/tắt, màu, độ dày. Đổ bóng / phát sáng: màu, độ nhoè, lệch xuống.
• Chữ trong nút: nội dung, font (gõ tên font bất kỳ máy có), đậm/thường, nghiêng, IN HOA, cỡ chữ, giãn chữ, chữ lên/xuống, viền chữ (màu + độ dày), màu chữ.
• Nhịp đập: bật/tắt, biên độ, tốc độ.
• Nút ↺ "Về kiểu nút mặc định" đưa mọi thứ về như cũ. Cấu hình cũ đã lưu mở lại vẫn y nguyên.
• Sửa: dòng "phần vừa kéo: undefined" ở trang End card.

This is the beginning of the README. Read the rest at the original. Read the full README ↗