🎵 NCM Player

在 Minecraft 中畅听网易云音乐！

NCM Player 是一个 NeoForge 模组，让你可以在 Minecraft 游戏中搜索和播放网易云音乐。

⚠️ 重要提示

本模组需要自建网易云音乐 API 服务器才能正常工作！ 提供一个自建的 https://api-enhanced-plum-five.vercel.app 如果没有配置 API 服务器，模组将无法：

扫码登录
搜索歌曲
播放音乐

请先阅读下方「自建 API 服务器」章节完成配置。

✨ 功能

🔐 扫码登录 - 使用网易云音乐 App 扫码登录
🔍 歌曲搜索 - 搜索你喜欢的歌曲、歌手或专辑
🎵 流式播放 - 高品质音乐流式播放
⏯ 播放控制 - 暂停、继续、停止
🔊 音量调节 - 可配置的默认音量
🌐 中英双语 - 支持中文和英文界面

📦 安装

要求

Minecraft 1.21.1
NeoForge 21.1.x

步骤

从 Releases 下载最新的 ncmplayer-x.x.x.jar
将 JAR 文件放入 .minecraft/mods/ 文件夹
启动游戏

🎮 使用方法

打开播放器: 按 M 键 打开音乐播放器界面
登录: 点击左上角「扫码登录」，用网易云音乐 App 扫码
搜索: 在搜索框输入歌曲名，点击搜索
播放: 点击歌曲列表中的歌曲即可播放

⚙️ 配置

配置文件位于 config/ncmplayer-common.toml:

[music]
# 网易云 API 服务器地址
apiUrl = "http://your-api-server:3000"
# 默认音量 (0.0 ~ 1.0)
defaultVolume = 0.8
# 搜索结果数量限制
searchLimit = 30

🔧 自建 API 服务器

本模组需要网易云音乐 API 服务器。推荐使用：

NeteaseCloudMusicApiEnhanced

📝 更新日志

v1.0.0

🎉 首次发布
扫码登录
歌曲搜索
音乐播放

🔄 开发说明

自动构建触发条件

只有以下文件变化时才会触发自动构建和发布：

src/** - 源代码
build.gradle / settings.gradle - 构建配置
gradle.properties - 版本号等
gradle/** - Gradle Wrapper

跳过构建

在 commit message 中包含以下关键词可跳过构建：

[skip ci]
[ci skip]

示例：

git commit -m "docs: 更新 README [skip ci]"

📄 许可证

MIT License

👨‍💻 作者

SelfAbandonment

⭐ 如果觉得好用，请给个 Star！

NCM Player