Tutorial  Updated

How to use NitroHax3DS (Including Managing Cheats File Size)

NitroHax3DS is a tool to apply cheat codes to NTR (NDS) games on the 3DS. This tutorial guides you on how to install, add cheats, and how to deal with the 2,500kb (2.5mb) cheats.xml file size limit. This tutorial does not show you the general usage of NitroHax, as the homebrew GUI generally takes care of that for you.

Requirements
  • A 3DS with Luma 6.1.2 or newer using boot9strap is the recommended setup for your 3DS and for any homebrew.
    If you are still on arm9loaderhax, pasta cfw, or anything alike, then try updating your hacks to boot9strap.
  • NitroHax3DS 0.99.NTR (Final ver?) CIA file, Do not use the DSi release downloads.
  • FBI 2.6.1 (Final) for installing NitroHax3DS CIA file.
  • Revolution 4 Cheat Code Editor (R4CCE) for managing the cheats.xml cheats and therefore the file size.
  • An Action Replay XML file (cheats.xml), e.g., DeadSkullzJr Repo (right click -> save link as), CodeJunkies EU, CodeJunkies US
NitroHax3DS Installation and Usage

Please follow the instructions on the NitroHax3DS readme for general Installation and Usage Instructions.

Lowering the cheats.xml file size

While NitroHax3DS has no actual cheats.xml file size limit, it should NOT exceed 2.5MB, nor should it really even get close to that size. NitroHax3DS loads the cheats.xml to RAM and the 3DS only has 4MB of RAM. This means you would potentially run out of ram, or leave too little amount of RAM available for the game or system to work sufficiently.

To be on the safe side I recommend lowering the cheats.xml file size to be less than 1.5MB in size. The lower it is, the better. You should only have cheat codes for games you want to use, and only have cheat codes you plan to actually use. White screens and crashes may be caused by the cheats.xml being too large (even if it's around 1.5MB).
  1. Open R4CCE, click `File` -> `Open` -> And open the cheats.xml file.
  2. Remove all cheats for games you do not have and/or want to use, the more you can remove the better.
  3. Once you have the cheats.xml lowered as much as you can, Put it on the root of your 3DS SD Card.
F.A.Q

Q: I get a white screen when booting from Nitro but not when I boot normally;
A: The game may be unsupported, or the cheat code may be incompatible with your specific ROM region.

Q: I'm encountering a problem that happens even if I disable all cheats, yet doesn't happen if I play without NitroHax3DS;
A: It might be a NitroHax3DS problem. If you feel strongly that it could be a NitroHax3DS bug, report it on the GitHub Issues page and not here.

Q: Do DSi Enhanced Games work? What about DSi Exclusive Games?
A: No! [source] Sadly DSi Enhanced Games are not supported! This is due to NitroHax using an incredibly outdated Cart loader code that is not compatible with TWL game cartridges. This means both DSi Enhanced and DSi Exclusive games are not supported. E.g., Pokemon SoulSilver/HeartGold (DSi Enhanced), and Face Training (DSi Exclusive).

Got a question not here? Post it below.
 
Last edited by PRAGMA,

Hadobedo

Well-Known Member
Newcomer
Joined
Dec 5, 2015
Messages
72
Trophies
0
Age
33
XP
281
Country
Canada
I made the cxi file and it's 3,072 bytes. Whenever I try to launch Nitrohax or any DS game, it brings me to a black screen. When I delete the cxi file off my sd, they work again. Any help?
 

PRAGMA

Well-Known Member
OP
Member
Joined
Dec 29, 2015
Messages
2,258
Trophies
1
Location
Ireland
Website
github.com
XP
5,038
Country
Ireland
I made the cxi file and it's 3,072 bytes. Whenever I try to launch Nitrohax or any DS game, it brings me to a black screen. When I delete the cxi file off my sd, they work again. Any help?
The cxi file is corrupt, If its 3,000 bytes/3kb then it failed to load Python - Follow this tutorial as if you never ever started making the cxi and you will be golden. (That means uninstall python and devkitpro if you have them installed)
 

Hadobedo

Well-Known Member
Newcomer
Joined
Dec 5, 2015
Messages
72
Trophies
0
Age
33
XP
281
Country
Canada
The cxi file is corrupt, If its 3,000 bytes/3kb then it failed to load Python - Follow this tutorial as if you never ever started making the cxi and you will be golden. (That means uninstall python and devkitpro if you have them installed)

Alright, i'll try reinstalling. Thanks for writing the guide!
 

Exaltys

Well-Known Member
Member
Joined
Nov 10, 2009
Messages
473
Trophies
0
Age
32
Website
Visit site
XP
746
Country
United States
Since we are just placing patched files in the luma folder on the sd card this is easily revertible by just deleting the files we added, correct?
 

Exaltys

Well-Known Member
Member
Joined
Nov 10, 2009
Messages
473
Trophies
0
Age
32
Website
Visit site
XP
746
Country
United States
There is a crucial step is missing for those few people who follow the steps to the T. After copying your dump, you need to rename the file "firmware_twl.bin".
 

Viri

Well-Known Member
Member
Joined
Sep 13, 2009
Messages
4,226
Trophies
2
XP
6,823
Country
United States
Well, I tried your guide and my file is 1.23 MB (1,291,264 bytes, I'm on the latest Luma version(holding down select says so!).

When I open the program, I get "fatinitDefault failed!"
 

PRAGMA

Well-Known Member
OP
Member
Joined
Dec 29, 2015
Messages
2,258
Trophies
1
Location
Ireland
Website
github.com
XP
5,038
Country
Ireland
Well, I tried your guide and my file is 1.23 MB (1,291,264 bytes, I'm on the latest Luma version(holding down select says so!).

When I open the program, I get "fatinitDefault failed!"
You are on the ltest "normal" luma version but not the latest "dev" luma version.
Download LumaUpdater.cia and use that to update to the latest hourly dev version.

--------------------- MERGED ---------------------------

What is this for?
This tutorial generates the .cxi for NitroHax
 

Viri

Well-Known Member
Member
Joined
Sep 13, 2009
Messages
4,226
Trophies
2
XP
6,823
Country
United States
You are on the ltest "normal" luma version but not the latest "dev" luma version.
Download LumaUpdater.cia and use that to update to the latest hourly dev version.

--------------------- MERGED ---------------------------


This tutorial generates the .cxi for NitroHax
I just downloaded the Luma updater, and updated to the latest hourly dev version, and I still get the same error.
 

Posghetti

Un-official ReVeluv Leader
Member
Joined
Mar 15, 2016
Messages
1,141
Trophies
0
Location
Michigan
XP
782
Country
United States
TA7KkiA.png
 

PRAGMA

Well-Known Member
OP
Member
Joined
Dec 29, 2015
Messages
2,258
Trophies
1
Location
Ireland
Website
github.com
XP
5,038
Country
Ireland
I just downloaded the Luma updater, and updated to the latest hourly dev version, and I still get the same error.
Please follow the Troubleshooting at the bottom of the Thread

--------------------- MERGED ---------------------------

It was never mentioned to be installed .-. I'll run the setup and see if it changes anything
Dont install CgyWin, It's not needed - The cp error is the Linux equivalent of "copy", To fix it you need to install Devkitpro.
Also uninstall Python, Then reinstall it and when your at a screen with features scroll down and click The X on the Python Path feature.
Now restart your PC (MUST)

--------------------- MERGED ---------------------------

https://github.com/PokeAcer549/twl_firm_patcher download cxis from here if you can't generate them for some reason

--------------------- MERGED ---------------------------

remember to remove o3ds_/n3ds_ from the title of the cxi if you're downloading from there
These will work but they might not work for certain systems as I do believe it tailors depending on 3DS Region.
But if you cant get it done then it will be your last shot.
 

WarioTails358

Well-Known Member
Member
Joined
Oct 2, 2015
Messages
345
Trophies
0
Age
24
XP
168
Country
United States
I'm on the latest luma3ds dev version 6.0.1-DEV
The twlBg.cxi is 1,263 kb or 1.23mb and is located in luma/sysmodules on my microsd card on my new Nintendo 3ds.
Nitrohax boots and my game cart of golden sun dark dawn is not inserted until the message to insert it appears.
I insert it and press start, the cheats show up and I check one of them and then click start game.
And my game is stuck on a white screen and does not boot.
but I know nitrohax works since it booted my copy of Mario kart ds.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • TwoSpikedHands @ TwoSpikedHands:
    Do I restart now using what i've learned on the EU version since it's a better overall experience? or do I continue with the US version since that is what ive been using, and if someone decides to play my hack, it would most likely be that version?
  • Sicklyboy @ Sicklyboy:
    @TwoSpikedHands, I'll preface this with the fact that I know nothing about the game, but, I think it depends on what your goals are. Are you trying to make a definitive version of the game? You may want to refocus your efforts on the EU version then. Or, are you trying to make a better US version? In which case, the only way to make a better US version is to keep on plugging away at that one ;)
  • Sicklyboy @ Sicklyboy:
    I'm not familiar with the technicalities of the differences between the two versions, but I'm wondering if at least some of those differences are things that you could port over to the US version in your patch without having to include copyrighted assets from the EU version
  • TwoSpikedHands @ TwoSpikedHands:
    @Sicklyboy I am wanting to fully change the game and bend it to my will lol. I would like to eventually have the ability to add more characters, enemies, even have a completely different story if i wanted. I already have the ability to change the tilemaps in the US version, so I can basically make my own map and warp to it in game - so I'm pretty far into it!
  • TwoSpikedHands @ TwoSpikedHands:
    I really would like to make a hack that I would enjoy playing, and maybe other people would too. swapping to the EU version would also mean my US friends could not legally play it
  • TwoSpikedHands @ TwoSpikedHands:
    I am definitely considering porting over some of the EU features without using the actual ROM itself, tbh that would probably be the best way to go about it... but i'm sad that the voice acting is so.... not good on the US version. May not be a way around that though
  • TwoSpikedHands @ TwoSpikedHands:
    I appreciate the insight!
  • The Real Jdbye @ The Real Jdbye:
    @TwoSpikedHands just switch, all the knowledge you learned still applies and most of the code and assets should be the same anyway
  • The Real Jdbye @ The Real Jdbye:
    and realistically they wouldn't

    be able to play it legally anyway since they need a ROM and they probably don't have the means to dump it themselves
  • The Real Jdbye @ The Real Jdbye:
    why the shit does the shitbox randomly insert newlines in my messages
  • Veho @ Veho:
    It does that when I edit a post.
  • Veho @ Veho:
    It inserts a newline in a random spot.
  • The Real Jdbye @ The Real Jdbye:
    never had that i don't think
  • Karma177 @ Karma177:
    do y'all think having an sd card that has a write speed of 700kb/s is a bad idea?
    trying to restore emunand rn but it's taking ages... (also when I finished the first time hekate decided to delete all my fucking files :wacko:)
  • The Real Jdbye @ The Real Jdbye:
    @Karma177 that sd card is 100% faulty so yes, its a bad idea
  • The Real Jdbye @ The Real Jdbye:
    even the slowest non-sdhc sd cards are a few MB/s
  • Karma177 @ Karma177:
    @The Real Jdbye it hasn't given me any error trying to write things on it so I don't really think it's faulty (pasted 40/50gb+ folders and no write errors)
  • DinohScene @ DinohScene:
    run h2testw on it
    +1
  • DinohScene @ DinohScene:
    when SD cards/microSD write speeds drop below a meg a sec, they're usually on the verge of dying
    +1
  • Psionic Roshambo @ Psionic Roshambo:
    Samsung SD format can sometimes fix them too
  • Purple_Heart @ Purple_Heart:
    yes looks like an faulty sd
  • Purple_Heart @ Purple_Heart:
    @Psionic Roshambo i may try that with my dead sd cards
    +1
  • Psionic Roshambo @ Psionic Roshambo:
    It's always worth a shot
  • TwoSpikedHands @ TwoSpikedHands:
    @The Real Jdbye, I considered that, but i'll have to wait until i can get the eu version in the mail lol
    TwoSpikedHands @ TwoSpikedHands: @The Real Jdbye, I considered that, but i'll have to wait until i can get the eu version in the...