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

GBAVCSM 3DS: Difference between revisions

From GameBrew
No edit summary
m (Text replacement - "Category:Homebrew utility applications on 3DS" to "")
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS Homebrews
{{Infobox 3DS Homebrews
|title=GBAVCSM
|title=GBAVCSM
|image=https://dlhb.gamebrew.org/3dshomebrew/GBAVCSM-3DS.png
|image=Gbavcsm2.png
|description=Game Boy Advance Virtual Console Save Manager.
|description=Game Boy Advance Virtual Console Save Manager.
|author=TurdPooCharger
|author=TurdPooCharger
|lastupdated=2020/04/09
|lastupdated=2020/04/09
|type=Utilities
|type=Save Managers and Editors
|version=1.3
|version=1.3
|license=GPL-3.0
|license=GPL-3.0
Line 12: Line 12:
|source=https://github.com/TurdPooCharger/GBAVCSM
|source=https://github.com/TurdPooCharger/GBAVCSM
}}
}}
GBAVCSM (Game Boy Advance Virtual Console Save Manager) is a gm9 script dedicated to handling GBA VC saves.
GBAVCSM, or Game Boy Advance Virtual Console Save Manager, is a [[GodMode9 3DS|GodMode9]] (gm9) script dedicated to handling GBA VC saves.


==Features==
==Features==
Line 32: Line 32:


===Notes===
===Notes===
* The v1.2 release supports direct injection.
The [9:] RAMDRIVE was chosen for its availability on both o3DS and n3DS series systems.
* The [9:] RAMDRIVE was chosen for its availability on both o3DS and n3DS series systems, close proximity to the [S:] SYSNAND VIRTUAL, and no need for post cleanup as the file erases itself after closing GodMode9.
* It is close proximity to the [S:] SYSNAND VIRTUAL, and no need for post cleanup as the file erases itself after closing GodMode9.
** Update edit (2020/01/17): For the v1.2 release, this only applies for EEPROM 64k saves when the EEPROM 64k Mode is set to manual.
* Update edit 2020/01/17 - For the v1.2 release, this only applies for EEPROM 64k saves when the EEPROM 64k Mode is set to manual.
* Unlike the method found below, you can inject saves for multiple titles in a single session.  
 
** The process of going back and forth exiting GodMode9, launching the GBA VC title, and going back to GodMode9 is eliminated.
Unlike [https://3ds.hacks.guide/godmode9-usage.html#restore-gba-vc-saves this method], you can inject saves for multiple titles in a single session.  
** [https://3ds.hacks.guide/godmode9-usage.html#restore-gba-vc-saves 3ds.hacks.guide GodMode9 Usage - Restore GBA VC Saves.]
* The process of going back and forth exiting GodMode9, launching the GBA VC title, and going back to GodMode9 is eliminated.
* A newly installed GBA VC title needs to be launched at least once in order to initialized its save. If the save isn't initialized, the script will fail to find the title in a cache search.
* A newly installed GBA VC title needs to be launched at least once in order to initialized its save.  
* If the save isn't initialized, the script will fail to find the title in a cache search.
 
About cache setup:
* Rebuild Cache (Auto) - Carefully read the top screen's ~ INSTRUCTIONS ~.
* Rebuild Cache (Auto) - Carefully read the top screen's ~ INSTRUCTIONS ~.
* Update Cache (Manual) - To find newly installed games so that they can be added:
* Update Cache (Manual) - To find newly installed games so that they can be added:
** [A:] SYSNAND SD/title/00040000 > hold (R) and press (A) > Search for titles.
** [A:] SYSNAND SD/title/00040000 > hold (R) and press (A) > Search for titles.
** Use pen(cil) and paper to write down their TitleIDs.
** Use pen(cil) and paper to write down their TitleIDs.
* A title's folder name and NAME_* cache are adjustable. However, changing the NAME_* affect its save folder's name.
 
* To quickly switch from Home Menu/NATIVE_FIRM to GodMode9, press (L)+(DOWN)+(SELECT) to open Rosalina menu, press (UP) twice, Reboot, and then quickly press & hold (START) to access Luma3DS chainloader.
A title's folder name and NAME_* cache are adjustable. However, changing the NAME_* affect its save folder's name.
* Early in its development, this script was internally known as project TOTO. The code name was adopted in jest to the person who helped out the most, and it stems from this individual's game character. However, the actual meaning or backstory of the name and how it came to be was never divulged; whoever this original TOTO refers to remains a mystery.​
 
To quickly switch from Home Menu/NATIVE_FIRM to GodMode9:
* Press (L)+(DOWN)+(SELECT) to open Rosalina menu.
* Press (UP) twice, reboot, and then quickly press & hold (START) to access Luma3DS chainloader.
 
Early in its development, this script was internally known as project TOTO. The code name was adopted in jest to the person who helped out the most, and it stems from this individual's game character. However, the actual meaning or backstory of the name and how it came to be was never divulged; whoever this original TOTO refers to remains a mystery.​


==Screenshots==
==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/gbavcsm2.png
https://dlhb.gamebrew.org/3dshomebrews/gbavcsm2.png
https://dlhb.gamebrew.org/3dshomebrews/gbavcsm24.png
https://dlhb.gamebrew.org/3dshomebrews/gbavcsm24.png
==Changelog==
'''v1.3'''
* Choosing a game in Titles Selection now checks if it is still installed in the Nintendo 3DS folder. If the game is not found, ask the user if (s)he would like to remove it from the cache. The [removed] game's save files are kept intact and left alone in the saves folder.
* Streamlined some of the code by exchanging the fset command with fill command when generating dummy CIAs. Very minor speed bump when adding new titles to the cache.


==Credits==
==Credits==
Line 64: Line 77:
* GitHub - https://github.com/TurdPooCharger/GBAVCSM
* GitHub - https://github.com/TurdPooCharger/GBAVCSM
* GBAtemp - https://gbatemp.net/threads/release-godmode9-scripts-megathread.482150/page-10#post-8790663
* GBAtemp - https://gbatemp.net/threads/release-godmode9-scripts-megathread.482150/page-10#post-8790663
[[Category:3DS homebrew applications]]
[[Category:Homebrew utility applications on 3DS]]

Latest revision as of 05:40, 6 Mayıs 2024

GBAVCSM
Gbavcsm2.png
General
AuthorTurdPooCharger
TypeSave Managers and Editors
Version1.3
LicenseGPL-3.0
Last Updated2020/04/09
Links
Download
Website
Source

GBAVCSM, or Game Boy Advance Virtual Console Save Manager, is a GodMode9 (gm9) script dedicated to handling GBA VC saves.

Features

  • Automatically mass dump all the GBA VC saves in one go. Caching the titles list is not required.
  • Extract the *.gba roms from the individual injections.
  • User customizable script icon, title box art, and save folder's name & directory.
    • See further details in the option, About the script.
    • Edit the settings with a text editor like Notepad or Programmer's Notepad.
  • Supports up to four (4) separate Nintendo 3DS folders. Compatible with:

User guide

Box Arts, Banners, Screenshots, Rom Info Lookup

Notes

The [9:] RAMDRIVE was chosen for its availability on both o3DS and n3DS series systems.

  • It is close proximity to the [S:] SYSNAND VIRTUAL, and no need for post cleanup as the file erases itself after closing GodMode9.
  • Update edit 2020/01/17 - For the v1.2 release, this only applies for EEPROM 64k saves when the EEPROM 64k Mode is set to manual.

Unlike this method, you can inject saves for multiple titles in a single session.

  • The process of going back and forth exiting GodMode9, launching the GBA VC title, and going back to GodMode9 is eliminated.
  • A newly installed GBA VC title needs to be launched at least once in order to initialized its save.
  • If the save isn't initialized, the script will fail to find the title in a cache search.

About cache setup:

  • Rebuild Cache (Auto) - Carefully read the top screen's ~ INSTRUCTIONS ~.
  • Update Cache (Manual) - To find newly installed games so that they can be added:
    • [A:] SYSNAND SD/title/00040000 > hold (R) and press (A) > Search for titles.
    • Use pen(cil) and paper to write down their TitleIDs.

A title's folder name and NAME_* cache are adjustable. However, changing the NAME_* affect its save folder's name.

To quickly switch from Home Menu/NATIVE_FIRM to GodMode9:

  • Press (L)+(DOWN)+(SELECT) to open Rosalina menu.
  • Press (UP) twice, reboot, and then quickly press & hold (START) to access Luma3DS chainloader.

Early in its development, this script was internally known as project TOTO. The code name was adopted in jest to the person who helped out the most, and it stems from this individual's game character. However, the actual meaning or backstory of the name and how it came to be was never divulged; whoever this original TOTO refers to remains a mystery.​

Screenshots

gbavcsm2.png gbavcsm24.png

Changelog

v1.3

  • Choosing a game in Titles Selection now checks if it is still installed in the Nintendo 3DS folder. If the game is not found, ask the user if (s)he would like to remove it from the cache. The [removed] game's save files are kept intact and left alone in the saves folder.
  • Streamlined some of the code by exchanging the fset command with fill command when generating dummy CIAs. Very minor speed bump when adding new titles to the cache.

Credits

  • @Aurora Wright - Research in AGB_FIRM save types and sizes.
  • @d0k3 - Research in GBA VC *.sav and agbsave.bin CMACs.
  • @Wolfvak - Peer reviewed the initial rough draft code for CMAC handling the GBA VC saves on the SD card.
  • @CheatFreak47 - Research in EEPROM saves 0x8 bytes flipping.
  • @KleinesSinchen - Very thorough safety, critical functions, validation, and stress testings.
  • @EventAssistant (Bernardo Giordano) - Save manager ideas of cache and naming conventions borrowed from Checkpoint.
  • @JK_ - Save manager ideas of a bare minimum user interference appropriate for gm9 script borrowed from JKSM.
  • Nintendo - Box icon's simple style inspired from CTR SDK dev tools.

External links

Advertising: