H2A 音楽と効果音を ZzFX で鳴らします - H2A_ZzFXPlayer.js

シェア用テキスト：

▼H2A 音楽と効果音を ZzFX で鳴らします（はどはど様作） - H2A_ZzFXPlayer.js
https://plugin-mz.fungamemake.com/archives/7071
これは実験的なプラグインです。音楽と効果音を ZzFX で鳴らします

ふりがな：おんがくとこうかおんを ZzFX でならします

機能概要： これは実験的なプラグインです。音楽と効果音を ZzFX で鳴らします

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

作者：はどはど

作者サイト：https://had2apps.com/

解説ページ：https://had2apps.com/mvzp?pluginName=H2A_ZzFXPlayer

ファイル名：H2A_ZzFXPlayer.js

プラグインのヘルプ：

*:ja
 * @plugindesc [実験作] 音楽と効果音を ZzFX で鳴らします
 *
 *   @base zzfx
 *
 *   @base zzfxm.min
 *
 * @target MZ
 * @author Had2Apps
 * @url https://github.com/katai5plate/RPGMakerPlugins
 *
 * @param _volumeBoost
 * @text 音量ブースト
 * @desc 音量が全体的に小さい時や大きい時に調節する％
 * @type number
 * @min 0
 * @max 500
 * @default 100
 *
 * @param _staticSe
 * @text システムSE設定
 * @type struct<ss>
 * @default {”_cursor”:”[2.63,,107,,.01,.01,3,.21,,,,,.18,,390,,.36,.61,.01]”,”_decision”:”[1.15,,1190,.02,.06,.13,1,1.32,,1.1,-219,.01,.01,,,,,.65,,.13]”,”_cancel”:”[2.36,,391,.01,.02,.03,1,1.94,4.9,.6,,,,,26,.1,.11,.6,.02]”,”_buzzer”:”[,,881,.02,.05,.13,1,.5,9.5,2.9,-26,.05,,,48,,,.45,.03,.05]”,”_equip”:”[1.55,,313,.01,.06,.19,1,.01,,,615,.1,,,,.1,.03,.8,.01,.18]”,”_save”:”[,,1600,.01,.04,.19,2,1.34,,,240,.04,,,,,,.86,.04]”,”_load”:”[,,1600,.01,.04,.19,2,1.34,,,240,.04,,,,,,.86,.04]”,”_battle”:”[1.02,,7,.07,.07,.42,2,1.27,8.3,.7,,,,,12,.1,,.65,.07,.18]”,”_run”:”[,,414,.01,.08,.05,4,.45,-9.7,-1.3,,,,.5,-101,.2,.25,.7,.08]”,”_enemyAttack”:”[1.95,,345,.01,.07,,3,1.4,-1.7,,,,.18,1.8,,,.13,.52,.07]”,”_enemyDamage”:”[,,457,.02,.03,.19,3,1.37,-9.6,,,,,1.2,-8.5,.2,,.87,.05,.07]”,”_enemyCollapse”:”[2,,490,.02,.09,.07,3,1.25,-4.9,-0.7,,,,,,.3,.18,.65,.02,.27]”,”_bossCollapse1”:”[1.09,,204,,1,1,4,.43,.1,.8,,,,,,.3,,.44,.04,.31]”,”_bossCollapse2”:”[1.01,,271,.01,1,1,,.53,-3.2,,,,,1,126,.4,,.78,.06,.27]”,”_partyDamage”:”[1.39,,308,.01,.06,.06,4,2.51,.6,,,,.1,1.6,310,,.08,.94,.09]”,”_partyCollapse”:”[2.04,,767,.04,.2,.06,2,.43,,,-370,.2,.26,,,,.45,.86,.14,.38]”,”_recovery”:”[1.22,,574,.1,.18,.01,3,2.58,8.5,,,,.18,,,,.02,.95,.03,.3]”}
 *
 * @command playSongFromFile
 * @text BGMを再生
 *
 *   @arg _name
 *   @text 使用する JS ファイル名
 *   @type string
 *
 *   @arg _isLoop
 *   @text ループするか
 *   @type boolean
 *   @default true
 *
 *   @arg _volume
 *   @text 音量
 *   @type number
 *   @min 0
 *   @max 100
 *   @default 90
 *
 * @command playSoundFromFile
 * @text SEを再生
 *
 *   @arg _name
 *   @text sounds.json に設定された、使用する音の名前
 *   @type string
 *
 *   @arg _volume
 *   @text 音量
 *   @type number
 *   @min 0
 *   @max 100
 *   @default 90
 *
 * @help
 * ※このプラグインは実験的なものです。
 * 　メモリリークやクラッシュなど、何か問題が発生しても、一切責任を取りません。
 * 　自己責任で使用してください。
 *
 * [使う準備]
 * 1. 前提ライブラリをダウンロードし、js/plugins/ に追加する
 *
 * zzfx.js
 * https://raw.githubusercontent.com/keithclark/ZzFXM/cb07fa9ca36aefd67a0c8c656d2958b62f8ed9fe/zzfx.js
 * zzfxm.min.js
 * https://raw.githubusercontent.com/keithclark/ZzFXM/cb07fa9ca36aefd67a0c8c656d2958b62f8ed9fe/zzfxm.min.js
 *
 * 2. プラグイン設定で、このプラグインの上に2つの前提ライブラリを設置する
 *
 * 例:
 * [ON] zzfx
 * [ON] zzfxm.min
 * [ON] H2A_ZzFXPlayer
 *
 * 3. 音楽作りと音作りをする
 *
 * 音楽作りはこのサイトで行う
 * https://keithclark.github.io/ZzFXM/tracker/
 * 作った音楽は左上の File -> Save にて JS ファイルでダウンロードできる。
 *
 * 音作りはこのサイトで行う。
 * https://killedbyapixel.github.io/ZzFX/
 * 作った音は画面下部の「ZzFX JavaScript (Use this code to play the sound)」の部分に
 * コードが生成されるので、[] で囲まれた部分を使用する。
 *
 * 4. zzfx/ に ZzFXM Tracker で作った曲の JS ファイルを置く
 * index.html と同じフォルダに zzfx/ を追加してその中に入れる。
 * 未使用素材削除機能は使えないので注意。
 *
 * 5. zzfx/sound.json にサウンドボードを置く
 * zzfx/ フォルダの中に JSON ファイルを置き、以下のように書く。
 * {
 *   ”音の名前1”: ”[,,126,,.05,.08,1,.07,-13,-2.6,,,,,,,,.73,.06]”,
 *   ”音の名前2”: ”[1.32,,118,.11,.18,.02,3,.41,25,40,,,.09,,,,.19,,.03]”,
 *   ”音の名前3”: ”[,,441,.02,.14,.3,,.47,,.6,-195,.05,.09,,,.1,,.66,.1]”
 * }
 *
 * [使い方]
 *
 * プラグインコマンドを使ってください。
 * 曲を止めたい時は BGM の時と同様に BGM を無音にしてください。
 *
 * スクリプトやプラグインから実行したい場合は、
 * $zfx というグローバル変数が用意されているので、
 * そこからアクセスしてください。
 *
 * 例:
 * $zfx.playSound(
 *   // 音データ
 *   [,,126,,.05,.08,1,.07,-13,-2.6,,,,,,,,.73,.06],
 *   // 音量 50%
 *   0.5
 * )
 * $zfx.playSoundFromFile(
 *   // zzfx/sounds.json の音名
 *   ”音の名前1”,
 *   // 音量 50%
 *   0.5
 * )
 * $zfx.stopSound()
 * $zfx.playSong(
 *   // 譜面データ
 *   songData,
 *   // ループするか
 *   true,
 *   // 音量 50%
 *   0.5
 * )
 * $zfx.playSongFromFile(
 *   // ファイル名(拡張子抜き)
 *   ”MyNewSong”,
 *   // ループするか
 *   true,
 *   // 音量 50%
 *   0.5
 * )
 * $zfx.stopSong()
 *
 * [プラグインパラメーター:システムSE設定]
 *
 * データベース -> システム1 -> 効果音 にて設定が OFF になっている効果音は、
 * ここで設定した音に置き換わります。
 *
 * [Tips]
 *
 * - 音データ単体で音量を変更したい場合は、配列の最初の値を変更すれば変えられます。
 * 例1: [1.23,,107,,.01,.01,3,.21,,,,,.18,,390,,.36,.61,.01]
 *        ↓
 *      [2.34,,107,,.01,.01,3,.21,,,,,.18,,390,,.36,.61,.01]
 * 例2: [,,107,,.01,.01,3,.21,,,,,.18,,390,,.36,.61,.01]
 *        ↓
 *      [1.23,,107,,.01,.01,3,.21,,,,,.18,,390,,.36,.61,.01]
 *
 * Copyright (c) 2022 Had2Apps
 * This software is released under the MIT License.
 *
 * Version: v0.2.0-EXP
 * RPG Maker MZ Version: v1.5.0
 */