diff --git a/.gitignore b/.gitignore index b2cea5e..a924ade 100644 --- a/.gitignore +++ b/.gitignore @@ -57,6 +57,9 @@ typings/ # vscode settings .vscode +# JetBrains settings +.idea + # dotenv environment variables file .env diff --git a/docs/common/errorList.json b/docs/common/errorList.json index 6afc545..d20ba88 100644 --- a/docs/common/errorList.json +++ b/docs/common/errorList.json @@ -14,6 +14,7 @@ "SYS-015-5006", "SYS-015-5007", "SYS-015-5015", + "SYS-102-2482", "SYS-115-2004", "SYS-115-5001", "SYS-115-5002", diff --git a/docs/en_US/errors/SYS-102-2482.md b/docs/en_US/errors/SYS-102-2482.md new file mode 100644 index 0000000..d195191 --- /dev/null +++ b/docs/en_US/errors/SYS-102-2482.md @@ -0,0 +1,31 @@ +# Error Code: 102-2482 +**Applies to:** Wii U + +--- + +- "Unable to connect to the server. Please try again later. If the problem persists, please make a note of the error code and visit support.nintendo.com." + +This error indicates one of the following: +1. The server you're connecting to is offline for maintenance. +2. Pretendo does not yet support the game or application in question. +3. The game or application's server is still in development and isn't available to your account yet. For example, beta + servers are generally only available to [supporters](https://pretendo.network/account/upgrade). + +### Possible Solutions + +- **Check our network status information** +> Check our [Network Status page](https://stats.uptimerobot.com/R7E4wiGjJq) and ensure that there are no ongoing service outages. + +- **Check Pretendo has a server for your game** +> Check our [Progress page](https://pretendo.network/progress) to see if a server exists and is in development. We don't +> support everything yet! + +- **Upgrade your account** +> Certain beta and development servers are available to supporters for beta-testing. If you'd like to help test these +> ahead of a public release, [consider supporting Pretendo](https://pretendo.network/account/upgrade). + +--- + +If you have not yet connected to Pretendo, please follow the instructions [here](/docs/install) to get started. + +If you are still unable to connect, please request to speak to a moderator in the [Discord server](https://discord.gg/pretendo). diff --git a/docs/en_US/install/cemu.md b/docs/en_US/install/cemu.md index ff0dd3f..e1628d8 100644 --- a/docs/en_US/install/cemu.md +++ b/docs/en_US/install/cemu.md @@ -10,23 +10,6 @@ Cemu 2.0 has official built-in support for Pretendo as of October 10, 2022. Head to the Cemu GitHub [releases](https://github.com/cemu-project/Cemu/releases) page and download the latest Cemu experimental release (tagged as `Pre-release`). Only `Cemu 2.0-5 (Experimental)` and above is supported at the moment. Additionally you may build Cemu from source using the provided [build instructions](https://github.com/cemu-project/Cemu/blob/main/BUILD.md) -## Online files -Cemu requires the use of several files obtained via dumping from real hardware. You may use those files if you have a physical Wii U, they will work just fine when connecting to Pretendo. If you _don't_ have a real Wii U navigate to [your account page](/account) and select `Download account files` - -
- -
- Note: - These online files are scrubbed of all console information and are stubbed enough for Cemu to think they are from real hardware. These files MAY fail to work correctly. Support for these files is very limited, and it is recommended to use files from a real console -
- -## Setup Cemu for online -After obtaining the files needed for online play refer to the official [Cemu Online Play](https://cemu.cfw.guide/online-play.html) guide - -
- Note! If you downloaded the account files from your Pretendo Network account you may skip the steps on the Cemu guide which dumps them from a console. However these files will not work on Nintendo Network. For compatibility with both servers, use files dumped from a real console -
- ## Connecting to Pretendo Once you have Cemu setup for online play navigate to `Options > General settings > Account`. You should now see a section titled `Network Service`. Select your PNID from the `Active account` menu and select the `Pretendo` Network Service option. Cemu should now be connected to Pretendo's servers diff --git a/docs/en_US/install/wiiu.md b/docs/en_US/install/wiiu.md index 7798a3e..ecb22ac 100644 --- a/docs/en_US/install/wiiu.md +++ b/docs/en_US/install/wiiu.md @@ -6,104 +6,78 @@ Aroma using this guide. -## Select your homebrew environment +You can get a Wii U onto Pretendo in just 3 steps: +1. [RCE Patches](#rce-patches) +2. [Connecting to Pretendo](#connecting-to-pretendo) +3. [PNID Setup](#pnid-setup) -- ### [Aroma](#aroma-1) -- ### [Tiramisu](#tiramisu-1) -- ### [Legacy](#legacy-1) +# RCE Patches +Unfortunately, some of Pretendo's supported games have major security and safety problems. While Nintendo fixed these +games on the 3DS, thus far they have neglected the Wii U. Pretendo has a patcher which attempts to fix these problems - +this is **essential** to play online safely, whether on Pretendo Network or Nintendo Network. -## Already have Pretendo installed? +
+⚠️ Don't skip this step! +
-- ### [PNID Setup](#pnid-setup-1) +To install the fix, naviagate to the +[latest release of the RCE patcher](https://github.com/PretendoNetwork/rce_patches/releases/latest) on GitHub and +download the `rce_patches.wps` file. -# Aroma + -To connect to Pretendo Network using Aroma you must use the [Inkay](https://github.com/PretendoNetwork/Inkay) plugin. +Place the downloaded `rce_patches.wps` file on your SD card at `sd:/wiiu/environments/aroma/plugins`. It's normal for other Aroma plugins to be in this folder too. + + + +Place your SD card back into your console and boot like normal. + +# Connecting to Pretendo + +
+ ℹ️ Already have Pretendo installed? Skip ahead to PNID Setup! +
+ +To connect to Pretendo Network you must use the [Inkay](https://github.com/PretendoNetwork/Inkay) plugin with Aroma. The stable version is recommended for most users, however betatesters and others may be interested in the bleeding edge version. -### Aroma - Stable -Navigate to the [releases](https://github.com/PretendoNetwork/Inkay/releases) page on the Inkay GitHub repository. +## Stable +Navigate to [Inkay's latest release](https://github.com/PretendoNetwork/Inkay/releases/latest) on GitHub and download the `Inkay-pretendo.wps` file from the latest release. - + -Now download the `Inkay-pretendo.wps` file from the latest release. +Place the downloaded `Inkay-pretendo.wps` file on your SD card at `sd:/wiiu/environments/aroma/plugins`. It's normal for other Aroma plugins to be in this folder too. - + -Place the downloaded `Inkay-pretendo.wps` file on your SD card at `sd:/wiiu/environments/aroma/plugins`. +Place your SD card back into your console and boot like normal. If it worked, you'll see a notification of your connection: - + -Place your SD card back into your console and boot like normal. You should now be connected to Pretendo Network. +You are now connected to Pretendo Network and can continue with [PNID Setup](#pnid-setup). -### Aroma - Bleeding Edge +## Bleeding Edge Navigate to the [actions](https://github.com/PretendoNetwork/Inkay/actions) page on the Aroma GitHub repository. - + Select the `Inkay-CI` workflow and select the latest workflow run. _**Note:** At this stage you may also use the provided filters to only grab builds from specific branches, events, etc. By default the latest build, regardless of branch, is always shown._ - + Select the `inkay` artifact. This will download a `inkay.zip` zip file. - + Extract `inkay.zip` and place the extracted `Inkay-pretendo.wps` file on your SD card at `sd:/wiiu/environments/aroma/plugins`. - + -Place your SD card back into your console and boot like normal. You should now be connected to Pretendo Network. +Place your SD card back into your console and boot like normal. If it worked, you'll see a notification of your connection: + -# Tiramisu - -
- ⚠ Note that Tiramisu is no longer supported by Pretendo and cannot receive the latest network and security patches. These instructions - are kept for legacy users only. -
- -To connect to Pretendo Network using Tiramisu you must use the [Nimble](https://github.com/PretendoNetwork/Nimble) set up module. There are 2 ways of obtaining the patch, either the stable release version or the bleeding edge version. - -### Tiramisu - Stable -Navigate to the [releases](https://github.com/PretendoNetwork/Nimble/releases) page on the Nimble GitHub repository - - - -Now download the `30_nimble.rpx` file from the latest release - - - -Place the downloaded `30_nimble.rpx` file on your SD card at `sd:/wiiu/environments/tiramisu/modules/setup` - - - -Place your SD card back into your console and boot like normal. You should now be connected to Pretendo Network - -### Tiramisu - Bleeding Edge -Navigate to the [actions](https://github.com/PretendoNetwork/Nimble/actions) page on the Nimble GitHub repository - - - -Select the `Nimble-CI` workflow and select the latest workflow run. _**Note:** At this stage you may also use the provided filters to only grab builds from specific branches, events, etc. By default the latest build, regardless of branch, is always shown._ - - - -Select the `nimble` artifact. This will download a `nimble.zip` zip file - - - -Extract `nimble.zip` and place the extracted `30_nimble.rpx` file on your SD card at `sd:/wiiu/environments/tiramisu/modules/setup` - - - -Place your SD card back into your console and boot like normal. You should now be connected to Pretendo Network - - -# Legacy - -Pretendo does not officially support legacy homebrew environments (Haxchi/CBHC) anymore. Legacy releases of the patcher may be found in old [releases](https://github.com/PretendoNetwork/Nimble/releases), and the source code may be found in the [old_hbl](https://github.com/PretendoNetwork/Nimble/tree/old_hbl) and [old_hbl_inkay](https://github.com/PretendoNetwork/Nimble/tree/old_hbl_inkay) branches on GitHub. However you will need to build these patches from source, and they will _**not**_ be receiving any updates or technical support. Please consider upgrading to Aroma. - +You are now connected to Pretendo Network and can continue with [PNID Setup](#pnid-setup). # PNID Setup @@ -112,13 +86,13 @@ After installing Pretendo, you will need to create a PNID to use our services. T ### PNID Setup - Website You will want to register an account from [here](/account) and click `Don't have an account?` to register. - + Right before registering a PNID, please make sure to save your password on some sort of note, as you will not be able to reset your password. After registering just simply change your birth date, gender, timezone, country/region, etc to what you see fit. Once you have it set up we can switch back to the Wii U. Within your Wii U you will want to reconnect to Pretendo _**Note:** how you reconnect to Pretendo depends on how you installed it on your Wii U!_ Once you are reconnected, you will want to press the top left profile icon and press `Switch Account`, then press `Add New User`. Go through the user set up normally, but when it asks if you have an account, press `Yes` and put in your username and password. If it asks you to confirm your email afterwards, simply skip it. You will now be able to use Pretendo Servers ### PNID Setup - Wii U Right before registering a PNID, please make sure to save your password on some sort of note, as you will not be able to reset your password. You will want to go on you Wii U while Pretendo is still active and press the top left profile icon. After pressing the icon, press `Switch Account`, and then `Add New User`. Set up this account as normal, but once it asks if you have an account, press `No` and go through the account process normally. When it asks you again to you want to link after adding a mii, press `Link`. Choose your language and then accept the Pretendo Network Service Agreement. - + Finally, set up your pnid, email and password. Once all of this is done you will be able to use Pretendo Server diff --git a/public/assets/images/docs/install/wiiu/aroma/actions-highlight.png b/public/assets/images/docs/install/wiiu/aroma/actions-highlight.png index fdac827..6f37071 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/actions-highlight.png and b/public/assets/images/docs/install/wiiu/aroma/actions-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/artifact-highlight.png b/public/assets/images/docs/install/wiiu/aroma/artifact-highlight.png index 31c4093..f4ae5c8 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/artifact-highlight.png and b/public/assets/images/docs/install/wiiu/aroma/artifact-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/rce-sd-card.png b/public/assets/images/docs/install/wiiu/aroma/rce-sd-card.png new file mode 100644 index 0000000..6effca4 Binary files /dev/null and b/public/assets/images/docs/install/wiiu/aroma/rce-sd-card.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/rce-wps-highlight.png b/public/assets/images/docs/install/wiiu/aroma/rce-wps-highlight.png new file mode 100644 index 0000000..c37f3f6 Binary files /dev/null and b/public/assets/images/docs/install/wiiu/aroma/rce-wps-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/releases-highlight.png b/public/assets/images/docs/install/wiiu/aroma/releases-highlight.png index 47428ca..22afb15 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/releases-highlight.png and b/public/assets/images/docs/install/wiiu/aroma/releases-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/sd-card.png b/public/assets/images/docs/install/wiiu/aroma/sd-card.png index eadbfab..8104483 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/sd-card.png and b/public/assets/images/docs/install/wiiu/aroma/sd-card.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/workflow-highlight.png b/public/assets/images/docs/install/wiiu/aroma/workflow-highlight.png index 24f7edd..b983740 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/workflow-highlight.png and b/public/assets/images/docs/install/wiiu/aroma/workflow-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/working-notification.jpg b/public/assets/images/docs/install/wiiu/aroma/working-notification.jpg new file mode 100644 index 0000000..5107ce0 Binary files /dev/null and b/public/assets/images/docs/install/wiiu/aroma/working-notification.jpg differ diff --git a/public/assets/images/docs/install/wiiu/aroma/working-notification.png b/public/assets/images/docs/install/wiiu/aroma/working-notification.png new file mode 100644 index 0000000..2f7431e Binary files /dev/null and b/public/assets/images/docs/install/wiiu/aroma/working-notification.png differ diff --git a/public/assets/images/docs/install/wiiu/aroma/wps-highlight.png b/public/assets/images/docs/install/wiiu/aroma/wps-highlight.png index 3ce0f11..5c75d7a 100644 Binary files a/public/assets/images/docs/install/wiiu/aroma/wps-highlight.png and b/public/assets/images/docs/install/wiiu/aroma/wps-highlight.png differ diff --git a/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.jpg b/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.jpg new file mode 100644 index 0000000..26b6500 Binary files /dev/null and b/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.jpg differ diff --git a/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.png b/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.png deleted file mode 100644 index 72d780e..0000000 Binary files a/public/assets/images/docs/install/wiiu/pnid/pretendo-eula.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/pnid/register-account-web.png b/public/assets/images/docs/install/wiiu/pnid/register-account-web.png index 3909cec..af24d1b 100644 Binary files a/public/assets/images/docs/install/wiiu/pnid/register-account-web.png and b/public/assets/images/docs/install/wiiu/pnid/register-account-web.png differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/actions-highlight.png b/public/assets/images/docs/install/wiiu/tiramisu/actions-highlight.png deleted file mode 100644 index 49f0cdf..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/actions-highlight.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/artifact-highlight.png b/public/assets/images/docs/install/wiiu/tiramisu/artifact-highlight.png deleted file mode 100644 index 989bbc5..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/artifact-highlight.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/releases-highlight.png b/public/assets/images/docs/install/wiiu/tiramisu/releases-highlight.png deleted file mode 100644 index 555038e..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/releases-highlight.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/rpx-highlight.png b/public/assets/images/docs/install/wiiu/tiramisu/rpx-highlight.png deleted file mode 100644 index 02bc2a7..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/rpx-highlight.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/sd-card.png b/public/assets/images/docs/install/wiiu/tiramisu/sd-card.png deleted file mode 100644 index 18684df..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/sd-card.png and /dev/null differ diff --git a/public/assets/images/docs/install/wiiu/tiramisu/workflow-highlight.png b/public/assets/images/docs/install/wiiu/tiramisu/workflow-highlight.png deleted file mode 100644 index ff587a7..0000000 Binary files a/public/assets/images/docs/install/wiiu/tiramisu/workflow-highlight.png and /dev/null differ