Utility for proxying and viewing gameplay sessions from various consoles, including the 3DS, Wii U and Switch.
- Quazal Rendez-Vous
- PRUDPv0
- PRUDPv1
- PRUDPLite
- NetZ (WIP)
- PIA (WIP)
- HPP
- HTTP
- gRPC/NPLN
- PCAP (
.pacp) - PCAPNG (
.pacpng) - HAR (
.har) - Charles (
.chls,.chlz) - Mitmproxy Flows (
.flow,.flows) - Fiddler (
.saz) - Proxide (
.bin)
- RemoteLogDevice
- NATTraversal
- TicketGranting
- SecureConnection
- BackEndManagement
- NotificationEvents
- SimpleAuthentication
- Siege
- Health
- Monitoring
- Friends
- MatchMaking
- Messaging
- PersistentStore
- AccountManagement
- Competition
- MessageDelivery
- ClientSettings
- UbiAccountManagement
- GeoLocalization
- News
- Privileges
- Tracking3
- Localization
- GameSession
- SubAccountManagement
- IPToLocation
- IPToLocationAdmin
- UbiFriends
- SkillRating
- UplayWin
- MatchMakingExtension
- TitleStorage
- UserStorage
- PlayerStats
- Spark
- OfflineGameNotifications
- UserAccountManagement
- SiegeAdmin
- NintendoNotificationEvents
- Friends3DS
- FriendsWiiU
- MatchmakeExtension
- Utility
- StorageManager
- Ranking
- DataStore
- Debug
- Subscription
- Rating
- ServiceItem
- MatchmakeReferee
- Subscriber
- Ranking2
- AAUser
- Screening
- WebNotificationsStorage
- TitleStorageAdmin
- UserStorageAdmin
- Dummy
- SecureConnectionInternal
- NATTraversalReportInternal
- Shop (Pokemon Bank)
- OLSStorage (Rayman Legends)
- Tournament (Super Smash Bros. Ultimate)
Warning
Older versions of this tool precomputed the Kerberos keys for each password. These precomputed keys are NOT usable in newer versions. Password files must now always contain the raw game server password for each PID.
In order to decrypt PRUDP packet payloads for the games secure server(s) your game server account credentials must be known by Pretendo Network Viewer. To add an account to the settings open one of the following JSON files:
%AppData%/NEXViewer/settings.json(Windows)~/.config/nex-viewer/settings.json(Linux)code /Users/<UserName>/Library/Application\ Support/nex-viewer/settings.json(MacOS)
From here add an account entry to the accounts array. An account entry takes the following form:
{
platform: string; // The platform the account is for (W ii U, 3DS, PC, etc.). Unused currently
username: string; // Account username. For NEX accounts this is your account PID as a string
pid: number; // Account unique PID
password: string; // Account password. Must not be hashed. Used to generate the below hashes, and those for non-NEX game servers
password_hash_old: string; // Pre-computed Kerberos key using the old key derivation method
password_hash_new: string; // Pre-computed Kerberos key using the new key derivation method
}Caution
DO NOT SHARE YOUR NEX PID AND PASSWORD WITH ANYBODY UNLESS YOU ABSOLUTELY KNOW WHAT YOU ARE DOING OR YOU DO NOT CARE ABOUT THE ACCOUNT. THIS PID/PASSWORD COMBINATION IS WHAT THE CONSOLE USES TO AUTHENTICATE YOU WHEN PLAYING ONLINE, NOT YOUR NNID USERNAME/PASSWORD. SHARING THESE DETAILS CAN ALLOW ANYONE TO LOGIN TO ANY GAME UNDER YOUR ACCOUNT.
NEX accounts are not the same thing as NNIDs/NSO accounts. How you obtain your NEX account details depends on your system. See below for details.
There are 2 ways to obtain your NEX account details on a Wii U:
- Homebrew (can be unreliable)
- Proxy server (can be difficult to setup)
To use homebrew to obtain your NEX account details on Wii U, all you need is an FTP server homebrew (such as FTPiiU_Everywhere). Connect to your Wii U via FTP and navigate to /storage_mlc/usr/save/system/act. Here you will find folders for every account on your Wii U. Open each folder and then open the account.dat file in any text editor. Verify the account is the one you want to use by looking for your NNID user name (it will be labeled as AccountId). Once you have found the account.dat file for the account you want to use, find the PrincipalId and NfsPassword fields. If you do not see one of these fields, or if the field has no value, you must use the proxy server method. The PrincipalId field is your NEX PID encoded as hexadecimal. Decode it back to decimal for use here (example: 68503904 decodes to 1750087940). The NfsPassword field is your NEX password.
To use a proxy server to obtain your NEX account details on Wii U, you must first get a proxy server like Fiddler (Windows), Charles (all OSes) or mitmproxy (all OSes). Note: if using Fiddler, do not use Fiddler Everywhere, use the original Fiddler. Once installed you must either disable SSL verification on your console via homebrew or replace your systems SSL certificates with the proxy server certificates. Be warned that messing up replacing the SSL certficiates will brick your console (can be recovered). Here are guides for Fiddler and Charles. Once connected to the proxy server on your Wii U look for the request to https://account.nintendo.net/v1/api/provider/nex_token/@me. Open the response to this request and locate the pid and nex_password fields. These are your NEX account details.
Unlike the Wii U the 3DS does not request your NEX account details from any server. Instead it is stored on your console after the first time you connect to the friends server. The only way to obtain your 3DS NEX account details is to dump them with homebrew. Compile this homebrew application and run it on your 3DS. It will create a nex-keys.txt file on the root of the SD card in the correct format already. The source code for the homebrew is available here.
NEX account details are not required for traffic on the Nintendo Switch as there is no packet-level encryption. NEX account details are required in other versions in order to decrypt the session ticket to obtain the session key used to encrypt packet payloads, but NEX on the Nintendo Switch uses a WebSocket Secure connection rather than UDP, which relies on the encryption at the TLS layer rather than the application layer.
Pretendo Network Viewer supports standard Quazal Rendez-Vous connections as well. This means traffic from games such as Rayman Legends, Rock Band 1, 2 and 3, WATCH_DOGS, etc. are supported (though may require modifications to the viewer for any game-specific features). This is because Nintendo licensed Rendez-Vous from Quazal and only modified it slightly to create NEX, much of the underlying systems are identical (or at least broadly compatible). Ubisoft purchased Quazal in 2010, so many fo their games use the Rendez-Vous library.
This application is designed with this traffic in mind and tries it's best to support all possible games. Due to Quazal licensing it's Rendez-Vous software to many developers over time, the specifics on how you obtain the account details will vary. Due to Rendez-Vous' ability to be modified and extended (such as with the creation of NEX), some developers may have also made large changes to the protocols which are incompatible with other implementations. One such example is WATCH_DOGS, which changed the structure of RMC payloads. This application does a best attempt at supporting these changes, but it is possible that some changes are impossible to support cleanly along side other implementations. In those cases, a fork of Pretendo Network Viewer should be made.
Caution
Use at your own risk. While the proxy has been tested thoroughly, and no bans have occured from its use, Nintendo is much more cautious with NSO. Even irregularities such as the order of headers can trip their alarms. We are not responsible for anything that may happen to your console/NSO account when using this tool.
Pretendo Network Viewer implements a built-in gRPC/NPLN proxy server which can be used to capture traffic from NPLN games. It can be started and stopped from the application menu (under "Proxy") and it will listen on port 8080 by default, but it can be configured to listen to any port in the settings.
Before enabling the proxy on your console, you will need to make it trust the CA certificate, generated in the proxy-ca folder in the application data directory (Accessible by clicking "Open CA Certificate folder" in the "Proxy" menu) after the proxy has been started atleast once. To do this, you can use a tool like network_mitm.
Once the proxy has been set up, incoming gRPC/NPLN requests will automatically be parsed by the viewer and displayed in the packet list.
The recommended IDE for Pretendo Network Viewer is VSCode, using the following plugins:
$ git clone https://github.com/PretendoNetwork/nex-viewer
$ cd nex-viewer
$ npm installRun the app in development mode using electron-vite
$ npm run devRun the app in development mode using electron-forge
$ npm startBuild the app for distribution using electron-vite
$ npm run buildBuild the app for distribution using electron-builder
$ npm run build:win
$ npm run build:mac
$ npm run build:linuxBuild the app for distribution using electron-forge
$ npm run make