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

Discussion in '3DS - Homebrew Development and Emulators' started by Swiftloke, Sep 25, 2018.

  1. Swiftloke
    OP

    Swiftloke Hwaaaa!

    Member
    8
    Jan 26, 2015
    United States
    Nowhere
    [​IMG]

    ...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:
    Folder Structure

    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, Oct 24, 2018
  2. DewTek
    This message by DewTek has been removed from public view by Chary, Sep 25, 2018.
    Sep 25, 2018
  3. Fusion Luigi

    Fusion Luigi Pun Master/Loser

    Member
    3
    Feb 11, 2016
    United States
    Warp Zone
    Amazing. Goddamn this'll make life on the 3DS easier and more aesthetic than one could've imagined before today.
     
    TurdPooCharger and Itzumi like this.
  4. Itzumi

    Itzumi Needs More Aesthetics

    Member
    4
    Jun 27, 2018
    United States
    USA
    Dude nice! This makes things quite a bit easier!

    EDIT:just used it today, it is great! Very user friendly!
     
    Last edited by Itzumi, Sep 25, 2018
    TurdPooCharger likes this.
  5. lintu

    lintu Member

    Newcomer
    2
    Sep 6, 2018
    Canada
    This is fantastic! Big kudos to you, @Swiftloke .
     
  6. xGhostBoyx

    xGhostBoyx Newbie

    Newcomer
    1
    Oct 16, 2016
    United States
    Can't wait to actually test it out!
     
  7. Filo97

    Filo97 Zelda's totally my sister! Not lying!

    Member
    9
    Oct 8, 2015
    Italy
    Hyrule Castle
    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)
     
  8. seren3

    seren3 GBAtemp Regular

    Member
    2
    Jul 16, 2018
    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, Nov 26, 2018
    BOGY likes this.
  9. mike a

    mike a GBAtemp Advanced Fan

    Member
    5
    Oct 28, 2014
    United States
    Wow I didn't even know there were mods for 3ds games, this is awesome
     
  10. TurdPooCharger

    TurdPooCharger Meh

    Member
    10
    Jan 1, 2018
    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.


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

    Original Post
     
    Last edited by TurdPooCharger, Sep 29, 2018
    ConKonner and Itzumi like this.
  11. B_E_P_I_S_M_A_N

    B_E_P_I_S_M_A_N I'm better than you I think

    Member
    9
    Jun 7, 2016
    Antarctica
    Hell
    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.
     
  12. Swiftloke
    OP

    Swiftloke Hwaaaa!

    Member
    8
    Jan 26, 2015
    United States
    Nowhere
    This message is no longer relevant with the release of 3.0.1. It is enclosed for historical purposes.
    ModMoon v3.0 was broken
     
    Last edited by Swiftloke, Sep 29, 2018
  13. TurdPooCharger

    TurdPooCharger Meh

    Member
    10
    Jan 1, 2018
    United States
    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.

    [​IMG]

    [​IMG] [​IMG]

    [​IMG] [​IMG]

    [​IMG] [​IMG]

    [​IMG]
     
  14. Swiftloke
    OP

    Swiftloke Hwaaaa!

    Member
    8
    Jan 26, 2015
    United States
    Nowhere
    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.
     
  15. seren3

    seren3 GBAtemp Regular

    Member
    2
    Jul 16, 2018
    United States
    Question, would it be possible to load multiple mods at once, or stack mods? Ie Star Sapphire + Busty May mod?
     
  16. Valzi

    Valzi Advanced Member

    Newcomer
    1
    Jul 12, 2011
    United States
    New Mexico
    Where would I find mods to use with this? I've been searching for a while and haven't figured it out.
     
    Last edited by Valzi, Oct 2, 2018
  17. BOGY

    BOGY Newbie

    Newcomer
    1
    Sep 25, 2018
    Japan
    I anticipate that SSB HACK will be done more conveniently by Mod Moon.
    Thank you! Swiftloke!
     
  18. Itzumi

    Itzumi Needs More Aesthetics

    Member
    4
    Jun 27, 2018
    United States
    USA
    Just look for mods in general. Smash 4 mods can be found on gamebanana
     
  19. Valzi

    Valzi Advanced Member

    Newcomer
    1
    Jul 12, 2011
    United States
    New Mexico
    I Googled "3ds mods" and didn't find anything except smash bros mods.
     
  20. Itzumi

    Itzumi Needs More Aesthetics

    Member
    4
    Jun 27, 2018
    United States
    USA
    Try searching a particular game
     
  21. Valzi

    Valzi Advanced Member

    Newcomer
    1
    Jul 12, 2011
    United States
    New Mexico
    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.
     
Loading...