Mã nguồn Bar live TikTok 3D Ông Chú MMO

Bar live TikTok 3D là bộ công cụ biến phiên TikTok LIVE thành một sàn nhảy 3D tương tác. Người xem gửi chat, thả tim, follow hoặc tặng quà sẽ xuất hiện trên sàn với avatar TikTok thật. Dự án do Ông Chú MMO phát triển, mã nguồn mở theo giấy phép MIT, không có khóa bản quyền hay bước kích hoạt.

Trong ba dự án quán bar online trên trang này, đây là dự án duy nhất có sẵn kết nối TikTok.

Tính năng chính

• Sàn nhảy 3D realtime: người xem vào sàn với nhân vật và avatar TikTok.
• Quà tặng thành hiệu ứng: quà nhỏ cho nhân vật nhảy, quà trung zoom camera, quà VIP bật spotlight và pháo hoa.
• Bảng Top 3: ba người tặng nhiều nhất đứng trên bục trước bàn DJ.
• DJ Booth: phát nhạc và video nền của bạn.
• Master Rules: đổi luật quà và cách vào sàn trên giao diện web, không cần sửa code.
• Test Lab: tạo người xem giả để thử trước khi lên sóng.
• Chroma Key: bấm F2 để bật nền xanh, ghép vào OBS.

Lệnh chat của người xem

• nhảy hoặc dance: nhân vật nhảy.
• đi vòng hoặc walk: nhân vật bước tại chỗ.
• đổi nv: đổi nhân vật ngẫu nhiên.

Bản quyền

Mã nguồn dùng giấy phép MIT, được phép đổi thương hiệu và thương mại hóa. Tác giả ghi rõ GIF, hình ảnh và font của bên thứ ba có thể có giấy phép riêng. Gói Windows kèm một file nhạc nền mẫu, bạn nên thay bằng nhạc có bản quyền hợp lệ trước khi live.

Quan trọng: nút Tải file ZIP miễn phí trên trang này chỉ có mã nguồn, không có game. Nếu chỉ muốn dùng, hãy tải gói Windows ở trang Releases.

Cách nhanh trên Windows

1. Cài Node.js 20 trở lên.
2. Tải file OngChuMMO-Live-Windows-...zip trong Releases.
3. Giải nén toàn bộ ra một thư mục mới, không chạy trực tiếp trong file ZIP.
4. Nhấp đúp run.bat. Launcher tự cài thư viện, mở Bridge, game và bảng điều khiển.

Nếu SmartScreen cảnh báo, chỉ chọn More info → Run anyway khi file được tải từ đúng Releases của repo này.

Bảng điều khiển nằm tại http://127.0.0.1:3000/control.html. Bạn có thể bấm DEMO 30 hoặc DEMO 200 để thử.

Kết nối TikTok LIVE

1. Mở TikFinity Desktop, đăng nhập và bật LIVE.
2. Trong bảng điều khiển, nhập username TikTok đang live, không kèm dấu @.
3. Bấm Kết nối.

Ghép vào OBS

1. Thêm nguồn Game Capture và chọn cửa sổ game.
2. Bấm F2 trong game để bật nền xanh.
3. Thêm filter Chroma Key trong OBS.

Tự build từ mã nguồn

git clone https://github.com/cherry9001/tiktok-live-bar.git
cd tiktok-live-bar/TikTokBridge
copy .env.example .env
npm ci
npm start

Phần game cần Unity đúng bản 6000.2.10f1, sau đó chạy build.bat ở thư mục gốc.