Homebrew ModMoon - a beautiful, simple, and compact mods manager for the Nintendo 3DS.

Swiftloke

Hwaaaa!
OP
Member
Joined
Jan 26, 2015
Messages
1,770
Trophies
1
Location
Nowhere
XP
1,467
Country
United States
banner.png


...I must be crazy; especially given that this was originally just a recreation of Smash Selector.

Latest Release: Version 3.0.1.

So, what exactly is ModMoon?

This software is a LayeredFS/SaltySD manager for the 3DS. It supports every title in existence, even homebrew! It also includes many awesome easter eggs and features for the user to discover, but core functionality is its main goal. Switching mods is painless, and the user-interface is beautifully simple.
What makes ModMoon especially unique is its UI, built off of the sDraw rendering engine- an original, immensely flexible graphics core created for ModMoon. This is much, much more impressive than it sounds. For end users, the result will be a UI experience superior and better looking (in my humble opinion :) ) to nearly all homebrew on the 3DS. sDraw is the reason ModMoon started development - I wanted Smash Selector to have an excellent UI, instead of boring and confusing console text.

Functionality
ModMoon has a ton of stuff packed in to it. Here's a quick overview of what everything does throughout the various menus.

Main Menu:
Launch:
Applies and launches mods for the selected game.
Tools: Opens up the tools menu, which provides access to more functionality.
Selector Bar: Changes the currently selected mod for the current game.

Tools Menu:
Active Title Selection:
This menu allows you to change the titles currently "active" (which titles are available in the title selection menu). This is to minimize clutter by only displaying the titles the user actually uses.
Smash Controls Modifier: This code is taken straight out of Smash Selector 2.4 with no changes. It allows you, like Smash Selector, to modify the controls of the game with much greater customization than the game itself allows- including mapping two buttons to the same action, changing the controls of the D-Pad, and even changing the actions of the New 3DS buttons/C-Stick!
Tutorial: This replays the tutorial that was shown at the first start of ModMoon.
Migrate Mods: This allows you to migrate mods that were used in Smash Selector. This action is done automatically at first start.
Dark/Light Mode: This option allows you to change between two "themes"- dark mode and light mode! To you dark theme master racers out there, this one is for you.

Major Features:
Error Checking:
ModMoon supports checking, displaying, and sometimes even automatically fixing errors when moving mods around. This is a significant source of information for users and helpers, as earlier mod tools were very opaque about what went wrong (and even if something went wrong at all), thus breaking quite a bit. Anyone who has ever used Smash mods knows this aggravation- this feature alone makes Smash Selector obsolete.
Help Pop-up: At any time, you can press X while hovering over a button or in a menu to get some helpful information about that feature- what it is, how to use it, and helpful tips!
Title Selection Menu: Press Y to open this from any menu. Allows you to select the current game from your list of active titles.
Built-in SaltySD files: For Smash players, ModMoon contains a set of built in IPS files for SaltySD, just like its predecessor Smash Selector. These files will be copied when you select Smash from the Active Title Selection menu. (If Smash on an SD card is automatically selected for you, these files will also be copied automatically. If you have Smash on a cartridge, just tap it like you would any other title to trigger the copy.)
Background title loader: All titles, both active and non-active, installed on the system will be loaded immediately in the background, with no lag to the rest of the system.
Auto-updater (ModMoon): If you're connected to the internet, ModMoon will check for updates for itself. This system runs in the background, which means you'll experience no lag while it does its thing. If an update is available, it will prompt you to update (and give you an opportunity to skip it) and install the update.
Auto-updater (SaltySD): This is a big one for Smash players. Smash Selector, like ModMoon had built in SaltySD IPS files. However, those files were very old, and there was never a system in place to update them. This is, of course, solved with ModMoon. Alongside updating itself, it will check for updates to the aforementioned SaltySD files used to run Smash mods, and download them seamlessly without rebooting.
Not a fan of auto-updaters? Understandable. Just open the config file (/3ds/ModMoon/settings.txt) and set "ShouldDisableUpdater" to "True", but keep in mind that you'll miss out on any improvements I ever make until you either update manually or re-enable the updater. I highly recommend against this, but the choice is there.
Flexible Cartridge System: This system automatically detects if you've inserted/ejected a cartridge, and reacts based on that, just like the HOME menu. Unfortunately, there seems to be a bug with either the 3DS homebrew development system (libctru) or Luma3DS which makes this code, when enabled, take upwards of 30 seconds to exit ModMoon. It is disabled by default, and you can try it out by, in the config system, setting "EnableFlexibleCartridgeSystem" to "True". When a solution is found, I will release an update with the fix and enable this for all users.
Configurable Highlighter Colors: ModMoon, as a modding tool, has some customization tools for itself as well. Alongside the Dark Mode functionality, a user can change the highlighter colors used in each of the menus! Open the config file (/3ds/ModMoon/settings.txt), and inside the "*HighlighterColors" option (where * is the menu you want to change) write the red, blue and green values (in 0-255 format) with commas separating them. Google has a nice tool to do this for you (use the rgb(*, *, *) output).
Custom SaltySD: For Smash mod creators, this one is pretty nice. It allows you to provide a custom code.ips file within the /codes folder of your modpack, and it will automatically be moved to the correct location. LayeredFS games need not worry about this since the file structure will allow you to do this anyway.

Usage
Usage of ModMoon is pretty easy. Here's how everything works:

ModMoon works with mods that it finds in your "ModsFolder" config setting (by default, it's /3ds/ModMoon, but you can change it to whatever you'd like by opening the file (/3ds/ModMoon/settings.txt) and changing the setting). It then looks into the folder of the title ID of the game you want to load mods for (created automatically when you select a title from the Active Title Selection menu) and reads mods from the "Slot_X" folder, where X is a number starting at 1. Here's a quick visual example:
The following is an example for Smash 3DS (00040000000EDF00) and Pokemon Sun (0004000000164800).
Code:
G:\3ds\ModMoon
|
|
+---00040000000EDF00
|    \---Slot_1
|    |   |   desc.txt
|    |   |
|    |   \---animcmd
|    |       \---fighter
|    |           \---captain
|    |                \--game.bin
|    |
|    \---Slot_2
|    |    \--desc.txt
|    |
|    \---Slot_3
|    |    \--desc.txt
|    |
|    \---Slot_4
|    |    \--desc.txt
|    |
|    \---Slot_5
|    |    \--desc.txt
|    |
|    \---Slot_6
|    |    \--desc.txt
|    |
|    \---Slot_7
|         \--desc.txt
|
+---0004000000164800
|    \---Slot_1
|    |    |    desc.txt
|    |    |
|    |    \---romfs
|    |        \--Shop.cro
|    |    \---a
|    |        \---0
|    |            \---1
|    |                \--3

When you first start up ModMoon, it will migrate your mods from Smash Selector, check for updates, then play a quick tutorial. It will show you how to set your active titles in the Active Title Selection menu, then how to select which game to run mods for. Because the Active Title Selection menu makes the folders for the games you select, I'd recommend going through this tutorial before adding your mods.

On a regular use, you'll select the game you want to use, then change what mod you want to run by scrolling through the list, tapping on the selector bar (or moving the Circle Pad left and right with the selector bar highlighted). To disable mods, simply select "Disabled" from the mods list. You'll then press the Launch button, and ModMoon will fade into the game!

Note that you must exit ModMoon by either pressing Start or launching a game. Shutting down the 3DS, or closing ModMoon by pressing "close" in the Home Menu, will, on top of hanging the system, not give it the chance to save configuration information for itself and the mods it handles. On top of the aforementioned hang, you will receive several error messages the next time ModMoon starts due to this failure to save.

As for using the many tools available, check the help popup for each option for instructions.

Errors
As previously mentioned, ModMoon has quite a bit of built in error checking. Here are some of the things it will warn the user about, and how you should solve them:

Warning: Failed to find mods for this game! ModMoon couldn't find any mod slots for the game you just selected. You should make some!

Failed to enable/disable mods! This may resolve itself through normal usage. Try the inverse of the action you just performed (as in, if you just enabled mods and that error message occurred, try disabling them; if you tried to disable mods, try enabling them) and this error message will probably disappear. You can then move on with your modding experience :)

Congrats! You have gained 30 extra lives! Hmmmm... Where does this appear, and what does it indicate? ( ͡° ͜ʖ ͡° )

Failed to move slot file from X to X! Error code: What could be going wrong here depends on the error code. See below.

In the Smash Controls Modifier: The currently selected title is not Smash. Please select Smash and try again. ModMoon will not attempt to modify the save data of a game other than Smash- this would probably cause save corruption. Set Smash as your active title and try to open it again.

Custom SaltySD code.ips move failed! (original move) Error Code: ModMoon failed to move the normal SaltySD file out of, or in to, the /luma/titles folder.

Custom SaltySD code.ips move failed! (custom move) Error Code: ModMoon failed to move the custom code.ips file from or to the mod slot it originated from.

I have come across two prominent error codes in development:
Error Code 2: "No such file or directory". ModMoon itself indicates that this is probably the result of you not properly closing it out. ModMoon requires that you close it either by pressing Start to exit or launching a game- otherwise, it will not be able to properly save mod configurations.
Error Code C82044BE: "Destination already exists". ModMoon will attempt to handle this error automatically, but will not attempt to destroy any files. This error code means that ModMoon cannot move a folder somewhere because that folder already exists. Check the destination folder it provided you, and if necessary manually move it back to where it should be (this error may occur if you broke its record-keeping by, say, shutting it off improperly (see "Usage") and ModMoon won't fix it automatically if the attempt will destroy files in the process. It's like asking a robot to move records around file cabinets, except you already had them do it but you wiped their memory, and now they can't try doing that same movement again without intervention from someone who can analyze the situation.) If this error occurred while disabling Smash mods, check the luma/titles/ folder. There will be a Disabled(smash title ID) folder and a (smash title ID) folder. Remove one or the other to resolve the situation.

Development Time
Smash Selector 2.4 is just over a year old at the time of writing. Why did it take so long to make its successor?
Soon-ish (within the next few weeks) I intend on making a full article about what goes into homebrew development, and why that caused ModMoon to release rather late. Check back soon, I'll post a link to it when it's done.

Credits
ModMoon was my first from-the-ground-up, full-scale, completely polished program. Along the course of its development there are many, many people I want to thank for making development of this program possible.

The USM-eM Team, composed of @LinkSoraZelda, @Dannyo15, @DewTek, @Yudowat, Gryz, Karma, and M-1: Fostering the scene in which I developed ModMoon. Encouraging me to work on Smash-Selector, which is what taught me to program, and many more small pieces of encouragement that have made a significant impact.
@Yudowat, @LinkSoraZelda and @xGhostBoyx for the amazing design of the UI!
@Cydget, for originally developing Smash Selector and allowing me to work on it with him. Also for nerd-sniping me late in development into making several interesting graphics effects (namely, the animated banner and launch button).
@realWinterMute and fincs, for giving me early access to the new versions of citro3d and early access to citro2d, and for a very particular event.
You, for reading the credits! As a reward, here's a hint- try entering the Konami Code in ModMoon.
fincs, for a TON of things. Inspiring me to learn graphics programming, without which ModMoon in its present maturity would have been impossible. Making citro3d, without which ModMoon would also have been impossible. Countless hours of help with citro3d, without which ModMoon would have been (guess what!) impossible. Helping me track down many different bugs within ModMoon's codebase. Just being awesome. Props to this guy.
@smealum, @realWinterMute, mtheall, fincs, yellows8, Lectem, and every other contributor to libctru, for building such an awesome library for 3DS development.
@Aurora Wright and @TuxSH for making Luma3DS, and more importantly LayeredFS and code.ips loading.
@shinyquagsire23, for developing SaltySD.
@LinkSoraZelda and Cloud Road Music for the banner music (taken from USM-eM)
M-1 for shooting me the code.bin files to build SaltySD with at the last minute.
@ih8ih8sn02 for the reverse engineering work that made the Smash Controls Modifier possible.
The USM-eM beta testers, specifically, @NoThisIsStupider, Solid, and Lil-G.
mtheall, for his incredible work in two areas. The first: resolving a ridiculous crash that left ModMoon in an unreleaseable state for weeks on end. This guy put several days of his own time in to use his significant expertise to solve my mistake. The release of 3.0 would have been delayed indefinitely without him. The second: Creating Tex3DS (a fancy graphics tool for building textures), and helping me migrate ModMoon's codebase to use it instead of a nasty hack.

Builds and Source
The latest release can be found here: https://github.com/Swiftloke/ModMoon/releases
The source code can be found here: https://github.com/Swiftloke/ModMoon
Did I forget something in this release writeup? Got an idea for a new feature for me to add? Don't hesitate to reply and mention it or contact me on Discord at Swiftloke#3647. (I will not respond to DMs on GBATemp.)

I hope you enjoy this thing. All the effort that's gone in to it pays off, I hope :)
 
Last edited by Swiftloke,

seren3

Well-Known Member
Member
Joined
Jul 16, 2018
Messages
112
Trophies
0
XP
307
Country
United States
Much thanks for everyone involved!

If you're looking for things to add to ModMoon, may I suggest importing modpacks from 3dsmods.fm1337.com? It would be very cozy to be able to download modpacks from a repository.
 
Last edited by seren3,
  • Like
Reactions: BOGY
Joined
Jan 1, 2018
Messages
7,292
Trophies
2
XP
5,939
Country
United States
My god, this is one of the most polished looking GUI I've seen in a homebrew app. @Swiftloke, this project must have bled you dry and made you cry until no more tears could be shed. No words to describe this other than total awe.


You can launch withouth actually setting any game, making the 3ds crash. (That, or i have a really weird title with everything 0 as title id)

Edit - As of ModMoon v3.0.1, the issue has been fixed. See post #13 below.

Lol. I had this happen to me. I used ModMoon on Super Smash Bros (USA) without having any mods. ARM11 crashes right after character and stage selection.

To fix this, go into the luma/titles folder and delete the 00040000######## subfolder corresponding to your game. In my csae, SSB (USA) was 00040000000edf00. There was a small sized dummy
Code:
[I]*.ips[/I] file within that folder.

Edit - * Crash will happen if [B](x) Enable game patching[/B] is selected in [B]Luma3DS v9.1 configuration[/B], and there's a bad patch in place at [B]luma/titles/00040000########.[/B]

[IMG]https://image.ibb.co/b0RdS9/luma_config.png[/IMG]
[/SPOILER]
 
Last edited by TurdPooCharger,
D

Deleted User

Guest
Nice! I'll be testing it out some Smash mods later on.

Could you add some screenshot of the app, though? I'm sure people just stumbling upon this will want to get an idea of how this app looks and feels like.
 

Swiftloke

Hwaaaa!
OP
Member
Joined
Jan 26, 2015
Messages
1,770
Trophies
1
Location
Nowhere
XP
1,467
Country
United States
This message is no longer relevant with the release of 3.0.1. It is enclosed for historical purposes.
Hey all, a quick update on the apparently broken Smash SaltySD .ips files: (Especially @TurdPooCharger)
You're affected IF and only if you ever saw a "New SaltySD file written" notice during first start. Otherwise, don't worry about this.
They are broken. The latest commit for SaltySD is broken, which is what they were compiled from. I didn't catch this because I had never entered a match while testing (I was more interested in playing with ModMoon ;) ). Fortunately, I was able to get my hands on working SaltySD files rather easily. I uploaded them to GitHub Pages, however, for some reason, ModMoon will not connect to it (the SaltySD updater works fine with a local testing server). Therefore, for the immediate time being, I will leave a link to the updated files. Please download them manually while I sort this out. They can be found here: https://github.com/Swiftloke/ModMoon/tree/gh-pages/
You can see that there's a SaltySD(Title ID).ips file for each region. Please place the one corresponding to the Smash version you use (EDF = USA, EE0 = EUR, BB8 = JPN) and place it in the /luma/titles/(Title ID) folder. This will enable you to use Smash mods without crashing.
I appreciate all the positive feedback so far, a lot. It means a lot to me to know that people really appreciate my work. As with any brand new release, there's always a couple bugs that slip past even the most hardened beta testing. Thanks for sticking with me :)
 
Last edited by Swiftloke,
Joined
Jan 1, 2018
Messages
7,292
Trophies
2
XP
5,939
Country
United States
Nice! I'll be testing it out some Smash mods later on.

Could you add some screenshot of the app, though? I'm sure people just stumbling upon this will want to get an idea of how this app looks and feels like.

Everyone should check this out. Even if you know nothing about SaltySD or mod plugins, there's a cool built-in tutorial that cuts down the learning curve anxiety.

Mod_Moon_FBI.png


Mod_Moon_HOME_Menu.png
Mod_Moon_HBL.png


Mod_Moon_Light_Theme_1.png
Mod_Moon_Light_Theme_2.png


Mod_Moon_Light_Theme_3.png
Mod_Moon_Light_Theme_4.png


Mod_Moon_Dark_Theme_1.png
 

Swiftloke

Hwaaaa!
OP
Member
Joined
Jan 26, 2015
Messages
1,770
Trophies
1
Location
Nowhere
XP
1,467
Country
United States
A new version has been released- version 3.0.1. It includes several CRITICAL bug fixes for version 3.0. The changelog can be found here: https://github.com/Swiftloke/ModMoon/releases/tag/v3.0.1

If you downloaded ModMoon version 3.0 (as in, you downloaded it in the last week, 9/24/18 through 9/29/18) please download version 3.0.1 manually. On top of fixing the broken SaltySD files that cause crashes in Smash, it also fixes the broken updater(!) that shipped with 3.0. As such, 3.0 will not be able to receive this update over the air (automatically). I personally apologize for the inconvenience.

With this newfound stability comes a deprecation. If you're using Smash Selector, STOP USING SMASH SELECTOR. It is now officially deprecated, and I'm going to get in touch with the folks around NinHo, GBATemp etc. to stop providing support for it. ModMoon is Smash Selectors' successor, and superior, in every way possible.
 

seren3

Well-Known Member
Member
Joined
Jul 16, 2018
Messages
112
Trophies
0
XP
307
Country
United States
Question, would it be possible to load multiple mods at once, or stack mods? Ie Star Sapphire + Busty May mod?
 

BOGY

New Member
Newbie
Joined
Sep 25, 2018
Messages
3
Trophies
0
XP
66
Country
Japan
I anticipate that SSB HACK will be done more conveniently by Mod Moon.
Thank you! Swiftloke!
 

Valzi

Well-Known Member
Newcomer
Joined
Jul 12, 2011
Messages
70
Trophies
0
Location
New Mexico
XP
128
Country
United States
I'm wanting to find out what sorts of things are possible or have been done. I want to know which games people have modded too. I don't have a specific mod I want to find for a specific game.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
    K3Nv2 @ K3Nv2: Sorry for accidentally bending over