音色包管理器

Extended Note Block 的音色包本质上是标准的 Minecraft 资源包，这使得它们易于分享和安装。模组提供了一个内置的管理器来简化创建和切换过程。

打开管理器

• 在游戏设置页面中，找到并打开 音色包...。

核心功能

1. 浏览与激活

• 管理器会列出 resourcepacks 目录下所有识别到的 Extended Note Block 音色包。
• 选中一个音色包即可将其激活。这实际上是将该资源包在 Minecraft 的资源包列表中置顶启用。

2. 创建新音色包

• 点击“新建”按钮，输入名称，模组会在 .minecraft/resourcepacks/ 下自动创建一个新的文件夹结构。
• 自动生成的文件包括 pack.mcmeta (资源包元数据) 和 pack.json (音色包配置文件)。

3. 编辑与刷新

• 你可以直接作为普通文件夹打开音色包进行编辑。
• 修改文件后，在游戏内点击 “刷新”，模组会重新扫描目录，更新 sounds.json 并重载资源，无需重启游戏。

制作音色包指南

如果你想手动制作或修改音色包，请遵循以下规范：

目录位置

所有音色包都位于标准资源包目录： .minecraft/resourcepacks/

文件结构

一个标准的音色包结构如下：

MySoundPack/
├── pack.mcmeta          # (必须) 标准 Minecraft 资源包元数据
├── pack.json            # (必须) Extended Note Block 专用配置
└── assets
    └── extendednoteblock
        ├── sounds.json  # (自动生成) 定义声音事件，通常由模组自动维护
        └── sounds
            └── notes    # (核心) 放置音频文件的地方

音频文件规范

1. 格式: 必须是 .ogg 格式 (Vorbis 编码)。不支持 .wav 或 .mp3。
2. 命名: 文件名必须遵循 乐器ID.音符ID.ogg 的格式。
   • 乐器ID: 对应模组内的乐器编号 (例如 0 是竖琴/钢琴)。
   • 音符ID: MIDI 音高编号 (0-127)。
   • 示例: 0.60.ogg 代表乐器 0 (钢琴) 的中央 C 音符。

配置文件 (pack.json)

这是模组识别音色包的关键文件。

{
  "displayName": "我的音色包",
  "available_instruments": {
    "0": [54, 60, 66, 72],  // 乐器0拥有的采样音高列表
    "1": [60]
  }
}

注意：通常你只需要放入音频文件并点击“刷新”，模组会自动更新这个文件。

为什么使用音色包？

• 无限扩展: 只要按照命名规则放入采样，你可以在游戏里演奏任何真实乐器的声音。
• 智能映射: 你不需要为每个音高都录制采样。模组会自动将未录制的音符映射到最近的可用采样上，并调整音调播放。
• 高兼容性: 既然是标准资源包，你可以像分发普通材质包一样分发你的音色包。