Pokémon Supernova Sun & Penumbra Moon (for Ultra Sun & Ultra Moon)

ROM Hack for: Pokémon Ultra Sun and Pokémon Ultra Moon (Nintendo 3DS)

Pokémon Supernova Sun and Penumbra Moon are mods for Pokémon Ultra Sun and Ultra Moon. Like my Rutile Ruby & Star Sapphire hacks and my Nova Sun & Umbra Moon hacks, their main purpose is to provide a more challenging game experience while not artificially limiting the player. The premier feature of Supernova Sun and Penumbra Moon is the ground-up redesign of Pokémon Trainers in the world to increase the game’s challenge. Every trainer in the game has been edited, and the level curve expects use of the Experience Share, which means that the player levels up very quickly. Every Pokémon in Trainers’ teams has a a proper moveset and many are holding items. The Elite Four and Champion are Level 100, and the player doesn’t need to grind to equal that!

Supernova Sun and Penumbra Moon’s secondary focus is inspired by Super Smash Bros. Melee’s “20XX Hack Pack” which is designed to improve competitive players’ ability to practice and grind. In Supernova Sun and Penumbra Moon’s Legit Build, everything obtainable is 100% legal and legitimate for real online battles or trades. In all Builds, some features are designed to make preparing competitive teams much less of a hassle. Competitive hold items are much more available, a 6IV Ditto is available through an in-game trade (holding a Destiny Knot), Eggs hatch in one cycle, and Level 100 Memento Blissey battles are available in the Battle Buffet once the main story has been beaten.​

These mods are very expansive. In addition to Trainers, Supernova Sun and Penumbra Moon also feature edited:

  • Wild Pokémon availability (in three different ways!)
  • Wild Pokémon hold items
  • Item availability in Poké Marts and from special vendors
  • Evolution methods for Trade Evolutions and “Level up in a specific area/version” Evolutions
  • Level-Up movesets to handle the increased level curve and add access to TM and Tutor moves (details)
  • And much more!

Trainer Changes

  • Harsher Level Curve: The game is balanced around use of the EXP Share, which allows for explosive growth. Disabling the EXP share is not recommended.
  • All-new Trainer teams, designed from the ground up, many featuring six Pokémon!
  • All Captains, Kahunas, and other bosses have six Pokémon!
  • Every fully-evolved non-Legendary Pokémon (and Mega Evolution) will be encountered in a Trainer’s team during the main story!
  • Totems are powered up and pack new strategies!
  • Post-game Memento Blisseys added to Battle Buffet in Hau’oli City!
  • Trainers are capable of EV Training their Pokémon!
  • While grinding is always possible, the curve is such that the player will be approximately even with all enemy levels.
  • The player might become overleveled if they use the Lucky Egg, Pokémon Refresh, and/or the Trade Bonus.

Wild Pokémon Changes

There are four builds available of Supernova Sun & Penumbra Moon! They differ in Wild Pokémon availability. The Expanded Build is the most popular, since it increases the variety of Pokémon found in Alola.

Legit Build

  • All Wild Pokémon are 100% legit for trade and will not appear as “hacked” by any legitimacy testers.
  • Most nocturnal Pokémon are available in the day. The converse is true for diurnal Pokémon.
  • Rare and interesting Pokémon have been moved into more common slots. Fearow, Yungoos, and friends now occupy the rarer encounter chances. The more unique, fun Pokémon like Mimikyu and Stufful are now as common as a Yungoos or Alolan Rattata would have been.
  • This Build is recommended if you’re using the mod to facilitate competitive breeding, Shiny hunting, Pokédex filling, or other such post-game concerns.

Leveled Build

  • Wild Pokémon are the same as in the Legit Build, but are leveled up to keep pace with SnS/PuM’s harsh level curve.
  • It is recommended to use this over the Legit Build for gameplay if you don’t want to use the Expanded Build, since the Legit Build’s Wild Pokémon will be far behind the level curve.
  • Anything caught in the Leveled Build just needs a quick adjustment in PKHeX (edit its Met Level) to become 100% trade-ready.

Expanded Build

  • Wild Pokémon are altered so that every non-Legendary (Tapu/UB/Mythical Pokémon count as Legendary) species is available, at the same level as the Leveled Build. Legendary encounters are not changed in this or any Build. Click here to see where you can catch every Pokémon!
  • This Build is the recommended way to play the ROM hack.
  • The player will have access to 58% of non-Legendary evolution lines on Melemele Island alone. This access expands to 83% after Akala Island, and 98% after Ula’ula Island. Every non-Legendary evolution line is available before the Elite Four!
  • By editing anything caught in the Expanded Build to have come from an Egg (and making sure to obey Poké Ball legality), even Pokémon from this Build can be made legal, though not technically legitimate.
  • All encounter levels are increased to match Supernova Sun & Penumbra Moon’s harsh level curve.
  • This Build also features all of the rarity changes of the Legit Build.

Lite Build

  • No changes to the Wild Encounter tables of Ultra Sun and Ultra Moon were made.

Pokémon Changes

Certain tweaks have been made to Pokémon, but nothing “breaks the rules”. No illegal moves have been added to level up learnsets, no stat changes have been made, and Supernova Sun and Penumbra Moon maintain intercompatibility with Ultra Sun and Ultra Moon.

Improved Level-Up Learnsets

  • Learnsets have been adjusted to provide better access to moves, particularly in Expanded and Leveled Builds.
  • Species no longer “miss out” on moves because they were encountered at a high level, and most “Level 1” moves have been added to the standard level-up learnset.
  • TM and Tutor moves have also been added to the Level-Up learnsets. No illegal moves have been added to any species in any Build.
  • If you’re breeding Pokémon and both parents know a move that’s normally a Tutor/TM exclusive for the offspring, the offspring will get that move as an illegal Relearner move. To avoid this issue, delete the file /romfs/a/0/1/3 (this will remove all moveset changes!) if you intend to breed without a Ditto or simply check the Pokémon’s Relearn Moves in PKHeX.

Improved Wild Hold Items

  • Every species is now capable of holding at least one item in the wild.
  • Every species that has a Mega Evolution in its line is capable of holding its Mega Stone in the wild.
  • Wimpod, Alolan Meowth, and certain other species have been known to hold Bottle Caps and Gold Bottle Caps!
  • Pokémon that evolve through use of a hold item have a chance to hold that item in the wild.
  • Pokémon that need a special Incense to produce certain offspring have a chance to hold that Incense in the wild.
  • Check here for a list of all species and which Hold Items they can have in the wild.
  • The 10 Fossils available in Gen VII are now held by certain wild Pokémon 50% of the time. Some other Pokémon also have a chance to hold Fossils.
▶ Fossil Details
  • Armor Fossil: Jangmo-o, Hakamo-o, Kommo-o
  • Claw Fossil: Crabrawler, Crabominable
  • Cover Fossil: Mareanie, Toxapex, Torkoal
  • Dome Fossil: Scraggy, Scrafty
  • Helix Fossil: Poliwag, Poliwhirl, Poliwrath, Politoed
  • Jaw Fossil: Ekans, Arbok
  • Plume Fossil: Spearow, Fearow
  • Root Fossil: Bounsweet, Steenee, Tsareena
  • Sail Fossil: Basculin
  • Skull Fossil: Vullaby, Mandibuzz, Rufflet, Braviary
The remaining Fossil (Old Amber) is now held by the Oddish line, which only appears in the Expanded Build.

Universal SOS

All non-Legendary Pokémon are able to SOS call in the wild. Baby Pokémon and Pokémon with predatory SOS calls (Corsola, Carbink, Durant, etc.) have a higher SOS call rate than most species. The “normal” SOS call rate has been increased thanks to an anti-annoyance feature in Ultra Sun and Ultra Moon: Only one SOS call per fight will succeed unless the player uses an Adrenaline Orb.

Item Changes

  • A new Item, Restoration Wing, has been added to Poké Marts. It fully restores a Pokémon’s HP and status, but cannot be used during battles. This item replaces the Health Wing item, so it won’t show up as an illegal item and can freely be traded to other Gen VII games.
  • Sacred Ash has been renamed to “Revival Powder” and is available in Poké Marts! Revival Powder functions as a Max Revive for your whole party, but is unusable during battles.
  • Max Repel’s duration is increased by 50%.
  • Drink items and the Super Potion have had their Generation I-VI potency restored.
  • Revives have been nerfed to only heal 1 HP, to add strategic risk to their use in battle (Sacred Ash is unusable during battles). Beware of passive damage!
  • Roto Boost has been nerfed, and now only boosts Attack, Special Attack, and Speed.

Poké Mart Changes

  • Redundant items have been removed from Poké Marts! Items like Antidote and Paralyze Heal have been replaced with disposable competitive items like Focus Sash and Weakness Policy.
  • Item prices have been altered. Some items are more expensive than standard Ultra Sun and Ultra Moon, and many are much cheaper.
  • All Poké Balls and Repels are on sale!
  • Thrifty Megamart is now the go-to place to purchase competitive items like Leftovers and Life Orb. Don’t forget to grab a Discount Coupon at the door! The third counter sells useful breeding and training items, like Lucky Egg and Ability Capsule.
  • Route 8’s Pokémon Center sells second-tier competitive items like Flame Orb, Scope Lens, and Safety Goggles.
  • Route 2’s Pokémon Center sells the complete list of standard Poké Balls.
  • Hau’oli City’s Pokémon Center sells the complete list of Apricorn Balls, as well as Beast Balls.
  • Route 5’s Pokémon Center sells the six EV Reduction Berries, in addition to the Sitrus and Lum berries. Removing unused EVs (SpA on Machamp, etc.) is a great way to passively optimize your team!
  • Konikoni City’s Pokémon Center sells Bottle Caps, Gold Bottle Caps, and the six Power Items!
  • Mount Lanakila’s Pokémon Center sells everything you need to get your team ready to finish the game: Rare Candy, PP Max, and Heart Scale!
  • Full list of Poké Mart Changes.

Evolution Changes

  • Trade Evolutions now have alternate methods. You can still evolve them through their normal trade methods.
  • Pikachu, Exeggcute, and Cubone have alternate methods to evolve into their Kanto forms. You can still obtain Kantonian Raichu, Exeggutor, and Marowak by evolving them in the Ultra Wormhole.
  • Pokémon that evolve in specific areas now have alternate methods. You can still evolve them through their normal level-up locations.
  • Eevee can no longer evolve with its normal methods for Gen II+ Eeveelutions. It now uses a Stone to evolve into all of its options. Please note that Sylveon will be detected as illegitimate if it has less than two Affection and has never been traded.
  • Version-based Evolutions can now Evolve using the Sun or Moon Stone.
▶ Altered Evolution Methods
  • Boldore Evolves into Gigalith: Level up to 42
  • Charjabug Evolves into Vikavolt: Thunder Stone**
  • Clamperl Evolves into Gorebyss: Dawn Stone or level up while holding a Deep Sea Scale**
  • Clamperl Evolves into Huntail: Dusk Stone or level up while holding a Deep Sea Tooth**
  • Cosmoem Evolves into Solgaleo: Sun Stone*
  • Cosmoem Evolves into Lunala: Moon Stone*
  • Crabrawler Evolves into Crabominable: Ice Stone**
  • Cubone Evolves into Marowak (Kanto Form): Level up to 42 with a Dark-type in the party
  • Dusclops Evolves into Dusknoir: Level up while holding a Reaper Cloth at night or knowing the move Pursuit
  • Eevee Evolves into Espeon: Sun Stone✝**
  • Eevee Evolves into Glaceon: Ice Stone✝**
  • Eevee Evolves into Leafeon: Leaf Stone✝**
  • Eevee Evolves into Sylveon: Shiny Stone✝**
  • Eevee Evolves into Umbreon: Moon Stone✝**
  • Electabuzz Evolves into Electivire: Level up to 65 or while holding an Electirizer
  • Exeggcute Evolves into Exeggutor (Kanto Form): Level up while holding a Leaf Stone
  • Feebas Evolves into Milotic: Level up while knowing the move Attract or while holding a Prism Scale
  • Graveler Evolves into Golem: Level up to 75 or while holding a Hard Stone
  • Graveler (Alolan Form) Evolves into Golem (Alolan Form): Level up to 75 or while holding a Hard Stone
  • Gurdurr Evolves into Conkeldurr: Level up to 55 or while knowing the move Focus Punch
  • Haunter Evolves into Gengar: Level up to 40 with high Friendship at night or level up while holding an Iron Ball
  • Kadabra Evolves into Alakazam: Level up to 42 or while holding a Twisted Spoon
  • Karrablast Evolves into Escavalier: Level up to 62 or while holding a Shed Shell, or level up with Shelmet in the party
  • Machoke Evolves into Machamp: Level up to 42 or while holding a Black Belt
  • Magmar Evolves into Magmortar: Level up to 55 or while holding a Magmarizer
  • Magneton Evolves into Magnezone: Level up knowing Magnet Rise or use a Thunder Stone**
  • Nosepass Evolves into Probopass: Level up knowing Discharge or while holding a Magnet
  • Onix Evolves into Steelix: Level up to 55 or while holding a Metal Coat
  • Phantump Evolves into Trevenant: Level up to 58 or while knowing the move Forest’s Curse
  • Pikachu Evolves into Raichu (Kanto Form): Level up while holding a Thunder Stone
  • Poliwhirl Evolves into Politoed: Level up to 60 or while holding a King’s Rock
  • Porygon Evolves into Porygon2: Level up to 60 or while holding an Up-Grade
  • Porygon2 Evolves into Porygon-Z: Level up while holding a Dubious Disc or knowing the move Hyper Beam
  • Pumpkaboo Evolves into Gourgeist: Level up to 58 or while knowing the move Trick-or-Treat
  • Rhydon Evolves into Rhyperior: Level up to 52 or while holding a Protector
  • Rockruff Evolves into Lycanroc (Midday Form): Sun Stone*
  • Rockruff Evolves into Lycanroc (Midnight Form): Moon Stone*
  • Rockruff (with Own Tempo) Evolves into Lycanroc (Dusk Form): Dusk Stone*
  • Scyther Evolves into Scizor: Level up to 70 or while holding a Metal Coat
  • Seadra Evolves into Kingdra: Level up to 72 or while holding a Dragon Scale
  • Shelmet Evolves into Accelgor: Level up to 62 or while holding a Focus Sash, or level up with Karrablast in the party
  • Slowpoke Evolves into Slowking: Use a Shiny Stone or level up or while holding a King’s Rock
  • Spritzee Evolves into Aromatisse: Level up while holding a Sachet or knowing the move Aromatherapy
  • Swirlix Evolves into Slurpuff: Level up while holding a Whipped Dream or knowing the move Aromatherapy

* This Pokémon will be illegal until it reaches its normal Evolution level, at which point it will be 100% legit again.
** This Pokémon will be illegal if it hasn’t been leveled up at all before using the Stone; leveling it up will make it 100% legit again.
✝ This Pokémon can no longer evolve through its default method.

Miscellaneous Features

  • Custom Title Screens!
  • Eggs now hatch incredibly quickly. Every species now has a 1-cycle hatch rate. Note this doesn’t apply to Event eggs or Traded eggs.
  • Switch Mode no longer reveals the incoming Pokémon.
  • An in-game trade for a 6IV Ditto (holding a Destiny Knot) now exists!
  • New, improved Pickup tables!
  • Custom Banners for *.cia/.3ds installs!


  • If you haven’t done so already, please purchase Pokémon Ultra Sun or Ultra Moon! If you enjoy them (or this mod), Game Freak deserves your money.
  • The GARC file that contains Ultra Sun and Ultra Moon’s Encounter Data is 460MB. Unfortunately, that means that distribution packs for this mod (aside from Lite Builds) are quite large (140MB thanks to .7z compression) and will take quite a while to download.
  • If you’re using the Drag & Drop install method or running this with HANS, it will use your regular Sun/Moon save file. To back up your original save file on a CFW setup, use Checkpoint.
  • You cannot install a CIA of Supernova Sun alongside a CIA/eShop copy of Ultra Sun. The same restriction applies for Penumbra Moon and Ultra Moon.
  • This mod is capable of multiplayer. With the Drag & Drop install method, it’s capable of online multiplayer. It’s best to avoid using Game Sync while using any Ultra Sun / Ultra Moon mods.
  • Since this mod makes no changes to save file structure, it works perfectly fine with Pokémon Bank.
  • Only important text like the name and description of the Sacred Ash Revival Powder and Health Wing Restoration Wing have been edited in non-English languages. Only languages with Latin script have been edited at all.
  • Any Ultra Sun / Ultra Moon code.bin patches for the latest version of Ultra Sun / Ultra Moon will work with the Drag & Drop versions of the mod. If you want to use extra code.bin patches on the *.3ds or *.cia versions of the mod, make sure you’re using patches designed for Ultra Sun / Ultra Moon v1.0. Do not apply a SaltySD patch to the Drag & Drop package of this mod, it will cause the mod’s files to not be loaded. To add additional mods to Supernova Sun & Penumbra Moon, place them in the appropriate folder within SD:\luma\titles.
  • This is NOT designed for Nuzlocke play. I don’t believe a Nuzlocke of this game will be possible, let alone an enjoyable game experience. To have any chance at success in a Nuzlocke, you’ll have to overlevel, spam Potions, probably use Refresh, and generally play in the most boring and safe way possible.


  • I still cannot add Triple, Rotation, and Horde Battles to the world. I also cannot turn Single Battle trainers into Double Battle ones.
  • Enemy Trainers cannot use unique Z-Moves like Extreme Evoboost or Malicious Moonsault.
  • Certain battles won’t force you to black out if you lose, instead progressing the story the same as if you won. I can’t change this function.
  • Ultra Sun and Ultra Moon’s event scripts cannot currently be modified. This means that I cannot make cutscenes shorter or skippable.
  • The ability to use Mega Evolution is independent of the “Key Stone” item and is only set by triggering a flag in the save file after the battle with Dexio on Poni Island. This means that Mega Evolution is not accessible throughout gameplay unless save editing tools are used.

Installation Instructions

Drag & Drop Installation (Recommended!)

Requirements: 3DS Family System with Luma3DS installed, Pokémon Ultra Sun or Ultra Moon (Cartridge, eShop, or CIA install)

  • You need a 3DS running Luma3DS CFW. All 3DS models can install CFW using this guide.
  • Update Pokémon Ultra Sun or Ultra Moon to the latest version if you haven’t already done so.
  • Hold SELECT when booting Luma3DS (this is when you turn on the 3DS if you’re using B9S or A9LH)
  • Enable the option “Enable Game Patching” and press START to save. This is a persistent option, you don’t have to do it every time you want to play Nova Sun or Umbra Moon.
  • Download and unzip the 7z folder for the Version and Build you want to play.
  • If your preferred language isn’t English, run the NonEnglish.bat file.
  • Copy and paste the luma folder to the root of your 3DS’s SD card, merging/overwriting if prompted.
  • Boot up your cartridge or eShop copy of Pokémon Sun or Moon and the romhack’s modifications should be present!
  • Back up your game save with JKSM, start a fresh save file, and enjoy the ROM hack!

Drag and Drop Installation (on Citra)

Requirements: functioning Citra Emulator install with Pokémon Ultra Sun or Ultra Moon v1.2 installed on the emulator)

  • If you need to back up your existing eShop install of the game, use threeSD to do so.
  • Right click Pokémon Ultra Sun or Ultra Moon in the game picker menu. Select “open mods location”.
  • Go up one folder, so that you are in the \Citra\load\mods\ folder.
  • Download and unzip the 7z folder for the Version and Build you want to play.
  • Copy the contents of the \luma\titles\ folder from the ROMhack download (the folder with the long number) into the \citra\load\mods folder.
  • Start Pokémon Ultra Sun or Ultra Moon and it will start as Supernova Sun or Penumbra Moon!

Building a Custom CIA or *.3DS File

Requirements: 3DS Family System with Luma3DS installed, Godmode9 and FBI installed, Pokémon Ultra Sun or Ultra Moon (Cartridge, eShop, or CIA install)

  • You need a 3DS running Luma3DS CFW. All 3DS models can install CFW using this guide.
  • Installed Pokémon Ultra Sun / Ultra Moon updates will cause conflicts with the Supernova Sun or Penumbra Moon mod when installed as a CIA or 3DS file. Uninstall any Ultra Sun / Ultra Moon updates before using a CIA or .3DS build of Supernova Sun or Penumbra Moon.
▶ Building Custom CIA/3DS File Instructions
  • Download and unzip the 7z folder for the Version and Build you want to play. Make sure you unzip all of the files, it won’t work if you try to follow these instructions from inside the 7z file.
  • Follow these instructions to dump and decrypt your cartridge or installed copy of Pokémon Sun or Moon using Godmode9.
  • Place your decrypted ROM in Extra_Files. It should be named rom.cia or rom.3ds (depending on file type). It should look like this.
  • Run All_In_One.bat. A folder named “Extracted_ROM” should appear in Extra_Files. If this folder does not have files in it after you finish the All_In_One batch, run Extract_ROM.bat, Patch_ROM.bat, and Rebuild_3DS.bat or Rebuild_CIA.bat in order instead. The All_In_One batch file will prompt you to randomize the game if you want to. Randomization with the three seperate batch files should be done in between Patch_ROM and Rebuild_3DS/CIA.
  • If you rebuilt as CIA, copy the new Modified_ROM.cia file to your SD card and install it with FBI. Back up your game save with Checkpoint first; installing the ROM hack CIA will overwrite your save!
  • If you rebuilt as *.3ds for Gateway, your ROM needs to be re-encrypted. Copy the resulting Modified_ROM.3ds file to your 3DS SD Card and use Godmode9 to encrypt it. After re-encrypting your *.3ds file, copy it to your Gateway MicroSD. Sky3DS cannot run ROM hacks because it can only run officially signed code.
  • Enjoy the ROM hack!

Special Thanks

  • Kaphotics: for creating the stellar PK3DS.
  • SciresM: For making everything possible and coding the tools that form the base of PK3DS.
  • evandixon: For 3DSDotNetToolkit.
  • smealum: For HANS, making piracy and specialized hardware unnecessary to run ROMhacks.
  • Aurora Wright: For Luma3DS, especially Luma3DS 7.0+ LayeredFS. This is the ultimate form of “simple installation with no piracy required”!
  • neobrain: For Braindump.
  • dnasdw: For 3dstool.
  • JK: For JKSM.
  • Bernardo Giordano: For Checkpoint.
  • My dedicated beta testers: WolfLord, Skeletonluvr, and JareDave. Without their help, this mod would be much more broken and much less fun.
  • Nintendo/GAME FREAK: For making a game series I’ve been devoted to for my entire life.

Change Log

Current Version: v1.0.5 (3/22/2018)

  • Fixed a minor moveset issue
▶ Version 1.0.4 (2/7/18)
  • Rebuilt Shop.cro to function with Ultra Sun / Ultra Moon v1.2. Drag and Drop installations now require Ultra Sun / Ultra Moon v1.2.
  • Minor Trainer tweaks
  • Minor text fixes
▶ Version 1.0.3 (2/7/18)
  • Fixed Lana’s battles (Konikoni City rematch was swapped with Mina’s Trial rematch)
  • Minor text fixes
▶ Version 1.0.2 (12/27/17)
  • Properly implemented altered Game Text for non-English languages.
▶ Version 1.0.1 (12/27/17)
  • Tweaked EV Spreads and Natures for Totems thanks to a new feature of PK3DS.
▶ Version 1.0.0 (12/26/17)

Download Link

Download the ROM hack here!

.7z files can be extracted with 7-Zip.

Pokémon, Pokémon Omega Ruby, Pokémon Alpha Sapphire, Pokémon Sun, Pokémon Moon, Pokémon Ultra Sun, Pokémon Ultra Moon, Pokémon Let’s Go, Eevee!, Pokémon Let’s Go, Pikachu!, the Pokémon logo, and all other related content are intellectual property of GAME FREAK, Creatures Inc, The Pokémon Company, and Nintendo. 
This project is a free modification that requires an existing copy of an official Pokémon game to function. It does not require, endorse, or encourage piracy of Nintendo or GAME FREAK content. If you want to play this mod, please purchase the official release.

Troubleshooting & FAQ

“HELP! The game freezes when I talk to a shopkeeper!”

  • This happens when you have a version mismatch on the Shop.cro file.
  • If you’re using a Drag & Drop install of the game, make sure Ultra Sun or Ultra Moon are updated to the latest version. If you’re getting shop freezes while Ultra Sun or Ultra Moon are updated to the latest version, update the ROM hack by redownloading the installation package.
  • If you’re using a *.3ds or *.cia install, make sure Ultra Sun or Ultra Moon are not updated at all. Uninstall updates from “Data Management” on the 3DS.
  • If you’re using a HANS install, you copied the shop.cro file into the ROMFS folder. Re-download the hack and start over from the beginning, including re-dumping your game with Braindump and make sure you do not copy the shop.cro folder from the download pack.

“I want to randomize the game and still use the Drag & Drop install method!”

  • PK3DS currently requires a complete ROM file system to be present to function. This means you need to follow these instructions to play a randomized game through Drag & Drop.
  • Download the Expanded Build of Supernova Sun or Penumbra Moon and copy the luma folder to your SD card. Follow all instructions included with the Drag & Drop.
  • Follow the included instructions for building a CIA/3DS file. When you reach the part where you can randomize your wild encounters, say Yes and use PK3DS to randomize them.
  • Once you’ve randomized your Wild Encounters, copy /Extracted_ROM/romfs/a/0/8/2 and /Extracted_ROM/romfs/a/0/8/3 to the /luma/titles/16DIGITTITLEID/romfs/a/0/8 folder on your SD card. If there is no “8” folder inside romfs/a/0, create one. For reference, the Title IDs for Ultra Sun and Ultra Moon are 00040000001B5000 and 00040000001B5100 respectively.
  • Booting Ultra Sun or Ultra Moon should load Supernova Sun or Penumbra Moon with randomized wild encounters.
  • You can now delete your dumped ROM and your Extracted_ROM folder.

“HELP! I want to use a cheat menu or NTR plugin, but (insert tool here) breaks with this mod!”

  • It’s not up to me to fix these sorts of tools.
  • The reason these tools will sometimes break with Supernova Sun / Penumbra Moon is that they aren’t capable of handling Luma3DS’s LayeredFS implementation.
  • If you want to complain to someone about incompatibility, complain to the developers of the cheat menu or plugin that their tool doesn’t support Luma3DS LayeredFS.
  • If you get random crashing during the ROM hack, do what you did again without any code.bin/code.ips/NTR hacks before you come here to report a “bug”.

“HELP! I get a black screen or crash dump error when I click Ultra Sun / Ultra Moon when using the Drag & Drop install method!”

  • Make sure you have properly removed any SaltySD-based hacks from your 3DS SD card as detailed at the top of this section.
  • Try deleting the files from SD:/luma/titles and re-copying them over to the SD. Plug your SD into your computer instead of using FTP or MicroSD Management for best results.
  • Update your Luma3DS install to the latest stable version and make sure “Enable Game Patching” is enabled. It’s possible Luma3DS’s “hourly” builds could break something important for the LayeredFS feature.
  • Make sure your 3DS firmware is on version 11.3 or greater (this is a requirement to run Pokémon Ultra Sun & Ultra Moon).
  • Make sure you have the latest Ultra Sun / Ultra Moon update installed.
  • Remove any code.bin or code.ips patches from your Sun/Moon Title ID folder, then try again. A code patch for v1.0 of Ultra Sun or Ultra Moon can cause a freeze on startup or a crash dump, depending on which Luma version you’re using. Make sure any code.bin patches you’re using alongside Supernova Sun / Penumbra Moon are for the latest version of Sun or Moon.
  • As a last resort, it seems some CFW installations are having trouble with Ultra SM themselves. This user recommends formatting the system, which worked for him… I’d recommend running a System Update and making sure to also update and clear the configurations for Luma3DS before doing the system format.

“HELP! When using the Drag & Drop pack, the game boots as normal Ultra Sun / Ultra Moon!”

  • Make sure the option “enable game patching” is enabled in your Luma3DS configuration.
  • Make sure you copied the luma folder from the ROM hack’s install folder directly to the root of your 3DS SD card.
  • If you’re using the Title Screen to tell the difference and you are playing in a language other than English, run the NonEnglish.bat file included in the Drag & Drop pack before you copy the files to the SD.
  • Make sure you don’t have a code.bin in Ultra Sun or Ultra Moon’s Title ID folder.
  • Make sure you’re using the latest stable version of Luma3DS CFW. If you’re on arm9loaderhax, follow this guide to update to boot9strap so you can use the latest Luma3DS version. The process is very quick (less than five minutes) and mostly consists of downloading and placing files on the SD card.
  • If you want to remain on arm9loaderhax for whatever reason, update your Luma3DS to version 7.0.5, which is the last stable version that supports a9lh.

“HELP! I am having trouble building a CIA/*.3DS of this!”

  • Always dump your own ROM instead of downloading it from some piracy site. This isn’t just for moral reasons: many pirate dumps of games are trimmed, compressed, or simply not decrypted and therefore will not extract correctly.
  • Make sure your rom is in the correct place. It should be in the folder you downloaded with the ROM hack, in “Extra_Files”, like this.
  • Make sure your rom is named “rom.cia” or “rom.3ds” before you run the All_In_One.bat or Extract_ROM.bat file.
  • You can’t build a 3DS file if your dump was from a CIA. You can build a CIA if your dump was from a 3DS file.
  • Both the extraction and rebuilding process will throw error messages at you during the process. Keep going until the process finishes.
  • You need 6GB of open storage space on your main system drive to use 3DS Toolkit. You also need 3GB of available RAM to dump and rebuild the game.
  • As a last resort, extract the ROM hack to the root of a hard drive and make sure you run the batch files as an administrator.
  • If all else fails, just use the Drag and Drop method. Any 3DS capable of installing CIAs is also capable of updating to the latest version of Luma3DS.


  • This ROM hack does not add Legendary Pokémon to the wild. This is a design choice made for the following reasons:
  • 3DS ROM hackers currently (and for the foreseeable future) can’t alter the game script to add events, so adding Legendary Pokémon would just be sticking them in random grass patches as low-percentage encounters. That’s ugly, feels hacky, and removes the reason Legendary Pokémon are cool in the first place.
  • Supernova Sun and Penumbra Moon are not balanced around the player using 650+ BST monstrosities. If I added Legendary Pokémon to the grass, they’d turn the supposedly challenging game into a cakewalk. If I balanced the game around Legendary Pokémon, you’d basically be required to either use them or grind and overlevel your team. More power to you if you want to go Ultra Wormhole hunting super-late in the game.
  • Hacked Legendary Pokémon cannot be converted to legitimate Pokémon by altering their data to make them “hatched from an egg”. This means using Legendary Pokémon as a post-game reward is absolutely and completely pointless.
  • Ultra Sun and Ultra Moon don’t have a National Dex, and any legendaries with illegitimate encounter history won’t transfer to the Pokémon Bank.
  • And finally: I personally believe the game is more fun without them, and I want to present the most fun (in my opinion) way to play Pokémon in my ROM hacks.