Mod Ardain - Roaming the Recolors -

Changelog

With this update, ARCropolis is now considered "feature complete". Everything that was required for me (@Raytwo) to consider it finished has now been implemented.

What does this mean for users:

• Future updates will mostly be about fixing bugs, improving user experience and improving speed when possible.
• New features might still be implemented, but the primary focus will be improving what's already there.
• Fighter/stage addition and other massive features are not going to be worked on. However if somebody manages to implement it independently, porting these features in ARCropolis is acceptable as they would benefit everybody.
• Porting the one-slot effects and alt-stages plugins by @blu-dev to ARCropolis might be considered at a later date after discussing it extensively with the author. Please stop asking me in DMs.

New feature(s)

• Directory addition (@Coolsonickirby)
• Online slot spoofing (@blu-dev)

Note

• Online slot spoofing has been tested and gave mixed results. More feedback would be appreciated so we know if it is working as intended.
• If you go online with added slots, you take full responsibility on whatever happens to your Switch or Nintendo Online account.
• We do not endorse going online with added slots and we are only trying to make it more safe to not risk running into trouble with Nintendo. If you get banned, that's on you. If you get disconnected, that's also on you. Choose carefully.

Donations

I'd like to personally thank every ARCropolis contributor for putting up the selfless and thankless job of implementing new features and fixing bugs.
As you may know, ARCropolis is a free modloader built during our spare time, as all of us have to make a living while sacrificing our time to the cause.
If you could spare to make a donation, or support our other activities, we would be extremely grateful.

Raytwo (@Raytwo)

• Ko-fi
• Twitter

blujay (@blu-dev)

• Ko-fi
• Patreon
• Twitter

CoolSonicKirby (@Coolsonickirby)

• Ko-fi
• Twitter

jozz (@jozz024)

• Twitter

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

blujay

Changelog

Bugfixe(s)

• Fix shared files not working in config.json (@blu-dev).

Read this

Skyline is not bundled with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

Angst

Changelog

New feature(s)

• Display the total size of loaded mods in the mod manager (thanks @blu-dev)

Bugfixe(s)

• Fix crashes and infinite loadings appearing seemingly at random (thanks @blu-dev)
• Fix UI filter not sorting properly in the mod manager (thanks @blu-dev)
• Reimplement missing mp4 extension support for webm (thanks @jozz024)
• Fix an issue where special taunts (Kid Icarus/Metal Gear Solid/Starfox) would play the wrong audio clips (thanks @Coolsonickirby)
• For plugin developers:
  • Fix a crash when using the arc:/ virtual filesystem (thanks @jozz024)
• (6/17/2022) Fixed is_mod_enabled API for Emulators

Special thanks

• The ARCropolis breaker gang
• Angst

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

Modders In the Desert

About emulator support

Ryujinx

The current release of ARCropolis is "usable" with the latest release of Ryujinx, and should remain that way at least until ARCropolis 4.0.0.
Due to a lack of coordination, some important features of ARCropolis are missing, such as the menus and popup dialogs.

That is not something that we can solve on our side and while we barely managed to supply fail-safes to keep it running, it'd be in your best interest to manifest your desire for better support on the official Github repository and their Patreon page should you wish to play on Ryujinx in the foreseeable future.

I must however inform you that ARCropolis is undergoing a significant rewrite, and should this rewrite break support with Ryujinx due to how we rework things behind the scenes, it is likely that no workaround will be provided if we can't help it.

If you'd like to see better support, please consider supporting their Patreon so that their lead developer, gdkchan, can afford to spend more time working on the emulator and eventually add the missing pieces!

Support for Yuzu

Not much to communicate on that front yet, as I haven't been contacted by any person in charge from their team either, but the latest news seem to imply that support for Skyline/ARCropolis is close but held back by a required change.

It is very likely that some of our changes might break support with Yuzu unknowingly, so I'd appreciate it if they could reach out to me before officially releasing support for it so that we can make sure everything goes smoothly.

Changelog

New feature(s)

• For plugin developers:
  • Support for region indicator when addressing the arc:/ mount point (arc:/your/path+us_en.bin)

Bugfixe(s)

• Enabling newly found mods on boot should now properly add them to your active workspace.

Change(s)

• Removed the Debug field in the configuration editor because people apparently feel the need to enable things they don't know about and then wonder why they get crashes.

Improvement(s)

• Mods using Music as their category will now display as Audio in the mod manager. This is however only a temporary measure, so please make sure to update your info.toml files before ARCropolis 4.0.0.
• Errors due to malformed XMSBT files are now human-readable and give the location of the error.
• Newly found mods on boot won't prompt you to enable them if they already are.

Special thanks

• jozz, for single handedly carrying this release.

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

Wifi Unsafe Noises

Changelog

Update 04/20 (nice)

• Fix support for Ryujinx. Please redownload the release if you were running into an issue.

New feature(s)

• New API calls for plugin developers:
  • is_file_loaded
  • is_mod_enabled
  • show_config_editor
  • show_main_menu

Relevant changes have been performed on arcropolis-api to account for these.

Change(s)

• Reword the popup prompt when generating a new configuration on first boot.

Special thanks

• itsmeft, for arcrop_is_file_loaded.
• Kalomaze, for rewording the popup prompt.

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

Desire for All That is Mods

Changelog

New feature(s)

• New (possibly temporary) API to open the mod manager from another plugin: arcrop_show_mod_manager.
• Ask the user if they'd like to open the configuration editor on first boot.
• Support for (reworked) workspaces, with a workspace manager accessible through the ARCropolis main menu.
  Features for the workspace manager include:
  • Adding
  • Renaming
  • Deleting
  • Duplicating
  • Editing the active mods for a workspace through the mod manager
  • Shortcut keys (displayed on the front page)

Improvement(s)

• Fix cut text on the mod manager buttons.
• Sort mods by enabled/disabled in the mod manager.
• Properly lets you know when there are no mods for a category in the mod manager.
• Show the total amount of mods as well as how many are active in the mod manager.
• Scrolling up/down when at the top/bottom of a page will now continue to the next/previous page in the mod manager.
• Enable/Disable all mods in a category in the mod manager.
• Display control hints at the bottom of the mod manager.

Bug fixe(s)

• Prevent the cursor from going back to the first entry when trying to change page but there is only one in the mod manager.
• Prevent the Disable All button from showing a cursor through the sub-menu in the mod manager.

Change(s)

• Bigger preview picture in the mod manager.
• "Music" category has been renamed to "Audio" for the info.toml file. While this isn't a breaking change, mods making use of "Music" will appear in All/Misc starting from this update.
• ICYMI, the button to open the mod menu on boot has been moved to + (Plus) because Gamecube controllers don't have a - (Minus) button (smh scrubs).
• Slightly larger text and border in the mod manager.

Note

• The homebrew version of ARCadia by @Coolsonickirby is now discontinued in favor of ARCropolis' built-in manager. Please note that the one in ARCropolis is also made by Coolsonickirby, so complaining is useless. We'd rather you suggest improvements.

Special thanks

• @Coolsonickirby for all of the mod manager improvements as well as the entirety of the workspace manager.
• In no particular order, beta testers who caught an insane amount of issues and suggested improvements before this release made it on your Nintendo Switch: HyperNuke, Devory, Segtendo, Jozz
• Charles, for useful tools such as .exe1MasterHandmod, .exesharing2, .exetranferfiles, .exeFileconversion, .exeFileHigh, .exeSmashultimatetools and probably many more the community has never heard of who carried this release hard. /s

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

The Legendary Mod Loading Machine, take #2

UPDATED

Due to GameCube controllers not having a - (Minus) button and most of you nerds using one for those sick Quickplay combos, the command has been moved to the + (Plus) button instead. If you're using a sideways JoyCon and you're missing a + (Plus) button, that's on you.

Changelog

Bug fixe(s)

• Opening the mod manager on boot has been fixed. Hold the - (Minus) button down when the Nintendo Switch boot loop is displayed (not before) to do so. Button subject to change in the future.
• Crashes after updating should not occur anymore (thanks @jozz024)

What's next

• [3.2.0] Implement reworked support for "workspaces", visual bugfixes for the mod manager and some small QoL.

Note(s)

• The homebrew version of ARCadia by @Coolsonickirby is now discontinued in favor of ARCropolis' built-in manager. Before complaining, please be aware that the built-in one has been fixed, performs really well and is ALSO made by Coolsonickirby.
• The mod manager won't ask you to reboot when making changes on boot. This is only required when using the mod manager from the main menu.

Read this

Skyline is not shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

Psycho Modder Theme

Changelog

Bug fixe(s)

• Can now patch using xmsbt/prcx without having the original file on your SD or a hashes.txt file.
• Support for prcxml has been fixed. Please check the Note section below.
• Patch files (xmsbt, prcx, prcxml, ...) now properly support a regional indicator.
• Now properly unshare/replace prebuilt: files.
• Properly defines the behavior when a normal AND regional file are found. Regional will now always take priority.
• Won't crash when a sd:/ultimate/mods directory is not found.

What's next

• [3.1.2] Visual bugfixes for the mod manager and some small QoL.
• [3.2.0] Implement reworked support for "workspaces".

Note(s)

• The homebrew version of ARCadia by @Coolsonickirby is now discontinued in favor of ARCropolis' built-in manager.
• XMSBT only supports UTF-16 at the moment. Consider using MSBT Editor Reloaded and the "Export mod" option to generate a compatible XMSBT easily.
• prcxml only supports UTF-8 at the moment.

Read this

If you encounter a crash after updating Atmosphere from a version lower than 1.2.0, it is not ARCropolis related, so please don't open issues about it. Follow the instructions below to fix it.
Skyline is not be shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

You Call This a Modloader?!

Correcting a misunderstanding

It was mentioned in the changelog for ARCropolis 3.0.0 that you could not put moveset edits in your mod as a plugin.nro.
It turns out that there was a misunderstanding, and you CAN and SHOULD actually use them for moveset edits.
What you CANNOT put there are the plugins they depend on. (Such as nro_hook, smashline, acmd_hook, ...)
Plugins that make use of the ARCropolis API can also be stored that way.

Sorry for the confusion.

Changelog

New feature(s)

• Detect new mods at boot time and offers to enable them automatically. (Does not apply to legacy discovery users)
• Ask the user if they'd like to convert their legacy discovery workspace to the new system when updating from < 3.0.0. This feature will be offered in a menu in a future update for people who change their preference.
• Add arcrop_is_file_loaded API to inquire if Smash has loaded a specific file using its hash. (thanks to @itsmeft24)
• Offers to reboot the game if changes are performed in the mod manager.

Change(s)

• Because of people expressing their concerns, the configuration is moved back to the SD card automatically if upgrading from ARCropolis v3.0.0 and the debug savedata for the current user is deleted.
  Please do not manipulate the configuration files yourself, use the configuration editor on the eShop button (emulator users, however, don't have a choice and are invited to manipulate it).

Improvement(s)

• Massive increase in performance and memory usage in the mod manager, which fixes the crash and lag when using it with a very large quantity of mods. If you had to use the legacy discovery system because of this, please consider trying it again!
  Please note that categories and filtering requires to press the Y button in the menu. This'll be made clearer in a new update coming shortly.
• For plugin developers: The arc:/ filesystem is now backed up by data.arc on the SD instead of the one in memory, which should now provide buffers of the correct size instead of buffers with the patched size from a mod. The files are now guaranteed to be vanilla!

Bug fixe(s)

• Fix a long standing bug with memory allocation, which should lead to fewer crashes all around. (thanks to @blu-dev)
• Thanks to this, XMSBT and PRCX patching now work as expected. However, due to some current limitations, the user requires a copy of the original file next to the xmsbt/prcx for it to work. This will be addressed in the future.
• Fix a panic with plugins using the ARCropolis API that'd lead to a "Physical loader could not find file data" message.
• Fix an issue where your configuration and enabled mods would sometimes be ignored if you booted games with different user profiles.

Note

• The homebrew version of ARCadia by @Coolsonickirby is now discontinued in favor of ARCropolis' built-in manager.

Special thanks

• @Raytwo, for putting up with JavaScript (AGAIN) and @Coolsonickirby for extra improvements to the mod manager.
• @itsmeft24 for modernizing the code related to stream replacement.

Read this

If you encounter a crash after updating Atmosphere from a version lower than 1.2.0, it is not ARCropolis related, so please don't open issues about it. Follow the instructions below to fix it.
Skyline is not be shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.

With Sakurai's Divine Protection

Changelog

Experimental

• Barebone support for Ryujinx. Please read the following before opening an issue or asking questions in here.

New features

• Mods containing a plugin.nro at their root will see this plugin being loaded. Do NOT use this with moveset plugins.
• A new ARCropolis menu has been added to the eShop button on the main menu, replacing the previous Help menu method. (Console only)
• A configuration editor has been implemented and added to the new menu. Do note that this is still heavily being worked on and is going to get improvements. (Console only)
• It is now possible to toggle logging to the SD on top of through network in the Configuration Editor. The files are going to be located in sd:/ultimate/arcropolis/logs
• A dump of your filesystem will be generated in sd:/ultimate/arcropolis/filesystem_dump.txt if the debug flag is enabled in your configuration. That is to be provided when asking for help so people can see what mods you have and if something looks off.
• File addition has been implemented, letting you add files to a specific directory using a configuration file. Documentation is lacking for the time being, but should be added to the Wiki in a timely manner. Consider consulting Gamebanana or asking in a Discord server of your choosing.
  Please, PLEASE don't ask if this lets you add fighters or directories to the game. It does not.
• Added files can be shared to other directories using the following structure:

{
    "new-shared-files": {
        "fighter/mario/model/body/c00/some_file.nutexb": [
            "fighter/mario/model/body/c01/some_file.nutexb",
            "fighter/mario/model/body/c02/some_file.nutexb",
            "fighter/mario/model/body/c03/some_file.nutexb",
            "fighter/mario/model/body/c04/some_file.nutexb",
            "fighter/mario/model/body/c05/some_file.nutexb",
            "fighter/mario/model/body/c06/some_file.nutexb",
            "fighter/mario/model/body/c07/some_file.nutexb"
        ]
    }
}

• Patch formats have been introduced for the following:
  prc -> prcx and prcxml
stprm -> stprmx and stprmxml
stdat -> stdatx and stdatxml
msbt -> xmsbt
  However, it has come to our attention that it is very prone to crashing for reasons outside of our control. Please do not open an issue about it while an attempt is made to fix the core issue.

Changes

• Mod conflicts are now detected. A prompt will let you know when it occurs, and you will be offered to write a list of the conflicts on your SD in sd:/ultimate/arcropolis/conflicts.json. (Prompt is console only, emulators will refuse automatically)
• The configuration file has now been removed in favor of a user-based savefile, meaning your configuration won't be shared between users anymore. This was made in an effort to reduce user error. (Emulator users can access their system savedata to manipulate their configuration at their own risk)
• If a configuration file exists, your settings are going to be migrated to the new system automatically.
• The paths for ARC and UMM modpacks can no longer be configured, in an effort to reduce user error.
• A new enable/disable system for mods has been introduced. Your enabled and disabled mods are going to be stored in your user-based savefile, in an effort to reduce duplicated mods for people sharing a Nintendo Switch. (Console only)
• If you'd rather use the old system for whatever reason, a (temporary?) option is available in the Configuration Editor to enable legacy behavior. The in-game Mod Manager won't work if you use this. (Ryujinx will use the legacy system from prior to 3.0.0 until the web browser is supported)

Improvements

• Big improvements on boot times.
• The auto-update server has been replaced by a new one that uses GitHub to look up for updates. This means no more down times (unless GitHub has an issue), and no more being stuck on a black screen on boot. (Console only)
  You can opt-out of updates or opt-in for beta updates of ARCropolis from the Configuration Editor.
• Ignore files starting with a period in an effort to reduce conflicts caused by OSes that add files when modifying directories such as OS X.

Regression

• Extra mod paths can no longer be added for the time being. This, however, is temporary until something can be worked out.

Notes

• Your mods won't be loaded on first boot because of the new system, so please use the mod manager in the new ARCropolis menu to enable your mods again.

Special thanks

• @blu-dev, for handling the rewrite of the file discovery/replacement system and file addition.
• @Raytwo, for putting up with JavaScript (again).

Read this

If you encounter a crash after updating Atmosphere from a version lower than 1.2.0, it is not ARCropolis related, so please don't open issues about it. Follow the instructions below to fix it.
Skyline is not be shipped with ARCropolis anymore.
Please read this issue to know how to proceed from now on.