インストールガイド

Balatro MODのインストール方法

Q: メインメニューにMODボタンが表示されない

Steamoddedが読み込まれていません。Lovelyがゲームフォルダにインストールされているか、SteamoddedのフォルダがModsフォルダの直下にあるかを確認してください。

ほとんどのBalatro MODは2つのツールで読み込まれます。Lovelyは、ゲームを起動するたびにパッチを当てるインジェクターです。Steamodded（smodsとも呼ばれます）はLovelyの上で動くMODローダーで、MODに共通のツールキットとゲーム内のMODメニューを提供します。両方が必要なMODもあれば、Lovelyだけで動くMODもあります。

このガイドでは両方のセットアップ方法、各OSでのModsフォルダの場所、よくあるトラブルを解説します。

aong.dev各MODの必要環境
MOD	Lovely	Steamodded
Edition Decks	はい	はい、26.829.0以降
Better Background	はい、0.9以降	任意
Chromite 開発中	はい、0.9以降	任意

1 Lovelyをインストール

LovelyのGitHubリリースページから最新版をダウンロードします。ゲームフォルダを開くには、SteamでBalatroを右クリックし、管理 › ローカルファイルを閲覧を選びます。

Windows: lovely-x86_64-pc-windows-msvc.zipをダウンロードし、winmm.dllをゲームフォルダにコピーします。古いLovelyを使っていた場合は、ゲームフォルダからそのversion.dllを削除してください。あとはいつも通りSteamからBalatroを起動します。
Steam Deck & Linux（Proton）: Windows版と同じwinmm.dllを使い、SteamでBalatroの起動オプションをWINEDLLOVERRIDES="winmm=n,b" %command%に設定します。
macOS: お使いのMacに合ったビルド（M系チップはaarch64、Intelはx86_64）をダウンロードし、liblovely.dylibとrun_lovely_macos.shをゲームフォルダにコピーします。ゲームはSteamからではなく、このスクリプトで起動してください。

各OSの最新情報は、Lovely公式のインストール手順を確認してください。

2 Steamoddedをインストール

使いたいMODがすべてSteamoddedを任意としている場合、この手順は飛ばしてください。それ以外の場合は、GitHubのリリースページから最新のSteamoddedをダウンロードして解凍し、そのフォルダをModsフォルダに移動します（次の手順）。公式の手順はSteamoddedのドキュメントにあります。

正しく動作していれば、メインメニューにインストール済みのMODを一覧できるMODボタンがあります。

3 Modsフォルダを探す

ModsフォルダはゲームフォルダではなくBalatroのセーブフォルダにあります。見つからない場合はModsという名前のフォルダを作成するか、Lovelyをインストールした状態で一度ゲームを起動すると自動で作成されます。

Windows: %AppData%\Balatro\Mods（エクスプローラーのアドレスバーに貼り付けてください）
macOS: ~/Library/Application Support/Balatro/Mods（Finderで Shift-Command-. を押すと隠しフォルダが表示されます）
Steam Deck & Linux: ~/.steam/steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods
Flatpak版Steam: ~/.var/app/com.valvesoftware.Steam/.steam/steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods

4 MODを追加

MODのzipをダウンロードします。aong.devでは、各MODページにある緑のダウンロードボタンです。
解凍します。EditionDecks-mainのようなフォルダが1つできます。
そのフォルダをModsフォルダに移動します。MODごとに専用のフォルダが必要です。
Balatroを起動します。Steamoddedを使うMODは、メインメニューのMODに表示されます。

GitHubからダウンロードしたフォルダ名の末尾にある-mainは、残しても消しても問題ありません。

MODの互換性

aong.devのMODは、同じModsフォルダで共存できるように作られています。確認済みの組み合わせと、それぞれの動作は以下のとおりです。

Chromite + Handy: Chromiteの速度、アニメーションスキップ、キー操作はHandyに譲ります。「強制」スイッチを使えば、Chromite側をオンにすることもできます。
Chromite + Saturn: 速度とアニメーションスキップも同じように譲ります。
Chromite + JokerDisplay: ジョーカーのオーバーレイはJokerDisplayが担当します。Chromiteはその表示/非表示を切り替えるキーを追加します。
Chromite + Multiplayer: ゲームのテンポを変えるChromiteの機能は、ロビー内ではオフになります。
Better Background + Chromite: ChromiteにもBetter Backgroundと同じ背景機能が含まれているため、Better Backgroundは自動でオフになります。

トラブルシューティング

メインメニューにMODボタンが表示されない

Steamoddedが読み込まれていません。Lovelyがゲームフォルダにインストールされているか（Windowsでは、インストールされているとゲームの横にコンソールウィンドウが開きます）、SteamoddedのフォルダがModsフォルダの直下にあるかを確認してください。

MODをフォルダに入れたのにゲームが読み込まない

Mods/BetterBackground/BetterBackground/のように、フォルダの中にフォルダがないか確認してください。解凍すると階層が一つ増えることがあります。内側のフォルダを上に移動し、MODのファイルがModsの一つ下に来るようにしてください。

MODを追加したらゲームがクラッシュする

クラッシュ画面でMODの名前を確認し、そのMODのページで必要なLovelyやSteamoddedのバージョンを確認してください。2つのMODが競合している場合は、片方をModsフォルダから外して再起動し、どちらが原因かを特定します。

LovelyとSteamoddedの違いは？

Lovelyは読み込み時にゲームのコードを書き換えます。SteamoddedはLovelyが読み込むMODで、さらに他のMODを読み込み、共通のツールと設定メニューを提供します。Steamoddedには必ずLovelyが必要です。

MODを削除するには？

そのフォルダをModsフォルダの外に移動します。すべてのMODを無効にするには、ゲームフォルダからLovelyのファイルを削除します。