YEP.98 – Common Event Menu
Introduction
The Common Event Menu allows you to create your own custom menu setups. When using it, you can list whatever common events you so wish and generate a menu that when selecting the menu command, it will run the common event. This common event menu setup allows you to utilize a help window, a picture window, and a subtext window to allow for your own personal touch when using the common event window.
公共事件菜單允許制作自定義菜單設(shè)置，當(dāng)你使用它時，你可以選擇你希望執(zhí)行的公共事件列表產(chǎn)生一個菜單。這個公共事件菜單允許你顯示幫助信息，圖片和下標(biāo)文本。
Instructions
The common event menu is constructed purely by plugin commands. You’ll have to carefully construct each plugin command to make the common event list appear the way you want. The following is an example of how to set up a common event menu with the default window layout:
這個公共事件菜單可以通過插件命令制作。你可以創(chuàng)建不同的菜單列表。下面是一些例子。
SetCommonEventMenuSettings Default Setup
ClearCommonEventMenu
AddCommonEventMenu 1 2 3 4 5
SetCommonEventMenuCancel 0
OpenCommonEventMenu
To find out more details about how to set up the common event menus, be sure to read through the help file carefully!
如果你想知道更多設(shè)置細(xì)節(jié)，請詳細(xì)閱讀幫助文件
Comment Tags
Common Events in RPG Maker MV do not have their own notetags. So to make up for that, we’ll be using comments instead. Simply create a comment event within the common event that will be used inside of the menu and use any of these comment tags:
MV中公共事件并沒有他們的標(biāo)簽欄，所以我們使用事件中的注釋命令。你可以使用下面的語句來簡便的創(chuàng)建菜單
Common Event Comment Tags:
<Menu Name: x>
– This changes the appearance of the common event’s text when displayed in the common event menu list. If this tag isn’t used, the text displayed will be the common event’s name. You can use text codes.
菜單名字，如果沒有設(shè)置，則顯示公共事件名字
<Icon: x>
– This changes the icon of the common event to x. If this tag isn’t used, the icon used will be the one set in the plugin’s parameters.
菜單圖標(biāo)，如果沒有設(shè)置，則顯示插件參數(shù)里的值
<Picture: x>
– This sets a picture to be associated with this common event when it is highlighted. If this isn’t used, no picture will be displayed and it will be left empty.
菜單圖片，如果沒有設(shè)置，則不會顯示
<Help Description>
text
text
</Help Description>
– This sets the help description used for the common event when it is selected in the common even menu list. If this tag isn’t used, the text displayed will be the default text from the plugin’s parameters.
設(shè)置幫助文本框，如果沒有設(shè)置，則顯示插件參數(shù)里的值
<Subtext>
text
text
</Subtext>
– This sets the subtext used for the common event menu’s subtext window while this common event is selected in the common event menu list. If this text isn’t used, the text displayed will be the default text from the plugin’s parameters.
設(shè)置幫助下標(biāo)文本，如果沒有設(shè)置，則顯示插件參數(shù)里的值
Lunatic Mode – Enabling/Disabling Common Events
For those with JavaScript experience, you can use the following comment tags for your common events to be enabled or disabled:
如果你有JavaScript經(jīng)驗，可以使用下面的標(biāo)簽
Common Event Comment Tags:
<Menu Enable Eval>
if ($gameSwitches.value(10)) {
enabled = true;
} else {
enabled = false;
}
</Menu Enable Eval>
– The ‘enabled’ variable determines if the common event can be selected or not. In the example above, Switch 10 needs to be ON in order for this common event to be selected.
開關(guān)10打開，菜單才可以選擇
Lunatic Mode – Showing/Hiding Common Events
For those with JavaScript experience, you can use the following comment tags for your common events to be shown or hidden:
如果你有JavaScript經(jīng)驗，可以使用下面的標(biāo)簽
Common Event Comment Tags:
<Menu Visible Eval>
if ($gameSwitches.value(20)) {
visible = true;
} else {
visible = false;
}
</Menu Visible Eval>
– The ‘visible’ variable determines if the common event is shown or hidden in the common event menu list. In the example above, Switch 20 needs to be ON in order for this common event to be visible and shown.
開關(guān)20打開，菜單才可以顯示
Plugin Commands
The following plugin commands are used to work the Common Event Menu. Look over each of the settings carefully:
你可以使用下面的插件命令
Plugin Command:
—
ClearCommonEventMenu
– This clears all the listed common events from the Common Event Menu Data pool meaning it has to be filled again. You can do so with the next plugin command:
清除公共事件菜單所有的事件
—
AddCommonEventMenu 1
AddCommonEventMenu 2, 3, 4, 5
AddCommonEventMenu 6 through 10
– This will add the listed common event numbers into the common event list that will be shown in the common event menu.
添加公共事件
—
SetCommonEventMenuCancel 20
– This will set the cancel button for the common event menu to run common event 20 when canceled. If it is left at 0, no event will run, but the menu can allow the cancel button to be pressed (and prematurely end it).
設(shè)置取消按鈕執(zhí)行的公共事件
—
DisableCommonEventMenuCancel
– This will disable the cancel button for the common event menu from being pressed. Pressing cancel while the common event menu is active will do nothing. Use ‘SetCommonEventMenuCancel x’ to re-enable the cancel button.
關(guān)閉取消按鈕
—
OpenCommonEventMenu
– After you’ve set everything up, this command will be used to open up the common event menu. This can be used on the map. If you are using the Battle Engine Core, this menu can be opened in battle as well. All of the common events listed by the ‘AddCommonEventMenu’ plugin command will appear in this list.
打開公共事件菜單。如果你使用了 Battle Engine Core，你可以在戰(zhàn)斗中打開它。
—
CommonEventMenuX 0
CommonEventMenuY this.fittingHeight(2)
CommonEventMenuWidth Graphics.boxWidth / 2
CommonEventMenuHeight Graphics.boxHeight – this.fittingHeight(2)
CommonEventMenuOpacity 255
CommonEventMenuColumns 1
– These plugin commands allow you to adjust the x, y, width, height, opacity, and the number of columns used for the main common event menu list. Make sure all of these settings are done BEFORE the common event menu is opened with the ‘OpenCommonEventMenu’ plugin command.
這些插件命令可以調(diào)整菜單位置，寬高，透明度，列數(shù)。確保這些插件命令在OpenCommonEventMenu命令之前
—
ShowCommonEventMenuHelp
HideCommonEventMenuHelp
– This will allow you to decide if the help window will be shown or hidden for the next ‘OpenCommonEventMenu’ plugin command usage.
對于后面的打開菜單命令，隱藏菜單幫助窗口
—
CommonEventMenuHelpX 0
CommonEventMenuHelpY 0
CommonEventMenuHelpWidth Graphics.boxWidth
CommonEventMenuHelpHeight this.fittingHeight(2)
CommonEventMenuHelpOpacity 255
– These plugin commands allow you to adjust the x, y, width, height, and opacity of the help window for the common event menu list. Make sure all of these settings are done BEFORE the common event menu is opened with the ‘OpenCommonEventMenu’ plugin command.
這些插件命令可以調(diào)整菜單幫助窗口位置，寬高，透明度。確保這些插件命令在OpenCommonEventMenu命令之前
—
ShowCommonEventMenuPicture
HideCommonEventMenuPicture
– This will allow you to decide if the help window will be shown or hidden for the next ‘OpenCommonEventMenu’ plugin command usage.
對于后面的打開菜單命令，隱藏菜單圖片
—
CommonEventMenuPictureX Graphics.boxWidth / 2
CommonEventMenuPictureY this.fittingHeight(2)
CommonEventMenuPictureWidth Graphics.boxWidth / 2
CommonEventMenuPictureHeight this.fittingHeight(10)
CommonEventMenuPictureOpacity 255
– These plugin commands allow you to adjust the x, y, width, height, and opacity of the picture window for the common event menu list. Make sure all of these settings are done BEFORE the common event menu is opened with the ‘OpenCommonEventMenu’ plugin command.
這些插件命令可以調(diào)整菜單圖片位置，寬高，透明度。確保這些插件命令在OpenCommonEventMenu命令之前
—
ShowCommonEventMenuSubtext
HideCommonEventMenuSubtext
– This will allow you to decide if the help window will be shown or hidden for the next ‘OpenCommonEventMenu’ plugin command usage.
對于后面的打開菜單命令，隱藏菜單下標(biāo)文本
—
CommonEventMenuSubtextX Graphics.boxWidth / 2
CommonEventMenuSubtextY Graphics.boxHeight – height
CommonEventMenuSubtextWidth Graphics.boxWidth / 2
CommonEventMenuSubtextHeight Graphics.boxHeight – this.fittingHeight(2) – this.fittingHeight(10)
CommonEventMenuSubtextOpacity 255
– These plugin commands allow you to adjust the x, y, width, height, and opacity of the subtext window for the common event menu list. Make sure all of these settings are done BEFORE the common event menu is opened with the ‘OpenCommonEventMenu’ plugin command.
這些插件命令可以調(diào)整菜單下標(biāo)文本位置，寬高，透明度。確保這些插件命令在OpenCommonEventMenu命令之前
—
SetCommonEventMenuSettings Default Setup
SetCommonEventMenuSettings Basic Setup
– This allows you to set the common event windows to position themselves to the default setup provided by the plugin parameters or a basic setup made of just the main list and a help window.
設(shè)置菜單為默認(rèn)設(shè)置，或者對于列表和幫助的基本設(shè)置
