[Tutorial] Creating Hans Shortcuts

Discussion in '3DS - Tutorials' started by Flerp, Nov 1, 2015.

Nov 1, 2015
  1. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    I could never find good documentation on HANS shortcuts, so I decided to document it myself!

    This tutorial should allow you to easily create working hans shortcuts, capable of having multiple romhacks on the SD card at once (I use them mostly for VC injected romfs hacks)

    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>
    This is an example of the default eshop hans xml

    First things first, the main shortcut to Hans

    Code:
    <executable>/3ds/hans/hans.3dsx</executable>
    This is just a simple path to your hans executable, should generally always be the same, unless you're using special folders (Like with the gridlauncher HBL)

    Code:
    <icon>/3ds/eshop.smdh</icon>
    Path to your SMDH (Icon, basic info) For your HANS Shortcut.

    Code:
    <arg>-f/3ds/hans/titles/eshop.txt</arg>
    Path to the hans boot argument text
    your romfs for romhacks should be named the same as your text file, no additional lines in the text file are needed for custom named romfs files. (IE: neoy.romfs will load from neoy.txt)

    Code:
    <title mediatype="0">0004001000020900</title>
    This is the title you wish to launch, alone with the media type

    For Mediatype there are 3 options
    0 for a NAND title (eshop, System Settings, etc)
    1 for SD card titles (Most games downloaded from the eshop)
    2 for Gamecart (self Explanatory)

    You can have multiple lines for alternate titles and locations

    Code:
    <title mediatype="1">0004001000020900</title>
    <title mediatype="2">0004001000021900</title>
    So this would first attempt to find the title on the SD card, and then move on to the game cart, should the SD title not be found.

    For the title string, an easy eay to grab it is the folder name of your braindump.

    Let's move on to the HANS title text file

    Code:
    region : 1
    language : -1
    clock : 0
    romfs : 1
    code : 1
    nim_checkupdate : 1
    This is a default launch text file(For USA) for a title

    Code:
    Region : 1
    This is which region you'd like to launch from
    0 - Japan
    1 - USA
    2 - Europe

    Code:
    Language : -1
    This is the language in which to launch the title, there can be some conflicts with certain regions and languages that I have experienced.
    -1 - System Default Language
    0 - Japanese

    Code:
    Clock : 0
    This specifies which clockrate the game runs with
    0 - 268Mhz
    1 - 804Mhz

    Code:
    romfs : 1
    This line specifies whether to load the default romfs in the title, or another in the root/hans folder
    0 - Custom romfs, named the same as the text file
    1 - Default romfs

    Code:
    code : 1
    The same as the romfs argument, but with the code file
    0 - custom code, named the same as the text file
    1 - Default code

    Code:
    nim_checkupdate : 1
    Simple firmware spoofer for the title you are launching
    0 - Spoofer active
    1 - Default, no spoof



    There are a few things I left out, such as all of the language settings, I didn't quite have the time to go through every language, heh.

    And if it was confusing I'll reiterate a little bit of the file structure

    shortcut.xml:
    Location - /3ds
    Description - Main shortcut to the hans executable with locations for the smdh, title ID, and boot arguments text file.

    shortcut.smdh
    Location - /3ds (Or somewhere else specified in the XML)
    Description - Icon and info for the title/romhack

    title.txt
    Location - /3ds/hans/title
    Description - Boot arguments for HANS when booting your title. Should be named the same as your romfs file when using romhacks. IE Neoy.romfs would have a complementary Neoy.txt in the /3ds/hans/title folder.
     
    Last edited by Flerp, Nov 1, 2015


  2. Keizel

    Member Keizel GBAtemp Regular

    Joined:
    Jun 28, 2015
    Messages:
    279
    Country:
    Spain
    I take this opportunity to indicate how to put in a folder eShop, I said yesterday this:

    With this tutorial, you can use eShop spoofer in others Homebrew Launcher
     
  3. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
    Here is a two noob questions :rolleyes::

    1.- Can i write the code in a simple notepad? (Or have i to use Notepad++ for example?)
    2.- How can i make a .smdh file?

    Tanks a lot for your help :grog:
     
    Last edited by pinguino1234, Nov 1, 2015
  4. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    I would assume regular notepad would be fine, I use notepad++ for just about everything though xD

    https://gbatemp.net/threads/release-the-smdh-creator-make-your-own-icon-pack.396765/
    for making smdh files

    (Note: I have been having some issues with that program, being that some smdh files created have blank text in the grid launcher HBL)
     
    pinguino1234 likes this.
  5. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
  6. Gettwobirdsstone

    Member Gettwobirdsstone Triforce Guardian

    Joined:
    Jul 1, 2012
    Messages:
    372
    Location:
    Behind you breathing heavily
    Country:
    Canada
    Sweet now I can play Cave Story Eshop from my HBL, thanks. Also do you know of a SMDH editor for ubuntu? and game title numbers?
     
    Last edited by Gettwobirdsstone, Nov 3, 2015
  7. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    If you manually launch HANS and a title, on the bottom it has the game ID number on the bottom before you hit ok.

    And sadly I dunno for ubuntu smdh creation :(
     
  8. Pottty

    Newcomer Pottty Advanced Member

    Joined:
    Jul 22, 2015
    Messages:
    51
    Country:
    Hungary
  9. Gettwobirdsstone

    Member Gettwobirdsstone Triforce Guardian

    Joined:
    Jul 1, 2012
    Messages:
    372
    Location:
    Behind you breathing heavily
    Country:
    Canada
    Last edited by Gettwobirdsstone, Nov 4, 2015
  10. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
    Testing this, I got an idea to have the shortcuts on a folder! :grog: (This is not the big thing I now ;)):

    1.- Copy the hans.3dsx on the Shortcut´s folder. (/3ds/name/hans.3dsx)
    2.- Rename the .3dsx with the same name as .smdh
    3.- Create a folder named "titles" and put the .txt on it. (/3ds/name/titles/xxxxxxxx.txt)
    4.- Update the .xml with the new directions (e.j. <executable>/3ds/hans/hans.3dsx</executable> to <executable>/3ds/name/name.3dsx</executable>)

    In the folder should be:

    titles --- xxxxxxxx.txt
    name.3dsx
    name.smdh
    name.xml
    Enjoy!! :yaysp:
     
  11. Lemon_

    Newcomer Lemon_ Member

    Joined:
    Oct 31, 2015
    Messages:
    28
    Country:
    Argentina
    Is there a way to make two separate HANS shortcuts but with different ".romfs" files to redirect to?
    Inyecting multiple roms onto the same VC title is getting kinda tedious.
     
  12. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    Whatever you name the .txt file will be the name of the romfs file it looks for.

    Example, I have 6 "romhacks" for Wario Land 2 VC

    The .xml files are identical, minus the miles looking for the SMDH and .txt file

    So one xml looks for pkmy.txt, which loads pkmy.romfs
    The other xml looks for pkmg.txt, which loads my pkmg.romfs

    The XML and SMDH can be named whatever you like, as long as the XML and SMDH are in the /3ds folder and the XML points to the ".txt" file that you want to load.

    The romfs files do not have to be named with the 8 digit ID, that's only if you are using HANS default "save configuration" which creates the text file with those 8 digits
     
    Lemon_ likes this.
  13. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
    But... where do you have to put ".romfs"? I tried in /hans and /3ds without a result :unsure:
     
  14. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    .romfs files go in the root/hans folder
     
  15. Ericjwg

    Member Ericjwg Good

    Joined:
    Jul 2, 2015
    Messages:
    2,591
    Country:
    Canada
  16. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
    I can not do this correctly. This is my .xml:

    .txt= /3ds/hans/titles/Castelvania.txt
    .romfs=/hans

    I have "0006f100.romfs" and "Castelvania.romfs" but the last dont work. What is wrong? Thanks again for the help.
     
  17. Flerp
    OP

    Newcomer Flerp Member

    Joined:
    Nov 1, 2015
    Messages:
    31
    Country:
    United States
    When you say it doesn't work, what error are you having? Does it return to homebrew menu? what happens?
     
  18. Sev501

    Member Sev501 GBAtemp Regular

    Joined:
    Nov 5, 2012
    Messages:
    154
    Country:
    Philippines
    Thank you, a bit of trial and error at first but I made it work!! Thanks for the guide!
     
  19. duwen

    Member duwen Old Man Yoshi

    Joined:
    Sep 6, 2013
    Messages:
    946
    Location:
    Bullet Hell
    Country:
    United Kingdom
    Great guide! I set up a nice shortcut for Bravely Default: Uncensored a few days ago from these instructions... actually from the post over at se7ensins... was that you Flerp, or has someone else ripped off your guide?

    Any reason you're spelling Castlevania as Castelvania? Thought I'd point it out in case that's the problem...
     
    Last edited by duwen, Nov 12, 2015
    Sev501 likes this.
  20. pinguino1234

    Newcomer pinguino1234 Advanced Member

    Joined:
    Sep 22, 2015
    Messages:
    54
    Country:
    Mexico
    An old friend say the same, (I dont know it writes "Castlevania" :sad:) But whitout this error it isnt work (all the files named "Castelvania")
     

Share This Page