合成器

合成器

一个音频播放器，可以播放任何声音，比如表情包。

实用

Synth 是一个轻量级的 Hytale 服务器插件，灵感来自《反恐精英》的 sm-saysounds。

它允许玩家通过聊天或指令触发简短的 全局音效，并支持个人音量控制、冷却时间和管理员监管。

设计目标：简单、快速、有趣。

功能

  • 播放全局音效 (!sound, /synth play sound)
  • 聊天触发音效（CS风格）
  • 每位玩家单独控制音量
  • 个人静音 / 管理员静音
  • 内置防刷屏冷却
  • 支持自定义音效 (.ogg)
  • 可选通过 ffmpeg 将 MP3 转换为 OGG

快速开始

  • 安装

    • 将 Synth.jar 放入服务器的 mods/ 文件夹
    • 启动一次服务器（Synth 会自动创建其文件夹）

  • 添加音效

    • 将 .ogg 文件放入: mods/Kirami_Synth/sounds/
    • 然后运行: /synth add [ogg file]
    • 玩家现在可以使用: /synth play 或 !

MP3 支持（可选但强烈推荐）

Synth 不需要 ffmpeg，但强烈建议安装，以防止音效无法播放。
但如果安装了 ffmpeg，Synth 可以自动转换 MP3 文件。

启用 MP3 → OGG 转换

  1. 下载 ffmpeg
    推荐版本（Windows）：
    https://www.ffmpeg.org/download.html

  2. 解压并放置： ffmpeg.exe 放入 mods/Kirami_Synth/tools/

  3. 重启一次服务器
    （Synth 会自动检测 ffmpeg 并更新 config.json）

现在你可以运行：

  • /synth convert sound.mp3
  • /synth play <sound name> 或 !<sound name>

添加音效后无需重启服务器。

重要： 如果播放音效时提示"Sound not found"，快速重启或离开重进服务器即可解决。

支持的指令

玩家指令

  • !<sound> 播放音效
  • /synth play <sound>
  • /synth list
  • /synth volume <1–100>
  • /synth hide <true|false>
  • 新功能 /synth reply <player name> <sound>

管理员指令

  • /synth add <file.ogg> <name>
  • /synth remove <name>
  • /synth mute <player> <seconds>
  • /synth reload
  • /synth enable
  • /synth disable

注意事项

  • 音效最大体积：5 MB
  • 推荐格式：.ogg
  • 音效为全局播放，并尊重客户端音量