FriendAddTool

The FriendAddTool reduces the workload involved in building friendships when developing software that uses the friend feature.

Specifically:

• It allows you to register friends by batch reading files that include the friend codes to be registered from an SD Card, when you want to test using the friend feature among several CTR handheld systems.
• It allows you to simulate situations where the friend list has become full by registering dummy friends, in cases where preparing a large number of devices might prove difficult.

If you want to register several friend codes, you can register them at once, by loading a file that includes those friend codes from an SD Card.

Registration Procedure

To register friends from an SD Card, first collect the friend codes of devices between which you want to establish friendships.
Next, save the collected friend codes to an SD Card as a text file (friend_code.txt).
Insert the SD Card into a CTR handheld system, start the tool, and batch register friend codes listed in friend_code.txt by executing "Register friends by list in SD".

Registering friends from an SD Card has the same result as if friend codes were entered by selecting the system feature Register Friend followed by Internet on the Friend List. This is only one-side of friend registration. The other system must also complete registration in order to establish a friend relationship.

Important

• Communication with the friend server is required to register friends.
  Be sure to make connection settings with the access point ahead of time under system settings.
• Even if friend registration is being restricted by Parental Control, this tool will ignore that restriction and register friends anyway.

Place the text file to be loaded (friend_code.txt) in the root directory of the SD Card.
Start the tool and press the load button. The file will be loaded from the SD Card and saved as a list inside the tool.

Friend codes to be registered should be listed one per line using single-byte numeric characters.
Friend codes will be loaded ignoring any single-byte hyphens and/or single-byte spaces that may be included.

Important

• Any lines that contain characters other than single-byte numeric characters, hyphens or spaces will be skipped.
• If the friend code of the system registering friend codes is encountered, that line will be ignored and the next line loaded.
• Up to 100 friend codes can be loaded from an SD Card. If the file contains more friend codes than that, friend codes past the 100th will not be loaded.
• The maximum size of this text file is 5120 bytes. If this file size is exceeded, no data will be loaded at all.

Example of friend_code.txt

012345678901
1234-5678-9012
2345 6789 0123

If you want to verify conditions when many friends have been registered, but can't ready enough separate devices to fully populate the friend list, you can simulate a full friend list by registering dummy friends.

Registration Procedure

Start the tool and execute "Register Dummy Friends." Dummy friends will be registered until the number of friends reaches 100.

Dummy Friends

The result of registering a dummy friend is the same as registering a friend by selecting the system feature Register Friend followed by Local on the Friend List.
As with a regular friend, you can obtain the friend key, Mii and Mii name, system profile, and friend relationships for a dummy friend.

Precautions Regarding Dummy Friends

Although a friend relationship is established, registration has only been made on the system running the tool. Status is, therefore, the same as if you have been removed from the other system's friend list. There is, therefore, no change in status regarding the friend being online, or that a Mii has been updated.
Furthermore, because the account does not really exist on the server, it cannot be used in server-based processing, such as, obtaining ranking information using the NEX library.

All friends (friends listed in friend_code.txt and dummy friends) can be removed at one time using these range specifications.

The number of friends, one's own friend code, and a description of operations are displayed on the upper screen. A log of operations and results are displayed on the lower screen.

The method of operations are as explained below.

Friend Registration

Button	Operation
A while holding down L	Registers Dummy Friends
A Button while holding down R Button	Registers friends listed on the SD Card.

Removing Friends

Button	Operation
X Button while holding down L Button	Removes dummy friends.
X Button while holding down R Button	Registers friends listed on the SD Card.
X Button while holding down L Button and R Button	Removes all friends.

Other Settings

Button	Operation
Y Button	Reloads data from SD Card.

2012/01/05

Initial version.