Merge branch 'master' of https://github.com/khjxiaogu/MinecraftMidiPl…

…ayer.git

README.md

@@ -1,14 +1,15 @@
 # Minecraft Midi Player   
 [简体中文](#minecraft-midi%E6%92%AD%E6%94%BE%E5%99%A8)  
-a simple plugin to play midi in your minecraft server!   
+a simple bukkit plugin to play midi in your minecraft server!   
 Minecraft version: 1.8.1+   
-Recommend using with Piano+ resource pack.  
+Can map notes to several instruments, creating a note range from A0 to C7(1.8+)or even A0 to C9(1.12+), nearly all midi notes are supported in 1.12+(midi supports from A0 to G#9).  
+Also compatible with Piano+ resource pack, creating a note range from C1 to C7, only thing to do is to set config item "universal" in "plugin.yml" to false.  
 [Piano+ 1.6+](https://drive.google.com/file/d/0B6nFdqZCyZZ2dTdTa2lQZnZQdWM/edit?usp=sharing)   
 [Piano+ 1.9-1.12](https://www.mediafire.com/file/zbawlf4ae3ukrbf/Piano++(1.12).7z)   
 [Piano+ 1.13+](https://www.mediafire.com/file/u7rkappl54nc03d/Piano++(1.13).7z)   
 # How to use  
 0. Download the Latest version of this plugin from [releases](https://github.com/khjxiaogu/MinecraftMidiPlayer/releases)   
-1. Install this plugin in your minecraft server's plugins folder(Server Directory/plugins/).   
+1. Install this plugin in your minecraft server's plugins folder(Server Directory/plugins/). __make sure your server supports bukkit!__   
 2. Start server, wait before fully loaded and generates a folder named "MCMIDI".   
 3. Place your midi music files inside MCMIDI folder.   
 4. Use`/mcmidi load foo.mid`to load foo.mid into memory before first play.    
@@ -18,28 +19,29 @@ Recommend using with Piano+ resource pack.
 - Server tps may affect play speed.
 - Midi files that are too fast may have some notes lost, the smallest time unit is a minecraft tick(50ms), notes closer than this may be considered as notes at the same moment.  
 - The velocity,pressure or volume of a single key would not be considered as there's no way to present this in minecraft.  
-- Only midi speed change message and key press messages would take effect.  
+- Only midi speed change message and key on messages would take effect.  
 - generating structure may cause performance issues. There's no undo, so be careful!
-- structure width must larger than 10, you can calculate a approxmate value by lengthInTicks*3(cell width)/250(height).
+- structure width must larger than 16, you can calculate a approxmate value by lengthInTicks*3(cell width)/250(height).
 # Minecraft midi播放器   
-适用于minecraft服务器的midi插件   
+适用于minecraft bukkit服务器的midi插件   
 Minecraft版本：1.8.1+   
-建议与Piano+资源包一起食用。  
+可以把音高映射到不同的乐器，支持从A0到C7(1.8以后)甚至从A0到C9(1.12以后)的音高，1.12以后的版本几乎所有的midi音高都支持播放了（midi仅支持从A0到G#9的音高）。  
+支持Piano+资源包，支持C1到C7的音高，只需要设置"config.yml"里的"universal"为false即可。  
 [Piano+ 1.6+](https://drive.google.com/file/d/0B6nFdqZCyZZ2dTdTa2lQZnZQdWM/edit?usp=sharing)   
 [Piano+ 1.9-1.12](https://www.mediafire.com/file/zbawlf4ae3ukrbf/Piano++(1.12).7z)   
 [Piano+ 1.13+](https://www.mediafire.com/file/u7rkappl54nc03d/Piano++(1.13).7z)   
 # 用法  
 0. 在[Releases](https://github.com/khjxiaogu/MinecraftMidiPlayer/releases)下载本插件的最新版本。   
 1. 把本插件放在插件文件夹(服务器目录/plugins/)。    
 2. 启动服务器，等待完全开启并生成MCMIDI文件夹。  
-3. 把midi音乐放在插件文件夹下MCMIDI文件夹内（服务器目录/plugins/MCMIDI）。  
+3. 把midi音乐放在插件文件夹下MCMIDI文件夹内（服务器目录/plugins/MCMIDI）。__确保你的服务端支持Bukkit！__   
 4. 首次播放某个音乐时，需要使用`/mcmidi load 测试.mid`加载"测试.mid"到服务器缓存。  
 5. 载入后，就可以使用`/mcmidi play 测试.mid 玩家`为玩家播放"测试.mid"，或者`/mcmidi play 测试.mid`为自己播放了。  
 6. 也可以使用`/mcmidi generate 测试.mid`在你所在位置生成一个红石音乐结构。  
 # 注意事项
 - 服务器tps会影响播放速度。  
 - 过快的midi文件可能会出现音符丢失，最小时间单位是1 mc tick(50ms)，间隔低于这个的音符会被认为是同一时间内的音符。
-- 速度、压力和音量属性都不会被使用，因为在minecraft内很难表达这些属性
-- 只有midi速度变化和按键按下信息会生效
+- 速度、压力和音量属性都不会被使用，因为在minecraft内很难表达这些属性。
+- 只有midi速度变化和按键按下信息会生效。
 - 生成红石音乐会导致性能问题和卡服，不能撤销，请慎重操作！
-- 结构宽度最低为16，可以近似计算长度为 tick长度*3(单元宽度)/250(高度)
+- 结构宽度最低为16，可以近似计算长度为 tick长度*3(单元宽度)/250(高度)。