天空装饰是由引擎直接绘制太阳、月亮、云的图像,并放入资源包和光影包的功能。不会读取或复制原版的天空图像。声音库用于管理声音事件和声音文件。音源 Actor 会在固定位置发出声音,例如洞穴水滴、瀑布等。
| 内容 | 打开位置 |
|---|
| 天空装饰 | 工具 › 天空装饰 → 下方区域的「天空」面板 |
| 声音库 | 工具 › 声音库 → 下方区域的「声音」面板 |
| 放置音源 | 主工具栏「添加」› 声音 |
| 声音预览 | 主工具栏右侧的扬声器按钮(工具提示「声音预览」) |
两个面板也可以在「窗口」菜单中打开或关闭。
- 打开 工具 › 天空装饰。
- 在「太阳」栏中选择「形状」·「颜色」·「大小」。
- 用同样的方式选择「月亮」·「云」栏。
- 点击「白天」·「夜晚」,可在 F6 游戏画面中查看 13 时 · 23 时的天空。
- 数值会立即保存到项目的
assets/sky.np.json。
- 执行「生成资源包」和「制作光影包」时,天空会一同包含在内。
- 打开 工具 › 声音库。
- 在上方栏中输入新的事件 id 并点击「事件」(例如
noplatea:ambient.cave_drip)。
- 选择事件,用「添加文件…」添加
.ogg 或 .wav。
- 点击播放图标试听。
- 通过主工具栏「添加」› 声音 ›「洞穴水滴」等放置音源。
- 在细节面板中将音源的「事件」改为刚才创建的 id。
- 开启工具栏的「声音预览」,将相机靠近试听。
| 字段 | 可选内容 |
|---|
| 太阳 · 形状 | 保持原版 · 柔和太阳(光晕) · 像素太阳 · 光环太阳 · 星形 · 日食 |
| 太阳 · 颜色 | 暖白 · 金色 · 晚霞橙 · 冷白 · 玫瑰色 |
| 太阳 · 大小 / 光晕 / 种子 | 0.51.5 / 01 / 图案种子 |
| 太阳 · 用着色器绘制 | 开启后由光影包直接绘制此形状。关闭则使用资源包中的太阳图像。 |
| 月亮 · 形状 | 保持原版 · 环形山月亮 · 像素月亮 · 弯月图案 · 光晕月亮 |
| 月亮 · 颜色 | 默认(银色) · 血红 · 蓝月 |
| 月亮 · 预览月相 | 在 F6 中显示的月相(满月 ~ 盈凸月,共 8 种)。在游戏中会随日期变化。 |
| 云 · 形状 | 保持原版 · 积云 · 卷云(条纹) · 碎云(稀疏) · 无云 |
| 云 · 云量 / 云团大小 | 0.050.9 / 0.52 |
| 云 · 着色器云层 | 光影包在天空中绘制 2D 云层,并隐藏原版云。需同时设置「高度 (着色器)」·「流动 (着色器)」。 |
| 云 · 立体云(光影) | 将着色器云层改为立体云。「厚度(立体)」·「质量(立体)」(0 低 · 1 中 · 2 高) |
| 图像尺寸 · 太阳·月亮 | ×1 (32×32) · ×2 (64×64) · ×4 (128×128) |
| 图像尺寸 · 云图 | ×1 (256×256) · ×2 · ×4 (1024×1024,资源包自检会发出警告) |
| 包括旧路径 | 同时放入旧版客户端使用的图像路径。 |
| 「恢复原版」 | 将所有字段恢复为保持原版。不在资源包中放入天空图像。 |
- 种子相同则图像相同。更改种子后图案会变化。
- 月亮颜色(血红 · 蓝月)即使关闭「用着色器绘制」,也会由着色器叠乘。
自 0.9.7 起:新增「立体云(光影)」。游戏光影包与 F6 天空以相同的计算进行绘制。
| 类型 | 在哪里听到 | 生成的内容 |
|---|
新事件(<ns>:…) | 由服务器(插件 · 音源)播放时 | 资源包 assets/<ns>/sounds.json + ogg |
替换原版(minecraft:…) | 所有地方(仅靠资源包) | 资源包 assets/minecraft/sounds.json "replace": true |
| 事件字段 | 含义 |
|---|
| 字幕 | 字幕翻译键或文字。留空则没有字幕。 |
| 文件 (assets/sounds) | 事件使用的文件列表。有多个时随机播放其中一个。 |
| 音量 · 音调 · 权重 | 每个文件的音量、音调和被选中的比例。 |
| 长音频 | 背景音乐、长循环请开启。Minecraft 会分段读取。 |
| 状态 | 文件不存在或格式错误时显示。 |
| 按钮 | 动作 |
|---|
| 「事件」 | 以上方栏中的 id 创建或选择事件。 |
| 「替换原版」 | 从列表中选择要替换的原版声音 id。 |
| 「生成初始声音」 | 将引擎直接合成的声音(洞穴水滴 · 溪流 · 瀑布 · 营火 · 风 · 洞穴回响 · 风铃 · 石头/木头/水晶方块)作为 np:… 事件加入。已有的事件会跳过。 |
| 「添加文件…」 | 将 .ogg · .wav 加入事件。.wav 会转换为 Ogg。 |
| 「转为单声道」复选框(默认开启) | 将有位置的(3D)声音转换为单声道后加入。 |
| 播放图标 | 播放一次事件(按权重随机选择文件)。 |
| 移除图标 · 删除图标 | 从事件中移除所选文件 · 从注册表中删除事件。 |
| 刷新图标 | 重新读取 assets/sounds.np.json。 |
- 文件会复制到
assets/sounds/<ns>/<路径>.ogg。已有同名文件时,会附加 _v2 · _v3,不会覆盖。
- 删除事件或移除文件时,不会删除磁盘上的声音文件。
- 有位置的声音必须是单声道,才会随距离变小。立体声与距离无关,会原样传入耳中。
- 用配方和种子逐个合成声音的功能,位于 AI 连接的
sound_generate 工具中(AI 连接 (MCP))。
自定义方块以音符盒状态制作,客户端声音是固定的。因此由服务器插件代为播放声音。
| 字段 | 含义 |
|---|
| 破坏 · 放置 · 行走 · 敲击 · 摔落 | 每个方块在这五个时刻播放的事件 id。留空则为默认声音。 |
| 从已注册事件中选择 | 从库的事件列表中选择。 |
导出服务器注册表时,方块声音会作为 <名称>_sounds_server_vN.json 中的 block_sounds 导出。
| 「添加」› 声音 | 默认 |
|---|
| 洞穴水滴 | 每个间隔一次 |
| 瀑布·流水 | 持续循环 |
| 营火噼啪 | 每个间隔一次 |
| 风 | 持续循环 |
| 空音源 | 无事件 |
| 细节字段 | 含义 |
|---|
| 事件 | 要播放的声音事件 id。可用右侧按钮从库 · 原版建议中选择。 |
| 中心 | 发出声音的位置(方块坐标)。用「移到鼠标下方」移动。 |
| 可听距离 | 在此距离(方块)处声音变为 0。 |
| 方式 | 每个间隔一次 (random) · 持续循环 (loop) |
| 间隔 (秒) | 在最小 ~ 最大之间随机等待(random 方式)。 |
| 音量 · 音调 | 音量和音调(0.5~2,在最小 ~ 最大之间随机)。 |
| 时段 | 始终 · 仅白天 · 仅夜晚(白天 = 06~18 时) |
| 仅地下 | 只在上方被遮挡的地方(洞穴)播放。 |
- 在游戏中,服务器插件读取
sounds_server.json 的 sound_emitters,按此位置和周期播放。
- 在编辑器中开启「声音预览」后,可以听到相机 64 格以内的音源。运行中始终开启。
- 将内容浏览器中的「声音」项目拖到视口上,也会生成音源。
| 设置 | 位置 | 含义 |
|---|
| 声音预览 | 主工具栏 | 开启/关闭(默认关闭) |
| 总音量 | 主工具栏扬声器旁的滑块 | 预览总音量(默认 0.8) |
此功能没有专门的快捷键。细节面板中的「相机对准 (F)」会将相机移到所选音源。
- 编辑器中不包含原版声音文件。原版事件如果不添加文件,在编辑器中听不到。
- 替换原版事件如果没有文件,游戏中该声音将不会播放(静音)。
- 声音和天空只包含在完整资源包中。片段方式只会发出警告。
- 天空图像是用我们自己的公式绘制的,可以直接分发。
- 超过 10 秒的声音请开启「长音频」。