跳到正文

Minefy

在唱片机上播放 Spotify 曲目。由服务端控制,并提供原版备用方案;未安装模组的客户端也能安全游玩,兼容单人游戏。

收藏

截图

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

Minefy

在 Minecraft 唱片机上播放 Spotify 曲目。Minefy 是一款由服务器权威控制的 Fabric 模组:所有曲目状态都由服务器管理,服务器会验证每次提交,并决定每位玩家听到的内容。安装模组的玩家可以使用网址输入界面、接收同步的播放状态、通过位置音频钩子播放声音,还能看到带专辑封面的唱片贴图。未安装模组的玩家会听到根据曲目 ID 确定性选择的原版唱片音效作为回退,因此未安装模组的客户端也能正常连接和游玩,不会崩溃或被踢出。模组支持单人游戏(通过集成服务器)和专用服务器。

模组功能

  • 手持空手右键点击空唱片机,即可打开文本输入界面,粘贴 Spotify 曲目或专辑的链接、URI 或 ID(需要安装模组的客户端)。曲目会解析为真实歌名、艺人和封面图,并储存在服务器端的对应唱片机中。手持空手右键点击正在播放 Minefy 曲目的唱片机,则会停止播放并弹出 Minefy 唱片。
  • 粘贴带有 /minefy create 的专辑链接,会为专辑中的每首歌各生成一张唱片,并以真实歌名命名。启用空白唱片需求后,每首歌都会消耗一张原版唱片;如果唱片数量不足,系统会准确告知你还缺几张。
  • 每张 Minefy 唱片都会使用从封面图提取的歌曲主色,因此一眼就能认出来。唱片物品名会显示真实歌名,提示信息中则会显示艺人信息。
  • 分配了 Minefy 曲目后,安装模组的客户端会收到播放同步数据包,并在唱片机所在位置播放位置音频。其他玩家会听到根据曲目 ID 确定性选择的原版唱片回退音效,因此每首曲目都有对应的音效。
  • 手持空手右键点击正在播放的唱片机,即可停止播放并弹出 Minefy 唱片物品。唱片会携带曲目数据,物品名显示歌名,提示信息中显示艺人信息。
  • 可以通过命令创建唱片,无需合成;也可以选择要求消耗背包中的原版唱片。
  • 所有网络通信都受到保护:自定义数据包只会发送给已声明 Minefy 通道的玩家。原版客户端绝不会收到无法识别的数据包。

需求与安装

  1. 为你的 Minecraft 版本安装 Fabric Loader 0.19.5 或更高版本。
  2. 为相同版本的 Minecraft 安装 Fabric API(每个下载页面都会将其标记为必需前置)。
  3. 使用正确的 Java 版本:1.21 版本需要 Java 21,26.x 版本需要 Java 25。
  4. 下载与你的 Minecraft 版本匹配的 Minefy 文件,并放入 mods 文件夹。
  5. 服务器需要安装相同的文件。客户端并非必须安装此模组,但只有安装了模组的客户端才能使用网址输入界面、接收同步状态和显示专辑封面。
  6. 单人游戏只需将模组(以及 Fabric API)放入 mods,然后打开任意地图即可。集成服务器会自动处理服务端部分。

| Minefy 文件 | Minecraft | 加载器 | Java |
|—|—|—|—|
| minefy-1.0.0+1.21.jar | 1.21 – 1.21.11 | Fabric | 21+ |
| minefy-1.0.0+26.1.jar | 26.1 – 26.1.2 | Fabric | 25+ |
| minefy-1.0.0+26.2.jar | 26.2 | Fabric | 25+ |
| minefy-1.0.0+26.3.jar | 26.3 | Fabric | 25+ |

单曲的 Spotify 元数据无需额外配置即可通过免密钥查询获取。若要获取完整的专辑曲目列表和更丰富的元数据,可以在配置中添加 Spotify API 凭据(参见下方的 spotifyClientId):在 Spotify 开发者后台创建免费应用,并将其 client id 和 secret 填入 minefy-server.json(secret 也可以通过 SPOTIFY_CLIENT_SECRET 环境变量提供)。即使没有凭据,单曲仍可解析出真实名称;专辑链接则会说明缺少什么。

关于 Spotify 音频的说明:曲目元数据、同步、回退音效和专辑封面获取功能均已完整实现。Spotify 音频流的实际解码仍需接入其他组件(需要 Spotify API 凭据和流媒体 SDK):安装模组的客户端会通过提供的处理器钩子播放位置音频;在接入流媒体后端之前,所有人都会听到原版回退音效。

配置

服务器配置文件:config/minefy-server.json(首次运行时会以默认值创建)。

| 键 | 默认值 | 说明 |
|—|—|—|
| requireBlankDiscInInventory | false | 设为 true 时,/minefy create 会消耗背包中的一张原版唱片。设为 false(默认值)时,直接发放 Minefy 唱片。 |
| fallbackVolume | 1.0 | 未安装模组的客户端听到的原版唱片回退音效音量。 |
| maxTrackUrlLength | 512 | 提交的 Spotify 链接或曲目 ID 所允许的最大长度。 |
| enableSpotifyStreaming | true | 安装模组的客户端 Spotify 音频流播放总开关。 |
| maxDistance | 24.0 – 64.0 | 客户端距离衰减的可听范围(方块数);具体默认值取决于 Minecraft 版本。 |
| enableFallbackForUnmodded / fallbackForUnmodded | true | 设为 false 时,不会为未安装模组的客户端播放原版回退音效。 |
| enrichViaOEmbed | true | 通过 Spotify 公共 oEmbed 接口补充曲目名称和艺人信息(无需 API 密钥)。 |
| defaultVolume | 0.8 | 安装模组的客户端播放 Spotify 音频时的基础音量。 |
| spotifyClientId | (empty) | 可选的 Spotify 应用 client ID。启用后可通过 Spotify Web API 查询完整曲目和专辑信息。 |
| spotifyClientSecret | (empty) | 可选的 Spotify 应用 client secret(也可以通过 SPOTIFY_CLIENT_SECRET 环境变量提供)。专辑链接需要同时提供 client ID 和此项。请勿分享此值。 |

并非每个 Minecraft 版本的构建都包含所有配置项;缺少的配置项会使用上面注明的默认值。

命令

所有玩家均可使用这些命令(权限等级 0)。

| 命令 | 说明 |
|—|—|
| /minefy create | 创建以真实歌名命名的 Minefy 唱片。曲目链接会生成一张唱片;专辑链接会为每首歌生成一张唱片(如果 requireBlankDiscInInventory 为 true,则每首歌消耗一张原版唱片;数量不足时会告知你具体还缺几张)。如果背包已满,唱片会掉在你的脚边。 |
| /minefy play | 立即在你注视的唱片机上开始播放(距离需在 8 格以内),并使用真实歌名。专辑链接会播放第一首曲目,并以专辑名命名。 |
| /minefy stop | 停止你注视的唱片机上的播放(适用于 26.1 和 26.3 版本)。 |

支持的曲目格式:https://open.spotify.com/track/<id> 和 .../album/<id> 链接(忽略查询参数)、spotify:track:... 和 spotify:album:... URI,以及原始曲目 ID。

兼容性说明

  • 客户端:可选。未安装模组的客户端可以正常连接,并听到原版唱片回退音效。
  • 服务器:必需。服务器(或单人游戏的集成服务器)必须安装此模组,Minefy 功能才能运行。
  • 单人游戏:完全支持。将模组和 Fabric API 安装到 mods,然后进入任意地图即可。

常见问题

Minefy 支持哪些 Minecraft 版本?

Minefy 支持 Minecraft Java 版 1.21–26.3,共 17 个版本,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。

Minefy 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:客户端 / 服务端。

评论

登录后评论和评分

Fabric Server Essentials 的其他作品

查看全部 →