culdo/web-mmd

🌐 web-mmd: Chơi MMD trên trình duyệt thời gian thực

Một dự án TypeScript cho phép chơi MMD trực tiếp trên trình duyệt với hỗ trợ thời gian thực, cảm hứng từ ví dụ three.js của takahirox.

web-mmd là một dự án mã nguồn mở cho phép người dùng chơi MMD (MikuMikuDance) trên trình duyệt bằng cách sử dụng công nghệ three.js. Dự án hỗ trợ hai chế độ chính: MV Player để phát lại với thanh điều khiển thời gian và MultiPlayer Game mode để tương tác với người khác. Các tính năng bao gồm nhiều chế độ camera khác nhau như Director, Fixed-Follow, Editor và AR, cùng khả năng tùy chỉnh mô hình, nhạc, ánh sáng và cài đặt bố cục.

✨ Điểm nổi bật

• MV Player mode: Phát MMD với thanh thời gian hỗ trợ tìm kiếm thời gian và nhảy đến thời điểm cụ thể.
• MultiPlayer Game mode: Điều khiển nhân vật MMD và tương tác với người chơi khác qua bàn phím W/A/S/D và phím Space.
• Chế độ camera đa dạng: Director (điều khiển bằng phím tắt), Fixed-Follow (chuột), Editor (dope-sheet timeline) và AR.
• Tùy biến đầy đủ: Thay đổi mô hình, sân khấu, chuyển động, camera và nhạc; bật/tắt otomatik camera; điều chỉnh bóng đổ, đường viền và màu sắc.
• Cài đặt bố cục & Presets: Tùy chỉnh giao diện (ẩn tự động GUI, hiển thị FPS, toàn màn hình) và lưu/xuất cài đặt dưới dạng JSON.
• Phím tắt bàn phím: Điều khiển phát/pause, chuyển chế độ camera và thao tác cắt cảnh nhanh chóng.
• Hỗ trợ WebGPU & Hiệu ứng thực tế: Hỗ trợ thử nghiệm WebGPU và hiệu ứng Hex DoF được tối ưu hiệu suất.

💡 Vì sao đáng chú ý

web-mmd nổi bật bởi sự kết hợp giữa việc chơi MMD truyền thống và trải nghiệm đa người trực tuyến, mở rộng tiềm năng sử dụng trong các buổi biểu diễn hoặc ván đấu nhóm. Dự án còn được xây dựng trên nền tảng Next.js và React Three Fiber, giúp tích hợp dễ dàng với hệ sinh thái web hiện đại, đồng thời hỗ trợ kiểm thử E2E bằng Playwright và triển khai CI/CD qua GitHub Actions.

#MMD #ThreeJS #WebMMD #OpenSource #TiniX