0 of 0

File information

Last updated

Original upload

Created by

S-Katagiri

Uploaded by

4lga6a5ka

Virus scan

Safe to use

Tags for this mod

About this mod

Random Music Player version of Jenix's Music Replacer Framework/Jenix の Music Replacer Framework にランダム再生機能を付けてみた

Requirements
Permissions and credits
Changelogs
日本語の説明は一番下にあります

Features

Like Jenix's Music Replacer Framework , You can also make playlists and play them randomly when a wave is going. (I got permission to publish this mod from the author)

After this mod is independent from the original mod, both mods have changed much for a long time.

In summary, this mod's goal is to provide a random music player and display the music information because I'm bored of the default music.





Spoiler:  
Show

All music by Sei Mutuski, licensed under CC-BY-SA

  • EpicBattle_Deity

  • Epicbattle_J

  • 8bitRPG_Battle

  • Seanchas



How to Install

same as the original mod

  • As usual, install this via any Mod manager, or download, unzip, drag, and drop the folder into {BaS Folder}\BladeAndSorcery_Data\StreamingAssets\Mods\
  • Prepare music sources in one of the ways A to C, which is explained in the section "Usage"

Usage

Almost the same as the original mod, but many features added. You can choose One out of the following three (A to C) ways to play music. I recommend method A if you can't decide.

A. How to Play Your Favorite Audio Files

  • Make sure to set the "folder" value to the "Folder From " option in the Menubook.
  • Create a folder named "Musics" in this mod folder (where RandomMusicPlayer.dll is placed)
  • Make a folder structure and drop audio files into them as playlists. E.g., If you want to play foobar.mp3 in any battle, drop this file into Musics\global\; if you want to play it only when fighting in Arena level, drop it into Musics\Arena\; if you want to play it only in wave Recruit1, drop into Musics\Recruit1\.
I.e., please do like this.
Spoiler:  
Show




Please note:

  • Only MP3 and OGG are available
  • The audio metadata is retrieved from the file automatically, no need to write it down in the musicMetadata field
  • playLists is also ignored when  "audiosFrom": "folder"

B. How to install Music Pack Mods

You need to install extra music pack mods like the original instruction of the Music Replacer Framework. Note that currently only my sample is available, and any music pack for Music Replacer Framework DOESN'T WORK with this mod.

Spoiler:  
Show

Please note the following new instructions:



  • Install any music pack. You can find the Sample Music Pack on this page and download it just like a typical mod.
  • Confirm that "Audios From" is set to "bundle" in the Menubook.
  • Specify the Play List option. The playlist is chosen automatically if not set.
If you want to make your music pack, see the Sample Music pack. It contains the bundle files and JSON files which can describe the audio file address and its metadata.



C. How to Play External Media Players (DEPRECATED since v3.0)

Spoiler:  
Show

Disclaimer: Currently this function is very limited. Please agree on this if you use this function.
  • Make sure "audiosFrom": "external" in Level_MusicReplacer.json
  • Launch any media player (including YouTube, Spotify, etc. on a web browser)
  • Open your favorite playlist
  • Launch the game and start the battle
  • If it doesn't work well, make the media player status "paused" before starting the battle

This function is implemented by pressing the Windows virtual keyboard. I guess this is technically identical to KaiDevvy's Media Controller. So if this doesn't work, in most cases, it will be caused by the Windows environment, not this mod.



More Options:

This mod has many options. You can check them on the Menubook. E.g.,

  • Soundtrack information widget on HMD/Window/LIV Mixed Reality screen
  • The widget can change the alignment and size 
  • playing mode: you can choose to play all soundtracks randomly, choose one out of them per wave, or play all without shuffling

Notes

Please check out my UI mods



Acknowledgments

I made this mod referring to Jenix's source code. Thanks for the permission to publish.
Thank you for the helpful comments, MemeMan.

--------------------------------------------------------------------------------------------------------

機能

Jenix の Music Replacer Framework を参考に, Wave戦闘時に好きなBGMをランダム再生できるプログラムを作りました.

オリジナルから独立してから時間が経ったため, 両者の細かい違いは多岐にわたります. 要約すると, 私が同じBGMに飽きたので, ランダム再生と再生情報を表示する機能が欲しかったというのがこのmodを作ったのモチベーションです.




Spoiler:  
Show

例えば, 付属のサンプルファイルには, 以下のようなBGMが収録されています.
全ての音声ファイルはムツキセイ氏の著作物であり, クリエイティブ・コモンズ表示 - 継承 4.0 国際ライセンスの下で提供されています.

  • EpicBattle_Deity

  • Epicbattle_J

  • 8bitRPG_Battle

  • Seanchas




インストール方法

オリジナルとほぼ同じです.

  • いつも通りです. Mod Organizer 2 や Vortex のような mod管理ソフトを使ってインストールするか, フォルダを解凍して {BaS インストールフォルダ}\BladeAndSorcery_Data\StreamingAssets\Mods\ にドラッグ&ドロップしてください
  • 「使用法」に書かれている A から C いずれかの方法で音声ファイルを再生できる状態にしてください

使用法

元modのコンセプトを踏襲していますが, ランダム再生をはじめ多くの機能を追加しています. 好きな音声を再生するには, 以下A-Cの3種類の方法があります. 同時に複数使用することはできません. Aが一番簡単だと思うので, どれにすべきか判断できない場合はとりあえずAの方法でやってみてください. 

A. 好きな音声ファイルを追加する方法

  • ゲーム内でメニューブックを開き, このmodのオプションの「取得元」の値が「フォルダ」になっていることを確認してください.
  • この modフォルダ (RandomMusicReplacerFramework) 内に Musics というフォルダを作り, その中に playLists と同じフォルダ構造でファイルを配置してください. 例えば, 全てのマップ・waveで共通のプレイリストを指定したい場合, Musics\global\ フォルダ内に音声ファイルを配置してください. Arena マップ限定のプレイリストならば, Musics\Arena\ フォルダに, Recruit1 (練習の「簡単」レベル) 限定のBGM にしたいならば Musics\Recruit1\ フォルダに音声ファイルを配置してください.

つまり, こんな感じのフォルダ階層になります.
Spoiler:  
Show




以下3点に注意してください.

  • 対応している音声ファイルは MP3 と OGG のみです
  • メタデータはファイルから直接読み取られます. JSONファイル内の musicMetadata フィールドは無視されます
  • playLists の記述も, このモードでは無視されます.

B. 音声パックmodを追加でインストールする方法

音声パックmodをインストールして再生することも出来ます. 現在このmod専用の音声パックmodは現時点では私の作ったサンプルのみです. Music Replacer Framework の音声パックmodとは互換性がないので動作しません.

Spoiler:  
Show

以下に注意してください.

  • 音声パックmodをインストールしてください. このページにある Sample Music Pack がその1つです. インストール方法は典型的なmodと同じです.
  •  ゲーム内のメニューブックを開き,「取得元」オプションの値が「バンドルになっていることを確認してください.
  • 「プレイリスト」オプションでプレイリストを選択してください. 設定しない場合は適当に自動で選ばれます.

音声パックを自分でつくりたい場合は, ここで配布している音声パックmodを参考にしてください. Unity Editor と B&S SDK と, そしてこれらを扱う知識が必要です.


C. 外部メディアプレイヤーを使う場合 (v3.0以降は廃止されました)

Spoiler:  
Show

この機能はまだかなり限定的なことに注意してお使いください.
  • "audiosFrom": "external" に設定を変更します
  • いずれかのメディアプレイヤーを起動します (Webブラウザで YouTube や Spotify を開いてもかまいません)
  • お気に入りのプレイリスト等が再生できる状態にしておきます
  • ゲームを起動し, 適当に戦ってください
  • もし再生がうまくいかない場合, 戦闘開始前にメディアプレイヤーを一時停止状態にしてみてください.

この機能は Windows API の仮想キーボードを使用しており, おそらくこれは KaiDevvy の Media Controller と技術的に同じことをしています. うまく動作しない場合のほとんどはメディアプレイヤー側が仮想キーボードに対応していないのが原因です.


オプションについて

ゲーム中にメニューブックを開くことで, 色々なオプションを設定できます. 例えば

  • HMD/ウィンドウ/LIV Mixed Reality それぞれの画面に再生中の楽曲情報を表示させられます.
  • ウィジェットの表示位置やサイズを変えられます
  • 再生モードを変更できます. 登録した全曲をランダムに再生・戦闘1回ごとに1つだけランダムに選んでループ再生・シャッフルせずに全曲再生, の3通りから選べます.

その他

私の作った UI改善系Mod群です.


謝辞

このmodを作成するにあたって Jenix のオリジナルのソースコードを参考にしました. 作者の許可に感謝します.
  翻译: