Review Quán bar online XiuGou Disco
3/5Bởi Chủ trang manguonfree · 05/11/2026
Quán bar online XiuGou Disco là dự án nhỏ, phù hợp để học cách một trang web nhận chat live và biến thành nhân vật. Toàn bộ logic nằm trong một file HTML và một controller Java, nên đọc rất nhanh.
Mình đã kiểm tra những gì
Mình đọc mã nguồn và mở thử giao diện dưới dạng tĩnh, chưa chạy server Java và chưa kết nối phòng live thật, nên điểm 3/5 là đánh giá từ code. Ảnh bìa là giao diện mình dựng lại từ file trong repo. Trang demo tác giả ghi trong README không truy cập được khi mình kiểm tra ngày 05/11/2026.
Điểm mạnh
- Mã ngắn, dễ đọc, hợp để học WebSocket và hiệu ứng canvas.
- Không cần Unity, chỉ cần một server Java và trình duyệt.
- Có thể đưa vào OBS như một trang web.
Điểm cần cân nhắc
- Không có TikTok: README ghi rõ bản mở nguồn chỉ hỗ trợ Bilibili, còn các bản hỗ trợ TikTok là bản Unity riêng của tác giả.
- Repo thiếu file: không có chứng chỉ
.jksvàjs/decode.js, nên không chạy được ngay. - Dự án cũ: lần cập nhật cuối là tháng 7/2022, dùng Spring Boot 2.6 và Java 8.
- Phụ thuộc bên ngoài: jQuery tải từ
jq22.com, API lấy thông tin phòng của Bilibili có thể đã thay đổi. - Nhạc đi kèm: hai bài nhạc thương mại trong repo không nên phát lại trên live.
Nên dùng cho ai
Hợp với lập trình viên muốn tự làm quán bar online trên nền web. Nếu cần sản phẩm chạy được trên TikTok LIVE, hãy chọn Bar live TikTok 3D. Nếu thích bản 3D bằng Unity, hãy xem source code quán bar online DJ Club.
Quán bar online XiuGou Disco là gì?
Quán bar online XiuGou Disco là một trang web mô phỏng trò 修勾夜店. Mở trang là thấy sàn nhảy, DJ mèo và nhạc chạy vòng. Người xem live chat là có một chú chó xuất hiện trên sàn, nội dung chat hiện trên đầu nhân vật.
Lưu ý trước khi tải: README ghi bản mở nguồn chỉ hỗ trợ Bilibili, chưa có TikTok. Nếu cần chạy trên TikTok, hãy xem Bar live TikTok 3D.
Dự án có gì
- Sàn nhảy web: nền, DJ, pháo giấy trên canvas và danh sách nhạc phát vòng.
- Người xem thành nhân vật: mỗi người chat có một chú chó riêng, gõ
换修勾để đổi hình. - Đọc chat và quà: trang tự kết nối WebSocket của phòng Bilibili theo số phòng trên đường dẫn
/index/số-phòng.
Giấy phép
Dự án dùng giấy phép Mulan PSL v2, không phải MIT. Hình ảnh và hai bài nhạc đi kèm không có ghi chú bản quyền riêng, bạn nên thay bằng tài nguyên của mình trước khi live.
Cách cài đặt Quán bar online XiuGou Disco
Dự án chạy bằng Java 8 và không có bản dựng sẵn. Tác giả ghi mở bằng IntelliJ IDEA là dùng được, nhưng repo còn thiếu vài thứ nên bạn cần sửa trước.
1. Tải mã nguồn
git clone https://github.com/mh3400425/XiuGouDisco-master.git
2. Sửa cấu hình SSL
File src/main/resources/application.yaml trỏ tới một file chứng chỉ .jks không có trong repo. Khi chạy thử trên máy, hãy xóa khối ssl để server chạy HTTP thường.
server:
port: 64848
3. Chạy
./mvnw spring-boot:run
Trên Windows dùng mvnw.cmd spring-boot:run, hoặc chạy XiuGouApplication trong IDEA.
4. Mở trang
Vào http://localhost:64848/index/số-phòng, thay số-phòng bằng số phòng live Bilibili của bạn.
Trang còn tham chiếu file js/decode.js không có trong repo và tải jQuery từ một trang bên ngoài. Nếu gặp lỗi, hãy kiểm tra hai chỗ này đầu tiên.
Lần đầu cài mã nguồn? Đọc hướng dẫn cho người mới.
Câu hỏi thường gặp về Quán bar online XiuGou Disco
Quán bar online là gì?
Là kiểu livestream tương tác có sàn nhảy ảo, mỗi người xem chat hoặc tặng quà sẽ xuất hiện thành nhân vật trên sàn.
XiuGou Disco có dùng được cho TikTok không?
Bản mở nguồn chỉ đọc chat Bilibili. Muốn dùng TikTok, bạn phải tự sửa phần kết nối hoặc chọn dự án Bar live TikTok 3D.
Cần gì để chạy XiuGou Disco?
Cần Java 8 và biết chạy dự án Spring Boot. Bạn phải sửa cấu hình SSL trong application.yaml vì repo không kèm file chứng chỉ.
XiuGou Disco có miễn phí không?
Có. Dự án dùng giấy phép Mulan PSL v2, không phải MIT. Bạn nên đọc giấy phép và thay nhạc đi kèm trước khi dùng.
Có bản demo để xem thử không?
README có link demo, nhưng link đó không truy cập được khi mình kiểm tra ngày 05/11/2026.
