Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

SimpleModManager Switch: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 1: Line 1:
{{Infobox Switch Homebrews
{{Infobox Switch Homebrews
|title=SimpleModManager
|title=SimpleModManager
|image=simplemodmanagerswitch.png
|image=simplemodmanagernx.png
|description=SimpleModManager is an homebrew app for the Nintendo Switch.
|description=SimpleModManager is an homebrew app for the Nintendo Switch.
|author=nadrino
|author=nadrino
Line 8: Line 8:
|version=2.1.0
|version=2.1.0
|license=GPL-3.0
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch.7z
|download=https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx.7z
|website=https://gbatemp.net/threads/simplemodmanager-a-mod-manager-for-your-switch.548658/
|website=https://gbatemp.net/threads/simplemodmanager-a-mod-manager-for-your-switch.548658/
|source=https://github.com/nadrino/SimpleModManager
|source=https://github.com/nadrino/SimpleModManager
|donation=
|donation=
}}
}}
{{#seo:
SimpleModManager is an homebrew app for the Nintendo Switch CFW [[Atmosphere Switch|Atmosphere]], inspired by [[Generic_Mod_Manager_Switch|Generic Mod Manager]].
|title=Switch Homebrew Apps (Utilities) - GameBrew
 
|title_mode=append
It allows to manage your mods directly from the Switch (via LayeredFS).
|image=simplemodmanagerswitch.png
 
|image_alt=SimpleModManager
==Installation==
}}
* Download the latest version in the [https://github.com/nadrino/SimpleModManager/releases release page].
SimpleModManager is a homebrew application for the Nintendo Switch running on custom firmware (CFW) such as [[Atmosphere Switch]]. It allows you to manage your mods using LayeredFS. LayeredFS is a feature that allows you to replace game files with custom modifications without actually modifying the original files on the game cartridge or installed game on the console.
* Place the .nro file in the <code>/switch/</code> folder of your SD card.
* At the root of your SD card, create a <code>/mods/</code> folder.
* Place your mod with the following tree structure:
** Tree structure - <code>/mods/&lt;NameOfTheGame&gt;/&lt;NameOfTheMod&gt;/&lt;ModTreeStructureFromAtmosphereFolder&gt;</code>
** For plugins - <code>/mods/&lt;NameOfTheGame&gt;/.plugins/&lt;NameOfTheNro&gt;.smm</code>
 
Example - <code>/mods/The Legend of Zelda - Breath of the Wild/First Person View/contents/01007EF00011E000/romfs/Actor/Pack/GameRomCamera.sbactorpack</code>


The application supports hbmenu plugins, which should be linked against [https://github.com/withertech/libsmm libsmm]. The plugins can be developed by including the libsmm header file and implementing the required functions.
==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx2.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx3.png


== How to install==
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx4.png
* Download the latest version in the [https://github.com/nadrino/SimpleModManager/releases release page]
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx5.png
* Place the .nro file in the <code>/switch/</code> folder of your SDcard.
* At the root of your SDcard, create a <code>/mods/</code> folder.
* Tree structure : <code>/mods/&lt;NameOfTheGame&gt;/&lt;NameOfTheMod&gt;/&lt;ModTreeStructureFromAtmosphereFolder&gt;</code>
* For plugins: <code>/mods/&lt;NameOfTheGame&gt;/.plugins/&lt;NameOfTheNro&gt;.smm</code>


Example : <code>/mods/The Legend of Zelda - Breath of the Wild/First Person View/contents/01007EF00011E000/romfs/Actor/Pack/GameRomCamera.sbactorpack</code>
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx6.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagernx7.png


==Media==
==Media==
'''Simple Mod Manager : a Showcase - ([https://www.youtube.com/watch?v=uJiIzLvsW2Y Trash Channel])'''<br>
'''Simple Mod Manager : a Showcase ([https://www.youtube.com/watch?v=uJiIzLvsW2Y Trash Channel])'''<br>
<youtube>uJiIzLvsW2Y</youtube>
<youtube>uJiIzLvsW2Y</youtube>
==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-01.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-02.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-03.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-04.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-05.png
https://dlhb.gamebrew.org/switchhomebrews/simplemodmanagerswitch-06.png


==Changelog==
==Changelog==
'''v2.1.0'''
'''v2.1.0 2023/04/30'''
* Restructuring the core engine & cleaning code. Should be a lot more stable. For this version, I've dropped the overlay module as it instantaneously crash even with the simplest include.
* Restructuring the core engine & cleaning code. Should be a lot more stable. For this version, I've dropped the overlay module as it instantaneously crash even with the simplest include.
* The console version is now shipped appart as the escape codes (colors for example) are not displayed correctly when compiled with borealis.
* The console version is now shipped appart as the escape codes (colors for example) are not displayed correctly when compiled with borealis.
'''v2.0.4'''
'''v2.0.4 2021/01/11'''
*Compiled with latest libnx (v4.0.0)
*Compiled with latest libnx (v4.0.0).
'''v2.0.3'''
'''v2.0.3 2020/09/05'''
*Updated borealis (GUI submodule)
*Updated borealis (GUI submodule).
'''v2.0.2b'''
'''v2.0.2b 2020/07/19'''
*Overlay module is now fixed: apply/disabling mods won't crash Atmosphere anymore!
*Overlay module is now fixed: apply/disabling mods won't crash Atmosphere anymore.
'''v2.0.2'''
'''v2.0.2 2020/07/14'''
* Fixing focus loss when mod checking is faster than the display animation
* Fixing focus loss when mod checking is faster than the display animation.
* Fixing last install preset not being remembered while restarting the app
* Fixing last install preset not being remembered while restarting the app.
* Fixing loading subtitle display for mods checking
* Fixing loading subtitle display for mods checking.
* Increasing read buffer size for file comparison (faster mods status check)
* Increasing read buffer size for file comparison (faster mods status check).
* Adding color to mods status tags
* Adding color to mods status tags.
'''v2.0.1'''
'''v2.0.1 2020/07/07'''
* Minor UI improvements
* Minor UI improvements.
* Updating loading display for mod sets operations
* Updating loading display for mod sets operations.
* Adding icons to options labels
* Adding icons to options labels.
'''v2.0.0'''
'''v2.0.0 2020/07/02'''
* New features:
* New features:
** First release of the GUI.
** First release of the GUI.
Line 72: Line 69:
** Few features are still missing from the consoleUI version (like showing conflicts or detailed view of the status of each mod file). You can still switch back to the old UI by going to the Settings menu. You can switch back to the GUI as well.
** Few features are still missing from the consoleUI version (like showing conflicts or detailed view of the status of each mod file). You can still switch back to the old UI by going to the Settings menu. You can switch back to the GUI as well.
** Sometimes while playing with the mods preset editor might cause some random crashes. Those don't affect your mods files or parameters of SMM since they're related to the GUI memory allocation. If it happens just relaunch the app and everything you've done should be there.
** Sometimes while playing with the mods preset editor might cause some random crashes. Those don't affect your mods files or parameters of SMM since they're related to the GUI memory allocation. If it happens just relaunch the app and everything you've done should be there.
'''v1.6.0'''
'''v1.6.0 2020/06/07'''
* First release of the Tesla module ! (put the .ovl file in "/switch/.overlays/")
* First release of the Tesla module (put the .ovl file in "/switch/.overlays/").
* Minor changes in the UI of the applet version
* Minor changes in the UI of the applet version.
'''v1.5.2'''
'''v1.5.2 2020/06/02'''
* Slight modification in the UI.
* Slight modification in the UI.
* ZL and ZR now show a menu in which you can select the options.
* ZL and ZR now show a menu in which you can select the options.
* Adding option to specify which preset should be used in this folder (in ZL/ZR menu).
* Adding option to specify which preset should be used in this folder (in ZL/ZR menu).
* Fixed a bug while removing a mod from a preset.
* Fixed a bug while removing a mod from a preset.
'''v1.5.1'''
'''v1.5.1 2020/05/31'''
*New features:
*New features:
**Now SMM remembers the last install-preset you used.
**Now SMM remembers the last install-preset you used.
**Mods status cache is now considering install-preset
**Mods status cache is now considering install-preset.
**Now by pressing "Y", you can also check the conflicts a given mod wrt the others.
**Now by pressing "Y", you can also check the conflicts a given mod wrt the others.
**After the creation(edition) of a presets, SMM will now show the list conflicted files and the mod that will be considered for each of these files. Also the total size of the preset is printed.
**After the creation(edition) of a presets, SMM will now show the list conflicted files and the mod that will be considered for each of these files. Also the total size of the preset is printed.
Line 91: Line 88:
**Fixing a bug in the config file reading that prevented the program to get non install-preset related options: stored-mods-base-folder and last-program-version.
**Fixing a bug in the config file reading that prevented the program to get non install-preset related options: stored-mods-base-folder and last-program-version.
*Technical:
*Technical:
**Now mods status cache file is writen as "mods_status_cache.txt"
**Now mods status cache file is writen as "mods_status_cache.txt".
**Adding "use-gui" parameter, but will only be used by the GUI build
**Adding "use-gui" parameter, but will only be used by the GUI build.
**Now FS is properly handled by "enableEmbeddedSwitchFS"/"disableEmbeddedSwitchFS"
**Now FS is properly handled by "enableEmbeddedSwitchFS"/"disableEmbeddedSwitchFS".
**mkdir is now handled by native Switch FS calls
**mkdir is now handled by native Switch FS calls.
'''v1.5.0'''
'''v1.5.0 2020/05/11'''
*New features :
*New features:
**Now using built in filesystem functions for IO. (see Performance Improvement section below)
**Now using built in filesystem functions for IO. (see Performance Improvement section below).
**Optimized presets
**Optimized presets.
***Now if you apply any preset where several mods overwrite the same file, only the file of the last mod will be actually written.
***Now if you apply any preset where several mods overwrite the same file, only the file of the last mod will be actually written.
**Changing location of the config file : "/config/SimpleModManager/parameters.ini".
**Changing location of the config file : "/config/SimpleModManager/parameters.ini".
***You will be warn at the first launch of the v1.5.0 if you already had SimpleModManager before. The program will automatically detect the old parameter file, and move it to the new location
***You will be warn at the first launch of the v1.5.0 if you already had SimpleModManager before. The program will automatically detect the old parameter file, and move it to the new location.
**Last cursor position is now save: each time you go back to the mod list, the cursor will no longer be at the begining of the list.
**Last cursor position is now save: each time you go back to the mod list, the cursor will no longer be at the begining of the list.
**Removing cache of files list. (saving some RAM)
**Removing cache of files list. (saving some RAM).
**Preparing ground for a Tesla overlay :).
**Preparing ground for a Tesla overlay.
*Performance Improvement :
*Performance Improvement:
**Mods status check : 300% faster (CRC check reimplementation helped a lot)
**Mods status check : 300% faster (CRC check reimplementation helped a lot).
**Disabling mods : 40% faster
**Disabling mods : 40% faster.
**Apply mods (tested with preset) : 20% faster
**Apply mods (tested with preset) : 20% faster.
'''v1.4.1'''
'''v1.4.1 2020/05/01'''
* New features :
* New features:
** Adding checksum support (CRC32) with cache
** Adding checksum support (CRC32) with cache.
** Adding keyboard to rename presets
** Adding keyboard to rename presets.
** Fixing various displaying bugs
** Fixing various displaying bugs.
** Fixing mod presets editing
** Fixing mod presets editing.
* Key mapping changes:
* Key mapping changes:
** Y will now show you the files status of the selected mod
** Y will now show you the files status of the selected mod.
** ZL will force a recheck of applied mods (CRC32)
** ZL will force a recheck of applied mods (CRC32).
'''v1.4.0'''
'''v1.4.0 2020/02/17'''
* New feature : ability to create and apply presets of mods
* New feature : ability to create and apply presets of mods.
* Now handles key persistence
* Now handles key persistence.
* Minor bugs fixes
* Minor bugs fixes.
'''v1.3.1'''
'''v1.3.1 2019/12/16'''
*Compiled with latest libnx (Compatible with 9.1.0).
*Compiled with latest libnx (Compatible with 9.1.0).
'''v1.3.0'''
'''v1.3.0 2019/10/25'''
* Adding multiple presets in config file
* Adding multiple presets in config file.
* Possibility to swap preset during the app execution with "Y"
* Possibility to swap preset during the app execution with "Y".
'''v1.2.0'''
'''v1.2.0 2019/10/17'''
* Adding the possibility to change destination folder (Feature Request)
* Adding the possibility to change destination folder (Feature Request).
* Adding parameter file reading (Initiated by kowbot, thanks !)
* Adding parameter file reading (Initiated by kowbot, thanks).
* Changing keybinding
* Changing keybinding.
* Fixing bugs
* Fixing bugs.
* Cosmetics changes
* Cosmetics changes.
'''v1.1.0'''
'''v1.1.0 2019/10/01'''
* Compiled with latest libnx (Compatible with 9.0.0)
* Compiled with latest libnx (Compatible with 9.0.0).
* Few changes in the ui
* Few changes in the ui.
* Minor bug fix
* Minor bug fix.
'''v1.0.0'''
'''v1.0.0 2019/09/22'''
* First Release.
* First Release.


== External links ==
== External links ==
* Gbatemp - https://gbatemp.net/threads/simplemodmanager-a-mod-manager-for-your-switch.548658/
* GitHub - https://github.com/nadrino/SimpleModManager
* Github - https://github.com/nadrino/SimpleModManager
* GBAtemp - https://gbatemp.net/threads/simplemodmanager-a-mod-manager-for-your-switch.548658/
* Reddit -

Revision as of 12:49, 4 Mayıs 2023

SimpleModManager
Simplemodmanagernx.png
General
Authornadrino
TypeUtilities
Version2.1.0
LicenseGPL-3.0
Last Updated2023/04/30
Links
Download
Website
Source

SimpleModManager is an homebrew app for the Nintendo Switch CFW Atmosphere, inspired by Generic Mod Manager.

It allows to manage your mods directly from the Switch (via LayeredFS).

Installation

  • Download the latest version in the release page.
  • Place the .nro file in the /switch/ folder of your SD card.
  • At the root of your SD card, create a /mods/ folder.
  • Place your mod with the following tree structure:
    • Tree structure - /mods/<NameOfTheGame>/<NameOfTheMod>/<ModTreeStructureFromAtmosphereFolder>
    • For plugins - /mods/<NameOfTheGame>/.plugins/<NameOfTheNro>.smm

Example - /mods/The Legend of Zelda - Breath of the Wild/First Person View/contents/01007EF00011E000/romfs/Actor/Pack/GameRomCamera.sbactorpack

Screenshots

simplemodmanagernx2.png simplemodmanagernx3.png

simplemodmanagernx4.png simplemodmanagernx5.png

simplemodmanagernx6.png simplemodmanagernx7.png

Media

Simple Mod Manager : a Showcase (Trash Channel)

Changelog

v2.1.0 2023/04/30

  • Restructuring the core engine & cleaning code. Should be a lot more stable. For this version, I've dropped the overlay module as it instantaneously crash even with the simplest include.
  • The console version is now shipped appart as the escape codes (colors for example) are not displayed correctly when compiled with borealis.

v2.0.4 2021/01/11

  • Compiled with latest libnx (v4.0.0).

v2.0.3 2020/09/05

  • Updated borealis (GUI submodule).

v2.0.2b 2020/07/19

  • Overlay module is now fixed: apply/disabling mods won't crash Atmosphere anymore.

v2.0.2 2020/07/14

  • Fixing focus loss when mod checking is faster than the display animation.
  • Fixing last install preset not being remembered while restarting the app.
  • Fixing loading subtitle display for mods checking.
  • Increasing read buffer size for file comparison (faster mods status check).
  • Adding color to mods status tags.

v2.0.1 2020/07/07

  • Minor UI improvements.
  • Updating loading display for mod sets operations.
  • Adding icons to options labels.

v2.0.0 2020/07/02

  • New features:
    • First release of the GUI.
    • Now SMM will automatically find the game image to the game folders.
    • Mods management operation (applying, removing, checking) are now done asynchronously. This improves speed and allows a better loading monitor display.
  • Caveats:
    • Few features are still missing from the consoleUI version (like showing conflicts or detailed view of the status of each mod file). You can still switch back to the old UI by going to the Settings menu. You can switch back to the GUI as well.
    • Sometimes while playing with the mods preset editor might cause some random crashes. Those don't affect your mods files or parameters of SMM since they're related to the GUI memory allocation. If it happens just relaunch the app and everything you've done should be there.

v1.6.0 2020/06/07

  • First release of the Tesla module (put the .ovl file in "/switch/.overlays/").
  • Minor changes in the UI of the applet version.

v1.5.2 2020/06/02

  • Slight modification in the UI.
  • ZL and ZR now show a menu in which you can select the options.
  • Adding option to specify which preset should be used in this folder (in ZL/ZR menu).
  • Fixed a bug while removing a mod from a preset.

v1.5.1 2020/05/31

  • New features:
    • Now SMM remembers the last install-preset you used.
    • Mods status cache is now considering install-preset.
    • Now by pressing "Y", you can also check the conflicts a given mod wrt the others.
    • After the creation(edition) of a presets, SMM will now show the list conflicted files and the mod that will be considered for each of these files. Also the total size of the preset is printed.
    • Adding default install preset : "root", where the mods are installed in "/".
    • Re-design the buttons layout.
  • Fixes:
    • Fixing a bug in the config file reading that prevented the program to get non install-preset related options: stored-mods-base-folder and last-program-version.
  • Technical:
    • Now mods status cache file is writen as "mods_status_cache.txt".
    • Adding "use-gui" parameter, but will only be used by the GUI build.
    • Now FS is properly handled by "enableEmbeddedSwitchFS"/"disableEmbeddedSwitchFS".
    • mkdir is now handled by native Switch FS calls.

v1.5.0 2020/05/11

  • New features:
    • Now using built in filesystem functions for IO. (see Performance Improvement section below).
    • Optimized presets.
      • Now if you apply any preset where several mods overwrite the same file, only the file of the last mod will be actually written.
    • Changing location of the config file : "/config/SimpleModManager/parameters.ini".
      • You will be warn at the first launch of the v1.5.0 if you already had SimpleModManager before. The program will automatically detect the old parameter file, and move it to the new location.
    • Last cursor position is now save: each time you go back to the mod list, the cursor will no longer be at the begining of the list.
    • Removing cache of files list. (saving some RAM).
    • Preparing ground for a Tesla overlay.
  • Performance Improvement:
    • Mods status check : 300% faster (CRC check reimplementation helped a lot).
    • Disabling mods : 40% faster.
    • Apply mods (tested with preset) : 20% faster.

v1.4.1 2020/05/01

  • New features:
    • Adding checksum support (CRC32) with cache.
    • Adding keyboard to rename presets.
    • Fixing various displaying bugs.
    • Fixing mod presets editing.
  • Key mapping changes:
    • Y will now show you the files status of the selected mod.
    • ZL will force a recheck of applied mods (CRC32).

v1.4.0 2020/02/17

  • New feature : ability to create and apply presets of mods.
  • Now handles key persistence.
  • Minor bugs fixes.

v1.3.1 2019/12/16

  • Compiled with latest libnx (Compatible with 9.1.0).

v1.3.0 2019/10/25

  • Adding multiple presets in config file.
  • Possibility to swap preset during the app execution with "Y".

v1.2.0 2019/10/17

  • Adding the possibility to change destination folder (Feature Request).
  • Adding parameter file reading (Initiated by kowbot, thanks).
  • Changing keybinding.
  • Fixing bugs.
  • Cosmetics changes.

v1.1.0 2019/10/01

  • Compiled with latest libnx (Compatible with 9.0.0).
  • Few changes in the ui.
  • Minor bug fix.

v1.0.0 2019/09/22

  • First Release.

External links

Advertising: