Battle Bgm Invalidate - PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

Battle Bgm Invalidate - BattleBgmInvalidate.js

16 September 2025

Plugin desc : Battle BGM Disable Plugin

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/BattleBgmInvalidate.js

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MZ-plugins/refs/heads/main/BattleBgmInvalidate.js

File name : BattleBgmInvalidate.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/BattleBgmInvalidate.js
@plugindesc Battle BGM Disable Plugin
@author Triacontane
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MZ-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----

BattleBgmInvalidate.js

When the specified switch is ON， battle BGM and victory ME will be disabled.
Map BGM and map BGS will continue to play even during battle.

If you change the BGM during a battle event， it will be carried over to the
map.
Defeat ME will also play normally.

This plugin requires the base plugin ”PluginCommonBase.js.”
”PluginCommonBase.js” is located in the following folder under the RPG Maker
MZ installation folder:
dlc/BasicResources/plugins/official

Terms of Use:
You may modify and redistribute this plugin without permission， and there are
no restrictions on its use (commercial， 18+， etc.).
This plugin is now yours.

@param switchId
@text Condition Switch
@desc When the specified switch is ON， the battle BGM will be disabled. If not specified， it will always be disabled.
@type switch
@default 1

@param invalidateMe
@text Victory ME nullification
@desc When the conditions are met， not only the battle BGM but also the victory ME will be disabled at the same time.
@type boolean
@default true

munokura

Welcome to PGMZ! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.