# Bizhawk Shuffler 2 設定筆記

------

{%youtube cM59AVWpFv8 %}

> Bizhawk Shuffler 2 的插件「Megaman Damage Shuffler」功能演示

------

## Bizhawk Shuffler？

> 「A script and setup program to randomize games being played in BizHawk」- brossentia

在 Bizhawk 上隨機遊戲的設定工具、腳本，讓玩家體驗「**Random Games at Random Times**」從而導致腦袋打結的混沌快感。

------

## 事前準備

- 模擬器 Bizhawk 2.6.2，其他版本未確定效果，
但根據 brossentia 說明至少要在 2.5.3 或以上
- 遊戲 ROM 和相對應的 BIOS
(例如洛克人 X2、X3 需要一個叫 CX4 的 BIOS 檔案)
- Bizhawk Shuffler 2 的 [Github 專案頁面](https://github.com/authorblues/bizhawk-shuffler-2)，
往下拉，點擊「click here to download the latest version」下載

------

## Bizhawk Shuffler 2 要放哪裡？

解壓縮後把整個資料夾放到跟 EmuHawk.exe 同一個目錄那邊。

------

## 檔案配置

(1) 打開 Bizhawk，先不要載入遊戲

(2) Bizhawk 工具列 Tools -> Lua Console，打開 Lua 小視窗

(3) Lua 小視窗工具列 Script -> Open Script，
選擇下載回來的「shuffler.lua」
(會有小視窗彈出來但先縮小不用管)

(4) shuffler.lua 同一個目錄會自動產生一個資料夾「games」，
把洛克人 X1 ~ X3 這堆遊戲 ROM 通通塞進去

> 如果是 PS 遊戲，通常會包含兩個檔案以上 (bin/cue、ccd/img)，
這部分 Shuffler 會自動處理 (吧？)

------

## 隨機配置 (Bizhawk Shuffler 2 小視窗)

回到 Bizhawk Shuffler 2 小視窗，以下按重要順序說明：

**Min/Max Swap Time (時間到就切換)**

經過幾秒後會切換遊戲，min -> 最快，max -> 最慢。
想要固定時間切換的話可以把 min 值和 max 值都設定為同一個秒數。

**Setup Plugins (安裝插件)**

這邊可以藉由插件新增額外功能，像是「Countdown to Swap (切換倒數提醒)」；
以及**特殊玩法**插件，像是「Megaman Damage Shuffler (洛克人受傷切換)」，
「Sonic Ring Sync (音速小子金環同步)」等等。

> 插件安裝方法
>
> (1) Setup Plugins
> (2) Choose a Plugin
> (3) 選擇「Megaman Damage Shuffler」
> (4) Select
> (5) Enabled 打勾
> (6) Save and Close

要注要的是如果只想要挑戰 Megaman Damage Shuffler，
可以把 Swap Time 的 min 值和 max 值都設定為 75600 秒 (= 21 小時)，
讓遊戲過程中就只有在 21 小時後，或者受傷時才會切換。

**Shuffler Swap Order (遊戲出場順序)**

基本上不用管，預設是 Random Order (隨機順序)，
選 Fixed Order 的話就是固定順序。

**Seed (亂數種子)**

基本上不用管，開始前按一下旁邊的 Randomize Seed 即可，
如果想要電視牆、共用同一個 Seed 的話可以複製給其他跑者。

**Hotkey: Game Completed (跑完辣熱鍵)**

基本上不用管，預設是 Ctrl + Shift + End，
完成一款遊戲之後，輸入熱鍵就會繼續下一款，
並且不會再跑回來重複挑戰。

------

## 開始挑戰！！

按下「Start New Session」開始挑戰，武運ㄛ！

------

## 挑戰可以中斷嗎？

可以，假設挑戰過程中關掉 Bizhawk，那麼：

### Part 1 - Lua 小視窗

(1) 重新打開 Bizhawk，先不要載入遊戲
(2) Bizhawk 工具列 Tools -> Lua Console，打開 Lua 小視窗
(3) Lua 小視窗工具列 Script -> Open Script，
選擇下載回來的「shuffler.lua」，會有小視窗彈出來

### Part 2 - Bizhawk Shuffler 2 小視窗

(1) 勾選「Resume a session?」
(2) 點擊「Resume Previous Session」就會回到上次進度，插件也會自動載入

------

## 挑戰過程中可以新增額外的遊戲項目嗎？

可以，把想要新增的遊戲放到 games 資料夾裡，再砍掉「.games-list.txt」，Bizhawk 會產生新的隨機遊戲清單。

------

## 一款遊戲雙線進行～以洛克人 X4 美版為例

(1) 備份 Mega Man X4 (USA).bin 和 Mega Man X4 (USA).cue

(2) 複製兩份放到 games 資料夾

(3) 改名字，分別改成：

Mega Man X4 (USA) - X.bin
Mega Man X4 (USA) - X.cue
Mega Man X4 (USA) - Z.bin
Mega Man X4 (USA) - Z.cue

(4) [X 線] 用 Notepad++，或者記事本打開 Mega Man X4 (USA) - X.cue，
把裡面的「Mega Man X4 (USA).bin」改成「Mega Man X4 (USA) - X.bin」

(5) [Z 線] 用 Notepad++，或者記事本打開 Mega Man X4 (USA) - Z.cue，
把裡面的「Mega Man X4 (USA).bin」改成「Mega Man X4 (USA) - Z.bin」

(6) 挑戰的時候打開 OBS 預覽，看正在跑的遊戲是哪條路線，這部分可以參考筆記下一環

------

## 文字檔輸出給 OBS

shuffler.lua 同一個目錄有一個資料夾「output-info」，
裡面都是 txt 文字檔，可以丟給 OBS 秀出來。

**current-game.txt**
正在跑的遊戲 (的檔案名字)

**total-time.txt**
全程用時 (參考用，非 Speedrun 精準需求)

**total-swaps.txt**
全程切換了多少次

**current-time.txt**
正在跑的遊戲的時數 (參考用，非 Speedrun 精準需求)

**current-swaps.txt**
全程切換了多少次到正在跑的遊戲

**completed-games.txt**
已經完成的遊戲，一款一行

------

## Megaman Damage Shuffler 支援列表 (20210821)

> 目前這個插件對於美版 ROM 支援度較高，希望之後更新會更完整 QQ

遊戲 | ROM Hash 支援一覽
-----------------|-----------------------
Mega Man 1-6 NES | FC 元祖 1 ~ 6 (日、美版)
Mega Man 7 SNES | SFC 元祖 7 (日、美版)
Mega Man 8 PSX | PS 元祖 8 (美版)
Mega Man X SNES | SFC X1 (日版 1.0、1.1、美版 1.0、1.1、歐版)
Mega Man X 2-3 SNES | SFC X2、X3 (日、美、歐版)
Mega Man X3 PSX (PAL & NTSC-J) | PS X3 (日、歐版)
Mega Man X4-X5 PSX | PS X4、X5 (美版)
Mega Man X6 PSX | PS X6 (日、美版)
Mega Man Xtreme 1 & 2 GBC | GBC X1、X2 (美版)
Rockman & Forte SNES | SFC 洛克人與佛魯迪 (日版)
Mega Man I-V GB | GB 洛克人世界 1 ~ 5 (日、美、歐版)
Mega Man Wily Wars GEN | MD 洛克人威利戰爭 (日、歐版)
Mega Man Battle Network 1-3 GBA | GBA EXE1 ~ EXE3 (美版)
Mega Man Legends/64 | PS or N64 Dash 1 (美版)
Rockman & Forte WonderSwan | WonderSwan 洛克人與佛魯迪 (日版)
Rockman EXE WS | WonderSwan EXE WS (日版)
Rockman Battle & Fighters | Neo Geo Pocket Color 洛克人威力熱鬥戰士 (日版)
Mega Man Soccer | SFC 洛克人足球 (日、美版)
Mega Man Battle & Chase | PS 洛克人賽車 (日版 1.0、1.1、歐版)
Super Adventure Rockman PSX | PS 洛克人大冒險 (日版)

------

## Bizhawk 的 NDS 設定

- 目前仍然在實驗階段，核心為 MelonDS
- (居然沒有模擬器原版的 JIT 功能太難過)
- 畫面大小不能用內建的 custom size 功能調整 (觸控方面有 Bug)，解決方法：
(1) Bizhawk 工具列 -> Config -> Display -> Aspect Ratio Selection -> 選擇「Use system's recommendation」
(2) Bizhawk 工具列 -> View -> Window Size，在這邊選擇想要的視窗大小
- 按鍵設定保留 Touch (滑鼠左鍵)，其他按鍵可以用 Esc 清掉再設定

------

## 參考資料

Bizhawk Shuffler 2 by authorblues
https://github.com/authorblues/bizhawk-shuffler-2

Megaman Damage Shuffler 的 ROM Hash 資料庫
https://github.com/authorblues/bizhawk-shuffler-2/blob/main/plugins/megaman-hashes.dat

Bizhawk Shuffler by brossentia
https://github.com/brossentia/BizHawk-Shuffler

元祖 5 代假老哥強制切換 by PinkKittyRose
https://clips.twitch.tv/HedonisticDaintyMetalPJSugar-_wdjbp8wxet2pbvI

------