狐狸小憩

这是什么？

FoxNap 是一个简单的“原版增强”模组，用于向 Minecraft 中添加自定义音乐唱片。

• 与仅使用资源包所能实现的效果不同，通过 FoxNap 添加的音乐唱片不会覆盖原版音乐唱片。
• 与其他类似模组不同，FoxNap 允许你：
  • 随意添加任意数量的音乐唱片
  • 添加_任何_你想要的音乐
  • 在同一个服务器上使用与其他人_不同_的音乐
  • 通过一种新的村民职业在生存模式中获得所有音乐唱片（计划中会添加用于修改苦力怕/宝藏战利品表的实用工具）

FoxNap 还添加了自定义乐器，你可以像使用山羊角一样演奏它们，让你拥有编排“现场音乐”表演的创作自由。

安装与自定义

此模组预置了七张新的音乐唱片：

1. “Colors”，作者 Tobu
2. 卡米尔·圣-桑：由 Kevin MacLeod 演奏的《骷髅之舞》

• 由 PM Music 演奏的来自 Lud and Schlatts Musical Emporium 的四首曲目

  1. 理查德·施特劳斯：选自《查拉图斯特拉如是说》的主题曲
  2. 彼得·伊里奇·柴可夫斯基：选自《罗密欧与朱丽叶》的爱情主题曲
  3. 安东尼奥·维瓦尔第：选自《四季》的“冬”
  4. 理查德·瓦格纳：《女武神的骑行》

1. 尼古拉·里姆斯基-科萨科夫：选自《萨尔丹沙皇的故事》的“野蜂飞舞”，由美国陆军乐队演奏

所有这些曲目均根据此处规定的宽松许可条款进行再分发（我通过此仓库和模组在兼容的知识共享署名-相同方式共享 4.0 许可下重新分发它们）。

如果这个内置播放列表正合你意，并且你不想添加任何其他内容，那么恭喜你！这很简单！这是一个 Fabric 模组，支持 1.19+ 版本，仅依赖 Fabric API，只需将对应版本下载到你的实例的 mods 文件夹中，启动游戏，然后去寻找村庄吧。

但如果你对自定义感兴趣，请继续阅读：

资源包生成器

如果手动转换 mp3 和手工编辑 JSON 不是你认为的乐趣所在，本项目提供了一种替代方案，即一个独立且便携的资源包生成器。

安装

1. 从发布页面下载与你操作系统和模组版本匹配的可执行文件。
2. 根据你的操作系统和安全设置，你可能需要显式地将资源包生成器设置为可执行文件（在 *nix 系统上，你可以通过终端运行 chmod u+x /path/to/FoxNapRPG 或进入大多数文件管理器中的属性设置来完成）。

生成资源包和数据包

将生成器可执行文件放在一个空文件夹中，然后将你想要转换为唱片的任何音乐移动到此文件夹中。你可以包含的曲目数量没有限制，并且它们不需要预先转换为 Ogg 格式。唯一的要求是文件必须能被 ffmpeg 解码。

专业提示： 如果你的音乐文件包含元数据，标题和艺术家名称将被自动提取，任何专辑封面图也将被用于帮助生成音乐唱片纹理。

当你准备好后，只需双击 FoxNapRPG 可执行文件。可能会弹出一个终端窗口显示资源包创建的进度，很快你就应该在当前目录中看到一些新文件：

• FoxNapRP.zip 是包含所有转换歌曲和音乐唱片纹理的资源包，你可以将其放入你的 Minecraft resourcepacks 文件夹中
• FoxNapDP.zip 是定义曲目本身所有属性的数据包。你需要将此包放入任何你想使用你的音乐的世界中的 datapacks 文件夹（参见下方关于多人游戏的说明）。
• foxnap.yaml 需要放入你的 Minecraft config 文件夹。这告诉游戏要为你启用多少张音乐唱片。

高级选项：命令行选项

你也可以从命令行运行生成器，这将使你可以访问许多额外的自定义选项，例如设置搜索音乐的目录或生成资源包和模组配置的保存位置。

有关更多详细信息，请在你保存生成器可执行文件的文件夹中运行：

$ ./FoxNapRPG --help

多人游戏呢？

在服务器上游戏时，是服务器的数据包和配置文件决定：

• 每首歌播放的时间长度
• 播放每张唱片的唱片机输出的红石信号强度
• Maestro 可提供的曲目数量

但是每个玩家的资源包和配置文件将控制：

• 每张唱片将播放的歌曲
• 每张唱片的外观（和描述）
• 哪些唱片会显示为“占位”唱片

明确地说：

• 如果服务器指定了比你配置中更多的唱片数量，一些唱片会以占位纹理和声音文件的形式显示给你
• 如果你的资源包中的唱片数量多于服务器设置，并非所有曲目都将在你的共享游戏中可用
• 一些音乐唱片可能在歌曲结束后继续静音播放，有些可能会被截断

然而，除了唱片数量之外，没有理由不能让每个玩家带着长度相似的完全自定义歌曲播放列表上线！

获取唱片 及更多内容！

那么既然你已将自定义唱片注册到游戏中，实际上如何获取它们呢？除了指令（例如 /give @s foxnap:track_1）和创造模式之外，获取 FoxNap 唱片的唯一方法是通过与_The Maestro_交易，他是一位拥有唱片机作为工作站点的新村民（注意 The Maestro 目前不会自然生成，但此功能已在计划中）。

The Maestro 会为音木板——稀有木材类型的去皮方块、山羊角和非 FoxNap 唱片支付高价，并出售各种可演奏的乐器（其纹理采用自经典的 mxTune 模组）以及你的自定义音乐唱片。

禁用 The Maestro

如果你不希望将 The Maestro 添加到你的游戏中（并希望通过其他方式（例如数据包）获取你的音乐唱片），你可以编辑你的 foxnap.yaml 配置文件 并添加以下行来禁用此部分功能：

enable_maestro: false

原版 Fox Nap

随着 Minecraft 1.21 的发布，音乐唱片现在完全由数据驱动！因此，由 Fox Nap 资源包生成器生成的资源包和数据包与原版游戏完全兼容。详细信息可以在wiki上找到。

贡献

发现错误？有建议或问题？想要贡献新功能或增强功能？开启一个 issue！

许可与致谢

本仓库中的所有代码均根据 GPLv3 许可。

FoxNap 资源包生成器（FoxNapRPG）的构建包含 ffmpeg 的二进制文件，这些文件根据 GNU 宽通用公共许可证 (LGPL) 2.1 版 或更高版本许可，并包含根据 GNU 通用公共许可证 (GPL) 2 版 或更高版本许可的组件。

除非另有说明，本仓库中的所有资源均根据 知识共享署名-相同方式共享 4.0 许可 分发。

乐器图标取自 @AeronicaMC 的模组 mxTune。

乐器声音由 Philharmonia 的声音采样库提供。

非常感谢 @FoundationGames 使其出色的 Sandwichable 模组代码易于理解和学习，同样也感谢 Modding by Kaupenjoe 提供的出色且详细的 Minecraft 模组开发教程，在这里特别是他关于添加自定义村民职业的教程。

此外还要感谢 @Siphalor 和 Reddit 的 jSdCool 关于此对话中向 Fabric 模组添加非模组外部库的讨论。向模组中添加 SnakeYAML 库本不应该这么困难。