PretendoNetwork/nimbus v2.0.0-rc1

on GitHub

BREAKING CHANGES ⚠️

This new release requires user intervention for existing installations. Please check below for how to install this update. You MUST follow this procedure EXACTLY, or your PNID will be removed and you'll have to take some recovery steps.

• If you are installing Nimbus for the first time, you can skip this section.
• If you have connected to Pretendo in the past but don't have a PNID linked to your console, you MUST still follow these steps, or you will have problems when linking one in the future.

Update steps

1. Install the nimbus.3dsx or nimbus.cia file ONLY. DO NOT COPY ANY OTHER FILES YET!
2. Launch the new version of Nimbus
   2.1. The new version of Nimbus should show the version 2.0.0 on the bottom-right corner of the top screen. If this isn't the case, verify that you are launching the correct version and you have installed everything properly.
3. Press the B button to save your PNID
4. If everything goes well, Nimbus will show a success message
   4.1. If Nimbus shows an error, ask on our Discord or the forum for assistance
5. Press START to exit Nimbus and copy all of the other files for the update. You should now be good to go!

Recovery steps

If you have copied all of the Nimbus files and you haven't saved your PNID, you have to follow these recovery steps:

1. Ensure you have installed Nimbus 2.0.0 correctly and that the version shows on screen when opening it
2. If you are connected to Pretendo, open Nimbus and switch to the Nintendo account. If you are already connected to Nintendo, skip to the next step
   2.1. This is required because the Pretendo account is now in a bugged state where it has a Pretendo Friend Code but it's linked to your Nintendo NNID, because the Pretendo PNID was deleted from the system
3. Open Nimbus and switch to the Pretendo account
   3.1. This will recreate the Pretendo PNID and link the Pretendo account back to it
4. After this, opening the NNID settings should now show the account creation and linking screen properly

What's New

• Improvements on account management and error handling. If an error happens while switching accounts, they will be reported on screen for easier debugging.
• New multi-purpose plugin. This plugin bundles patches for game exploits, a PID logger for a bunch of games and HokakuCTR. This plugin must be activated each time you want to use it from the Nimbus app by pressing the Y button.

FAQ: When switching accounts I sometimes get the following error: d8a0c4e5

Short explanation: This error is very uncommon, but it can be fixed by trying again or disabling Wi-Fi to ensure it doesn't happen.

Long explanation:

Before switching accounts, the system must be logged out from any accounts to be able to switch to another one. However, the friends sysmodule requires to be disconnected from the friends server in order to log out, or it will throw FPD::Connected, the error from above. There isn't any API available to "disconnect" from the server, so the way it works is by blocking the network connection (in a similar way as when switching from Internet to Local Play) to get the friends sysmodule to disconnect from the server.

Our code checks for when the friends sysmodule actually gets disconnected, so this error shouldn't in theory happen, but there have been very rare instances of this error popping up despite the fact. As mentioned, this issue can be fixed by retrying the account switch or disabling Wi-Fi on the console full stop to ensure it always disconnects successfully.

What's Changed

• [Important] Fix Miiverse patch misattribution and missing license by @TraceEntertains in #51
• feat: Improve account management by @DaniElectra in #54
• feat: Add PNID migration tool and bump version to 2.0.0 by @DaniElectra in #63
• feat: Add Nimbus plugin by @DaniElectra in #65

Full Changelog: v1.6.1...v2.0.0-rc1