Fugs Multi-Track Audio EX v1.0 GitHub Download === Intro === Unlimited audio tracks with advanced fading and crossfading capabilities for BGM, BGS, ME, and SE audio.
Fugs Multi-Track Audio EX v1.0
GitHub Download
=== Intro ===
Unlimited audio tracks with advanced fading and crossfading capabilities for BGM, BGS, ME, and SE audio.
=== Features ===
Play multiple tracks of the same or different audio types simultaneously.
Seamless fade-in, fade-out, and crossfading support across all tracks.
Independent track handling to prevent conflicts with the default audio system or other audio plugins (e.g., OC Rams Audio EX).
=== Why Use This Plugin? ===
This plugin offers extensive control and flexibility over audio transitions, such as seamlessly fading a BGM into a BGS or layering SEs with precise adjustments for pan, and pitch. The best part? It integrates into your project without interfering with the stock audio system or any other plugins, allowing you to use only the features you need without disrupting the rest of your game’s audio.
=== Command Structure ===
The plugin commands follow this general format:
[Command]-[Type][Track]? [Arguments]?
- **Command**: The action to perform (e.g., play, fade, stop, crossfade).
- **Type**: The audio type (BGM, BGS, ME, SE).
- **Track**: (Optional) The specific track number (defaults to Track 1 if omitted).
- **Arguments**: (Optional) Parameters for the command (e.g., volume, fade duration).
Example Commands:
play-bgs3 Scene1 // Plays a BGS on Track 3.
stop-bgs3 // Stops the BGS on Track 3 immediately.
play-bgs "Title Music" 90 3 // Plays BGS with spaces in its name, 90% volume, and 3s fade-in.
=== Detailed Commands ===
1. **Play Audio**
`play-[Type][Track]? [name] [volume]? [fadein]? [pan]? [pitch]?`
- Plays the specified audio with optional adjustments.
- Example: `play-bgs2 Scene1 90 5 -30 120`
(Plays Scene1 BGS on Track 2, 90% volume, 5s fade-in, -30 pan, and 120% pitch).
2. **Fade Audio**
`fade-[Type][Track]? [volume] [duration] [pan]? [pitch]?`
- Gradually adjusts the volume, pan, or pitch over time.
- Example: `fade-bgm 30 3`
(Fades BGM volume to 30% over 3 seconds).
3. **Stop Audio**
`stop-[Type][Track]? [fadeout]?`
- Stops the audio with an optional fade-out duration.
- Example: `stop-bgm2 5`
(Stops BGM on Track 2 with a 5-second fade-out).
4. **Crossfade Audio**
`crossfade-[Type][Track]? [toTypeTo] [TrackId]? [name] [duration]`
- Crossfades from one track to another with a smooth transition.
- Example: `crossfade-bgm2 bgm3 Scene2 5`
(Crossfades BGM on Track 2 to Scene2 on BGM Track 3 over 5 seconds).
=== Important Notes ===
- **Track Numbers**: Optional. Defaults to Track 1 if omitted.
- **Default Values**:
- Volume: 90%, Pan: 0, Pitch: 100%.
- Audio plays/stops immediately if fade-in/out duration is not provided.
- **Quoted Names**: Audio files with spaces in their names require quotes.
=== Todo ===
Add save and resume track for battles and scene changes.
Add options for when to stop/save BGM and BGS e.g.; battles
More testing.
MZ port.
Make markdown readme.
Add play argument to start audio at specified time. Same with stop.
Take screenshot and get a demo project.
=== Final Notes ===
- I have not done much testing!
edit: AI helped write my documentation and possible a few lines of code(Regex )
