# Mods Listing and Installation

{% hint style="warning" %}
Using mods may cause unexpected bugs and errors in the game
{% endhint %}

## How to prepare your mods for installation

Mods can enhance your experience while playing the game. So we are going to teach how to install and use some of the most popular by players

1. Head over to **newman55's GitHub** repository and download the **Unity Mod Manager** \[[Click here](https://github.com/newman55/unity-mod-manager)]

<figure><img src="/files/FxYfVgrozbhcaKm6Zyxn" alt="" width="563"><figcaption><p>Newman55 Github - Readme Pagination</p></figcaption></figure>

2. Unzip the `UnityModmanager.zip` file into your desired location

<figure><img src="/files/CPszvuKtcboWeG8jfILm" alt="" width="563"><figcaption><p>File Explorer - Extracting the Unity Mod Manager</p></figcaption></figure>

3. Find the `UnityModManager.exe` file and run it

   3.1. In case you find trouble running the file due to version incompatibility, follow these steps \[[here](https://github.com/CrackThrough/ADOFAI-Mod-Installation-Guide/blob/main/eng/use-1.md#How-to-check-your-games-version)]

<figure><img src="/files/8DZ8gLaSNBBczSKyFWET" alt="" width="563"><figcaption><p>File Explorer - Running Unity Mod Manager</p></figcaption></figure>

4. Select the Game and the Game's Folder you want to install this Manager

<figure><img src="/files/Lw77PN20Xm36bhBvMWXL" alt="" width="332"><figcaption><p>Unity Mod Manager - Selecting the Game folders</p></figcaption></figure>

4.1. For the Game, select A Dance of Fire and Ice. For the game's folder, select the main folder where your game is located, typically with the folder name "A Dance of Fire and Ice"

<div><figure><img src="/files/HxxITcEC9AjtFaqLbACg" alt=""><figcaption><p>File Explorer - Finding the Game Folder 1</p></figcaption></figure> <figure><img src="/files/el9llTJfXupmSRFiawbi" alt=""><figcaption><p>File Explorer - Finding the Game Folder 2</p></figcaption></figure> <figure><img src="/files/wPR0ceTb2iJkuIsSHLn7" alt=""><figcaption><p>File Explorer - Finding the Game Folder 3</p></figcaption></figure></div>

{% hint style="info" %}
Default Steam Folder is at C:\Program Files (x86)\steam\steamapps\common\A Dance of Fire and Ice
{% endhint %}

5. Select the Mods Tab and drag all the .zip mod files you want into the white area and press Install Mod

<div><figure><img src="/files/vSxFnejZDPQyEbqKevGa" alt="" width="563"><figcaption><p>Unity Mod Manager - Dragging all .zip Mod Files</p></figcaption></figure> <figure><img src="/files/8smDhlcrxnSrhVEo2nfX" alt="" width="332"><figcaption><p>Unity Mod Manager - Mod Status</p></figcaption></figure></div>

6. Select the Install Tab and click on Install

<div><figure><img src="/files/eM7ikh44J8oR1vHOmSZI" alt="" width="333"><figcaption><p>Unity Mod Manager - Installing all Mods</p></figcaption></figure> <figure><img src="/files/00L6pjT03IRG6bkjwa9r" alt="" width="332"><figcaption><p>Unity Mod Manager - Successful Installation</p></figcaption></figure></div>

If everything worked correctly, all your mods should have an ok Status message on the Mod Tab and be found inside the game folder

When loading the game, the Unity Mod Manager should open automatically. Open/Close the manager window using <mark style="color:yellow;">`Ctrl + F10`</mark> at any time

<figure><img src="/files/iFr1nuFy5qTLQFZ6hbRN" alt="" width="563"><figcaption><p>Game Menu - Mod Manager working and ready to use</p></figcaption></figure>

## Mod List

### [AdofaiTweaks](https://github.com/PizzaLovers007/AdofaiTweaks)

* Provides various Quality Of Life settings, such as disabling VFX from levels, hiding judgment texts such as the "perfect!" judgment for less visual pollution, along with many other settings, and a key viewer.

***

### [AdofaiCSL](https://github.com/thijnmens/AdofaiCSL/releases/tag/V2.1.0)

* A custom level loader for levels that weren't downloaded from the workshop. Find a guide on how to use it [here](https://github.com/thijnmens/AdofaiCSL/tree/V2.1.0).

***

### [Release Overlay](https://github.com/c3nb/Overlayer/releases/tag/v2.4.0)

***

### [ShowBPM](https://github.com/FLOWERs-Modding/ADOFAI_ShowBPM/releases/tag/1.2.0)

* Shows the current BPM of the level being played, along with the *real* BPM, displayed according to angle turns; and displays BPM changes as multipliers.

***

### [Progress Displayer](https://github.com/FLOWERs-Modding/ADOFAI_ProgressDisplayer2/releases/tag/v2.0.8)

* Shows the progress percentage of a level throughout the gameplay.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://adofaieditor.gitbook.io/english/mods-listing-and-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.