[![][Bilibili: 凌云金羿]](https://space.bilibili.com/397369002/)
[![][Bilibili: 诸葛亮与八卦阵]](https://space.bilibili.com/604072474)
[![CodeStyle: black]](https://github.com/psf/black)
[![][python]](https://www.python.org/)
[![][license]](LICENSE)
[![][release]](../../releases)
简体中文🇨🇳 | [English🇬🇧](README_EN.md)
## 介绍🚀
音·创 Musicreater 是一款免费开源的 **《我的世界：基岩版》** 音乐制作软件
音·创 pkgver (Musicreater Package Version) 是一款免费开源的 **《我的世界：基岩版》** 音乐转换库
欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
**此分支为音·创的包版本，即便于其他软件使用的可被import版本**
## 软件作者✒
金羿 Eilles：我的世界基岩版指令师，个人开发者，B站不知名UP主，江西在校高中生。
诸葛亮与八卦阵 bgArray：我的世界基岩版玩家，喜欢编程和音乐，深圳初一学生。
## 软件架构🏢
这是一个简单的Python包
## 使用教程📕
> 0. 安装python3.6+
>
> 在安装时，一定要勾选Add Python 3.X to PATH，不然就要手动设置
>
> 同时，装完之后记得在cmd中输入：python 试试是否安装成功，
> python的安装可以去网上随便找一下。
> 1. 安装（下载本程序）git的话，可以使用以下命令：
>
> `git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git`
>
> 没有安装git的话，可以下载zip包，解压后进入目录即可。
>
> 2. 运行（进入目录）
> 在目录下打开cmd，进入到目录下，执行以下命令：
>
> `pip install mido`
>
> `pip install brotli`
>
> 3. 开始使用！
> 在目录下打开cmd，进入到目录下，执行以下命令：(选择你需要的)
>
> `python example_convert_bdx.py`
>
> `python example_convert_mcpack.py`
### 对于 进度条自定义 功能的说明
因为我们提供了可以自动转换进度条的功能，因此在这里给出进度条自定义参数的详细解释。
一个进度条，明显地，有**固定部分**和**可变部分**来构成。而可变部分又包括了文字和图形两种（当然，《我的世界》里头的进度条，可变的图形也就是那个“条”了）。这一点你需要了解，因为后文中包含了很多这方面的概念需要你了解。
进度条的自定义功能使用一个字符串来定义自己的样式，其中包含众多**标识符**来表示可变部分。
标识符如下（注意大小写）：
| 标识符 | 指定的可变量 |
|---------|----------------|
| `%%N` | 乐曲名(即传入的文件名)|
| `%%s` | 当前计分板值 |
| `%^s` | 计分板最大值 |
| `%%t` | 当前播放时间 |
| `%^t` | 曲目总时长 |
| `%%%` | 当前进度比率 |
| `_` | 用以表示进度条占位|
表示进度条占位的 `_` 是用来标识你的进度条的。也就是可变部分的唯一的图形部分。
**样式定义字符串**的样例如下，这也是默认的进度条的样式：
`▶ %%N [ %%s/%^s %%% __________ %%t|%^t]`
这是单独一行的进度条，当然你也可以制作多行的，如果是一行的，输出时所使用的指令便是 `title`，而如果是多行的话，输出就会用 `titleraw` 作为进度条字幕。
哦对了，上面的只不过是样式定义，同时还需要定义的是可变图形的部分，也就是进度条上那个真正的“条”。
对于这个我们就采用了固定参数的方法，对于一个进度条，无非就是“已经播放过的”和“没播放过的”两种形态，所以，使用一个元组来传入这两个参数就是最简单的了。元组的格式也很简单：`(str: 播放过的部分长啥样, str: 没播放过的部分长啥样)` 。例如，我们默认的进度“条”的定义是这样的：
`('§e=§r', '§7=§r')`
综合起来，把这些参数传给函数需要一个参数整合，你猜用的啥？啊对对对，我用的还是元组！
我们的默认定义参数如下：
`(r'▶ %%N [ %%s/%^s %%% __________ %%t|%^t]',('§e=§r', '§7=§r'))`
*对了！为了避免生成错误，请尽量避免使用标识符作为定义样式字符串的其他部分*
## 致谢🙏
- 感谢 昀梦\