mirror of
https://github.com/TriM-Organization/Musicreater.git
synced 2025-09-05 20:06:23 +00:00
Merge branch 'pkgver' of https://gitee.com/TriM-Organization/Musicreater
This commit is contained in:
123
README_EN.md
123
README_EN.md
@ -17,121 +17,52 @@
|
||||
[![][license]](LICENSE)
|
||||
[![][release]](../../releases)
|
||||
|
||||
[简体中文](README.md) | English
|
||||
[简体中文🇨🇳](README.md) | English🇬🇧
|
||||
|
||||
|
||||
|
||||
**Notice that the language support of *README* may be a little SLOW.**
|
||||
**Notice that the language translation of *Musicreater* may be a little SLOW.**
|
||||
|
||||
## Introduction🚀
|
||||
|
||||
Musicreater(音·创) is an free open source software which is used for making and also creating music in **Minecraft: Bedrock Edition**.
|
||||
Musicreater is a free open-source library used for converting midi file into formats that could be read in *Minecraft*.
|
||||
|
||||
Welcome to join our QQ group: [861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
|
||||
|
||||
**ATTENTION!** This software is under testing and developing, there is still a lot of bugs needed to be fixed. Please use it wisely.
|
||||
## Documentation📄
|
||||
|
||||
(Not in English yet)
|
||||
|
||||
[生成文件的使用](./docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)
|
||||
|
||||
[仓库API文档](./docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)
|
||||
|
||||
### Authors✒
|
||||
|
||||
Eilles (金羿)：A high school student, individual developer, unfamous BilibiliUPer, which knows a little about commands in *Minecraft: Bedrock Edition*
|
||||
Eilles (金羿)：A senior high school student, individual developer, unfamous Bilibili UPer, which knows a little about commands in *Minecraft: Bedrock Edition*
|
||||
|
||||
bgArray "诸葛亮与八卦阵": Fix bugs, improve code aesthetics, add new functions, change data format, etc.
|
||||
bgArray "诸葛亮与八卦阵": A junior high school student, player of *Minecraft: Bedrock Edition*, which is a fan of music and programming.
|
||||
|
||||
### Framework🏢
|
||||
|
||||
Developed under *Python3.8 3.9*. However, theoretically support Python3.6+.
|
||||
|
||||
Support Windows7+ && Linux (that supports Python3.6+)
|
||||
|
||||
***ATTENTION TO DEVELOPERS!!! TO SUPPORT DIFFERENT LANGUAGES, PLEASE USE FUNCTION(METHOD) `_` TO LOAD TEXTs!!! IF YOU NEED TO SUPPLEMENT, PLEASE ADD THEM IN SIMPLEFIED CHINESE\'S LANGUAGE FILE(zh-CN.lang), WHEATHER WHAT LANGUAGE YOU USE!!!***
|
||||
|
||||
## Instructions📕
|
||||
|
||||
### Installation
|
||||
|
||||
Download the *[MSCT Auto Installer](https://github.com/EillesWan/Musicreater/releases/tag/v0.2.0.0-Delta)*, put it in a directory that you want to install *Musicreater* into. Then run the auto installer and it will help you to install the *Musicreator* as well as Python3.8(if you haven\'t install it)
|
||||
|
||||
Tips: You'd better choose the \"2 GitHub\" download source
|
||||
|
||||
### Run with Source Code
|
||||
|
||||
#### Windows7+
|
||||
|
||||
0. First, download the source code pack of Musicreater.
|
||||
[Download from Gitee (Need to Login)](https://gitee.com/EillesWan/Musicreater/repository/archive/master.zip)
|
||||
[Download from Github](https://github.com/EillesWan/Musicreater/archive/refs/heads/master.zip)
|
||||
1. Install Python 3.8.10
|
||||
[Download the 64-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
|
||||
[Download the 32-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
|
||||
2. After completing installation, we need to install the libraries :
|
||||
- Open "Start Menu" and find `cmd`
|
||||
- Run `cmd` as Administrator
|
||||
- Drag "作者的自我修养.py" into the opened window and press Enter
|
||||
3. After completing installation，double click Musicreater.py to run
|
||||
|
||||
#### Linux
|
||||
|
||||
0. If you 're not sure whether your environment is good enough, please run these commands on Terminal
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install python3
|
||||
sudo apt-get install python3-pip
|
||||
sudo apt-get install git
|
||||
```
|
||||
1. Now if you are confident enough about your runtime environment, open Terminal on the place which you want to download Musicreater, and run these
|
||||
```bash
|
||||
sudo git clone https://gitee.com/EillesWan/Musicreater.git
|
||||
cd Musicreater
|
||||
python3 作者的自我修养.py
|
||||
python3 Musicreater.py
|
||||
```
|
||||
|
||||
### Instructions of Using
|
||||
|
||||
1. Just run Musicreater.pyc(or .py) if you have installed well
|
||||
2. Detailed instructions is coming soon
|
||||
3. If you find a bug, could you please report it to me? My contact info is right below.
|
||||
|
||||
## Explanation of the use of *PlumeAudioSurrounding Resource Pack* by bgArray (unnecessary)📖
|
||||
|
||||
1. First! The tips here are for those who want to use the multi tone resource package, [Shenyu resource package (Shenyu's own link)](https://pan.baidu.com/s/11uoq5zwN7c3rX-98DqVpJg) \(Extraction code: `ek3t`\)
|
||||
2. Download it to any location on your PC. Note that it does ***not*** need to be placed in the directory where *Musicreater* are. The audio resource package is large, so you can choose to download only:`神羽资源包_乐器、音源的资源包\羽音缭绕-midiout_25.0`.
|
||||
Also, you can download only `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\mcpack(国际版推荐)格式_25.0` or
|
||||
`神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\zip格式_25.0`.
|
||||
4. The next step is the most IMPORTANT: to bind the resource package to *Musicreater*
|
||||
First, open *Musicreater*->Q&A->Select \[MiraclePlumeResourcePack\]... .At this time, in the selection box,
|
||||
the IMPORTANT step comes, select: ***The directory you downloaded: `羽音缭绕-midiout_25.0`, or also the parent directory `mcpack(国际版推荐)格式_25.0`or`zip格式_25.0`***
|
||||
For example, my file path is as follows:
|
||||
`L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0` and in the directory, there are two folders and one .xls file:
|
||||
`神羽资源包_25.0_使用方法.xls`, `mcpack(国际版推荐)格式_25.0` and `zip格式_25.0`, so in *Musicreater* you should also select this folder: **L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0**
|
||||
6. If you want to use the Miracle Plume Bedrock Edition Audio Resource Pack to make .mcfunction s, you should use Musicreater -> Edit - > Import audio tracks from MIDI and parse them with a new method, and then use it
|
||||
Musicreater - > function (package) - > the following four new functions
|
||||
|
||||
## Thanks🙏
|
||||
This list is not in any order.
|
||||
|
||||
1. Thank [Fuckcraft](https://github.com/fuckcraft) *(“鸣凤鸽子” ,etc)* for the function of Creating the Websocket Server for Minecraft: Bedrock Edition.
|
||||
- *!! They have given me the rights to directly copy the lib into Musicreater*
|
||||
2. Thank *昀梦*\<QQ1515399885\> for finding and correcting the bugs in the commands that *Musicreater* Created.
|
||||
3. Thank *Charlie_Ping “查理平”* for bdx convert funtion.
|
||||
4. Thank *CMA_2401PT* for BDXWorkShop as the .bdx structure's operation guide.
|
||||
5. Thank *Miracle Plume “神羽”* \<QQshenyu40403\> for the Miracle Plume Bedrock Edition Audio Resource Pack
|
||||
6. Thank *Arthur Morgan* for his/her biggest support for the debugging of Musicreater
|
||||
7. Thanks for a lot of groupmates who support me and help me to test the program.
|
||||
8. If you have give me some help but u haven't been in the list, please contact me.
|
||||
- Thank *昀梦*\<QQ1515399885\> for finding and correcting the bugs in the commands that *Musicreater* generated.
|
||||
- Thank *Charlie_Ping “查理平”* for bdx convert function for reference, and the chart that's used to convert the mid's instruments into Minecraft's instruments.
|
||||
- Thank *[CMA_2401PT](https://github.com/CMA2401PT)* for BDXWorkShop for reference of the .bdx structure's operation, and his guidance in some aspects of our development.
|
||||
- Thank *[Dislink Sforza](https://github.com/Dislink) “断联·斯福尔扎”* \<QQ1600515314\> for his midi analysis algorithm brought to us, we had adapted it and made it applied in one of our working method; Also, thank him for the [WebConvertor](https://dislink.github.io/midi2bdx/) which brought us so much pressure and power to develop as well as update our projects better, instead of loaf on our project. We hope he can get into a good university as he wantted to!
|
||||
- Thank *Touch “偷吃”*\<QQ1793537164\> for support of debugging and testing program and algorithm, as well his/her suggestions to the improvement of our project
|
||||
- Thank *Mono*\<QQ738893087\> for reporting problems while installing
|
||||
- Thank *Ammelia “艾米利亚”*\<QQ2838334637\> for urging us to develop new functions, and put forward a lot of excellent suggestions for new functions, as well as the BDX file's importing test support provided, which has given a lot of practical theoretical support for our new Structure Generating Algorithm
|
||||
- 感谢 *[神羽](https://gitee.com/snowykami) “[SnowyKami](https://github.com/snowyfirefly)”* for supporting and promoting our project
|
||||
|
||||
## Contact Information📞
|
||||
> Thanks for a lot of groupmates's support and help
|
||||
>
|
||||
> If you have given contribution but haven't been in the list, please contact us!
|
||||
|
||||
### Author *Eilles*(金羿)
|
||||
## Contact Us📞
|
||||
|
||||
1. QQ 2647547478
|
||||
2. E-mail EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
|
||||
3. WeChat WYI_DoctorYI
|
||||
|
||||
### Author *bgArray*(诸葛亮与八卦阵)
|
||||
|
||||
1. QQ 4740437765
|
||||
Meet problems? Welcome to give out your issue [here](https://gitee.com/EillesWan/Musicreater/issues/new)!
|
||||
|
||||
Want to get in contact of developers? Welcome to join our [Chat QQ group](https://jq.qq.com/?_wv=1027&k=hpeRxrYr).
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user