ループなしBGM演奏プラグイン - ASAGI_playBgmNotLoop.js

シェア用テキスト：

▼ループなしBGM演奏プラグイン（あさぎすおう様作） - ASAGI_playBgmNotLoop.js
https://plugin-mz.fungamemake.com/archives/8815
BGMをループなし指定で演奏できるプラグインです。 また、演奏中のBGMのループ仕様を途中で変更することもできます。

ふりがな：るーぷなしBGMえんそうぷらぐいん

機能概要： BGMをループなし指定で演奏できるプラグインです。 また、演奏中のBGMのループ仕様を途中で変更することもできます。

利用規約（ライセンス）： MITライセンス

作者：あさぎすおう

作者サイト：https://note.com/suou_color

解説ページ：https://note.com/suou_color/n/nd6a6a41a274d

ダウンロードページ：https://raw.githubusercontent.com/suou-color/PublicPlug…

ファイル名：ASAGI_playBgmNotLoop.js

プラグインのヘルプ：

/*
 Version
 1.00 2026/01/17 初版作成
 */
/*:ja
 * @target MZ
 * @plugindesc ループなしBGM演奏プラグイン
 * @base PluginCommonBase
 * @orderAfter PluginCommonBase
 * @author あさぎすおう
 * @url https://note.com/suou_color
 *
 * @help ASAGI_playBgmNotLoop.js
 * Ver : 1.00
 * License : MIT license
 * 
 * 現在このプラグインを使用するにはトリアコンタン様のベースプラグイン『PluginCommonBase.js』が
 * 必要となります。将来的には独立でも使用できるよう目指しています。
 * 
 * BGMをループなし指定で演奏できるプラグインです。
 * 方法は以下の２つです。
 * ・プラグインコマンドから『ループなしBGM演奏』を選択する。
 * ・『ループなしBGMスイッチ』を設定し、そのスイッチをONにしてからBGMを演奏する。
 * 
 * また、プラグインコマンドの『演奏中BGMのループ仕様変更』では、現在流れているBGMの
 * ループ仕様を途中で変更することができます。
 * 
 * 【注意１】
 * 『ループありBGM』と『ループなしBGM』は別の曲として判定します。そのため、
 * 『ループあり』の演奏途中で『ループなし』の演奏を実行すると、同じ曲でも最初からBGMが流れます。
 * 演奏中にループ仕様を変更したい場合は『演奏中BGMのループ仕様変更』を使用してください。
 * 
 * 【注意２】
 * 『演奏中BGMのループ仕様変更』は演奏開始直後では反映されないことがあります。
 * 目安として演奏開始から10フレーム以上たってから使用するようにしてください。
 * 
 * 【補足】
 * トリアコンタン様のベースプラグイン『PluginCommonBase.js』があると"\V[1]"などの変数が使えます。
 * 
 * @param NotLoopSwitch
 * @text ループなしBGMスイッチ
 * @desc このスイッチがONのときにBGMを演奏すると、そのBGMはループしません。
 * @type switch
 * @default 0
 * 
 * @param SettingToResetNotLoopSwitch
 * @text スイッチのリセット設定
 * @desc この設定をONにすると、BGM演奏実行後に『ループなしBGMスイッチ』を自動でOFFにします。
 * @type boolean
 * @default false
 * 
 * @command PlayBgmNotLoop
 * @text ループなしBGM演奏
 * @desc 指定したBGMをループ仕様なしで演奏します。
 *
 * @arg FilePath
 * @text ファイルパス
 * @desc BGMファイルを指定してください。
 * @default
 * @require 1
 * @dir audio/bgm/
 * @type file
 * 
 * @arg Volume
 * @text 音量
 * @desc 演奏するオーディオの音量です。
 * @default 90
 * @type number
 * @min 0
 * @max 100
 *
 * @arg Pitch
 * @text ピッチ
 * @desc 演奏するオーディオのピッチです。
 * @default 100
 * @type number
 * @min 50
 * @max 150
 *
 * @arg Pan
 * @text 位相
 * @desc 演奏するオーディオの位相です。
 * @default 0
 * @type number
 * @min -100
 * @max 100
 * 
 * @command SetBgmLoop
 * @text 演奏中BGMのループ仕様変更
 * @desc 現在演奏中のBGMのループ仕様を変更します。※演奏開始直後は変更できないため、10フレーム以上たってから設定してください。
 * 
 * @arg Loop
 * @text ループ仕様変更内容
 * @desc 注意：現在の演奏位置がループ範囲よりも後ろの場合は設定変更できません。
 * @type boolean
 * @default true
 * @on ループあり
 * @off ループなし
 */