音频合成器

音频合成器

这个模组添加了一个音频合成器方块。

工具

Audio Synth - 声音合成器模块

Modrinth Version

Audio Synth 是一个 Minecraft Forge 模组,添加了一个能够合成并播放多种波形的自定义方块——声音合成器。它支持正弦波、方波、三角波、锯齿波和白噪声,具备频率调制、混合输出、独立音量控制、红石激活、基于距离的衰减以及简单的 GUI 配置界面。全局音量可通过模组的配置界面调整,每个方块也可以拥有独立的音量增益设置。


✨ 特性

  • 🎵 多种波形:正弦波、方波、三角波、锯齿波、白噪声
  • 🎛 频率调制:支持 FM 合成,可调节调制深度和调制频率
  • 🔀 混合输出:可调节的混合系数(预留用于扩展;当前版本使用单一波形)
  • 🔊 独立音量控制:每个方块的独立音量增益调节(-60dB ~ +60dB)
  • 📏 范围衰减:可配置的声音传播范围(以方块为单位);超出范围后静音,并随距离增加而音量衰减
  • 🔴 红石激活:接收到红石信号时开始播放,信号消失时停止
  • 🖥 GUI 配置:右键点击方块打开配置界面,可实时调整参数,点击“应用”保存并关闭
  • ⚙️ 全局音量:通过模组配置界面(Mods → Audio Synth → Config)调整所有方块的全局音量倍率
  • 🧩 条件配方:根据是否安装 Create 模组及其版本,自动适配三种不同的合成配方
  • 🧵 线程安全:音频播放在独立线程上运行,支持多个方块同时发声

📦 依赖

  • Minecraft Forge 47.4.4+(适用于 1.20.1)
  • Create 模组(可选):如果已安装,配方会根据其版本自动调整

注意:全局音量配置界面需要 Forge 的 Mods 菜单支持;无需额外模组。


🔧 安装

  1. 安装 Minecraft Forge 1.20.1。
  2. 下载本模组的 .jar 文件并放入 mods 文件夹。
  3. (可选)如需使用 Create 模组的配方,请安装对应版本的 Create 模组。
  4. 启动游戏。

🎮 使用指南

获取方块

  • 按照配方合成声音合成器(见下文)。

放置与激活

  • 放置后,右键点击打开 GUI 并配置参数。
  • 施加红石信号(例如拉杆、红石粉)以开始播放。
  • 移除红石信号即停止播放。

GUI 参数

参数 描述 范围
频率 (Hz) 基础频率 20 ~ 2000
波形 选择波形类型 正弦波/方波/三角波/锯齿波/噪声
混合系数 预留(当前固定为 0.5) 0.0 ~ 1.0
调制深度 频率调制深度 0.0 ~ 1.0
调制频率 (Hz) 调制频率 0.1 ~ 20
范围(方块) 声音传播范围 1 ~ 64
音量 (dB) 每个方块的独立音量增益 -60 ~ +60

全局音量配置

  • 从主菜单点击 Mods → 选择 Audio Synth → 点击 Config。
  • 使用滑块调整全局音量倍率(0.0 ~ 2.0),点击“完成”保存。

🔨 合成配方

配方会根据是否安装 Create 模组及其版本自动适配。

情况 1:Create 版本 ≥ 6.0

  • 配方类型:无序合成
  • 材料:
    • 1 × 黄铜机壳(create:brass_casing)
    • 1 × 音符盒(minecraft:note_block)
    • 1 × 脉冲定时器(create:pulse_timer)
    • 1 × 电子管(create:electron_tube)

情况 2:Create 版本 ≥ 0.5 且 < 6.0

  • 配方类型:无序合成
  • 材料:
    • 1 × 黄铜机壳(create:brass_casing)
    • 1 × 音符盒(minecraft:note_block)
    • 1 × 电子管(create:electron_tube)
    • 1 × 脉冲延长器(create:pulse_extender)
    • 2 × 脉冲中继器(create:pulse_repeater)

情况 3:未安装 Create 或版本 < 0.5

  • 配方类型:有序合成(3×3)
  • 图案:
    G C G
    R N R
    G C G
    
  • 材料:
    • G = 金锭(minecraft:gold_ingot)
    • R = 红石中继器(minecraft:repeater)
    • N = 音符盒(minecraft:note_block)
    • C = 红石比较器(minecraft:comparator)
  • 产出:1 × 声音合成器

游戏会自动检测环境并加载正确的配方。JEI 等模组会显示对应的配方。


⚙️ 配置文件

客户端配置文件位于 .minecraft/config/audiosynth-client.toml:

[Audio Settings]
    # Global volume multiplier for all sound generator blocks (0.0 - 2.0)
    globalVolume = 1.0

可以通过 Mods 菜单中的 Config 按钮修改,或直接编辑该文件。


🧪 开发信息

  • 模组 ID:audiosynth
  • 主类:top.hibermod.audiosynth.AudioSynth
  • MCP 映射:official 1.20.1
  • Forge 版本:47.4.4

构建

使用 Gradle 构建:

./gradlew build

输出文件位于 build/libs/。


📄 许可证

本项目基于 MIT 许可证开源。详见 LICENSE 文件。


🙏 致谢

  • 感谢 Forge 团队提供的模组开发框架
  • 感谢 Create 模组提供的优秀机械组件
  • 感谢所有使用和测试本模组的玩家

📮 反馈与支持

如有问题或建议,请在项目的 GitHub Issues 页面提交。


享受你的声音实验吧! 🎶