From d228b23a9be25b382de289d6dd3f51ae9b3bd46b Mon Sep 17 00:00:00 2001
From: lizzie <lizzie@eden-emu.dev>
Date: Sat, 7 Mar 2026 06:21:06 +0000
Subject: [PATCH] add mods.md

---
 docs/user/Mods.md   | 206 ++++++++++++++++++++++++++++++++++++++++++++
 docs/user/README.md |   1 +
 2 files changed, 207 insertions(+)
 create mode 100644 docs/user/Mods.md

diff --git a/docs/user/Mods.md b/docs/user/Mods.md
new file mode 100644
index 0000000000..c5f33cf54e
--- /dev/null
+++ b/docs/user/Mods.md
@@ -0,0 +1,206 @@
+# User Handbook - Installing Mods
+
+## General Notes
+
+**Note:** When installing a mod, always read the mod's installation instructions.
+
+This is especially important if a mod uses a framework such as **ARCropolis**, **Skyline**, or **Atmosphere plugins**. In those cases, follow the framework’s instructions instead of using Eden’s normal mod folder.
+
+For example, **Super Smash Bros. Ultimate** uses such a framework. See the related section below for details.
+
+---
+
+# Installing Mods for Most Games
+
+1. Right click a game in the game list.
+2. Click **"Open Mod Data Location"**.
+3. Extract the mod into that folder.
+
+Each mod should be placed inside **its own subfolder**.
+
+---
+
+# Enabling or Disabling Mods
+
+1. Right click the game in the game list.
+2. Click **Configure Game**.
+3. In the **Add-Ons** tab, enable or disable mods, updates, and DLC by ticking or unticking their boxes.
+
+---
+
+# Important Note About SD Card Paths
+
+Some mods are designed for real Nintendo Switch consoles and refer to the **SD card root**.
+
+The emulated SD card is located at:
+
+```
+%AppData%\eden\sdmc
+```
+
+Example:
+
+```
+Switch instruction:  sd:/ultimate/mods
+Eden equivalent:     sdmc/ultimate/mods
+```
+
+---
+
+# Framework-Based Mods (Super Smash Bros. Ultimate)
+
+Some games require external mod frameworks instead of the built-in mod loader.
+
+The most common example is **Super Smash Bros. Ultimate**.
+
+These mods are installed directly to the **emulated SD card**, not the normal Eden mod folder.
+
+---
+
+# Installing the ARCropolis Modding Framework
+
+**Note:** Some mod packs bundle ARCropolis with their installer (for example, Smash Ult-S).
+
+---
+
+## 1. Download ARCropolis
+
+Download the latest release:
+
+https://github.com/Raytwo/ARCropolis/releases/
+
+---
+
+## 2. Install ARCropolis
+
+Extract the **`atmosphere`** folder into:
+
+```
+%AppData%\eden\sdmc
+```
+
+This is the **emulated SD card directory**.
+
+Verify installation by checking that the following file exists:
+
+```
+sdmc\atmosphere\contents\01006A800016E000\romfs\skyline\plugins\libarcropolis.nro
+```
+
+---
+
+## 3. Download Skyline
+
+Download the latest Skyline release:
+
+https://github.com/skyline-dev/skyline/releases
+
+Skyline used to be bundled with ARCropolis but is now distributed separately to avoid compatibility issues caused by outdated bundled versions.
+
+---
+
+## 4. Install Skyline
+
+Extract the **`exefs`** folder into:
+
+```
+sdmc\atmosphere\contents\01006A800016E000
+```
+
+The `exefs` folder should be **next to the `romfs` folder**.
+
+Verify installation by checking that the following file exists:
+
+```
+%AppData%\eden\sdmc\atmosphere\contents\01006A800016E000\exefs\subsdk9
+```
+
+---
+
+## 5. Launch the Game Once
+
+Start the game and make sure you see the **ARCropolis version text on the title screen**.
+
+This will also create the folders required for installing mods.
+
+---
+
+## 6. Install Smash Ultimate Mods
+
+Install mods inside:
+
+```
+sdmc\ultimate\mods
+```
+
+Each mod must be placed inside **its own subfolder**.
+
+Example:
+
+```
+sdmc\ultimate\mods\ExampleMod
+```
+
+---
+
+# Troubleshooting
+
+## ARCropolis text does not appear on startup
+
+Check the following:
+
+- `libarcropolis.nro` exists in:
+
+```
+sdmc\atmosphere\contents\01006A800016E000\romfs\skyline\plugins
+```
+
+- `subsdk9` exists in:
+
+```
+sdmc\atmosphere\contents\01006A800016E000\exefs
+```
+
+- Files were extracted to:
+
+```
+%AppData%\eden\sdmc
+```
+
+---
+
+## Mods are not loading
+
+Make sure mods are installed inside:
+
+```
+sdmc\ultimate\mods
+```
+
+Each mod must have its **own subfolder**.
+
+Correct example:
+
+```
+sdmc\ultimate\mods\ExampleMod
+```
+
+Incorrect example:
+
+```
+sdmc\ultimate\mods\ExampleMod\ExampleMod
+```
+
+---
+
+## Installing mods in the wrong folder
+
+ARCropolis mods **do not go in Eden's normal mod folder**.
+
+Do **not** install Smash mods here:
+
+```
+user\load\01006A800016E000
+```
+
+That folder is only used for traditional **RomFS mods**, not ARCropolis.
diff --git a/docs/user/README.md b/docs/user/README.md
index 9ef4185423..9804f4d62f 100644
--- a/docs/user/README.md
+++ b/docs/user/README.md
@@ -11,6 +11,7 @@ A copy of this handbook is [available online](https://git.eden-emu.dev/eden-emu/
 - **[The Basics](Basics.md)**
 - **[Quickstart](./QuickStart.md)**
 - **[Settings](./Settings.md)**
+- **[Installing Mods](./Mods.md)**
 - **[Run On macOS](./RunOnMacOS.md)**
 - **[Audio](Audio.md)**
 - **[Graphics](Graphics.md)**