Cafe SDK  Version 2.13
API References for nn Library Modules
 All Data Structures Namespaces Functions Variables Typedefs Enumerations Enumerator Groups Pages
Account Manager

Running the Software

caferun $CAFE_ROOT/system/bin/ghs/cafe/app/actmgr/NDEBUG/actmgr.rpx

Overview

This tool provides an alternative to the Wii U Menu for creating, registering, deleting, and selecting accounts.

A keyboard or software keyboard can be used for text input when using this tool. If the focus is on the console used to run the tool, input from the PC keyboard is sent to the tool in addition to any input from a USB keyboard directly connected to the development hardware.

To input text using the GamePad, use the analog stick to select characters. Use the L and R Buttons to switch the type of input characters.

The following table shows the correspondence between controller buttons and keyboard keys for operations other than text input.

ControllerKeyboard
+Control PadArrow Keys
A ButtonA Key, Enter Key
B ButtonB Key, Esc Key
X ButtonX Key
Y ButtonY Key
L ButtonL Key
R ButtonR Key

Account Creation

To create a local account, rest the pointer over an empty slot and select Create Console Account.

The console must be restarted to store the BOSS settings made when creating the local account. Restart the console from the HOME Menu, or press the POWER Button.

Note
You can only rest the pointer on the first empty slot from the top.

Registering a Nintendo Network ID

To use networking features with the Wii U, you must register a Nintendo Network ID and link it to a Nintendo Network account.

To register your Nintendo Network ID and upgrade to the local account to a network account, point to the local account and select Register Account ID. Enter an ID, password, and date of birth according to the instructions on the screen. After entering the date of birth, no additional input is required when relinking to an account that already exists.

Under Area, enter the numeric code representing your state or province. Although the valid values vary depending on your country, currently there is no effect on the system no matter what value you enter.

If you select Yes for Initialize Friend Preference?, the friend list is initialized with the initial settings. To initialize this functionality without the initial settings sequence, select No.

If you select Yes for Initialize Miiverse?, Miiverse functionality is set to the initial settings. To initialize this functionality without the initial settings sequence, select No.

This operation requires a network connection. You must have previously configured a connection that has access to the Internet.

To register a Nintendo Network ID, you must have a console with one of the following country code settings.

RegionCountry CodeCountry Name
JPN1Japan
USA16Brazil
18Canada
36Mexico
49United States
EUR65Australia
77France
78Germany
83Italy
105Spain
110United Kingdom
Note
The account ID and password must comply with the following restrictions.
  • Both the account ID and password must be between 6 and 16 characters in length.
  • Your account ID may only consist of alphanumeric characters plus nonconsecutive hyphens (-), periods (.), and underscores (_).
  • The account password can include alphanumeric characters and symbols, and must contain at least two of the following: uppercase letters, lowercase letters, numbers, and symbols.
  • The same character cannot be repeated three times in a row within an account password.
  • The account ID and password must not match.

Account Deletion

To delete an account, rest the pointer on a slot that is not empty, and select Delete.

Deleting an account on the Wii U console does not delete the Nintendo Network account from the server. Enter the same ID and password from the same console to link again to this account.

Default Account Settings

To set that account as the default account, rest the pointer on a slot that is not empty, and select Set Default Account. The default account is selected as the current account when starting an application.

The default account shows an asterisk (*) to the left of the slot number.

Changing a Mii Character

You can change the Mii character set for an account by resting the pointer on a slot that is not empty and selecting Change Mii. The Mii character set for the account before the change will be lost.

You can select from 12 Mii characters or import a Mii character from an SD card. Mii characters selected from the predefined types are assigned separate unique IDs every time they are configured, so even if they look the same, they are recognized as separate Mii characters. To import a Mii character from an SD card, in the System Config tool under Boot Configuration, select Development as the system mode, and place an FFSD file named mii.ffsd in the root directory of the SD card.

Getting Email Addresses

To ask the server for confirmation of the email address set for the account, rest the pointer on a network account and select Get Email Address.

Note
If you created a Nintendo Network ID for an account using a version of the account manager tool earlier than 1.0.7, the email address is set to a dummy address that is generated based on the account ID.

Password Cache Settings

To change the password cache setting, rest the pointer on the network account and select Disable/Enable Password Cache.

Account authentication by the application fails if you disable the password cache or register an invalid password in it.

Uploading Mii Characters

Point to your network account and click Upload Mii to upload the Mii character configured for your account to the server.

If you do not upload a Mii character, either the earlier Mii character appears in Miiverse, or a silhouette appears indicating that there is no image of the Mii character.

Note
There is no image of a Mii character configured for the following accounts, so the upload fails for them. Configure a Mii character for the account by creating an account again or changing the Mii character.
  • Accounts created automatically by the system with a Mii character name of "???"
  • Accounts created with the account manager for SDK 2.07 or earlier

Checking Passwords

To check the password for your network account, rest the pointer on the account name, and select Check Password. If the password was entered correctly and verified by the server, OK is displayed.

Replacing Account IDs

If you change your account ID on the server so that it no longer matches the account ID stored locally, you cannot use any network features that require account authentication. This feature enables you to update the account ID stored locally to avoid this problem. To update the locally stored account ID to the one set on the server, rest the pointer on the target network account and select Replace Account ID with the One Changed on Server.

Note
Account IDs on the server can be changed from the Account Developer Portal.

You cannot update the locally stored account ID immediately after changing the account ID from the Account Developer Portal because the change is not detected right away. In that case, run password confirmation. Once the "Error:Account ID changed on server" error occurs, run it again.

Creating a Notifications Storage Region

To create storage used for BOSS notification tasks, select Create BOSS storage for notifications.

BOSS notification storage is created for each region setting of the console. Create BOSS notification storage only after having first set the region for your console.

This operation does not need to be performed each time the account is created. Create BOSS notification storage once when you first set the region and each time you change it thereafter. You must restart the console for your changes to take effect. Restart the console from the HOME Menu, or press the POWER Button.

Notes on Using the HOME Menu

The following irregular operations result if the HOME Menu is opened from the account manager tool.

You cannot open the HOME Menu if there are no accounts at all.

Important Information About Downgrading From Cafe SDK 2.13 and Later

In Cafe SDK 2.12.x and earlier, cafeupdate did not install the account manager tool in NAND memory. As a result, when downgrading from Cafe SDK 2.13 or later to 2.12 or earlier, the new version of the account manager tool remains installed in NAND memory. Each SDK package comes with an installation image for the account manager tool (at $CAFE_ROOT/system/bin/ghs/cafe/app/actmgr/NDEBUG/actmgr_p01). Make sure to install and use the version of the account manager tool that comes with the version of the SDK you are using.

Notice About Using NAND Boot Mode

In NAND boot mode, when an RPX is directly executed using caferun or a similar command after using the account manager tool, the system may jump to the application with the account unloaded. Either run cafestop once, or reload the account by launching System Config Tool before running the application.

Error List

If another error code of the form XXX-XXXX is displayed, check it against the error code list included in the Error Viewer package.