# XiuGouDisco

**Repository Path**: hfcfdf/XiuGouDisco

## Basic Information

- **Project Name**: XiuGouDisco
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 122
- **Forks**: 41
- **Created**: 2022-01-10
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XiuGouDisco（修勾夜店）

> **维护状态：已停止维护**
>
> 本项目仅作为早期学习作品和历史归档保留，不再修复问题、提供部署支持或适配哔哩哔哩接口与协议变更。当前代码不保证仍可运行，请勿用于生产环境或公网服务。

原 Gitee 项目地址：[https://gitee.com/hfcfdf/XiuGouDisco](https://gitee.com/hfcfdf/XiuGouDisco)

XiuGouDisco 是一个将哔哩哔哩直播间互动映射为“修勾夜店”网页动画的实验项目。访问指定直播间后，服务端获取弹幕服务器信息，浏览器通过 WebSocket 接收直播事件并展示互动效果。

本仓库仅包含哔哩哔哩 Web 版本，不包含历史 Unity、抖音或 TikTok 版本。

## 效果展示

> 下图为历史 Unity 版本效果，该版本源码不在本仓库中。

![历史 Unity 版本效果](src/main/resources/static/img/image.png)

## 功能

- 根据直播间号连接哔哩哔哩直播间
- 观众进入时随机生成修勾角色
- 显示用户名与弹幕内容
- 发送“换修勾”切换角色形象
- 轮播本地背景音乐

## 技术栈

- Java 8
- Spring Boot 2.6.2
- Spring MVC、Thymeleaf
- JavaScript、WebSocket
- Maven Wrapper

## 本地运行

准备 JDK 8–17，并确保可以访问 Maven Central 与哔哩哔哩相关接口。

应用默认通过 HTTP 监听 `64848` 端口。

哔哩哔哩直播间号位置示例：

![哔哩哔哩直播间号位置示例](https://images.gitee.com/uploads/images/2022/0110/210547_e560f701_7696486.png)

Windows PowerShell：

```powershell
.\mvnw.cmd spring-boot:run
```

Linux / macOS：

```bash
sh ./mvnw spring-boot:run
```

启动后访问：

```text
http://localhost:64848/index/{哔哩哔哩直播间号}
```

例如：

```text
http://localhost:64848/index/5050
```

如需启用 HTTPS，请在 [`application.yaml`](src/main/resources/application.yaml) 中使用自己的证书配置，并通过环境变量或密钥管理服务提供密码。请勿将证书私钥提交到仓库。

## 已知限制

- 项目依赖旧版哔哩哔哩接口和弹幕协议，可能已经失效。
- 浏览器的自动播放策略可能阻止背景音乐播放。
- 依赖和前端资源版本较旧，未经过当前环境下的安全性与兼容性验证。

## 许可证与素材

项目源代码采用[木兰宽松许可证，第 2 版](LICENSE)。

仓库中的音乐、图片、动图等第三方素材不一定受该许可证覆盖，使用或分发前请自行确认相关授权。