diff --git a/docs/user/AddEdenToSRM_SteamDeck.md b/docs/user/AddEdenToSRM_SteamDeck.md new file mode 100644 index 0000000000..4658bcf7e0 --- /dev/null +++ b/docs/user/AddEdenToSRM_SteamDeck.md @@ -0,0 +1,162 @@ +# Importing Eden into Steam with Steam Rom Manager + +Use this when you want to import the Eden AppImage into your Steam Library along with artwork using *Steam ROM Manager.* + +**Click [Here](https://evilperson1337.notion.site/Importing-Eden-into-Steam-with-Steam-Rom-Manager-2b757c2edaf68054851bc287b6382cb5) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden set up and configured +- Internet Connection +- Comfort Accessing and Navigating SteamOS Desktop Mode + +--- + +## Steps + +### Initial Setup + +1. Press the **STEAM** button and then go to *Power → Switch to Desktop* to enter the Desktop mode. + +2. Install ***Steam ROM Manager*** (if needed), there are 2 ways you can accomplish this, either manually or through [*EmuDeck*](https://www.emudeck.com/#downloads). + + --- + + ### Manual Installation + + 1. Open the *Discover Store* and search for *Steam ROM Manager.* + 2. Select the **Install** button to install the program. + + --- + + ### Installing Through *EmuDeck* + + + + 1. Open **EmuDeck**, then navigate to *Manage Emulators.* + 2. Scroll down to the bottom of the page to the *Manage your Tools & Frontends* section. Click **Steam ROM Manager**. + 3. Click the **Install** button on the right hand side to install it. + + --- + +### Adding Eden into *Steam ROM Manager* + +### EmuDeck Users + +EmuDeck will automatically create an *Emulators - Emulators* parser for ***Steam ROM Manager*** that uses shell scripts to launch them. We will follow this convention. + +1. In the file explorer go to your **EmuDeck installation folder → tools → launchers** +2. Right-Click some empty space and hit **Create New → Text File,** call this new file ***eden.sh*** instead of ***Text File.txt*** +3. Right-Click the ***eden.sh*** file you created and hit ***Open with Kate***. +4. Paste the following code into the contents of the file, save and close the file. + + ```bash + #!/bin/bash + emuName="eden" #parameterize me + + . "$HOME/.config/EmuDeck/backend/functions/all.sh" + emulatorInit "$emuName" + + # find full path to emulator appimage + appimage=$(find "$emusFolder" -iname "${emuName}*.AppImage" -print -quit 2>/dev/null) + + # make sure the appimage is executable + chmod +x "$appimage" + set -- "$appimage" "$@" + + echo "Launching ${emuName} with:" "$@" + "$@" + + cloud_sync_uploadForced + rm -rf "$savesPath/.gaming" + ``` + +5. Open a terminal in the directory containing the ***eden.sh*** file and run the following command to make it executable. + + ```bash + chmod u+x ./eden.sh + ``` + +6. Proceed to the Adding the Emulator section + +--- + +### Non-EmuDeck Users + +We will need to create a new parser for the Emulators. Unlike with the EmuDeck model, we will have the parser look for AppImages. + + + +1. Open *Steam ROM Manager* and choose **Create Parser**. + + + +2. Add the following settings to create the parser. + + 1. Basic Configuration + 1. **Parser Type**: *Blob* + 2. **Parser Title**: *Emulators - Emulators* + 3. **Steam Directory**: *${steamdirglobal}* + 4. **User Accounts**: *Global* + 5. **ROMs Directory**: + 6. **Steam Collections**: *Emulation* (OPTIONAL) + 2. Parser Specific Configuration + 1. **Search Glob**: *${title}@(.AppImage|.APPIMAGE|.appimage)* + 3. Executable Configuration + 1. **Executable Modifier**: *"${exePath}”* + 4. Title Modification Configuration + 1. **Title Modifier**: *${fuzzyTitle}* + +3. Hit the **Test** button to ensure your emulator AppImages. +4. Hit **Save** to save the Parser. + +--- + +### Adding Eden to Steam + +Now that we have the parser or shell script created, we can actually add it to Steam. + +1. Open *Steam ROM Manager* if it is not already open. +2. Toggle the **Emulators - Emulators** parser on and hit ***Add Games*** in the top left. +3. Click **Parse** to identify the emulators. +4. Make sure all your emulators are showing up and have the right matches. + + --- + + ### Correcting a Mismatch + + If the emulator is not identified correctly, you may need to tell *Steam ROM Manager* what the game is manually. + + 1. Hover over the emulator card and click the magnifying glass icon. Here it incorrectly identified *Eden* as a game by a similar name. ** + 2. Search for *Eden Emulator* on the *Search SteamGridDB* section and scroll through the results, selecting the one you want. + 3. Ensure the *Name* and *Game ID* update in the **Per-App Exceptions** and press **Save and close**. The game should now update. + + --- + + ### Excluding Matches + + You may want to tell Steam ROM Manager to ignore some files that it finds in the directory. This is how you do so. + + 1. Hit the **Exclude Games** button in the bottom right. + 2. Deselect the game you want to exclude, the poster artwork should go dim and the **Number Excluded** number should increment up. Repeat with any other exclusions you want to add. + 3. Hit **Save Excludes** when you are happy with your selections. + + --- + +5. The program will now start writing the entries into the Steam Library. You should get pop up notifications of the progress, but you can monitor the progress by selecting the **Log** on the left-hand side if needed. +6. Restart Steam to have the changes take effect. Check your library to ensure that your games are there, in a category if you defined one in the parser. +7. Try to launch the Emulator from Steam and ensure everything is working. You are now good to go. \ No newline at end of file diff --git a/docs/user/AddGamesToSRM_SteamDeck.md b/docs/user/AddGamesToSRM_SteamDeck.md new file mode 100644 index 0000000000..433999c9b6 --- /dev/null +++ b/docs/user/AddGamesToSRM_SteamDeck.md @@ -0,0 +1,100 @@ +# Importing Games into Steam with Steam Rom Manager + +Use this when you want to import your games inside Eden into Steam to launch with artwork from Steam Game Mode without needing to launch Eden first. + +**Click [Here](https://evilperson1337.notion.site/Importing-Games-into-Steam-with-Steam-Rom-Manager-2b757c2edaf680d7a491c92b138f1fcc) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Steam Deck Set up and Configured +- Eden set up and Configured +- Internet Access + +--- + +## Steps + +1. Press the **STEAM** button and then go to *Power → Switch to Desktop* to enter the Desktop mode. + +1. Install ***Steam ROM Manager***, there are 2 ways you can accomplish this, either manually or through [*EmuDeck*](https://www.emudeck.com/#downloads). + + --- + + ### Manual Installation + + 1. Open the *Discover Store* and search for *Steam ROM Manager.* + 2. Select the **Install** button to install the program. + + --- + + ### Installing Through *EmuDeck* + + + + 1. Open **EmuDeck**, then navigate to *Manage Emulators.* + 2. Scroll down to the bottom of the page to the *Manage your Tools & Frontends* section. Click **Steam ROM Manager**. + + 3. Click the **Install** button on the right hand side to install it. + + --- + +2. Open the Start Menu and Launch ***Steam ROM Manager*** + +1. The program will now launch and show you a window with parsers. + + + +2. Switch off all Parsers by hitting the *Toggle Parsers* switch. +3. Scroll down the list on the left-hand side and look for a parser called *Nintendo Switch - Eden* and switch it on. This parser may not exist depending on how you installed *Steam ROM Manager* (EmuDeck creates it for you). Follow these steps to create it if it is missing. + + --- + ### Creating the Eden Parser + + 1. Select Create Parser and in the *Community Presets* option look for **Nintendo Switch - Yuzu**. + 2. Change the **Parser title** from *Nintendo Switch - Yuzu* to *Nintendo Switch - Eden.* + 3. Hit the **Browse** option under the *ROMs directory* section. Select the directory containing your Switch ROMs. + 4. Under *Steam collections*, you can add a Steam category name. This just organizes the games under a common category in your Steam Library, this is optional but recommended. + 5. Scroll down slightly to the **Executable Configuration → Executable**, select **Browse** and select the Eden AppImage. + 6. Leave everything else the same and hit **Save** to save the parser. + --- + +4. Click the Eden parser to view the options on the right, select **Test** at the bottom of the screen to ensure that *Steam ROM Manager* detects your games correctly. +1. *Steam ROM Manager* will start to scan the specified ROMs directory and match them to games. Look over the results to ensure they are accurate. If you do not see any entries - check your parsers ROMs directory field. +1. When you are happy with the results, click the **Add Games** → **Parse** to start the actual Parsing. +1. The program will now identify the games and pull artwork from [*SteamGridDB*](https://www.steamgriddb.com/). +2. Review the game matches and ensure everything is there. + + --- + + ### Correcting a Mismatch + + If the game is not identified correctly, you may need to tell *Steam ROM Manager* what the game is manually. + + 1. Hover over the game card and click the magnifying glass icon. + 2. Search for the game on the *Search SteamGridDB* section and scroll through the results, selecting the one you want. + 3. Ensure the *Name* and *Game ID* update in the **Per-App Exceptions** and press **Save and close**. The game should now update. + + --- + + ### Excluding Matches + + You may want to tell Steam ROM Manager to ignore some files (updates/DLC/etc.) that it finds in the directory. This is how you do so. + + 1. Hit the **Exclude Games** button in the bottom right. + 2. Deselect the game you want to exclude, the poster artwork should go dim and the **Number Excluded** number should increment up. Repeat with any other exclusions you want to add. + 3. Hit **Save Excludes** when you are happy with your selections. + --- +3. When you are happy with the results, select **Save to Steam** to save the results. +1. The program will now start writing the entries into the Steam Library. You should get pop up notifications of the progress, but you can monitor the progress by selecting the **Log** on the left-hand side if needed. +2. Restart Steam to have the changes take effect. Check your library to ensure that your games are there, in a category if you defined one in the parser. +3. Try to launch a game and ensure everything is working. You are now good to go. \ No newline at end of file diff --git a/docs/user/AlterDate-Time.md b/docs/user/AlterDate-Time.md new file mode 100644 index 0000000000..43bd3ed7b1 --- /dev/null +++ b/docs/user/AlterDate-Time.md @@ -0,0 +1,20 @@ +# Setting a Custom Date/Time in Eden + +Use this guide whenever you want to modify the Date or Time that Eden reports to games. This can be useful for modifying RNG elements, skipping wait times in games, etc. + +**Click [Here](https://evilperson1337.notion.site/Setting-a-Custom-Date-Time-in-Eden-2b357c2edaf680acb8d4e63ccc126564) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden set up and fully configured + +--- + +## Steps + +1. Navigate to *Emulation → Configure*. +2. Click on the **System** item on the left-hand side navigation, then check the *Custom RTC Date* box. +3. The Date/Time option now becomes editable. Set it to the value you want and hit **OK**. +4. GREAT SCOTT! We have time traveled! You can of course go forward or backward in time (as long as it is not before the year 1970) and your game should update accordingly (e.g. certain *Super Mario Odyssey* moons that take time for flowers to grow will now be fully grown.). \ No newline at end of file diff --git a/docs/user/ControllerProfileByGame.md b/docs/user/ControllerProfileByGame.md new file mode 100644 index 0000000000..3bc1a31263 --- /dev/null +++ b/docs/user/ControllerProfileByGame.md @@ -0,0 +1,28 @@ +# Setting Controller Profiles By Game + +Use this guide when you want to set up specific controller profiles for specific games. This can be useful for certain games like *Captain Toad Treasure Tracker* where a blue dot appears in the middle of the screen when you have docked mode enabled, but not handheld mode. + +**Click [Here](https://evilperson1337.notion.site/Setting-Controller-Profiles-By-Game-2b057c2edaf681658a57f0c199cb6083) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden Emulator set up and fully configured +- Controller Profile Created + - See [*Configuring Controller Profiles*](./ControllerProfiles.md) for instructions on how to do this if needed. + +--- + +## Steps + +1. *Right-Click* the game you want to apply the profile to in the main window and select **Properties.** +2. Navigate to the **Input Profiles** tab in the window that appears. Drop down on *Player 1 profile* (or whatever player profile you want to apply it to) and select the profile you want. + + +1. Click **OK** to apply the profile mapping. +2. Launch the game and confirm that the profile is applied, regardless of what the global configuration is. \ No newline at end of file diff --git a/docs/user/ControllerProfiles.md b/docs/user/ControllerProfiles.md new file mode 100644 index 0000000000..c9a232f730 --- /dev/null +++ b/docs/user/ControllerProfiles.md @@ -0,0 +1,20 @@ +# Configuring Controller Profiles + +Use this guide for when you want to configure specific controller settings to be reused. + +**Click [Here](https://evilperson1337.notion.site/Configuring-Controller-Profiles-2be57c2edaf680eabc3ac8c333ec75c4) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden Set Up and Configured + +--- + +## Steps +1. Launch Eden and wait for it to load. +2. Navigate to *Emulation > Configure…* +3. Select **Controls** from the left-hand menu and configure your controller for the way you want it to be in game. +4. Select **New** and enter a name for the profile in the box that appears. Press **OK** to save the profile settings. +5. Select **OK** to close the settings menu. \ No newline at end of file diff --git a/docs/user/EdenFailsToLaunch_Windows.md b/docs/user/EdenFailsToLaunch_Windows.md new file mode 100644 index 0000000000..9a30348092 --- /dev/null +++ b/docs/user/EdenFailsToLaunch_Windows.md @@ -0,0 +1,91 @@ +# Eden Fails to Launch and Does Not Leave Any Logs + +**Click [Here](https://evilperson1337.notion.site/Windows-Eden-Fails-to-Launch-and-Does-Not-Leave-Any-Logs-2b057c2edaf68156b640cf1ac549870a) for a version of this guide with images & visual elements.** + +--- + +## Error Details + +*Behavior*: Program appears not to launch or exits immediately without leaving any log entries. +*Platform(s) Affected*: +- **Windows** + +**Error Log Entries:** + +``` +None +``` +**Example Error Message Entry in Windows Event Viewer** +``` +Faulting application name: eden.exe, version: 0.0.0.0, time stamp: 0x6795dc3c +Faulting module name: ntdll.dll, version: 10.0.26100.3037, time stamp: 0x95e6c489 +Exception code: 0xc0000005 +Fault offset: 0x0000000000014778 +Faulting process id: 0x2AF0 +Faulting application start time: 0x1DB7C30D2972402 +Faulting application path: C:\temp\Eden-Windows\eden.exe +Faulting module path: C:\WINDOWS\SYSTEM32\ntdll.dll +Report Id: 4c8a6e13-9637-438c-b4d0-e802d279af66 +Faulting package full name: +Faulting package-relative application ID: +``` + +--- + +## Causes + + + + \ No newline at end of file diff --git a/docs/user/GyroControls_SteamDeck.md b/docs/user/GyroControls_SteamDeck.md new file mode 100644 index 0000000000..2a98e676ec --- /dev/null +++ b/docs/user/GyroControls_SteamDeck.md @@ -0,0 +1,29 @@ +# Getting Gyro/Motion Controls Working on Steam Deck +Use this guide when you want to use the Steam Deck's native gyro functionality for motion controls in Eden. + +**Click [Here](https://evilperson1337.notion.site/Getting-Gyro-Motion-Controls-Working-on-Steam-Deck-2b057c2edaf681a1aaade35db6e0fd1b) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Steam Deck Set up and Configured +- Eden set up and Configured +- Internet Access + +--- + +## Steps + +1. Go into Steam Deck's Desktop Mode, and use the shortcut to launch EmuDeck. +2. Install [SteamDeckGyroDSU](https://github.com/kmicki/SteamDeckGyroDSU/releases) by going to *3rd Party Tools > Gyroscope* and clicking **Install.** + a. Alternatively you can install [SteamDeckGyroDSU](https://github.com/kmicki/SteamDeckGyroDSU/releases) manually following the GitHub page instructions. +3. Upon completion of the installation. You will need to reboot your Steam Deck. Do so before continuing on. +4. Go back into the Steam Deck Desktop Mode and open the Dolphin File Explorer. +5. Navigate to the following directory to see you controller configuration: `/home/deck/.config/Eden` +6. *Right-Click* the **qt-config.ini** file and open it with ***Kate*** +7. Look for the following line: `player_0_motionleft=[empty]`. +8. Change the line to now say: `player_0_motionleft="motion:0,pad:0,port:26760,guid:0000000000000000000000007f000001,engine:cemuhookudp"` +9. Save the file and open Eden. +10. Launch a compatible title, like *The Legend of Zelda: Breath of the Wild*. +11. Test the gyro capabilities, for the above mentioned title, it is accessed by holding down the **R Trigger** and moving the Steam Deck around. \ No newline at end of file diff --git a/docs/user/HowToAccessLogs.md b/docs/user/HowToAccessLogs.md new file mode 100644 index 0000000000..826ead382c --- /dev/null +++ b/docs/user/HowToAccessLogs.md @@ -0,0 +1,47 @@ +# How to Access Logs + +Use this when you need to review the logs to determine an issue or provide them to a member of the Eden team. + +**Click [Here](https://evilperson1337.notion.site/How-to-Access-Logs-2b057c2edaf68105a281fe1688a332d4) for a version of this guide with images & visual elements.** + +--- + +## Pre-Requisites + +- Eden installed and run at least once + +--- + +## Steps + +### Windows + +*By default the Eden folder is stored in your AppData `C:\Users\\AppData\Roaming\Eden\log`, or the local **user** folder if you have a portable installation.* + + + +### Steam Deck + +*By default the Eden folder is stored in `/home/deck/.local/share/Eden`, or the local **user** folder if you have a portable installation.* + + + +### Android + +*Logs are stored in the application data, so you wouldn't be able to access the files directly without a rooted device.* + + \ No newline at end of file diff --git a/docs/user/ImportingSaves_Windows.md b/docs/user/ImportingSaves_Windows.md new file mode 100644 index 0000000000..1827a6d6b7 --- /dev/null +++ b/docs/user/ImportingSaves_Windows.md @@ -0,0 +1,28 @@ +# Importing Saves Into Eden + +Use this guide when you want to manually import save files for use in the Eden emulator. + +**Click [Here](https://evilperson1337.notion.site/Importing-Saves-Into-Eden-2b057c2edaf681fe968df8d63821ccae) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites +- Eden emulator already set up and configured. +- The save file(s) you want to import + +--- + +## Steps +1. Open Eden and wait for it to load. +2. Start the game and create a save file to establish the directories. +3. *Right-Click* the game for which you want to load a save in. +4. Select *Open Save Data Location.* +5. A File Explorer will now appear where Eden is looking for the save data for this title. +6. Copy the save file(s) you want to import and use in Eden into this directory. + +7. Close the file explorer as it is no longer needed. +8. Launch the game in Eden and verify that the save data appears through whatever method the game implements. \ No newline at end of file diff --git a/docs/user/InstallingAtmosphereMods.md b/docs/user/InstallingAtmosphereMods.md new file mode 100644 index 0000000000..77eeea6080 --- /dev/null +++ b/docs/user/InstallingAtmosphereMods.md @@ -0,0 +1,32 @@ +# Installing Atmosphere Mods + +Use this guide for when you want to install an Atmosphere-based mod for use in Eden. + +**Click [Here](https://evilperson1337.notion.site/Installing-Atmosphere-Mods-2b057c2edaf681fe8d39cbfc2d0cc799) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden already set up and functioning with keys and firmware +- The mod you want to install + +--- + +## Steps + +1. Right-Click the game you want to apply the mod to and select **Open Mod Data Location.** +2. Create new folder inside the mod directory with the name of the mod. +3. Extract the downloaded mod (if applicable) to a temporary directory. +4. Locate the ***exefs*** and ***romfs*** folders inside the extracted mod - usually *atmosphere/contents/*. +5. Copy the ***exefs*** and ***romfs*** folders into the mod folder you created earlier. +6. Restart Eden. +7. Right-Click the game you installed the mod to and hit *Configure Game*. +8. Look in the **Add-Ons** tab and observe that the Mod Name (or whatever you named the folder to earlier) now appears on the list and is selected. +9. Hit **OK** and launch the game. Your mod should now be active. + +10. Your mod is now ready to play. \ No newline at end of file diff --git a/docs/user/InstallingUpdates-DLC.md b/docs/user/InstallingUpdates-DLC.md new file mode 100644 index 0000000000..6cb0099d85 --- /dev/null +++ b/docs/user/InstallingUpdates-DLC.md @@ -0,0 +1,52 @@ +# Working with Updates/DLC in Eden + +Use this guide when you want to install Updates or DLC for your games in Eden. + + + +**Click [Here](https://evilperson1337.notion.site/Working-with-Updates-DLC-in-Eden-2b057c2edaf681dfb65dfc4dd96980c0) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +1. Eden already setup and configured for your platform. +2. The Update/DLC file(s) you want to install + +--- + +## Installing Updates/DLC + +1. Open Eden to the Main Window. +2. Select *File > Install Files to NAND...*. +3. Navigate to the Update/DLC files you want to install. + + +4. The file(s) will be scanned for validity and then a confirmation window will appear, select *Install* to begin installation. + + +5. Upon installation, you will get a prompt saying it was installed successfully. +6. Look at the *Add-Ons* column in the main window, you should now see the additional installed content reflected. + +--- + +## Disabling Updates/DLC + +Upon occasion you may find that you want to disable a certain DLC or Update (incompatibility with a mod, causes significant regression, etc.). Luckily the process if very easy to do so. + +1. *Right-Click* the game for which you want to disable the additional content. +2. Select *Configure Game.* +3. Uncheck the box next to the DLC or Update you want to disable and hit **OK**. +4. The listing should now reflect that it has been disabled with a **[D]** before the entry. If you load the game, you will observe that the reported version is not updated (assuming the game reports this information). \ No newline at end of file diff --git a/docs/user/QuickStart_SteamDeck.md b/docs/user/QuickStart_SteamDeck.md new file mode 100644 index 0000000000..e43bc2cce9 --- /dev/null +++ b/docs/user/QuickStart_SteamDeck.md @@ -0,0 +1,42 @@ +# Eden Quick Start + +Use this guide to get starting using the Eden emulator on Steam Deck. + +**Click [Here](https://evilperson1337.notion.site/Eden-Quick-Start-2b757c2edaf680d49ffdcda291a32840) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Firmware dumped from your console +- Keys extracted from your console +- Games dumped from your console +- Internet Connection + +--- + +## Steps + +1. Access Steam Desktop Mode. +2. Download either the *Stable* or *Nightly* Eden AppImage onto your Steam Deck and save it somewhere accessible. + + + +3. Double-Click the Eden executable to launch the program. + + +4. If you have had a different Switch emulator installed, it will detect and ask if you want to import those settings. Make your selection to close the screen. +5. Eden will now launch and notify you about missing Encryption keys. Close the dialog box by hitting **OK**. +6. Navigate to **Tools → Install Decryption Keys**, navigate to the folder containing your ***prod.keys*** file and select the file and hit **Open**. +7. Navigate to **Tools → Install Firmware →** *Select **From Folder*** or ***From ZIP*** - depending on how your firmware is stored, navigate to where it is stored and select it. +8. Double-Click the main window to add the folder containing your games. +9. Go to *Emulation > Configure > Input* and set up your controller. Click **OK** to close the dialog window. +10. Double-Click a game to run it. \ No newline at end of file diff --git a/docs/user/QuickStart_Windows.md b/docs/user/QuickStart_Windows.md new file mode 100644 index 0000000000..9b90f622ce --- /dev/null +++ b/docs/user/QuickStart_Windows.md @@ -0,0 +1,47 @@ +# Eden Quick Start + +Use this guide to get starting using the Eden emulator. + +**Click [Here](https://evilperson1337.notion.site/Eden-Quick-Start-2b057c2edaf6817b9859d8bcdb474017) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + + +- The [*latest C++ Redistributable*](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version) from Microsoft. + - Eden will not even launch without it see [*Eden Fails to Launch*](./EdenFailsToLaunch.md) for more information. +- Firmware dumped from your console +- Keys extracted from your console +- Games dumped from your console +- Internet Connection + +--- + +## Steps + +1. Download either the *Stable* or *Nightly* Eden application. + +2. Extract the contents to wherever you want to store the program on your computer. + +3. Run ***Eden.exe*** to launch the program. + + +4. Eden will now launch and notify you about missing Decryption keys. Close the dialog box by hitting **OK**. +5. Navigate to **Tools → Install Decryption Keys**, navigate to the folder containing your key files and select the file, you should only be able to select one. +6. Navigate to **Tools → Install Firmware**, *Select **From Folder*** or ***From ZIP*** - depending on how your firmware is stored, navigate to where it is stored and select it. +7. Double-Click the main window to add the folder containing your games. +8. Go to *Emulation > Configure > Input* and set up your controller of choice. Click **OK** to close the dialog window. +9. Double-Click a game to run it. \ No newline at end of file diff --git a/docs/user/RunOnMacOS_MacOS.md b/docs/user/RunOnMacOS_MacOS.md new file mode 100644 index 0000000000..e01bf0253d --- /dev/null +++ b/docs/user/RunOnMacOS_MacOS.md @@ -0,0 +1,29 @@ +# Allowing Eden to Run on MacOS + +Use this guide when you need to allow Eden to run on a Mac system, but are being blocked by Apple Security policy. + +**Click [Here](https://evilperson1337.notion.site/Allowing-Eden-to-Run-on-MacOS-2b057c2edaf681fea63dc81027efeffd) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Permissions to modify settings in MacOS + +--- + +## Why am I Seeing This? + +Recent versions of MacOS (Catalina & newer) introduced the **Gatekeeper** security functionality, requiring software to be signed by Apple or a trusted (aka - paying) developer. If the signature isn’t on the list of trusted ones, it will stop the program from executing and display the message above. + +--- + +## Steps + +1. Open the *System Settings* panel. +2. Navigate to *Privacy & Security*. +3. Scroll down and observe the following message under the **Security** settings. +4. Select **Open Anyway** to tell your Mac that you trust the application. +5. You will now get another window appearing to verify you want to open Eden. Select **Open Anyway**. +6. You will be prompted for your password to authorize the request. Enter the credentials of an account that has permission to modify settings and press **OK**. +7. Eden will now open and any subsequent launches of the program will not prompt this. \ No newline at end of file diff --git a/docs/user/SyncthingGuide_General.md b/docs/user/SyncthingGuide_General.md new file mode 100644 index 0000000000..1ae9d13a05 --- /dev/null +++ b/docs/user/SyncthingGuide_General.md @@ -0,0 +1,66 @@ +# Backing Up/Syncing Eden Game Saves + +Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing*](https://syncthing.net/). + +**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b357c2edaf68000b40cfab2c2c3dc0a) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden already installed, configured, and functioning. +- Devices to run Syncthing on. +- Ability to allow a program to communicate through the firewall of your device. + +--- + +## Platform Specific Setup Guides + +- [*Windows*](./SyncthingGuide_Windows.md) +- *MacOS (Coming Soon)* +- *Steam Deck (Coming Soon)* +- *Android (Coming Soon)* +- [*Linux*](./SyncthingGuide_Linux.md) + +--- + +## A Few Notes Before You Proceed + + + +- While this is a de-centralized model without the concepts of a Server/Client, Parent/Child, etc. - For the purposes of these guides, we will borrow from this models terminology to avoid sync conflicts and potential data loss. After the initial setup, all the devices in the sync network are equals and can push & pull files from any other device. +- In order for this to work, you should get all of the save files in Eden in the save folder on the Parent. + - If you need help doing that, see the ***Importing Saves into Eden*** guide for the platform you elect to act as the Parent, and delete the save files on the "Child" devices. + +### Terminology + +- **Sync Network**: All the devices configured in *Syncthing* to push/pull files. +- **Parent**: This will be the device that you elect to push files to the other devices. There can only be one here initially in order to avoid sync conflicts. +- **Child**: All the other devices added to the Sync Network. These devices will pull files from the Parent. + +--- + +## Overview + +Rather than giving a breakdown of all the platforms and configurations, those will be in the platform’s specific guides - this will serve as a general overview of Syncthing. + +--- + +### What is Syncthing Anyway? + +Syncthing is a continuous file synchronization program (in the layman’s - make sure 2 or more systems with the same files are always up to date). This is perfect for game saves where we would want to play on 1 device, save our game, and then continue playing it on another device. This technology is what Epic/Steam/etc. use to allow you to do this on games run through their respective services. Syncthing is an open source implementation of this technology that you control, rather than relying on a 3rd party. This has a few key benefits, most notably - better security, privacy, and speed (when on your LAN). + +--- + +### What are some common issues? + +Syncthing is fairly robust and doesn’t have many issues luckily, but there are some things you should watch out for (almost all of them a user issue). + +- Sync conflicts + - If for whatever reason you update the same file on 2 different machines, the system does not know which updated file is considered the one to sync across. This results in a ***sync conflict*** where it may not sync the files as you would expect. Worst case scenario, this can result in your save progress being lost if you are not careful. When one of these occurs, it will create a copy of the file and store it with a specific name, like this example, *Paper Mario.sync-conflict-20251102-072925-TZBBN6S.srm.* To resolve this, you must remove the other files and remove the *.sync-conflict--* from the file name of the file you want to keep. +- Accidental Deletions + - If you delete a file from one of the devices, it will also remove the file on the other devices when they perform a sync so be careful when doing this. \ No newline at end of file diff --git a/docs/user/SyncthingGuide_Linux.md b/docs/user/SyncthingGuide_Linux.md new file mode 100644 index 0000000000..e7946151fc --- /dev/null +++ b/docs/user/SyncthingGuide_Linux.md @@ -0,0 +1,96 @@ +# Backing Up/Syncing Eden Game Saves + +Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing*](https://syncthing.net/) on Linux. + +**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b057c2edaf680fc8a28eba5a05fd7a3) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Read the [*Syncthing General Guide*](./SyncthingGuide_General.md). +- Eden already installed, configured, and functioning. + +--- + +## Steps + + + + + +### Downloading and Installing Syncthing + +1. Download [*Syncthing Tray*](https://flathub.org/en/apps/io.github.martchus.syncthingtray) from the Flatpak store. +2. Launch *Syncthing Tray* to run it, select the **Start guided setup** on the splash screen that appears and press **Next**. +3. It will then look for an existing *Syncthing* instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option. +4. Select ***Start installed Syncthing application via Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue. +5. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue. +6. You will now be prompted with a confirmation window that has a QR code and the devices identifier - you will need one of these to add other devices to the sync system. +7. *Syncthing/Syncthing Tray* are now installed. Press Finish to close the pop up. + + +--- + +### Configuring this Machine as a Parent + +Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup. + +1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.** + 1. If you don’t have a taskbar in your distro, you can also reach it directly by opening a web browser to: *http://127.0.0.1:8384/.* +2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them. +3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**. +4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves. +5. Enter the Full folder path to where your save files are stored on this machine. + + + +6. Ignore the other tabs for now and hit **Save**. +7. The folder is now ready to be shared with other devices. + +--- + +### Configuring this Machine as a Child + +Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup. + +1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent. +2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.** +3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them. +4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it. +5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID. +6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.** +7. We are done with the parent, now **SWITCH OVER TO THE CHILD.** +8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already. +9. You should now see a connection request pop-up from the parent. Hit **+ Add Device** to add the device. +10. Hit **Save** to finish adding the device. +11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.** +12. Enter the path to the save folder in Eden and hit **Save.** + + + +13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want. \ No newline at end of file diff --git a/docs/user/SyncthingGuide_Windows.md b/docs/user/SyncthingGuide_Windows.md new file mode 100644 index 0000000000..d94504423c --- /dev/null +++ b/docs/user/SyncthingGuide_Windows.md @@ -0,0 +1,95 @@ +# Backing Up/Syncing Eden Game Saves + +Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing](https://syncthing.net/)* on Windows. + +**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b057c2edaf680f5aa9cd1c4f97121ce) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Read the [*Syncthing General Guide*](./SyncthingGuide_General.md). +- Eden already installed, configured, and functioning. +- Ability to allow a program to communicate through the firewall in Windows. +- Ability to extract archive (.zip/.7z/.rar) files. + +--- + +## Steps + + + +### Downloading and Installing *Syncthing* + +1. Download [*Syncthing Tray*](https://martchus.github.io/syncthingtray/#downloads-section). + 1. While it is available as a command line interface, for most people I would recommend *Syncthing Tray* on Windows. For most people here, you would download the **64-bit (Intel/AMD)** version. +2. Open the downloaded archive and extract the **syncthingtray.exe** to wherever you want to store the executable. +3. Double-Click the application to run it, select the **Start guided setup** on the splash screen that appears and press **Next**. + + +4. It will then look for an existing Syncthing instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option. +5. Select ***Start Syncthing application that is built into Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue. +6. Check the box to start Syncthing Tray on login - as the name implies, this means the program will run automatically whenever you log onto the computer. Press Next to continue. +7. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue. +8. You will now be prompted with a confirmation window and a message to allow it through the firewall. Allow the access through the firewall to close that pop up. The confirmation screen has a QR code and the devices identifier - you will need one of these to add other devices to the sync system. +9. *Syncthing/Syncthing Tray* are now installed. + +--- + +### Configuring this Machine as a Parent + +Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup. + +1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.** +2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them. +3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**. +4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves. +5. Enter the Full folder path to where your save files are stored on this machine. + + + +6. Ignore the other tabs for now and hit **Save**. +7. The folder is now ready to be shared with other devices. + +--- + +### Configuring this Machine as a Child + +Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup. + +1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent. +2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.** +3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them. +4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it. +5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID. +6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.** +7. We are done with the parent, now **SWITCH OVER TO THE CHILD.** +8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.** +9. You should now see a connection request from the parent. Hit **+ Add Device** to add the device. +10. Hit **Save** to finish adding the device. +11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.** +12. Enter the path to the save folder in Eden and hit **Save.** + + + +13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want. \ No newline at end of file diff --git a/docs/user/UsingAmiibo_Windows.md b/docs/user/UsingAmiibo_Windows.md new file mode 100644 index 0000000000..e7cbae7cf0 --- /dev/null +++ b/docs/user/UsingAmiibo_Windows.md @@ -0,0 +1,43 @@ +# Using Amiibo with Eden + +Use this guide when you want to load Amiibo into your games for use with the Eden emulator. + +**Click [Here](https://evilperson1337.notion.site/Using-Amiibo-with-Eden-2b057c2edaf681b1b28ec6be600c6d3e) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +1. The Eden Emulator fully set up and configured. +2. The Amiibo file you want to use. + + + +## Steps + +--- + +1. Launch Eden and launch the game you want to load Amiibo for. + + +1. Navigate to the Amiibo section of the game. The method for initiating the scanning varies from game to game, for *Captain Toad’s Treasure Tracker*, you need to go to the press the **+** button when on the level select. You will need to look up how to do so with your specific game. +2. Upon activating the Amiibo scan functionality, you should get a Scan page. Eden is now looking for an Amiibo file to be loaded, which emulates scanning an Amiibo on actual hardware. +3. Navigate to **File > Load/Remove Amiibo…**, or press the hotkey to do the same (**F2** on keyboard by default). +4. In the file explorer that opens, navigate to the amiibo file you want to use. + + + +5. Upon loading a valid file, you will get a confirmation screen and your bonus content will be unlocked/functionality activated. +6. Repeat with any other Amiibo you want to use. \ No newline at end of file diff --git a/docs/user/UsingCheats_Android.md b/docs/user/UsingCheats_Android.md new file mode 100644 index 0000000000..cd7538be9d --- /dev/null +++ b/docs/user/UsingCheats_Android.md @@ -0,0 +1,92 @@ +# Using Cheats with Eden + +Use this guide when you want to add cheats into a game to alter gameplay for use with the Eden emulator. + +**Click [Here](https://evilperson1337.notion.site/Using-Cheats-with-Eden-2b057c2edaf6818fab66c276e2304bb4) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden Emulator fully set up and configured on your Android device. +- The cheat(s) you want to apply. +- The **Build ID** of the game. + + + +--- + +## Steps + +### Configuring a Cheat + +1. Create a directory somewhere accessible on your phone with the name of the cheat. The name you choose only affects how it is displayed in Eden. +2. Create a directory inside of this folder called **cheats.** +3. Create a new text file and copy the Hex Code of the cheat into it, optionally with the cheat name at the beginning like this example. Here this code will set the timer to 999 in *New Super Mario Bros. U Deluxe.* + + ```bash + [Time = 999] + 58000000 00C88A70 + 78001000 00000090 + 64000000 00000000 003E6F00 + ``` + +4. Save the file as a **txt** file with the Build ID of the game. For my example, my Build ID is **AEE6DCCC06D9C05B** so my file would be `AEE6DCCC06D9C05B.txt`. +5. Open Eden and press and hold the game you want to apply the cheat to. +6. Scroll down on the properties until you see **Add-ons**, select this option. +7. Select + **Install** then select **Mods and cheats** and **OK** on the window that appears. +8. A file explorer will now appear. Navigate to the directory created in step 1 and select the folder. + + +2. You should now see the cheat appear in the **Add-ons** screen. +3. Launch the game and confirm that the cheat is applied. + +--- + +### Multiple Cheats + +In order to install multiple cheats, you must repeat the steps above with the new cheat, creating a new directory with the name of the cheat and cheats directory. You **cannot** install multiple cheats with a single file. + +Community Member [Ninjistix](https://github.com/Ninjistix) created a utility (Windows or anything that can run Python) that can take a file with multiple cheats and create the files/structure for you with a provided Build ID. To download and run it, see the [GitHub Project](https://github.com/Ninjistix/nxCheat_Splitter) page. + +**Example cheat TXT file with multiple cheats. It must be in this format to work:** +``` +[Super Mario Bros. Wonder - Various] <- Optional + +[♯ 1. Always Star Power] +040E0000 00880580 52800035 + +[♯ 2. Star Power + Bubble Mode (Invincible)] +040E0000 00880580 52800075 + +[♯ 3. Can Fast Travel to Any Course and World] +040E0000 00935E10 52800036 +040E0000 0048A528 52800028 +040E0000 005D9F58 52800028 + +[♯ 4. Got All Top of Flag Poles] +040E0000 0048A818 52800028 +``` + +--- + +### Enabling/Disabling Cheats + +Cheats are enabled by default, but can be disabled so they don’t affect gameplay fairly easily using the game properties. + +1. Open Eden and press and hold the game you want to apply the cheat to. +2. Scroll down on the properties until you see **Add-ons**, select this option. +3. *Select/Deselect* the name of the cheat you wish to enable/disable. +4. Click **OK** to close the window. +5. Launch the game to confirm the cheat is/is not active. \ No newline at end of file diff --git a/docs/user/UsingCheats_Windows.md b/docs/user/UsingCheats_Windows.md new file mode 100644 index 0000000000..c2a23f869c --- /dev/null +++ b/docs/user/UsingCheats_Windows.md @@ -0,0 +1,83 @@ +# Using Cheats with Eden + +Use this guide when you want to add cheats into a game to alter gameplay for use with the Eden emulator. + +**Click [Here](https://evilperson1337.notion.site/Using-Cheats-with-Eden-2b057c2edaf6818fab66c276e2304bb4) for a version of this guide with images & visual elements.** + +--- + +### Pre-Requisites + +- Eden Emulator fully set up and configured +- The cheat(s) you want to apply +- The **Build ID** of the game. + + + +## Steps + +--- + +### Configuring a Cheat + +1. Copy the Hex Code of the cheat into a text file, optionally with the cheat name at the beginning like the example. Here this code will set the timer to 999 in *New Super Mario Bros. U Deluxe.* + + ```bash + [Time = 999] + 58000000 00C88A70 + 78001000 00000090 + 64000000 00000000 003E6F00 + ``` + +1. Save the file as a **txt** file with the Build ID of the game. For my example, my Build ID is **AEE6DCCC06D9C05B** so my file would be `AEE6DCCC06D9C05B.txt`. +2. Launch Eden and wait for the program to load. +3. *Right-Click* the game in Eden and select **Open Mod Data Location**. A file explorer window should appear. +4. Create a folder inside of the file explorer window with the name of the cheat. This name does not matter and only affects how it appears in the game properties inside of Eden. +5. Navigate inside of this folder and create another folder called **cheats.** +6. Move the txt file you created earlier into this **cheats** folder. (e.g. `/Time 999/cheats/AEE6DCCC06D9C05B.txt` ) +7. Go back to Eden and *right-click* the game. Select *Configure Game* and you should now see the cheat you created appear in the **Add-Ons** section with the name of the folder from step 6. +8. Launch the game to verify that the cheat is enabled. + +### Multiple Cheats + +In order to install multiple cheats, you must repeat the steps above with the new cheat, creating a new directory with the name of the cheat and cheats directory. You **cannot** install multiple cheats with a single file. + +Community Member [Ninjistix](https://github.com/Ninjistix) created a utility (Windows or anything that can run Python) that can take a file with multiple cheats and create the files/structure for you with a provided Build ID. To download and run it, see the [GitHub Project](https://github.com/Ninjistix/nxCheat_Splitter) page. + +**Example cheat TXT file with multiple cheats. It must be in this format to work:** +``` +[Super Mario Bros. Wonder - Various] <- Optional + +[♯ 1. Always Star Power] +040E0000 00880580 52800035 + +[♯ 2. Star Power + Bubble Mode (Invincible)] +040E0000 00880580 52800075 + +[♯ 3. Can Fast Travel to Any Course and World] +040E0000 00935E10 52800036 +040E0000 0048A528 52800028 +040E0000 005D9F58 52800028 + +[♯ 4. Got All Top of Flag Poles] +040E0000 0048A818 52800028 +``` + +--- + +### Enabling/Disabling Cheats + +Cheats are enabled by default, but can be disabled so they don’t affect gameplay fairly easily using the game properties. + +1. *Right-Click* the game and select *Configure Game*. +2. In the **Add-Ons** section, locate the cheat you wish to enable. +3. *Select/Deselect* the name of the cheat you wish to enable/disable. +4. Click **OK** to close the window. +5. Launch the game to confirm the cheat is/is not active. \ No newline at end of file