YEP.142 – Music Menu – RPG Maker MV
This plugin adds a new menu that you can send the player into. In it, the player will be able to play any songs previously encountered within the game that you allow them to be able to play. You can set the filename, display name of the song, the volume, pitch, pan, and even the help description for when the song will be replayed.
这个插件为你增加了音乐播放菜单，让玩家可以选择播放哪些音乐。你可以设置音乐的文件、名称、音量等特性，还可以显示帮助文件
This is a collaboration plugin by Chickie and Yanfly to ensure compatibility with the Yanfly Engine Plugins library.
这个插件是 Chickie和Yanfly合作完成，确保适配YEP库
Instructions
The songs displayed in the Music Menu will only be the ones you list within the plugin parameters labled as Song x Data.
音乐菜单里显示的音乐将有插件参数里面列举的决定
When entering the song data, it has to be done in a certain format:
音乐数据文件的格式如下
filename; display name; volume; pitch; pan; description
文件名；显示名；音量；音高；音域；描述文本
Each data segment is separated by a ; and must be entered in that particular order to keep all the data ordered and read correctly. Here is how to apply each entry:
每一个数据直接使用分号隔开，并且需要严格按顺序填写
filename
– This is the filename of the song. This must be case sensitive and must not include the file extension. For example, theme.mp3 will be written as theme for the parameters
包含拓展名的文件名
display name
– This is the name displayed in the game in the music menu. This has no effect on the actual song itself.
显示在菜单内的音乐名称
volume
– This will be the volume the song will be played at inside the music menu scene. Use an integar value from 0 to 100 for the plugin parameters.
音量0-100
pitch
– This is the pitch played for the song inside the music menu. Use an integar value from 0 to 200 for the plugin parameters.
音高0-200
pan
– This is the pan applied to the song inside the music menu. Use a value from -100 to 100 for the plugin parameters.
音域-100-100
description
– The help description that appears when the song is selected. The help description will appear at the top of the screen. You can use any kind of text code you want for this setting.
文本描述，将会显示在屏幕最上方，你可以使用文本代码
Main Menu Manager – Positioning the Music Menu
For those using the Main Menu Manager and would like to position the Music Menu command in a place you’d like, use the following format:
如果你使用了 Main Menu Manager插件，你可以这样创建菜单
Name: “Music Menu”
Symbol: musicMenu
Show: $gameSwitches.value(Insert a Switch ID to show this command)
Enabled: $gameSwitches.value(Insert a Switch ID to enable this command)
Ext:
Main Bind: this.commandMusicMenu.bind(this)
Actor Bind:
Insert the above setup within a Main Menu Manager slot. Provided you copy the exact settings to where you need it, it will appear there while using all of the naming, enabling, disabling, hiding, and showing effects done by the plugin parameters.
将上述代码插入Main Menu Manager管理槽，请准确的复制进入插件参数内
Remember to turn off ‘Auto Add Menu’ from the plugin parameters.
并且确保关闭插件内的Auto Add Menu选项
Plugin Commands
You can use the following plugin commands to alter the music menu settings for your game in many ways.
你可以使用下面的插件命令
Plugin Commands:
GoToMusicMenu
– Sends the player to the music menu scene.
打开音乐菜单
AllMusicMenuSongs
– Unlocks all music for the player without the player needing to hear it in the game at least once.
不需要至少播放一次的限制就可以解锁所有音乐
NormalMusicMenuSongs
– Removes the unlock all setting. The player now needs to hear music in the game at least once to unlock the song. This does not remove already unlocked song entries.
锁定所有音乐，玩家需要至少播放一次才可以解锁
UnlockMusicMenuSong x
UnlockMusicMenuSong x x x
– This will unlock song ID x for the game. Use multiple x’s to unlock a group of songs at once. x will refer to the ID found in the plugin’s parameters. The referred song will be unlocked without the player needing to hear the song in the game at least once.
解锁特定音乐文件
