├── .gitignore
├── LICENSE
├── README.md
├── TODO.md
├── eng
├── main.md
├── resources
│ ├── dev-3
│ │ └── image1.png
│ ├── use-1
│ │ ├── image1.png
│ │ ├── image2.png
│ │ └── image3.png
│ └── use-2
│ │ ├── image1.png
│ │ ├── image2.png
│ │ └── image3.png
├── use-1.md
└── use-2.md
├── jap
├── dev-1.md
├── dev-2.md
├── dev-3.md
├── main.md
├── resources
│ ├── dev-3
│ │ └── image1.png
│ ├── use-1
│ │ ├── image1.png
│ │ ├── image2.png
│ │ └── image3.png
│ └── use-2
│ │ ├── image1.png
│ │ ├── image2.png
│ │ └── image3.png
├── use-1.md
└── use-2.md
└── kor
├── dev-1.md
├── dev-2.md
├── dev-3.md
├── main.md
├── resources
├── dev-3
│ └── image1.png
├── use-1
│ ├── how-to-see-version.png
│ ├── smartscreen.png
│ ├── umm-folder-select.png
│ ├── umm-game-dropdown.png
│ ├── umm-icon.png
│ ├── umm-install.png
│ └── umm-method-select.png
└── use-2
│ ├── how-to-download-in-github.png
│ ├── mm-mod-needs-update.png
│ ├── mm-mod-settings.png
│ ├── mm-mod-status.png
│ ├── umm-auto-update.png
│ ├── umm-drop-to-install.gif
│ └── umm-select-to-install.gif
├── use-1.md
└── use-2.md
/.gitignore:
--------------------------------------------------------------------------------
1 | .vscode/
2 | .git/
3 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2024 CrackThrough
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # ADOFAI Mod Installation Guide
2 |
3 | > [!WARNING]
4 | > 이 가이드는 오래되었습니다!
5 | > 새로운 모드 설치 가이드는 https://adof.ai/mod 에서 확인하세요.
6 |
7 | ### 한국어: [여기를 클릭하세요!](./kor/main.md)
8 | ### English: [Click here!](./eng/main.md)
9 | ### 日本語: [ここをクリック!](./jap/main.md)
10 |
11 |
12 | ### 도움이 필요할 때 / Where to seek for help
13 |
14 | 이 가이드로도 진행에 어려움이 있다면, [ADOFAI.gg Community 디스코드 서버](https://discord.gg/TKdpbUUfUa)에 있는 `#모드-도움` 채널에 도움을 구하거나, 이 리포지토리에 이슈를 만들어 주세요.
15 |
16 | If anything stated here doesn't work for your distro, feel free to join the [ADOFAI.gg Community Discord](https://discord.gg/TKdpbUUfUa) and ask for help in `#modding-support` channel or open an issue.
17 |
18 |
19 | ### Contribution
20 |
21 | Thanks to:
22 | - [PizzaLovers007](https://github.com/PizzaLovers007) for helping English translations!
23 | - [Gotchfutchian](https://github.com/Gotchfutchian) for adding all the Linux related contents.
24 | - [sjk](https://github.com/sjkim04) for helping with Japanese translations
25 | - [ppapman](https://github.com/ppapman1) for rewriting entirety of the Korean installation guide
--------------------------------------------------------------------------------
/TODO.md:
--------------------------------------------------------------------------------
1 | # TODO List
2 |
3 | - [x] Discord channels should be `#in-this-format` instead of #in-this-format.
4 | - [x] Decide to whether only use `UnityModManager` or UnityModManager for consistent formatting.
5 | - [x] Create eng resources for `use-1` and `use-2`, then change the `resources/` structure.
6 | - [x] Lowercase all image extensions.
7 | - [ ] `dev-x.md` under `eng/` directory.
8 | - [ ] Finish writing `kor/dev-2.md`.
--------------------------------------------------------------------------------
/eng/main.md:
--------------------------------------------------------------------------------
1 | # English Modding Guide
2 | [[ < Previous Page ]](../README.md)
3 |
4 | ## Mod use and installation guide
5 | 1. [Installing and configuring UnityModManager](./use-1.md)
6 | 2. [Installing ADOFAI mods and configuring them within UnityModManager](./use-2.md)
7 |
8 | ## Mod development guide
9 | I'm still writing this. Come back later.
--------------------------------------------------------------------------------
/eng/resources/dev-3/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/dev-3/image1.png
--------------------------------------------------------------------------------
/eng/resources/use-1/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-1/image1.png
--------------------------------------------------------------------------------
/eng/resources/use-1/image2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-1/image2.png
--------------------------------------------------------------------------------
/eng/resources/use-1/image3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-1/image3.png
--------------------------------------------------------------------------------
/eng/resources/use-2/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-2/image1.png
--------------------------------------------------------------------------------
/eng/resources/use-2/image2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-2/image2.png
--------------------------------------------------------------------------------
/eng/resources/use-2/image3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/eng/resources/use-2/image3.png
--------------------------------------------------------------------------------
/eng/use-1.md:
--------------------------------------------------------------------------------
1 | # English Modding Guide
2 |
3 | [[< Previous Page]](./main.md) [[Next Page >]](./use-2.md)
4 |
5 | ## Installing and configuring UnityModManager
6 |
7 | ### Installing UnityModManager
8 |
9 | 1. `UnityModManager` installation link: https://github.com/newman55/unity-mod-manager
10 | - Click the **Dropbox** text to download the file.
11 | 2. Unzip the downloaded `UnityModManager.zip`.
12 | - **Do not** unzip the file inside ADOFAI's directory!
13 | 3. If needed, [edit](#File-Editing) the `UnityModManagerConfig.xml` file based on [your game's version](#How-to-check-your-games-version) and execute the `UnityModManager.exe` file.
14 | 4. Configure `UnityModManager`.
15 | - Click the `Install` tab.
16 | - Click the dropdown next to the `Game` text, and select `A Dance of Fire and Ice`.
17 | - Click the button next to the `Folder` text, and select the folder (preferably the Steam folder) that contains the .exe file of ADOFAI. After selecting the folder, you can click OK.
18 | - Choose `Assembly` in the `Installation Method` group.
19 | - After clicking the `Install` button, please check if notepad pops up after executing the game. If notepad pops up, it means something went wrong while editing `UnityModManagerConfig.xml`. If you can't see what's wrong and need help, you can always join the [ADOFAI Modding Community Discord](https://discord.gg/AGFXhCfyE5) and ask for help.
20 | - If you are having a hard time understanding, you can follow the same steps using image below. The correct sequence is Red → Blue → Green if you can't read small numbers well.
21 |
22 | 
23 |
24 |
25 | Note! Linux users should download the `mono` package to use for `UnityModManager`, and run it from the terminal with
26 | ```shell
27 | mono /path/to/UnityModManager.exe
28 | ```
29 | If you have problems while using the above method, you may have to use the command with sudo:
30 | ```shell
31 | sudo mono /path/to/UnityModManager.exe
32 | ```
33 | ~~Also, Run ADOFAI under "Proton-GE", its on github and allows for correct mod loading. (I think those who dont use the steam version may be able to use WINE-GE.)~~
34 |
35 | Currently, there is a native Linux version of ADOFAI in the alpha branch, but it is unconfirmed that mods will work. If you found something, tell us via opening an issue/PR!
36 |
37 | ---
38 |
39 |
40 |
41 | ### Additional Information
42 |
43 | #### How to check your game's version
44 |
45 | For older versions of ADOFAI, press `Esc` on main screen and go to `Settings`.
46 | 
47 |
48 | For the latest version of ADOFAI, press `Esc` on main screen.
49 | 
50 |
51 | #### File Editing (OUTDATED)
52 |
53 | **You should only do this if both installed mods and mod manager doesn't work and notepad pops up!**
54 |
55 | There is a case you should edit the `UnityModManagerConfig.xml` file because of codebase differences between the current(`1.11.3 r70~`) and past(`v1.11.1 r68`) versions.
56 |
57 | [Click here to see how you can check your game's version.](#How-to-check-your-games-version)
58 |
59 |
60 | ```xml
61 |
62 |
63 | ...
64 |
65 |
66 | ```
67 |
68 | Find the lines with above contents, and edit the nested `StartingPoint` and `UIStartingPoint`.
69 |
70 | On any version `r68` and below, use the below settings.
71 |
72 | ```xml
73 | [Assembly-CSharp.dll]ADOBase.SetupLevelEventsInfo:Before
74 | [Assembly-CSharp.dll]ADOBase.SetupLevelEventsInfo:After
75 | ```
76 |
77 | After any version `r69`, use the below settings. (You do not need to edit your file at all if you just downloaded `UnityModManager`.)
78 |
79 | ```xml
80 | [Assembly-CSharp.dll]ADOStartup.Startup:Before
81 | [Assembly-CSharp.dll]ADOStartup.Startup:After
82 | ```
83 |
84 | This is preview of your settings. Note that `your settings value..` is not the actual value; it should be one of the values above.
85 |
86 | ```xml
87 |
88 | ADOFAI
89 | Mods
90 | Info.json
91 | A Dance of Fire and Ice.exe
92 | [UnityEngine.UIModule.dll]UnityEngine.Canvas.cctor:Before
93 | your settings value..
94 | your settings value..
95 | 0.22.14
96 | Required minimum game version 1.11.3
97 |
98 | ```
99 |
100 | [Alternatively, you can download a pre-edited version of the file.](https://drive.google.com/file/d/1BZ6XJwMnb9KsKtLcuQ5JctRs81nw_60V/view?usp=sharing)
101 |
102 | __**Note that you are REQUIRED to restart your `UnityModManager` after making changes to your settings file.**__
103 |
104 | ---
105 |
106 | ## [Click here to go the next page.](./use-2.md)
107 |
--------------------------------------------------------------------------------
/eng/use-2.md:
--------------------------------------------------------------------------------
1 | # English Modding Guide
2 |
3 | [[< Previous Page]](./use-1.md)
4 |
5 | ## Installing ADOFAI mods and configuring them within UnityModManager
6 |
7 | ### Downloading the mod and applying it
8 |
9 | 1. Install any ADOFAI mod you'd like to. **It must be a .zip file, so do not unzip the file.**
10 | 2. Execute `UnityModManager.exe` and click the `Mods` tab.
11 | 3. Click the `Install Mod` button or drag your .zip file into the `Drop zip files here` area.
12 | 4. Check if you have the `OK` text in your mod's `Status`. If you don't have the text, then you should right click it and click `Install`.
13 | - If you still don't get the OK text, there's a high chance that it's a problem of the mod's file itself. Try contacting the mod developer or ask for help in the [ADOFAI.gg Community Discord](https://discord.gg/TKdpbUUfUa).
14 | 5. If there is any update for the mod, right click the mod and click `Update to vX.X.X`. If the mod's latest version cannot be checked via `UnityModManager`, you need to download the updated .zip by yourself and apply it again.
15 |
16 | Linux users; If ADOFAI Tweaks (or any mod) is reporting it cant read a DLL, use Proton-GE and manually re-extract the dll's it uses in
17 | `/[where steam is installed]/Steam/steamapps/common/A Dance Of Fire And Ice/Mods/AdofaiTweaks [or another mod]`
18 |
19 | The image below shows how UnityModManager should look like after installing a few mods.
20 |
21 | 
22 |
23 | ### Configuring the mod
24 |
25 | If the mod supports custom settings in `UnityModManager`, you can press `Ctrl + F10` (this is the default keybind, you can change this in the `Settings` tab) then click on the sliders icon to configure it. For example, the settings for `ADOFAI Tweaks` look like this:
26 |
27 | 
28 |
29 | Some mods may not have their settings in `UnityModManager`'s settings menu. You should read any instructions posted along with the mod file for how to change the settings.
30 |
31 | ### Updating the mod
32 |
33 | If you see a download icon after the mod's name, it means there's an update available.
34 |
35 | To update the mod, you should close the game first, open `UnityModManager.exe`, open the `Mods` tab, right-click the mod, and click `Update to vX.X.X`.
36 |
37 | ### Toggling ADOFAI mods
38 |
39 | You can toggle some mods by clicking the checkbox in the `On/Off` column.
40 |
41 | You can also check the status of the mod in the `Status` column.
42 |
43 | 
44 |
45 | `Status` List:
46 |
47 | | State | Explanation |
48 | | :---- | :-------------------------------------------------------------------- |
49 | | !!! | An error occurred in the mod. Check `Logs` tab to see its error logs. |
50 | | Red | You have to restart the game to use this mod. |
51 | | Gray | The mod is currently disabled. Toggle the mod to re-enable it. |
52 | | Green | The mod is currently active. |
53 |
--------------------------------------------------------------------------------
/jap/dev-1.md:
--------------------------------------------------------------------------------
1 | # 日本語MODガイド
2 | [[ < 前へ ]](./main.md) [[ 次へ > ]](./dev-2.md)
3 |
4 | ## 最小開発条件 (参考用)
5 | * [.NET Framework 4.8](https://go.microsoft.com/fwlink/?linkid=2088517) - (絶対4.8である必要はないですが、個人的に推薦するバージョンです。)
6 | * [UnityModManager](https://github.com/newman55/unity-mod-manager)
7 | * Harmony - `UnityModManager`と一緒にインストールされます。(ファイル名:`0Harmony.dll`)
8 | * Unity - ゲームのフォルダ内のdllファイルを参照に追加すればOKです。
9 |
10 | ## 開発環境の整備
11 |
12 | ここでは[Visual Studio 2019](https://visualstudio.microsoft.com/) IDEを基準に説明します。
13 |
14 | 1. [クラス ライブラリ C# プロジェクトを作成](https://docs.microsoft.com/ja-jp/dotnet/core/tutorials/library-with-visual-studio)します。
15 | 2. [必要な参照を追加](https://docs.microsoft.com/ja-jp/visualstudio/ide/managing-references-in-a-project?view=vs-2019)します。
16 | * `UnityModManager/0Harmony.dll`
17 | * `UnityModManager/UnityModManager.dll`
18 | * `A Dance of Fire and Ice_Data/Managed/Unity*.dll`(MODが必要とするUnityモジュールを追加してください。)
19 | * `A Dance of Fire and Ice_Data/Managed/Assembly-CSharp.dll`
20 | * `A Dance of Fire and Ice_Data/Managed/Assembly-CSharp-firstpass.dll`
21 | 3. Info.jsonファイルを作成し、MODの情報を記入します。
22 | * これに関しては[このサイト](https://wiki.nexusmods.com/index.php/How_to_create_mod_for_unity_game)で詳しく説明されています。
23 |
24 | ---
25 |
26 | ## [ここをクリックして次へ進む](./dev-2.md)
--------------------------------------------------------------------------------
/jap/dev-2.md:
--------------------------------------------------------------------------------
1 |
2 | # 日本語MODガイド
3 | [[ <前へ]](./dev-1.md) [[ 次へ > ]](./dev-3.md)
4 |
5 | まだ構想中の文書です。
6 |
28 | ---
29 |
30 | ## [ここをクリックして次へ進む](./dev-3.md)
--------------------------------------------------------------------------------
/jap/dev-3.md:
--------------------------------------------------------------------------------
1 |
2 | # 日本語MODガイド
3 | [[ < 次へ ]](./dev-2.md)
4 |
5 | MODが完成したら、人々に知らせる番です。 MODをリリースして知らせる最も効果的な方法は[ADOFAI.ggコミュニティDiscord](https://discord.gg/TKdpbUUfUa)でMODをリリースすることです。
6 |
7 | 1. コミュニティDiscordで`/createticket`を入力して`ADOFAI.gg Community`を選択してチケットを開き、Mod Developerロールの要請をしてください。
8 | 2. ロールをもらったら、`#모드-공지-mod-announcements`チャンネルに[下記のガイドライン](#)に沿ってMODをリリースできます。
9 | 3. MODをアップデートした場合、`#모드-공지-mod-announcements`チャンネルに、変更事項と共に[下記のガイドライン](#)に沿ってMODの新しいバージョンをリリースできます。
10 |
11 | ## MODリリースガイドライン
12 |
13 | MODをリリース、アップデートする場合は下記の内容が**絶対に**含まれる必要があります。
14 | - MODの名前
15 | - MODのバージョン
16 | - MODに含まれる、または追加・修正・削除された機能の説明
17 | - MODのダウンロードリンクまたは添付されたMODファイル
18 |
19 | 下記の内容は必須ではありませんが、MODを探しやすくするため、MOD利用者の便宜のため、含まれることが勧められる内容です。
20 | - サポートするA Dance of Fire and Iceのバージョン
21 | - MODでサポートされる言語(UIなど)
22 | - GitHubなど、信頼できるサイトに掲載されたMODダウンロードリンク
23 |
24 | ### MODのバージョン
25 | MODのバージョンは[セマンティックバージョニング](https://semver.org/lang/ja/)を守って表示してください。内容が多すぎて混乱する場合は、下の画像を参考にバージョンを設定しても大丈夫です。
26 |
27 | 
28 |
29 | ### MODリリース メッセージ テンプレート
30 | この下には、上で説明した内容が全て含まれたテンプレートが記載されています。下のテンプレートの使用が強制されるわけではありませんが、下のような形式を使えば人々があなたのMODをより簡単に接近できるようになると思います。
31 |
32 | #### 初リリース時のテンプレート
33 | ```
34 | **YourModNameHere (1.0.0)**
35 |
36 | **機能**
37 | - 機能1
38 | - 機能2
39 |
40 | **参考事項**
41 | (別にインストールが必要なMODライブラリ、MOD設定方法など。
42 | 無ければ削除。)
43 |
44 | **知られている問題**
45 | (無ければ削除。)
46 |
47 | (ダウンロードリンク)
48 | ```
49 |
50 | #### アップデート時のテンプレート
51 | ```
52 | **YourModNameHere (1.1.0)**
53 |
54 | **変更事項**
55 | + [追加] 機能1
56 | - [修正] 機能2
57 |
58 | **参考事項**
59 | (MOD利用時に参考する内容を記入。無ければ削除。)
60 |
61 | **知られている問題**
62 | (なければ削除。)
63 |
64 | (ダウンロードリンク)
65 | ```
66 |
--------------------------------------------------------------------------------
/jap/main.md:
--------------------------------------------------------------------------------
1 |
2 | # 日本語MODガイド
3 | [[ < 前のページへ ]](../README.md)
4 |
5 | ## MOD使用及びインストール説明
6 | 1. [UnityModManagerインストール方法](./use-1.md)
7 | 2. [MOD適用・使用方法](./use-2.md)
8 |
9 | ## MOD開発説明
10 | 1. [開発環境の整備](./dev-1.md)
11 | 2. [構想中](./dev-2.md)
12 | 3. [MODのアップロード](./dev-3.md)
--------------------------------------------------------------------------------
/jap/resources/dev-3/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/dev-3/image1.png
--------------------------------------------------------------------------------
/jap/resources/use-1/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-1/image1.png
--------------------------------------------------------------------------------
/jap/resources/use-1/image2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-1/image2.png
--------------------------------------------------------------------------------
/jap/resources/use-1/image3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-1/image3.png
--------------------------------------------------------------------------------
/jap/resources/use-2/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-2/image1.png
--------------------------------------------------------------------------------
/jap/resources/use-2/image2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-2/image2.png
--------------------------------------------------------------------------------
/jap/resources/use-2/image3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/jap/resources/use-2/image3.png
--------------------------------------------------------------------------------
/jap/use-1.md:
--------------------------------------------------------------------------------
1 | # 日本語MODガイド
2 | [[ < 前のページへ ]](./main.md) [[ 次のページへ > ]](./use-2.md)
3 |
4 | ## UnityModManagerインストール方法
5 |
6 | ### UnityModManagerのダウンロード
7 |
8 | 1. `UnityModManager`ダウンロードリンクhttps://github.com/newman55/unity-mod-manager
9 | * **Dropbox**をクリックしてファイルをダウンロードできます。
10 | 2. ダウンロードした`UnityModManager.zip`ファイルを解凍してください。
11 | * **絶対に**ADOFAIのフォルダ内で解凍しないでください!
12 | 3. 必要な場合、[自分のゲームバージョン](#ゲームバージョンの確認)に合うように`UnityModManagerConfig.xml`ファイルを編集し、解凍されたフォルダ内の`UnityModManager.exe`プログラムを実行してください。
13 | 4. `UnityModManager`プログラムを設定してください。
14 | * `Install`タブをクリックしてください。
15 | * `Game`の横のドロップダウンをクリックし、`A Dance of Fire and Ice`を選択してください。(もし違うゲームのMODを使う場合は、その名前を選択すればOKです。)
16 | * `Folder`の横のボタンをクリックし、ADOFAIがあるフォルダを選択し、OKを押してください。
17 | * `Installation Method`で`Assembly`を選択してください。
18 | * `Install` ボタンを押し、メモ帳にエラーが表示されるか確認してみてください。もしエラーが表示される場合は、設定が合っているか確認してみてください。いつでも[ADOFAI.ggコミュニティDiscord](https://discord.gg/TKdpbUUfUa)に参加してサポートを受けられます。
19 | * 文字で理解できなかった場合は、下の画像を御覧ください。赤→青→緑の順番で操作してください。
20 | 
21 |
22 |
23 | 注意: Linux利用者は、`UnityModManager`を利用するために`mono`パッケージが必要となります。インストール後、ターミナルで
24 | ```shell
25 | mono /path/to/UnityModManager.exe
26 | ```
27 | を使って実行できます。
28 |
29 | 上の方法で問題が生じた場合は、sudoを一緒に使ってみてください。
30 | ```shell
31 | sudo mono /path/to/UnityModManager.exe
32 | ```
33 |
34 | ~~ADOFAIは"Proton-GE"を使って実行してください。MODが正確にロードされます。(Steamバージョンを使わない人はWINE-GEを使えばいいと思います。)~~
35 |
36 | 現在、alphaブランチにnativeのLinux版がリリースされましたが、MODが作動するかは確認できていません。もし確認された場合はIssue/PRを開いてお知らせください!
37 |
38 | ---
39 |
40 |
41 | ### 追加情報
42 | #### ゲームバージョンの確認
43 |
44 | 古いバージョンのADOFAIの場合は、メインメニューで`Esc`キーを押し、設定ボタンを押すと左下に表示されます。
45 | 
46 |
47 | 最近のバージョンのADOFAIの場合は、メインメニューで`Esc`を押すと左下に表示されます。
48 | 
49 |
98 | ---
99 |
100 | ## [クリックして次のページへ進む](./use-2.md)
101 |
--------------------------------------------------------------------------------
/jap/use-2.md:
--------------------------------------------------------------------------------
1 | # 日本語MODガイド
2 | [[ < 前のページへ ]](./use-1.md)
3 |
4 | ## MOD適用・使用方法
5 |
6 | ### ADOFAI MODのダウンロード及び適用
7 |
8 | 1. 任意のADOFAIのMODをダウンロードしてください。**圧縮ファイル (.zip) 以外はインストールできません!**
9 | 2. ダウンロードしたMODを解凍せず、`UnityModManager.exe`プログラムを実行して`Mods`タブをクリックしてください。
10 | 3. `Install Mod`ボタンをクリックしてファイルを選択するか、ダウンロードした圧縮ファイルを`Install Mod`の下のところにドラッグしてください。. 맨 一番右のStatusにOKが表示されたか確認し、OKが表示されてないMODは右クリックし、`Install`をクリックしでください。
11 | * それでもOKが表示されない場合は、MODファイルに問題がある確率が高いです。この場合はMODの開発者に問い合わせて下さい。
12 | 5. アップデートがあるMODは右クリックし、`Update to vX.X.X`をクリックしてください。もし`UnityModManager`プログラムでアップデートを確認できない場合は、直接MODのダウンロードリンクを探して、再インストールする必要があります。
13 |
14 | 理解できない場合は、下の画像を参考にしてください。
15 |
16 | 
17 |
18 | ### ADOFAI MOD設定
19 |
20 | もしMODが`UnityModManager`内でのカスタム設定をサポートする場合は、MODマネージャーを`Ctrl + F10`キーで開き(デフォルト設定、Settingsタブでいつでも変更可能)、設定があるMODをクリックしてMODの設定をできます。例えば、`ADOFAITweaks` MODの設定は次のようになります。
21 |
22 | 
23 |
24 | 一部MODは`UnityModManager`だけでなく、外部設定をするよう作られる場合もあります。この場合、MODと一緒に提供された説明を読んでください。
25 |
26 | ### MODのアップデート
27 |
28 | もしMODの名前の横にダウンロードアイコンがある場合は、アップデートがあります。
29 |
30 | MODをアップデートするためには、ゲームを閉じてから`UnityModManager.exe`を開いて`Mods`タブを開き、そのMODを右クリックして、`Update to vX.X.X`をクリックしてください。
31 |
32 | ### ADOFAIのMODを有効化・無効化
33 |
34 | ADOFAIのMODは`On/Off`の下のボタンを押して有効化・無効化できます。MODがどんな状態かは、`Status`で確認できます。
35 |
36 | `Status` 色リスト
37 | | 状態 | 説明 |
38 | |:-----------|:--------------------------------------------------------------------------|
39 | | !!! | MODにエラーが発生しました。`Logs`タブを開いてエラーログを確認してみてください。 |
40 | | 赤 | MODを使用するにはゲームの再起動が必要です。ゲームを再起動してみてください。 |
41 | | 灰色 | ユーザーによってMODが無効化されています。 |
42 | | 緑色 | MODが正常に作動しています。 |
--------------------------------------------------------------------------------
/kor/dev-1.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](./main.md) [[ 다음 페이지 > ]](./dev-2.md)
3 |
4 | ## 최소 개발 조건 (참고용)
5 | * [.NET Framework 4.8](https://go.microsoft.com/fwlink/?linkid=2088517) - (무조건 4.8일 필요는 없으나 개인적으로 추천하는 버전입니다.)
6 | * [UnityModManager](https://github.com/newman55/unity-mod-manager)
7 | * Harmony - `UnityModManager`와 같이 설치됩니다. (파일명: `0Harmony.dll`)
8 | * Unity - 기존 게임 코드에 있는 dll 파일을 Reference에 추가하면 됩니다.
9 |
10 | ## 개발 환경 만들기
11 |
12 | 여기서는 [Visual Studio 2019](https://visualstudio.microsoft.com/) IDE를 기준으로 설명합니다.
13 |
14 | 1. [클래스 라이브러리 C# 프로젝트를 생성](https://docs.microsoft.com/en-us/dotnet/core/tutorials/library-with-visual-studio)합니다.
15 | 2. [필요한 Reference를 추가](https://docs.microsoft.com/en-us/visualstudio/ide/managing-references-in-a-project?view=vs-2019)합니다.
16 | * `UnityModManager/0Harmony.dll`
17 | * `UnityModManager/UnityModManager.dll`
18 | * `A Dance of Fire and Ice_Data/Managed/Unity*.dll` (모드가 필요로 하는 유니티 모듈들을 추가하세요.)
19 | * `A Dance of Fire and Ice_Data/Managed/Assembly-CSharp.dll`
20 | * `A Dance of Fire and Ice_Data/Managed/Assembly-CSharp-firstpass.dll`
21 | 3. Info.json 파일을 생성하고 모드의 정보를 채워넣습니다.
22 | * 관련된 정보는 [이 사이트](https://wiki.nexusmods.com/index.php/How_to_create_mod_for_unity_game)에서 찾을 수 있습니다.
23 |
24 | ---
25 |
26 | ## [이 곳을 클릭하면 다음 페이지로 넘어갑니다.](./dev-2.md)
--------------------------------------------------------------------------------
/kor/dev-2.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](./dev-1.md) [[ 다음 페이지 > ]](./dev-3.md)
3 |
4 | 아직 구상중인 문서입니다.
5 |
6 | 다음은 현재 문서에서 참고할 링크들의 목록입니다.
7 |
8 | * 유니티 모드 만들기 튜토리얼: https://wiki.nexusmods.com/index.php/How_to_create_mod_for_unity_game
9 | * 모드를 만들 때 클래스들의 형태 및 필수 조건 등을 설명하면서 Reflection을 이용해 더 깔끔하게 정리하면 특정 기능을 중점으로 한 프로그래밍이 가능함을 설명.
10 | * Reflection 및 Attribute에 대한 소개 또한 포함.
11 | * +) 독자의 Unity 엔진 자체에 대한 이해도가 중요함. Unity 엔진이 작동하는 방식, 게임의 파일 구조등을 모르면 모딩이 쉽지 않을 가능성이 상당히 높음.
12 | * 커스텀 Asset 추가: https://docs.unity3d.com/ru/2021.1/Manual/AssetBundlesIntro.html
13 | * 만약 게임 내에 없는 특정 텍스처를 모드가 필요로 할 일이 생겼을 때 위 문서를 참조해 에셋을 모드 단위로 추가할 수 있는 방법 소개.
14 | * 커스텀 GUI: https://docs.unity3d.com/Manual/GUIScriptingGuide.html
15 | * 유니티 내에서 GUI를 쉽게 만드는 방법을 소개하고 간단한 모드 설정 GUI를 만드는 방법 소개.
16 | * Harmony 패치: https://harmony.pardeike.net/articles/intro.html
17 | * Harmony를 이용해 게임 내에 있는 어셈블리의 메서드를 패치하는 방법 소개.
18 | * 패치의 원리에 대한 설명 또한 포함.
19 | * C# Reflection: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/reflection
20 | * dnSpy: https://github.com/dnSpy/dnSpy
21 | * 프로그램을 이용해 게임의 코드를 읽는 방법 소개.
22 | * UnityAssetBundleExtractor (UABE): https://github.com/DerPopo/UABE
23 | * 필요한 경우 유니티의 Asset을 뜯고 특정 리소스를 사용하는 방법 소개.
24 |
25 | ---
26 |
27 | ## [이 곳을 클릭하면 다음 페이지로 넘어갑니다.](./dev-3.md)
--------------------------------------------------------------------------------
/kor/dev-3.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](./dev-2.md)
3 |
4 | 모드를 완성했다면 사람들에게 알릴 차례입니다. 모드를 출시해 알리는 가장 효과적인 방법은 [ADOFAI.gg 커뮤니티 디스코드](https://discord.gg/TKdpbUUfUa)에 모드를 출시하는 것입니다.
5 |
6 | 1. 모딩 커뮤니티 디스코드에 있는 사람 중 SERVER OWNER 또는 ADMIN 역할이 있는 사람에게 Mod Developer 역할을 요청합니다.
7 | 2. `#모드-공지` 채널에 [아래 가이드라인](#모드-출시-가이드라인)을 따라 모드를 출시합니다.
8 | 3. 모드를 업데이트했다면, `#모드-공지` 채널에 변경 사항과 함께 [아래 가이드라인](#모드-출시-가이드라인)을 따라 새로운 버전의 모드를 출시합니다.
9 |
10 | ## 모드 출시 가이드라인
11 |
12 | 모드를 출시 또는 업데이트할 때에는 아래 내용이 **반드시** 들어가야 합니다.
13 | - 모드 이름
14 | - 모드 버전
15 | - 모드에 포함된, 또는 추가·수정·삭제된 기능 설명
16 | - 모드 다운로드 링크 또는 첨부된 모드 파일
17 |
18 | 아래 내용은 필수는 아니지만, 모드를 찾기 수월하게 하기 위해, 모드 이용자의 편의를 위해 포함이 권장되는 내용입니다.
19 | - 지원되는 A Dance of Fire and Ice의 버전
20 | - 이 모드에서 지원되는 언어 (UI 등에서)
21 | - GitHub 등 믿을 수 있는 사이트에 게재된 모드 다운로드 링크
22 |
23 | ### 모드의 버전
24 | 모드 버전은 [유의적 버전](https://semver.org/lang/ko/)을 지켜 표시하고, 내용이 너무 많아 헷갈린다면 아래 사진을 참고해 버전을 설정하셔도 됩니다.
25 |
26 | 
27 |
28 | ### 모드 출시 메시지 템플릿
29 | 이 아래에는 위에서 설명한 내용이 전부 들어간 템플릿이 기재되어 있습니다. 아래 템플릿 사용이 강제되는 것은 아니지만 아래와 같은 형식을 사용하면 사람들이 여러분의 모드를 더 쉽게 접근할 수 있도록 도와줄 것입니다.
30 |
31 | #### 최초 공개 시 템플릿
32 | ```
33 | **YourModNameHere (1.0.0)**
34 |
35 | **기능**
36 | - 기능 1
37 | - 기능 2
38 |
39 | **참고 사항**
40 | (이곳에는 따로 설치가 필요한 모드 라이브러리, 모드 설정법 등이 들어갑니다.
41 | 없으면 삭제하세요.)
42 |
43 | **알려진 문제**
44 | (없으면 삭제하세요.)
45 |
46 | (다운로드 링크)
47 | ```
48 |
49 | #### 업데이트 시 템플릿
50 | ```
51 | **YourModNameHere (1.1.0)**
52 |
53 | **변경 사항**
54 | + [추가] 기능 1
55 | - [수정] 기능 2
56 |
57 | **참고 사항**
58 | (모드 이용 시 참고해야 하는 내용을 적고, 없으면 삭제하세요.)
59 |
60 | **알려진 문제**
61 | (없으면 삭제하세요.)
62 |
63 | (다운로드 링크)
64 | ```
65 |
--------------------------------------------------------------------------------
/kor/main.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](../README.md)
3 |
4 | ## 모드 사용 및 설치 설명
5 | > [!WARNING]
6 | > 이 가이드는 오래되었습니다!
7 | > 새로운 모드 설치 가이드는 https://adof.ai/mod 에서 확인하세요.
8 | 1. [UnityModManager 설치 방법](./use-1.md)
9 | 2. [모드 적용 및 사용 방법](./use-2.md)
10 |
11 | ## 모드 개발 설명
12 | 1. [개발 환경 만들기](./dev-1.md)
13 | 2. [구상중](./dev-2.md)
14 | 3. [모드 업로드하기](./dev-3.md)
--------------------------------------------------------------------------------
/kor/resources/dev-3/image1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/dev-3/image1.png
--------------------------------------------------------------------------------
/kor/resources/use-1/how-to-see-version.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/how-to-see-version.png
--------------------------------------------------------------------------------
/kor/resources/use-1/smartscreen.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/smartscreen.png
--------------------------------------------------------------------------------
/kor/resources/use-1/umm-folder-select.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/umm-folder-select.png
--------------------------------------------------------------------------------
/kor/resources/use-1/umm-game-dropdown.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/umm-game-dropdown.png
--------------------------------------------------------------------------------
/kor/resources/use-1/umm-icon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/umm-icon.png
--------------------------------------------------------------------------------
/kor/resources/use-1/umm-install.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/umm-install.png
--------------------------------------------------------------------------------
/kor/resources/use-1/umm-method-select.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-1/umm-method-select.png
--------------------------------------------------------------------------------
/kor/resources/use-2/how-to-download-in-github.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/how-to-download-in-github.png
--------------------------------------------------------------------------------
/kor/resources/use-2/mm-mod-needs-update.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/mm-mod-needs-update.png
--------------------------------------------------------------------------------
/kor/resources/use-2/mm-mod-settings.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/mm-mod-settings.png
--------------------------------------------------------------------------------
/kor/resources/use-2/mm-mod-status.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/mm-mod-status.png
--------------------------------------------------------------------------------
/kor/resources/use-2/umm-auto-update.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/umm-auto-update.png
--------------------------------------------------------------------------------
/kor/resources/use-2/umm-drop-to-install.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/umm-drop-to-install.gif
--------------------------------------------------------------------------------
/kor/resources/use-2/umm-select-to-install.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CrackThrough/ADOFAI-Mod-Installation-Guide/a0abbae6b9352d12b7b68c1b435717308e200bf5/kor/resources/use-2/umm-select-to-install.gif
--------------------------------------------------------------------------------
/kor/use-1.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](./main.md) [[ 다음 페이지 > ]](./use-2.md)
3 |
4 | > [!WARNING]
5 | > 이 가이드는 오래되었습니다!
6 | > 새로운 모드 설치 가이드는 https://adof.ai/mod 에서 확인하세요.
7 |
8 | ### 목차
9 | - [UnityModManager에 대해](#unitymodmanager에-대해)
10 | - [UnityModManager 설치하기](#unitymodmanager-설치하기)
11 | - [추가 정보](#추가-정보)
12 | - [**[문제 해결]** UnityModManager.exe를 실행하면 윈도우가 실행을 차단함](#문제-해결-unitymodmanagerexe를-실행하면-윈도우가-실행을-차단함)
13 | - [얼불춤 버전 확인하기](#얼불춤-버전-확인하기)
14 |
15 | ---
16 |
17 | ## UnityModManager에 대해
18 |
19 | 얼불춤은 모드를 공식적으로 지원하고 있지 않기 때문에, 모드를 설치하기 위해서는 모드를 설치하고 관리하는 프로그램이 필요합니다.
20 |
21 | 세상에는 여러 모드 관리 프로그램이 있지만, 이 가이드에서는 가장 널리 쓰이는 UnityModManager(유니티 모드 매니저)를 설치하는 방법을 알아 보겠습니다.
22 |
23 | ## UnityModManager 설치하기
24 |
25 | 1. https://www.dropbox.com/s/wz8x8e4onjdfdbm/UnityModManager.zip?dl=0 링크로 들어가 왼쪽 위 '다운로드' 버튼을 누릅니다.
26 |
27 | 2. 다운로드받은 UnityModManager.zip의 압축을 풉니다. 앞으로 실행할 일이 꽤 있을 테니 바탕 화면처럼 눈에 띄는 곳에 푸는 걸 추천합니다.
28 | > ⚠️ **주의**
29 | > 얼불춤 폴더에 압축을 풀면 안 됩니다.
30 |
31 | 3. 압축 푼 폴더 안에 있는 UnityModManager.exe 파일을 실행합니다.
32 | > ℹ️ **참고**
33 | > 확장자 표시(.exe)가 보이지 않을 수 있는데, 그땐 파일 이름이 UnityModManager이면서 아이콘이
인 파일을 실행합니다.
34 |
35 | > ℹ️ **참고**
36 | > 윈도우가 실행을 차단한다면 [UnityModManager.exe를 실행하면 윈도우가 실행을 차단함](#문제-해결-unitymodmanagerexe를-실행하면-윈도우가-실행을-차단함) 문단을 참고해 보세요.
37 |
38 | 4. 창 중간 쯤에 있는 'Game' 오른쪽의 드롭다운을 누르고, 'A Dance of fire and Ice'를 선택합니다. 이미 선택돼 있다면 건너 뛰어도 됩니다.
39 | 
40 |
41 | 6. 'Game' 아래에 있는 'Folder' 오른쪽의 버튼을 누르고, 얼불춤 게임 실행 파일이 있는 폴더를 선택하고 '확인' 버튼을 누릅니다. 이미 선택돼 있다면 건너 뛰어도 됩니다.
42 | 
43 |
44 | 7. 'Folder' 아래에 버튼 두 개가 있을 텐데, 'Assembly'라고 쓰여진 버튼을 누릅니다.
45 | 
46 |
47 | 8. 창 위 쯤에 있는 커다란 'Install' 버튼을 누릅니다.
48 | 
49 |
50 | ---
51 |
52 | Linux에서 UnityModManager를 사용하고 싶다면, 아래 문단 제목을 눌러서 알아 보세요.
53 |
54 |
55 |
56 | Linux에서 UnityModManager 사용하기
57 |
58 |
59 | 만약 UnityModManager를 쓰려는 운영 체제가 Windows가 아니라 Linux라면, `mono` 패키지를 다운로드하고, 터미널에서 아래 명령을 입력하면 됩니다.
60 |
61 | ```shell
62 | # 일반적인 경우
63 | mono /path/to/UnityModManager.exe
64 |
65 | # 위 명령을 썼을 때 문제가 발생했을 경우
66 | sudo mono /path/to/UnityModManager.exe
67 | ```
68 |
69 | 현재 얼불춤이 alpha 브랜치에 리눅스 지원 버전을 배포했지만, 모드가 작동하는지는 확인되지 않았습니다. 혹시 시도해 보시면 이 리포지토리에 이슈나 풀 리퀘스트를 열어서 알려 주세요!
70 |
71 | ~~얼불춤은 "Proton-GE"를 사용해서 실행해 주세요. GitHub에 있으며, 알맞은 모드 로딩을 합니다. 확인된 바는 아니지만 Steam 버전을 사용하지 않는 사용자들은 WINE-GE 사용이 가능할지도 모릅니다.~~
72 |
73 |
74 |
75 | ---
76 |
77 |
78 | ## 추가 정보
79 | ### **[문제 해결]** UnityModManager.exe를 실행하면 윈도우가 실행을 차단함
80 |
81 | 
82 |
83 | 사진처럼 UnityModManager.exe를 실행하려 하면 윈도우가 실행을 차단하는 경우가 있습니다.
84 |
85 | 이때, 설명글 아래 '추가 정보'를 누르면 창 맨 아래쪽에 '실행' 버튼이 생깁니다. 그 버튼을 누르면 UnityModManager가 정상적으로 실행됩니다.
86 |
87 |
88 | ### 얼불춤 버전 확인하기
89 |
90 | 얼불춤에서 Esc 키를 누르면 나오는 일시 정지 메뉴에서 왼쪽 아래에 나오는 게 현재 컴퓨터에 깔려 있는 얼불춤의 버전입니다.
91 |
92 | 보통 v1.11.1 보다는 r68처럼 생긴 버전 형식을 보편적으로 사용합니다.
93 |
94 | 
95 |
96 | ---
97 |
98 | ## [이곳을 클릭하면 다음 페이지로 넘어갑니다.](./use-2.md)
99 |
--------------------------------------------------------------------------------
/kor/use-2.md:
--------------------------------------------------------------------------------
1 | # 한국어 모딩 가이드
2 | [[ < 이전 페이지 ]](./use-1.md)
3 |
4 | > [!WARNING]
5 | > 이 가이드는 오래되었습니다!
6 | > 새로운 모드 설치 가이드는 https://adof.ai/mod 에서 확인하세요.
7 |
8 | ### 목차
9 | - [얼불춤 모드 다운로드 및 적용](#얼불춤-모드-다운로드-및-적용)
10 | - [모드 업데이트하기](#모드-업데이트하기)
11 | - [얼불춤 안에서 모드 설정, 관리](#얼불춤-안에서-모드-설정-관리)
12 | - [모드 설정하기](#모드-설정하기)
13 | - [모드 켜고 끄기, 상태 확인하기](#모드-켜고-끄기-상태-확인하기)
14 | - [Status 모양에 따른 모드 상태](#status-모양에-따른-모드-상태)
15 | - [모드 업데이트 확인하기](#모드-업데이트-확인하기)
16 |
17 | ## 얼불춤 모드 다운로드 및 적용
18 |
19 | 1. 설치하고자 하는 얼불춤 모드를 다운로드합니다.
20 | > ℹ️ **참고**
21 | > 모드를 GitHub이라는 곳에서 다운로드해야 할 때가 있는데, 그땐 'Source Code'가 아니라 그 위에 있는 모드 파일을 클릭해야 합니다.
22 | > 
23 |
24 | 2. UnityModManager를 실행하고, Mods 탭에 들어갑니다. 이 탭에서 모드를 관리할 수 있습니다.
25 |
26 | 3. 두 가지 방법으로 모드를 적용할 수 있습니다. 원하는 방법으로 모드를 설치해 주세요.
27 | > ⚠️ **주의**
28 | > 모드를 설치하려면 모드 파일이 zip 파일이어야 합니다. **절대로 직접 압축을 풀면 안 됩니다.**
29 |
30 | - **직접 선택 방법**
31 | 창 아래 쯤에 있는 커다란 'Install Mod' 버튼을 누르고 다운로드받은 모드 파일을 선택합니다.
32 | 
33 | - **드래그 방법**
34 | 파일 탐색기에서 모드 파일을 마우스로 끌어서 UnityModManager의 아래 쯤 있는 'Drop zip files here'라고 쓰인 부분에 갖다 놓습니다.
35 | 
36 |
37 | 4. 설치한 모드가 창 중간에 있는 목록에 뜰 겁니다. 적용한 모드의 줄 맨 오른쪽 'Status' 부분에 'OK'라고 떠 있는지 확인합니다. OK가 뜨지 않는다면 두 가지 경우 중 하나입니다.
38 | - **UnityModManager가 옛날 버전일 경우**
39 | Install 탭으로 돌아가 창 중간 쯤에 있는 초록색 `Download X.XX.X` 버튼을 눌러 줍니다. 다시 Mods 탭에 되돌아가 모드를 우클릭하고, 'Install'을 눌러 주세요.
40 |
41 | - **애초에 모드 파일에 문제가 있을 경우**
42 | 스스로 할 수 있는 방법이 딱히 없습니다. 개발자에게 문의해 주세요.
43 |
44 | ## 모드 업데이트하기
45 |
46 | 
47 |
48 | UnityModManager에서 업데이트가 필요한 모드를 우클릭하면 뜨는 `Update to vX.X.X` 버튼을 누르면 자동으로 업데이트됩니다.
49 |
50 | 위 방법이 제일 편하지만 지원하지 않는 경우가 꽤 많이 있습니다. 모드 업데이트 방법은 설치 방법이랑 똑같으니, [얼불춤 모드 다운로드 및 적용](#얼불춤-모드-다운로드-및-적용) 문단을 보며 수동으로 업데이트할 수 있습니다.
51 |
52 | ## 얼불춤 안에서 모드 설정, 관리
53 |
54 | 얼불춤에서 `Ctrl + F10` 키를 누르면 모드 매니저 창이 열릴 겁니다. 이 단축키는 기본값이니 따로 설정하지 않는 한 작동해야 합니다.
55 |
56 | ### 모드 설정하기
57 |
58 | 
59 |
60 | 모드 매니저 창에서 모드를 설정할 수 있습니다. 사진에서 빨간색 부분에 있는 설정 버튼을 누르면 설정이 나타납니다.
61 |
62 | 모든 모드가 설정을 지원하는 건 아니니 설정 버튼이 없다고 해서 너무 걱정하진 않으셔도 됩니다.
63 |
64 | ### 모드 켜고 끄기, 상태 확인하기
65 |
66 | 
67 |
68 | 얼불춤 모드들은 'On/Off' 부분 밑에 있는 버튼으로 켜고 끌 수 있습니다. 그 버튼 바로 오른쪽에 있는 Status 표시로 이 모드가 어떤 상태인지 확인할 수 있습니다.
69 |
70 | #### Status 모양에 따른 모드 상태
71 |
72 | | 상태 | 설명 |
73 | | :--------- | :-------------------------------------------------------------- |
74 | | 초록색 | 모드가 정상적으로 작동 중이란 뜻입니다. |
75 | | 회색 | 모드가 꺼져 있다는 뜻입니다. |
76 | | 빨간색 | 모드가 정상적으로 작동하려면 게임 재시작이 필요하다는 뜻입니다. |
77 | | 느낌표 3개 | 모드에 오류가 발생했다는 뜻입니다. |
78 |
79 |
80 | ### 모드 업데이트 확인하기
81 |
82 | 
83 |
84 | 모드 버전 왼쪽에 다운로드 아이콘이 표시된다면, 새로운 버전이 있다는 뜻입니다.
85 |
86 | 안타깝게도 얼불춤 내에서는 모드 업데이트를 진행하지 못 합니다. [모드 업데이트하기](#모드-업데이트하기) 문단을 참고해 주세요.
87 |
--------------------------------------------------------------------------------