Notematic Player

插件

· 作者 Cayde26

一个 Minecraft 音频播放器插件和 API,可播放从 Notematic Studio 导出的自定义音符盒音乐序列,支持离线同步、多曲目播放以及每位玩家独立的音量设置。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.3 · 26.2 · Bukkit / Paper

一键开服(送7天)

Notematic Player

Notematic Player 是一款 Minecraft Java 版插件,作为 Notematic Studio 的配套玩家端工具。它可以将工作室导出的 .json 或 .mcfunction 格式的自定义音符盒音乐序列直接播放给玩家,或在世界中的特定位置播放。除了标准的音符盒声音外,它还可以直接播放任何游戏内的 /playsound 音频(包括自定义资源包的声音)。

功能特性

  • 自定义音乐播放: 播放自定义的音符盒编排曲目。支持公共和私有文件夹,仅限管理员访问控制。
  • 内置 MIDI 转换器: 使用 /notematic create 命令在游戏内直接下载并转换 MIDI 文件。
  • 每位玩家的独立音量: 每位玩家都可以通过 /notematic volume <val> 调整自己的个人收听音量(按 UUID 保存设置)。
  • 离线同步: 如果玩家断开连接,播放会在虚拟状态下继续计时,并在他们重新加入时恢复同步。
  • 唱片机持久循环: 基于位置的循环播放会在服务器重启或崩溃后保持持久化。
  • Notematic Studio 配套: 直接播放从 Notematic Studio MIDI 转换工具导出的文件。

官方插件

Notematic Vocoder

一款基于 Notematic Player 引擎构建的官方子插件。它使用数字信号处理 (DSP) 来分析文本转语音音频,提取共振峰频率,并将它们动态映射到 Minecraft 的声音系统中,使音符盒能够实时“说话”。

  • 实时游戏内语音: 通过 /<command> <prompt> 使用音符盒大声说话。
  • 6 个八度音域: 智能地将重叠的频率映射到 5 种音符盒乐器(低音、吉他、竖琴、长笛、钟)上,从而绕过 Minecraft 默认的 2 个八度限制。
  • 100% 服务端运行: 玩家无需安装模组或资源包。完全兼容原版客户端。

命令与权限

命令 权限 简短描述
/notematic [help] notematic.use 显示插件信息、状态和命令菜单。
/notematic play <song> [target] [loop] notematic.use
notematic.play.location (用于 at ...)
notematic.play.loop (用于 loop)
为你自己、目标玩家、所有玩家、3D 位置上的特定地点或通过移动收音机播放歌曲。
/notematic stop [#ID | song | player] [at <x> <y> <z>] notematic.use 停止正在进行的播放(通过 ID、歌曲、玩家或坐标)。
/notematic seek <#ID | song | player> <value> notematic.use 在播放中向前、向后跳转或跳转到绝对时间。
/notematic pause [#ID | song | player] [at <x> <y> <z>] notematic.use 暂停正在进行的播放。
/notematic resume [#ID | song | player] [at <x> <y> <z>] notematic.use 恢复暂停的播放。
/notematic volume <value> notematic.use 设置您自己的个人收听舒适音量(0-100%)。
/notematic volume #ID <value> notematic.use 为特定的活跃播放实例设置临时音量倍数。
/notematic volume song <name> <value> notematic.admin 设置歌曲的全局音量倍数(仅限管理员)。
/notematic list notematic.use 列出所有已加载的公共(如果是管理员则包括私有)歌曲(名称可点击以播放)。
/notematic active notematic.use 显示当前正在播放的所有歌曲及其实时状态。
/notematic commands [true | false] notematic.admin 全局切换或设置玩家命令使用情况(仅限管理员)。
/notematic reload notematic.admin 停止所有活跃歌曲并重新加载歌曲文件夹(仅限管理员)。
/notematic create <name> <url> [opts] notematic.create 异步下载并转换 MIDI 文件。
/notematic rename <old> <new> notematic.admin 重命名磁盘上和缓存中的歌曲文件(仅限管理员)。
/notematic admin <action> ... notematic.admin 管理伪管理员(仅限管理员)。
/notematic blacklist <action> ... notematic.admin 管理玩家命令黑名单(仅限管理员)。
查看详细命令说明与示例

Play 命令

开始播放歌曲。播放可以针对你自己、其他玩家、所有在线玩家、物理 3D 位置,或者作为跟随你的便携式收音机。

  • 语法变体:
    • /notematic play <song> — 为自己播放。
    • /notematic play <song> [player] — 为特定玩家播放(需要管理员权限)。
    • /notematic play <song> <@a | * | all> — 为所有在线玩家播放(需要管理员权限)。
    • /notematic play <song> at <x> <y> <z> [radius] [volume] [loop] — 在特定坐标处播放。声音按位置播放。支持相对 ~ 坐标。
    • /notematic play <song> radio [radius] [volume] [loop] — 播放位置音乐,实时跟踪承载玩家的坐标。
  • 示例:
    • /notematic play test_song
    • /notematic play test_song loop (无限循环)
    • /notematic play test_song at ~ ~ ~ 15 50% loop (在你所在位置循环,15 格聆听半径,50% 音量)
    • /notematic play test_song radio 32 (便携式音箱跟随你,32 格聆听半径)

停止命令

停止正在进行的播放。按以下顺序动态解析:

  1. 唯一 ID (#ID): 停止特定实例(例如 /notematic stop #3)。
  2. 歌曲名称: 停止该歌曲的所有活跃播放。
  3. 玩家名称: 停止指定玩家监听的所有播放。
  • 示例:
    • /notematic stop
    • /notematic stop #12
    • /notematic stop test_song
    • /notematic stop at ~ ~ ~ (在当前坐标停止基于位置的播放)

跳转命令

向前、向后或跳转到绝对时间点进行播放定位。

  • 相对跳转: 例如 +10s(前进 10 秒)、-5s(后退 5 秒)、+200t(前进 200 刻)。
  • 绝对跳转: 例如 30s(跳转至 30 秒标记处)、150t(跳转至第 150 刻)。
  • 注意:循环播放使用取模运算进行环绕处理。

音量控制

  • 个人音量 (/notematic volume <val>): 设置舒适的聆听级别。通过 UUID 保存在 player_volumes.yml 中。
  • 实例音量 (/notematic volume #ID <val>): 设置特定播放实例的临时音量倍数。
  • 全局音量 (/notematic volume song <name> <val>): 设置某首歌曲的基础音量级别。存储在 volumes.yml 中。
  • 音量叠加公式: 最终音符音量计算方式为:baseNoteVolume * songVolumeMultiplier * personalPlayerVolume。

MIDI 创建

异步下载并转换 MIDI 文件。默认采用 stitching(拼接)方法和 nolimit(无刻速限制),并将文件保存到公共目录。

  • 选项:
    • stitching(默认):采用拼接方法。绕过 Minecraft 标准的 2 个八度音程限制。当 MIDI 音符过高或过低时,插件会自动切换/拼接乐器声音(如低音、吉他、竖琴、长笛、钟),以覆盖完整的 6 个八度音程范围。
    • standard:遵循 Minecraft 标准的 2 个八度音程限制(超出范围的音符会被钳制)。
    • nolimit(默认):绕过标准红石刻速限制。快节奏歌曲严格按照其 MIDI 速度映射表的速率运行(最高可达游戏引擎 50ms 的刻速限制)。
    • limit:将刻速限制为 100ms(标准红石刻速)。
    • public(默认):将歌曲保存在公共文件夹 (songs/public/) 中,以便服务器上的任何人都可以播放。
    • private:将歌曲保存在私有文件夹 (songs/private/) 中,仅限管理员/Ops 访问。
  • 示例:
    • /notematic create Pirate_Theme https://example.com/song.mid
    • /notematic create oldschool https://example.com/song.mid standard private

查找与托管 MIDI 链接:

  • BitMidi: 在 BitMidi.com 上查找免费 MIDI 文件(例如 https://bitmidi.com/scotsong-mid)。右键点击 Download MIDI 按钮并复制链接地址。
  • Google Drive: 将你的 MIDI 文件上传到 Google Drive 并设置为“任何拥有链接的人均可查看”。复制分享链接(例如 ),并使用直接链接生成器如 [Lonedev's Google Drive Direct Link Generator](https://lonedev6.github.io/gddl/) 获取直接下载链接(例如 )。
  • GitHub: 将你的 MIDI 上传到公共仓库。在 GitHub 上导航到该文件并点击 Raw 按钮(或右键点击)并复制链接,以获取原始 URL。

重命名歌曲

重命名磁盘上的歌曲文件(包括公共和私有目录),并更新所有内存和基本音量映射。(需要管理员权限)。

  • 示例: /notematic rename old_song super_cool_song

伪管理员管理

授予普通玩家 Notematic Player 命令的管理特权,而无需服务器级别的操作员状态 (OP)。(需要真实管理员权限)。

  • 示例: /notematic admin add Cayde26

命令黑名单

阻止特定玩家使用任何 Notematic 命令。黑名单在服务器重启后依然有效。(需要管理员权限)。

  • 示例:
    • /notematic blacklist add Steve
    • /notematic blacklist list (显示所有被拉黑的玩家,并提供可点击的 GUI 以移除他们)

兼容性与平台

Notematic Player 完全在服务端运行,这意味着原版客户端无需安装任何模组即可听到音乐。它原生兼容以下平台上的 1.20.6 和 1.21 - 26.2.x:

  • Paper(推荐)
  • Purpur
  • Spigot
  • Bukkit

音乐文件格式与组织 (.json / .mcfunction)

将音乐文件放置在 plugins/NotematicPlayer/songs/ 目录下。

  • 公共歌曲 (/songs/ 或 /songs/public/): 任何人可以通过 /notematic list 和播放命令访问。
  • 私有歌曲 (/songs/private/): 仅 OP/管理员(或拥有 notematic.admin 权限的玩家)可访问。

JSON 格式

{
  "tempo": 1.0,
  "notes": [
    {
      "instrument": "harp",
      "note": 1.4142,
      "volume": 0.8,
      "when": 0
    },
    {
      "instrument": "bass",
      "note": 0.7071,
      "volume": 0.6,
      "when": 5
    }
  ]
}
  • tempo:速度倍增器(双倍)。1.0 表示正常速度播放。
  • notes:按 when 排序的音符事件数组。
    • instrument:乐器名称(例如 harp, piano, bass, bell, flute, guitar, pling, bit, banjo)。你也可以通过在键名中包含 ., : 或 / 来使用任何游戏内的 /playsound 标识符(例如 minecraft:entity.cow.ambient, minecraft:block.bell.use 或自定义资源包声音)。
    • note:从 0.5 到 2.0 的音高乘数。
    • volume:(可选)特定于音符的音量,范围为 0.0 到 1.0。
    • when:相对于起始时间的刻延迟。

数据包格式

如果你将 .mcfunction 文件放入歌曲文件夹,插件会扫描存储修改以解析 JSON:

data modify storage music sheet set value {"tempo":1,"notes":[{"instrument":"harp","note":1.4142,"when":0}, ...]}
开发者 API 参考

从 Bukkit 的插件管理器中获取插件实例:

import me.cayde26.notematicPlayer.NotematicPlayer;
import org.bukkit.Bukkit;

NotematicPlayer api = (NotematicPlayer) Bukkit.getPluginManager().getPlugin("NotematicPlayer");
if (api != null && api.isEnabled()) {
    // 为一名玩家播放一首歌曲,位置感知且无聊天消息
    api.playSong(player, "mysong", false, true);

    // 停止该玩家的所有活跃播放
    api.stopSong(player);

    // 获取/设置玩家的个人音量乘数
    double playerVol = api.getPlayerVolume(player);
    api.setPlayerVolume(player, 0.85);
}

可用的 API 方法

播放控制

  • boolean playSong(Player player, String songName)
  • boolean playSong(Player player, String songName, boolean showChatMessage)
  • boolean playSong(Player player, String songName, boolean showChatMessage, boolean positional)
  • boolean playSong(Player player, String songName, boolean showChatMessage, boolean positional, String initiator)
  • boolean playSongForAll(String songName)
  • boolean playSongForAll(String songName, boolean showChatMessage)
  • boolean playSongForAll(String songName, boolean showChatMessage, boolean positional)
  • boolean playSongForAll(String songName, boolean showChatMessage, boolean positional, String initiator)
  • void stopSong(Player player)
  • void stopSong(Player player, String songName)
  • void stopAllSongs()
  • void pauseSong(Player player)
  • void pauseSong(Player player, String songName)
  • void resumeSong(Player player)
  • void resumeSong(Player player, String songName)
  • void pauseAllSongs()
  • void resumeAllSongs()

状态与查询

  • boolean isPlaying(Player player)
  • boolean isPaused(Player player)
  • boolean songExists(String songName)
  • List<SongPlayback> getActivePlaybacks()

音量调整

  • double getSongVolume(String songName)
  • boolean setSongVolume(String songName, double multiplier)
  • double getPlayerVolume(Player player)
  • void setPlayerVolume(Player player, double volumeMultiplier)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源