OcRam - Audio_EX plugin (for MV)-1.jpg

*Comment* <aex:type:distance+radius: pan:loop:forced>

• type || Text || {x, y, d, bg}
  x = horizontal (ignores y axis)
  y = vertical (ignores x axis)
  d = dynamic (ignores nothing)
  bg = background (ignores both, x and y axis)
  
• distance || In tiles || {number}
  
• radius || in tiles || {number}
  
• fade || Seconds || {number}
  
• pan || text || {pan/true, nopan/false}
  
• forced || Text || {forced/true, default/false}
  
• new || text || {new/true, link/false}
  

Following examples are written with default plugin parameters:

*Comment* <aex> (is same as: <aex:d:25+0:0: pan:forced>)
*Play BGS* fire (90, 100, 0)

*Comment* <aex:::::default> (is same as: <aex:d:25+0:0: pan:default>)
*Play BGS* fire2 (90, 100, 0)

*Comment* <aex:x::0> (is same as: <aex:x:25+0:0: pan:forced>)
*Play BGS* ocean (90, 100, 0)

*Comment* <aex:bg:0:3> (is same as: <aex:bg:0+0:3:nopan:forced>)
*Play BGS* rain (90, 100, 0)

Below some notes:

• NOTE 1: ALL sounds created via <aex*> tags will be erased if player is transfered to another map.
  
• NOTE 2: "forced" parameter will execute BGS/SE always, when scene is loaded. (even if event trigger would be "Action button" or "on touch") "default" parameter will execute BGS/SE ONLY, when event is triggered as intended.
  
• NOTE 3: AEX params will execute ONLY if they are on ACTIVE event page!
  

NOTE: Plugin command parameters may NOT contain any spaces (because space is delimeter for command arguments)

Plugin command (to CLEAR buffers with this event id)
clear_aex [eventId]​
example: clear_aex 1​
​
You may also ommit event id then plugin will default to 'this' event​
example: clear_aex​

Plugin commands (to control dedicated bgs2, which will play also in battle):
play_bgs2 [bgs_name_here] [volume] [pitch] [pan]​
Example: play_bgs2 rain 90 100 0​
stop_bgs2​

Plugin command (to control dedicated bgs3, which will play also in battle):
play_bgs3 [bgs_name_here] [volume] [pitch] [pan]​
Example: play_bgs3 wind 40 80 0​
stop_bgs3​

Plugin commands to dynamic BGS:
pause_bgs [name] [fade_time]​
resume_bgs [name] [fade_time]​
fadeout_bgs [name] [fade_time]​
erase_bgs [name]​
(To erase all bgs use: erase_bgs *)​

fade [name] to [volume] in [fade_time] sec​
Example: fade Wind to 20 in 6 sec​
Same as: fade Wind to 20 in 6​
BGM: fade *bgm* to 0 in 4 sec​

ps. Do not mind those <light*> comments those are for OcRam_Lights -plugin.

First we need to tell that this is Audio_EX event (AEX). We can do it by adding *Comment* BEFORE actual *Play BGS* command. Because this event is forced it will start playing when ever this page is active (no Action button press required).

Then we need *Plugin command*clear_aex to clear this BGS before setting self switch on which will trigger event page 2 (shown after). This part will run only when player presses Action Button on this event.




This page has no BGS sound and because 1st page has FORCED AEX event it will play BGS automatically when Self Switch D is OFF.