# MIDI-MCSTRUCTURE_NEXT

**Repository Path**: mrdxhmagic/midi-mcstructure_next

## Basic Information

- **Project Name**: MIDI-MCSTRUCTURE_NEXT
- **Description**: MIDI音乐转mcstructure或mcfunction，支持新旧Java版和基岩版游戏
- **Primary Language**: Python
- **License**: MIT-0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-15
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MIDI-MCSTRUCTURE_NEXT


![MMS LOGO](Asset/image/logo.png)

#### 介绍
MIDI音乐转为mcstructure、mcfunction或SAPI行为包。

### 特性
1. 支持新旧Java版和基岩版游戏，对各个版本做了语法和音效的适配
2. 支持加载标准.lrc文件或加载MIDI内嵌歌词以在游戏中显示
3. 支持在.mcstructure文件中预添加一些指令或结构
4. 支持压缩游戏指令条数等......

### 编辑指令
指令使用JSON格式存储在程序运行目录/Asset/text/profile.json中，可使用Windows自带的记事本或其他文本编辑器来编辑。

如果一切顺利，你应当看到以下的文件结构：

```
"new_bedrock": {
  "command": {
    "delay": "/execute...",
    "clock": [
      "/execute...",
      "/scoreboard...",
      "/scoreboard..."
    ],
    "address": [
      "/execute..",
      "/scoreboard...",
      "/scoreboard..."
    ],
    "lyrics": [
      "/titleraw...",
      "/titleraw...",
      "/titleraw..."
    ],
    "timer_target_selector": {
      "regular": "MMS_Service={VALUE}",
      "compressed": [
        "MMS_Service=!{VALUE}",
        "{START}..{END}",
        ","
      ]
    }
  }
```
根据游戏版本分为了新旧基岩版和Java版，分别对应new_bedrock/old_bedrock/new_java/old_java，改的时候需要注意版本。

一个版本中，又根据模式分为了命令链延迟、计分板时钟和时钟与编号，分别对应delay/clock/address；此外lyrics指歌词字幕的指令，timer_target_selector指用于计时的计分板选择器。

计分板时钟和时钟与编号模式支持在命令链最后追加若干条指令，除配置文件中对应模式的第一条指令，其他均为追加指令。

一条指令中，使用{SOUND}代表我的世界中的音效ID；  
{POSITION}代表音效播放位置（用于立体声效果）；  
{VOLUME}代表音量（范围0.0 ~ 1）；  
{PITCH}代表音调（会根据游戏版本自动限制）；  
{TIME}在追加指令中指时间全长，单位为一个游戏刻；  
{TTS}在普通模式下为timer_target_selector中regular中的内容，压缩模式下为timer_target_selector中compressed中的内容，{VALUE}指时间。  
另外，歌词字幕中{LAST}指上一条歌词；{REAL_F}指当前歌词中已经唱到的部分，{REAL_S}指当前歌词中还未唱到的部分；{NEXT}指下一条歌词。

### 音色映射
MIDI映射表使用JSON格式存储在程序运行目录/Asset/text/mapping.json中，可使用Windows自带的记事本或其他文本编辑器来编辑。

格式如下：

```
{
  "undefined": "harp",
  "default": "harp",
  "0": "harp",
  "124": "telephone_ring"
  "percussion": {
    "undefined": "cymbal",
    "31": "hat"
  }
}
```
undefined指无法在映射表中找到定义所使用的乐器，default指通道初始乐器；percussion指打击乐器，undefined同上，没有default；其余的为定义某个MIDI乐器，键为文本形式的乐器ID。  
 **值得注意的是，每个键的值并不是对应游戏中的乐器ID，而是对应在profile.json中各个游戏版本中sound_list中的键，若无法在sound_list中找到，则再使用映射表中的undfined去sound_list寻找。**

### 复合音色
在上文提到的sound_list中， 每个MIDI乐器都可以对应不止一个游戏音效，格式如下：

```
"sound_list": {
  "harp": [
    ["note.harp", 0.53, 1.0, 0]
  ],
  "telephone_ring": [
    ["note.bit", 2.0, 1.0, 0],
    ["note.bit", 2.0, 0.5, 50],
    ["note.bit", 2.0, 1.0, 50],
    ["note.bit", 2.0, 0.5, 50],
    ["note.bit", 2.0, 1.0, 50],
    ["note.bit", 2.0, 0.5, 50],
    ["note.bit", 2.0, 1.0, 50],
    ["note.bit", 2.0, 0.5, 50]
  ]
}
```
每个键都对应一个列表（当禁用该乐器时需将列表替换为"disable"），列表内又有若干个列表（也就是一个MIDI乐器可以对应多个音效）。  
列表中，元素依次为游戏音效ID、音量倍率、音调倍率、相对延迟时间（指距离上个音效的时间，单位为ms）。