Creating Game Shortcuts In Homebrew Menu With HANS?

Discussion in '3DS - Homebrew Development and Emulators' started by ClassicGame1995, Oct 27, 2015.

  1. ClassicGame1995
    OP

    ClassicGame1995 Member

    Newcomer
    27
    11
    Aug 3, 2015
    United States
    I was wondering if anyone can tell me how to create a shortcut for my vc and digital 3ds games in the homebrew menu.
     
    Margen67 likes this.
  2. olshrimpeyes

    olshrimpeyes Your question is bad and you should feel bad

    Member
    454
    284
    Jul 30, 2015
    United States
    GNU/Somewhere
    Yes you can. You just need to make an .XML file for it. To find out how to do this look the eshop.XML file.
     
    Margen67 likes this.
  3. ClassicGame1995
    OP

    ClassicGame1995 Member

    Newcomer
    27
    11
    Aug 3, 2015
    United States
    Ok thanks very much for the help
     
    Margen67 likes this.
  4. smealum

    smealum growing up sucks.

    Member
    635
    2,035
    May 1, 2006
    United States
    SF
    i will try to write some proper documentation for the xml descriptor and shortcut format but it's pretty straightforward. here's the eshop shortcut example :

    Code:
    <shortcut>
        <executable>/3ds/hans/hans.3dsx</executable>
        <icon>/3ds/eshop.smdh</icon>
        <arg>-f/3ds/hans/titles/eshop.txt</arg>
    </shortcut>
    <targets selectable="false">
        <title mediatype="0">0004001000020900</title>
        <title mediatype="0">0004001000021900</title>
        <title mediatype="0">0004001000022900</title>
        <title mediatype="0">0004001000027900</title>
        <title mediatype="0">0004001000028900</title>
    </targets>
    
    basically the executable field points to the 3DSX you want the shortcut to run (in this case HANS), the icon points to the SMDH and arg is the argument that will be fed to the 3DSX. in this case, HANS interprets the argument as "load configuration file /3ds/hans/titles/eshop.txt instead of the default one for this target application". this also makes HANS try to load /hans/eshop.romfs and /hans/eshop.code if those options are enabled, instead of /hans/00021900.romfs, which can be helpful if you want to have multiple romhacks for the same game. (for example you could have rutile.romfs and smea.romfs for rutile ruby and ORAS smea edition)

    the second section is the list of titles HANS should run under. essentially, it's just an identifier for the game you want a shortcut to. you can find the identifier for your game on the HANS configuration screen. the mediatype should be set to 0 for a NAND title, 1 for an SD title and 2 for a gamecard. you can have multiple titles in the list so that you can handle different regions, or allow HANS to run under either the SD or gamecard version of your title. there's a priority order : HANS will launch the first title in the list it can, so the titles at the beginning of the list essentially have higher priority than the ones below.


    hope this helps.
     
  5. ClassicGame1995
    OP

    ClassicGame1995 Member

    Newcomer
    27
    11
    Aug 3, 2015
    United States
    Got it working! Thanks for the help smea and olshrimpeyes I really appreciate it.
    scr_9_BOTTOM.png
     
  6. Spatchy

    Spatchy Member

    Newcomer
    37
    12
    Oct 17, 2015
    Kent, UK
    The shortcut for the eShop is not showing up in HB launcher even though the xml and smdh are both on my sd card and hans runs fine... (yes I am running *hax 2.5)
     
    Margen67 likes this.
  7. GizmoTheGreen

    GizmoTheGreen GBAtemp Fan

    Member
    439
    121
    Oct 8, 2009
    how did you get the icon? does it default to the apps icon or did you make an smdh?
     
    Margen67 likes this.
  8. Spatchy

    Spatchy Member

    Newcomer
    37
    12
    Oct 17, 2015
    Kent, UK
    Don't worry, I found the solution, I just redownloaded the boot.3dsx and it worked - If anyone was having this problem, just redownload it from smealum.github.io/3ds


    If you are talking about the eShop, there should already be an smdh (and xml) in the 3ds folder. if you are talking about your own mods then yes, you need to make one yourself.
     
    Last edited by Spatchy, Oct 29, 2015
    Margen67 likes this.
  9. suloku

    suloku GBAtemp Advanced Fan

    Member
    866
    491
    Apr 28, 2008
  10. fiese_nase

    fiese_nase Advanced Member

    Newcomer
    93
    39
    Oct 21, 2015
    Gambia, The
    Margen67 likes this.
  11. ClassicGame1995
    OP

    ClassicGame1995 Member

    Newcomer
    27
    11
    Aug 3, 2015
    United States
    fiese_nase and GizmoTheGreen like this.
  12. GizmoTheGreen

    GizmoTheGreen GBAtemp Fan

    Member
    439
    121
    Oct 8, 2009
  13. suloku

    suloku GBAtemp Advanced Fan

    Member
    866
    491
    Apr 28, 2008
    What's the point of making an stripped version when the only difference would be not needing to touch the title launcher button? Launch it from wherever, create the shortcuts, then exit (use the L+R+DOWN+B combo, the launcher config files won't be written that way too).
     
  14. vhaines

    vhaines GBAtemp Regular

    Member
    208
    36
    Oct 13, 2015
    thanks for sharing this
     
  15. rimmyjustles

    rimmyjustles Member

    Newcomer
    34
    11
    Feb 1, 2016
    Canada
    Is there a way to use CTR to boot into a HANS Shortcut?