├── .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 | ![](./resources/use-1/image1.png) 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 | ![](./resources/use-1/image2.png) 47 | 48 | For the latest version of ADOFAI, press `Esc` on main screen. 49 | ![](./resources/use-1/image3.png) 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 | ![](./resources/use-2/image1.png) 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 | ![](./resources/use-2/image2.png) 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 | ![](./resources/use-2/image3.png) 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 | ![セマンティックバージョニングの要約](./resources/dev-3/image1.png) 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 | ![](./resources/use-1/image1.png) 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 | ![](./resources/use-1/image2.png) 46 | 47 | 最近のバージョンのADOFAIの場合は、メインメニューで`Esc`を押すと左下に表示されます。 48 | ![](./resources/use-1/image3.png) 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 | ![](./resources/use-2/image1.png) 17 | 18 | ### ADOFAI MOD設定 19 | 20 | もしMODが`UnityModManager`内でのカスタム設定をサポートする場合は、MODマネージャーを`Ctrl + F10`キーで開き(デフォルト設定、Settingsタブでいつでも変更可能)、設定があるMODをクリックしてMODの設定をできます。例えば、`ADOFAITweaks` MODの設定は次のようになります。 21 | 22 | ![](./resources/use-2/image2.png) 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`で確認できます。![](./resources/use-2/image3.png) 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 | ![유의적 버전을 요약해 사진으로 나타낸 것](./resources/dev-3/image1.png) 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 | ![](./resources/use-1/umm-game-dropdown.png) 40 | 41 | 6. 'Game' 아래에 있는 'Folder' 오른쪽의 버튼을 누르고, 얼불춤 게임 실행 파일이 있는 폴더를 선택하고 '확인' 버튼을 누릅니다. 이미 선택돼 있다면 건너 뛰어도 됩니다. 42 | ![](./resources/use-1/umm-folder-select.png) 43 | 44 | 7. 'Folder' 아래에 버튼 두 개가 있을 텐데, 'Assembly'라고 쓰여진 버튼을 누릅니다. 45 | ![](./resources/use-1/umm-method-select.png) 46 | 47 | 8. 창 위 쯤에 있는 커다란 'Install' 버튼을 누릅니다. 48 | ![](./resources/use-1/umm-install.png) 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 | ![](./resources/use-1/smartscreen.png) 82 | 83 | 사진처럼 UnityModManager.exe를 실행하려 하면 윈도우가 실행을 차단하는 경우가 있습니다. 84 | 85 | 이때, 설명글 아래 '추가 정보'를 누르면 창 맨 아래쪽에 '실행' 버튼이 생깁니다. 그 버튼을 누르면 UnityModManager가 정상적으로 실행됩니다. 86 | 87 | 88 | ### 얼불춤 버전 확인하기 89 | 90 | 얼불춤에서 Esc 키를 누르면 나오는 일시 정지 메뉴에서 왼쪽 아래에 나오는 게 현재 컴퓨터에 깔려 있는 얼불춤의 버전입니다. 91 | 92 | 보통 v1.11.1 보다는 r68처럼 생긴 버전 형식을 보편적으로 사용합니다. 93 | 94 | ![](./resources/use-1/how-to-see-version.png) 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 | > ![](./resources/use-2/how-to-download-in-github.png) 23 | 24 | 2. UnityModManager를 실행하고, Mods 탭에 들어갑니다. 이 탭에서 모드를 관리할 수 있습니다. 25 | 26 | 3. 두 가지 방법으로 모드를 적용할 수 있습니다. 원하는 방법으로 모드를 설치해 주세요. 27 | > ⚠️ **주의** 28 | > 모드를 설치하려면 모드 파일이 zip 파일이어야 합니다. **절대로 직접 압축을 풀면 안 됩니다.** 29 | 30 | - **직접 선택 방법** 31 | 창 아래 쯤에 있는 커다란 'Install Mod' 버튼을 누르고 다운로드받은 모드 파일을 선택합니다. 32 | ![](./resources/use-2/umm-select-to-install.gif) 33 | - **드래그 방법** 34 | 파일 탐색기에서 모드 파일을 마우스로 끌어서 UnityModManager의 아래 쯤 있는 'Drop zip files here'라고 쓰인 부분에 갖다 놓습니다. 35 | ![](./resources/use-2/umm-drop-to-install.gif) 36 | 37 | 4. 설치한 모드가 창 중간에 있는 목록에 뜰 겁니다. 적용한 모드의 줄 맨 오른쪽 'Status' 부분에 'OK'라고 떠 있는지 확인합니다. OK가 뜨지 않는다면 두 가지 경우 중 하나입니다. 38 | - **UnityModManager가 옛날 버전일 경우** 39 | Install 탭으로 돌아가 창 중간 쯤에 있는 초록색 `Download X.XX.X` 버튼을 눌러 줍니다. 다시 Mods 탭에 되돌아가 모드를 우클릭하고, 'Install'을 눌러 주세요. 40 | 41 | - **애초에 모드 파일에 문제가 있을 경우** 42 | 스스로 할 수 있는 방법이 딱히 없습니다. 개발자에게 문의해 주세요. 43 | 44 | ## 모드 업데이트하기 45 | 46 | ![](./resources/use-2/umm-auto-update.png) 47 | 48 | UnityModManager에서 업데이트가 필요한 모드를 우클릭하면 뜨는 `Update to vX.X.X` 버튼을 누르면 자동으로 업데이트됩니다. 49 | 50 | 위 방법이 제일 편하지만 지원하지 않는 경우가 꽤 많이 있습니다. 모드 업데이트 방법은 설치 방법이랑 똑같으니, [얼불춤 모드 다운로드 및 적용](#얼불춤-모드-다운로드-및-적용) 문단을 보며 수동으로 업데이트할 수 있습니다. 51 | 52 | ## 얼불춤 안에서 모드 설정, 관리 53 | 54 | 얼불춤에서 `Ctrl + F10` 키를 누르면 모드 매니저 창이 열릴 겁니다. 이 단축키는 기본값이니 따로 설정하지 않는 한 작동해야 합니다. 55 | 56 | ### 모드 설정하기 57 | 58 | ![](./resources/use-2/mm-mod-settings.png) 59 | 60 | 모드 매니저 창에서 모드를 설정할 수 있습니다. 사진에서 빨간색 부분에 있는 설정 버튼을 누르면 설정이 나타납니다. 61 | 62 | 모든 모드가 설정을 지원하는 건 아니니 설정 버튼이 없다고 해서 너무 걱정하진 않으셔도 됩니다. 63 | 64 | ### 모드 켜고 끄기, 상태 확인하기 65 | 66 | ![](./resources/use-2/mm-mod-status.png) 67 | 68 | 얼불춤 모드들은 'On/Off' 부분 밑에 있는 버튼으로 켜고 끌 수 있습니다. 그 버튼 바로 오른쪽에 있는 Status 표시로 이 모드가 어떤 상태인지 확인할 수 있습니다. 69 | 70 | #### Status 모양에 따른 모드 상태 71 | 72 | | 상태 | 설명 | 73 | | :--------- | :-------------------------------------------------------------- | 74 | | 초록색 | 모드가 정상적으로 작동 중이란 뜻입니다. | 75 | | 회색 | 모드가 꺼져 있다는 뜻입니다. | 76 | | 빨간색 | 모드가 정상적으로 작동하려면 게임 재시작이 필요하다는 뜻입니다. | 77 | | 느낌표 3개 | 모드에 오류가 발생했다는 뜻입니다. | 78 | 79 | 80 | ### 모드 업데이트 확인하기 81 | 82 | ![](./resources/use-2/mm-mod-needs-update.png) 83 | 84 | 모드 버전 왼쪽에 다운로드 아이콘이 표시된다면, 새로운 버전이 있다는 뜻입니다. 85 | 86 | 안타깝게도 얼불춤 내에서는 모드 업데이트를 진행하지 못 합니다. [모드 업데이트하기](#모드-업데이트하기) 문단을 참고해 주세요. 87 | --------------------------------------------------------------------------------