# MoreHeadSounds
 
**作者:** thojo0 & PYZR
## 描述
MoreHeadSounds 是一个 Minecraft 插件，通过允许将自定义声音与玩家头颅和音符方块关联起来，增强游戏体验。该插件提供了一种独特的方式来自定义 Minecraft 世界中的声音，为玩家互动和事件增加了个性化和趣味性。
## 特性
- **玩家头颅的自定义声音：** 将特定声音分配给玩家头颅，这些声音可以在与音符方块交互时触发。
- **动态声音配置：** 使用配置文件轻松配置哪些声音应包含或排除用于特定玩家头颅。
- **易于管理的命令：**
- **/moreheadsounds config:** 允许更改配置。
- **/moreheadsounds clearItem:** 清除玩家头颅中自定义的声音。
- **/moreheadsounds getHash:** 获取您手持或正在查看的玩家头颅的纹理哈希值，用于调试和配置。
- **制表符自动完成：** 为命令和坐标提供便捷的制表符自动完成，使使用插件的特性更容易。
## 命令和权限
- **/moreheadsounds config reload**
- **权限:** `moreheadsounds.config`
- **描述:** 重新加载插件配置。
- **/moreheadsounds config list [page]**
- **权限:** `moreheadsounds.config`
- **描述:** 列出所有配置的头颅哈希值。
- **/moreheadsounds config include **
- **权限:** `moreheadsounds.config`
- **描述:** 将声音添加到手持头颅的包含列表。
- **/moreheadsounds config exclude **
- **权限:** `moreheadsounds.config`
- **描述:** 将声音添加到手持头颅的排除列表。
- **/moreheadsounds config remove **
- **权限:** `moreheadsounds.config`
- **描述:** 从手持头颅的配置中删除声音。
- **/moreheadsounds config show**
- **权限:** `moreheadsounds.config`
- **描述:** 显示手持头颅的配置，包括当前声音的预览。
- **/moreheadsounds clearItem**
- **权限:** `moreheadsounds.clearItem`
- **描述:** 清除您主手中玩家头颅的自定义声音。
- **/moreheadsounds getHash**
- **权限:** `moreheadsounds.getHash`
- **描述:** 获取您手持或正在查看的玩家头颅的纹理哈希值，用于调试和配置。
## 配置
插件的配置文件 (`config.yml`) 允许服务器管理员指定哪些声音应包含或排除用于特定玩家头颅。 这使得可以对 Minecraft 世界中玩家头颅的自定义声音进行微调控制。
配置基于玩家头颅的纹理哈希值。对于每个哈希值，您可以为声音指定 `include` 和 `exclude` 列表。条目必须是有效的命名空间标识符。
- **`include`**: 与头颅关联的声音或声音类别列表。
- **`exclude`**: 要排除的声音或声音类别的列表。
您可以指定单个声音（例如，`entity.creeper.primed`）包括纹理包中的自定义声音，或通过以点结尾来指定整个声音类别（例如，`entity.creeper.`）。
处理顺序如下：
1. `include` 列表中的所有类别的声音都会被添加。
2. `exclude` 列表中的所有类别的声音都会被移除。
3. `include` 列表中的所有单个声音都会被添加。
4. `exclude` 列表中的所有单个声音都会被移除。
**示例：**
```yml
e50294a1747310f104124c6373cc639b712baa57b7d926297b645188b7bb9ab9:
include:
- entity.allay.
a3c34722ac64496c9b84d0c54019daae6185d6094990133ad6810eea3d24067a:
include:
- entity.parrot.
exclude:
- entity.parrot.imitate.
```
## 安装
1. 下载 MoreHeadSounds 插件的 jar 文件。
2. 将 jar 文件放在服务器的 `plugins` 目录中。
3. 启动或重新启动您的服务器。
4. 插件将在 `plugins/MoreHeadSounds` 目录中创建一个默认配置文件。
5. 根据需要编辑配置文件来自定义玩家头颅的声音。
6. 使用 `/moreheadsounds config reload` 命令应用对配置文件所做的任何更改。
## 使用
- 手持一个玩家头颅，并使用 `/moreheadsounds clearItem` 命令删除其中任何自定义声音。
- 使用 `/moreheadsounds getHash` 命令获取玩家头颅的纹理哈希值，该哈希值可以用于配置文件中。
- 在音符方块和玩家头颅上方放置一个音符方块，以在与音符方块交互时触发自定义声音。
## 支持
如需支持及更多信息，请访问插件的官方页面或联系作者。