JASM is a skin manager for a certain game. Made using WinUI 3 with WinAppSDK. I made this for fun, for myself and to learn WinUI, but it kinda took off over time.
There may be some "GIMI-ModManager" references throughout the app, that is what I originally called this project. I'll change them eventually.
Download link and images are also available over at GameBanana
This is still in an early stage of development. Make backups and use at your own risk
Unhandled exceptions are written to the Logs file as well. Debug logging can be enabled in appsettings.json
- Pretty UI 👀
- Drag And Drop files directly into the app
- Automatically sort unsorted mods into respective character's folders
- Move Mods between characters
- Start a 3Dmigto launcher and/or a certain game straight from the app
- The app watches character folders and automatically updates if skins are added or removed from folders.
- Edit merged.ini keys
- Export (copy) all mods managed by JASM to a user specified folder
- Refresh mods using F10 or the refresh button in app. (Requires an elevated side process, see description bellow)
- "SPACE" - In character view, toggles selected mods on/off
- "F10" - Refresh Mods in the game, if the elevator process and a certain game is running
- "F5" - In character view, refresh the character's mods from disk
- "CTRL + F" - In character overview, focus on the search bar
- "ESCAPE" - In character view, Go back to character overview
- "F1" - In character view, opens selectable in-game skins
Latest release can be downloaded either from GameBanana or from the Releases page. To start the app run JASM - Just Another Skin Manager.exe in JASM/ folder, I suggest creating a shortcut to it.
Latest development release can be downloaded from Actions Tab these are automatically built from the main branch and are '''usually stable''' but not necessarily
- Link to the latest successful build
- Select the latest build (top of the list)
- Scroll down to the "Artifacts" section and click the "Upload JASM" link to download.
- Windows 10, version 1809 or higher (supposedly)
- NET 7.0 Desktop Runtime (v7.0.10)
- Windows App SDK
If you don't have these downloaded the application will prompt you to download necessary dependencies and provide links.
The elevator process is a small program that can be started as an elevated process from the app. It is completely optional and is kind of a niche feature. It is used to send the F10 key to the game to refresh the mods. Enabling and disabling mods in JASM will also automatically refresh the mods. This is done through named pipes. The process does not listen for keybinds it only waits for a simple "1" command from the app. This makes it send the F10 key to the game.
The H.InputSimulator library is used to send keyboard input.
- The Json file that stores the Genshin characters is a modified and stripped down version of this genshin-impact-tools and some of the images are also from the same repository.
- The Json file that stores the Genshin weapons is a modified and stripped down version of this genshin-impact-tools and the weapon images are also from the same repository.
- 7-Zip is bundled with the app, 7-Zip is licensed under the GNU Lesser General Public License (LGPL). You can find the full license details and source code at www.7-zip.org.
- SharpCompress is used if the bundled 7-zip is not found. SharpCompress is licensed under the MIT license. You can find the full license details and source code at SharpCompress's GitHub Page
- WinUI3Localizer is used for localization. WinUI3Localizer is licensed under the MIT license. You can find the full license details and source code at WinUI3Localizer's GitHub Page
- I have tested this app mostly on two machines running Windows 11. I have tested it on Windows 10 in a virtual machine.
- There are definitely bugs. I have not tested this app enough and there are not tests written for it.
- Drag and drop is really finicky for some reason. It works but it's not perfect. So the code for it is still quite messy and it involved time consuming trial and error until it worked.
- Changing the app's theme causes instability and usually it crashes when navigating to another page. This means it needs to restart after changing the theme
- I made everything in dark mode theme, so light mode does not look good.
- App settings are stored here
C:\Users\<username>\AppData\Local\JASM\ApplicationData - Mod specific settings are stored within the mod folder themselves and are prefixed with
.JASM_. When exporting mods, these files can be ignored.
If you want to contribute to this project, feel free to do so. I am not a professional developer when it comes to WinUI and I am still actively learning.
The code has progressively gotten more spaghettified over time ;_;
So be aware that the code is not super clean...
- I suggest following the Install tools for the Windows App SDK tutorial.
- From then on it should be a simple git clone https://github.com/Jorixon/JASM
- Then inside the cloned folder, click on JASM\src\GIMI-ModManager.sln or open it trough Visual Studio.
- Then right click GIMI-ModManager.WinUI project in the sidebar and then click publish and click publish again.
- In the target location the application should have been built.
I Get the error: An error occurred while adding the storage items. Mod may have been partially copied. Could not find a part of the path "C:\Users\AppData\Local\Temp\7z..." When draging mods from 7z
This still seems to happen with certain mods, though an alternative is to use the “Add Archive…” command or drag and drop the entire archive file. Just note that it is not smart enough to detect a skin nested inside a “Mods/” folder, at least not yet.
There seems to be some odd behavior between WinUI/WinAppSdk frameworks and the way 7zip extracts files. Currently I don’t have a quick fix.
For some reason when you drag and drop 7z contents into, let’s say file explorer, the archive is first extracted to a “C:\Users\AppData\Local\Temp\7z…” folder. The folder is then moved/copied to where you dropped the files. The temp 7z folder is deleted once this process finishes. At least that’s how I understand it when it comes to drag and drop into file explorer. The exact details might be a little different.
This process is similar for this application. The problem is that for some reason 7z seems to delete the extracted contents in “/Temp/7z…” before JASM can copy/move the files to the mod’s directory. This took quite a while to debug and a lot of trial and error until I got to something that worked (during development?).
I believe it has something to do with IPC (Inter Process Communication) between 7z process and JASM. I’ve read some posts on Github of others having similar problems with drag and drop.
At the moment I don’t know what makes it sometimes fail, but I know it happens sometimes. I would really like to fix this, I just don’t how yet.