警察帽

关于

PoliceHat 添加了一顶可穿戴的警帽，帽子上有一个永不停歇旋转的发光信标——以及一段在你佩戴时始终伴随你的背景音乐。

这顶帽子作为轻量级头盔使用，可以戴在玩家和人形生物头上，并且只对当前佩戴者播放其专属音乐。一旦脱下帽子、丢弃、死亡、切换世界或断开连接，音乐会立即停止。

客户端和服务器端都需要安装。 在 Fabric 上，还需要 Fabric API。

可在任何整合包中免费使用 —— 无论是公开还是私人的，无需授权。

功能特性

• 佩戴警帽 —— 在头盔槽位装备 policehat:police_hat。
• 旋转信标 —— 帽子顶部的灯光持续旋转，并在黑暗中发光。
• 内置音乐 —— 帽子戴在头上时会循环播放一段背景音乐，一旦取下便立即停止。
• 仅本地播放 —— 你只能听到自己帽子的音乐，不会听到其他佩戴者的声音。
• 适用于人形生物 —— 手持帽子右键点击兼容的生物，即可将其戴在它们头上。
• 支持盔甲架 —— 可将帽子用于展示、建筑、场景或装饰。
• 轻型防护 —— 帽子提供 1 点护甲值，与皮革头盔相同。
• 不可破坏 —— 永远不会损耗耐久度，且堆叠数量为 1。
• 内置十种语言 —— 英语、德语、西班牙语、法语、意大利语、日语、韩语、巴西葡萄牙语、俄语和简体中文。

这顶帽子主要作为装饰物品，而非正经的护甲。

合成配方

在三个黑色羊毛方块上方放置一个红石火把：

 T
WWW

• T = 红石火把
• W = 黑色羊毛

面向整合包作者

无需修改或重新打包模组即可自定义 PoliceHat。其音乐设置位于：

config/policehat-client.properties

该文件会在首次启动时自动生成。

该配置是客户端的。它控制着每个玩家听到的内容，因此应包含在整合包的客户端部分，而不是仅在服务器端。

选项	默认值	功能说明
music.enabled	true	启用或禁用帽子音乐。
music.volume	1.0	控制播放音量，范围为 0.0 到 1.0。
music.pitch	1.0	控制播放速度，范围为 0.5 到 2.0。
music.category	records	选择控制音乐的 Minecraft 音量滑块。
music.loop	true	控制曲目是循环播放还是每次佩戴时仅播放一次。
music.sound	policehat:police_hat_music	选择帽子播放的声音事件。

音量会在玩家自身 Minecraft 声音设置的基础上叠加。

声音类别可以使用以下值：

records
music
master
ambient
players
blocks
hostile
neutral
weather
voice

在支持的新版 Minecraft 中也可使用 ui 类别。

诸如 record、player 和 block 等 Minecraft 风格的单数名称同样被接受。

使用其他声音

这顶帽子可以播放当前安装环境中的任何已注册声音事件。

例如，要使用原版音乐唱片：

music.sound=minecraft:music_disc.pigstep

缺少命名空间时默认使用 minecraft。

你也可以通过资源包添加自己的声音：

assets/mypack/sounds.json
assets/mypack/sounds/siren.ogg

示例 sounds.json：

{
  "siren": {
    "sounds": [
      {
        "name": "mypack:siren",
        "stream": true
      }
    ]
  }
}

然后将配置指向它：

music.sound=mypack:siren

Minecraft 不支持 MP3 文件。自定义音轨必须使用 Ogg Vorbis 格式。

你也可以通过资源包直接覆盖默认音轨来替换：

assets/policehat/sounds/police_hat_music.ogg

若想保留旋转的帽子但完全禁用音乐：

music.enabled=false

配置安全性

无效的设置不会导致模组崩溃。

未知值、格式错误的声音 ID、不支持的声音类别和无效数字都会回退到安全默认值。超出范围的数值会被限制在支持的范围内。

如果配置文件完全无法读取，PoliceHat 会保留已生效的设置，而不会意外重置它们。

该文件也接受小数逗号，因此以下两种写法都有效：

music.volume=0.5
music.volume=0,5

空白值则使用默认值。

重新加载配置

编辑文件后使用以下命令：

/policehat reload

该命令无需重启 Minecraft 即可重新加载客户端配置，并在聊天中报告任何无效设置。

这是一个客户端命令，无需管理员权限，并且在单人游戏和多人游戏中均可使用。

当帽子已被佩戴时更改音乐设置，音轨将以新设置重新开始播放。

资源包与数据包

资源包可以替换帽子的纹理、物品图标、物品模型、翻译和音乐。

常见的资源位置包括：

assets/policehat/textures/entity/police_hat.png
assets/policehat/textures/item/police_hat.png
assets/policehat/models/item/police_hat.json
assets/policehat/lang/en_us.json

帽子的 3D 形状是在代码中定义的，因此资源包可以更改其纹理，但不能更改其几何形状。

合成配方是普通的数据包配方，可以使用数据包、KubeJS、CraftTweaker 或标准加载器的配方事件来替换或移除。

稳定 ID 为：

模组:   policehat
物品:  policehat:police_hat
声音: policehat:police_hat_music

反馈

请在 Discord 上报告任何错误、缺陷或功能建议： https://discord.gg/HTkn94BXmA