NWC24Editor

Introduction

NWC24Editor is a tool for referencing and editing the data managed by the NWC24 library in the Wii system memory. The following can be edited and referenced.

• Friend Roster
• Message box
• Download tasks

(To send and receive messages, you need to configure network settings separately.))

Running the Tool

elf

Change to the $REVOLUTION_EXT_ROOT/RVL/bin/tools directory and run the ndrun script with the NWC24Editor.elf file as an argument.

By creating the directories described below (/template, /misc) directly under DVDROOT and placing the appropriate files, you can reference them at execution time.

When running with .elf, note that NWC24Editor creates files and directories in the Wii system memory's home directory. Specifically, the following files and directories are created.

Always created at startup time.
    /title/00010000/30303030/data/hst           Directory
    /title/00010000/30303030/data/hst/app.hst   File
    /title/00010000/30303030/data/hst/grp.hst   File
    /title/00010000/30303030/data/hst/hex.hst   File
    /title/00010000/30303030/data/hst/num.hst   File
    /title/00010000/30303030/data/hst/txt.hst   File

Created when saving to Home at the Data View screen.
    /title/00010000/30303030/data/misc          Directory
    /title/00010000/30303030/data/misc/A_*.bin  File ('*' is a number)

wad

Convert into a .wad file with makeWad.exe, then import and run in Nmenu.elf. When converting data to a .wad file with makeWad.exe, place the archived files that include the appropriate files as content2 in the directories described below (/template, /misc) to reference the data at execution time.
For details on how to handle .wad files and content, see NADK.

A save banner is created in the home directory when NWC24Editor is run as a NAND application.

Using the Tool

The tool is operated using either the Wii Remote or a USB keyboard.

Basic Controller Operations

The NWC24Editor screen has white text on a black background, but there are regions with grey border and background. These regions can be manipulated by pointing at them with the Wii Remote's DPD and then pressing the A Button. There are a number of varieties: a button, a character and number input box, a value selection box, and others.

Controller Operation for Character and Number Input Boxes

Keyboard Operation

You can input ASCII characters and the following full-width items: numbers, hiragana, and katakana. You cannot perform kanji conversion.

Template Feature

There is a template feature to save time and effort for repeated input.

Create a /template directory directly below either DVDROOT, SD card, or the content2 root directory for a .wad file. By placing in this directory the files that have the names listed below, you can select and input the file's content in the corresponding input item.

Except for txt.txt, the files follow a common format: one line describes one item in ASCII. Each line is recognized through the following conditions.

• Numeric characters only
  -> Recognized as a decimal number.
• Hexadecimal number characters beginning with 0x.
  -> Recognized as a hexadecimal number.
• Other
  -> Recognized as a binary value for the character string being described.

The txt.txt text file format is encoded in UTF16BE; lines that include only the '-' character are treated as delimiters between items.

Examples of Each File

• num.txt

  100
  256
  0x20
  

• hex.txt

  0x1000
  0x1234
  123
  

• app.txt

  RSPJ
  RHAJ
  0x5253504A
  

• txt.txt

  Message Subject Template
  -
  https://wc24.nintendo.co.jp/rspj/hoge.zip
  -
  Since delimiting is done on hyphens,
  messages that include linefeeds
  can be also used.
  

Each of these files is loaded when NWC24Editor starts up. They can also be reloaded by selecting Tool from the top menu, then NWC24Editor, and finally Reload Template.

History Feature

There is one more feature to save time and effort for repeated input: the history feature.

Up to six input values are automatically saved for each input item type, and by choosing between these values you can save time for later input.

The history is saved in the Wii console NAND memory's home directory, and it persists across restart. To delete the history, select Tool from the top menu, then NWC24Editor, and finally Clear History.

Console

When NWC24Editor is run on the NDEV, debugging output is performed from the NDEV's serial port. Debugging output is stored internally. When the API returns an error for a reason such as a mistake in the input values, the console is shown on the bottom half of the screen for a fixed period of time, using orange characters.

The most recent five lines of debugging output are shown in the console.

You can check the console at any time on the NWC24Editor Information screen where the console is always displayed.

Screenshot

Top Screen

This is the screen immediately after NWC24 is started. The operational status of the WiiConnect24 system is displayed.

Controller Operations

Button

* x No.3 wireless AP-SSID DHCP
- - ---- -------- ------- ----
1 2 3    4        5       6

View

Friend Roster Screen

Displays a list of registered friends.

The "close" button, "friends", and "established" are displayed on the first line. A single friend is displayed on each line thereafter in index order.
The number of registered friends is shown by "friends". The number of registered friends for whom a friend relationship has been established is shown by "established". The "close" button closes this screen.

For all lines starting with the second, if a friend relationship has been established, the line will be displayed in a brighter font; otherwise, the line will be displayed in a darker font. In addition, the "del" button will be displayed at the beginning of the lines for which a friend relationship has been registered. If this button is pressed, the friend will be unregistered. In the index with a registered Friend, if it is a Wii Friend, "W", nickname, and a Wii number are displayed after the index number. If it is a Public Friend, "P", nickname, and e-mail address are displayed. Indices that do not have a registered friend will display "(empty)" appended to the index number.

The button displayed by each line's index number will open the Edit Friend screen, whether or not a friend has been registered for that index. Also, the button can be grabbed and moved by pressing the A Button and B Button together above it; this allows you to change the ordering of friends.

Edit Friend Screen

A friend's details can be displayed and edited.

The OK button sets the edited value in Friend Roster and closes the screen.
The CANCEL button discards the edited values and closes the screen without changing Friend Roster.

NWC24Editor Information Screen

Displays information related to NWC24Editor's execution environment. The console is always shown on this screen.

Create Message Screen

A new message can be created.

The Commit to SendBox button stores messages in the outbox.
The Commit to RecvBox button stores messages in the inbox.
The CANCEL button closes this screen without doing anything.

(Items with [Ver.3] are features that require Wii Menu Version 3 or later)

File Selection Screen

On this screen, you can select files to attach to a message.

Files directly under the /misc directory for all media are displayed in a list. A single line corresponds to a single file. The following items are displayed left to right on each line: the D button, Select button, file size, and a button that shows the file name. If files do not exist for a media, "(empty)" is displayed.

D button only deletes files on media that allow deletions.
Select button selects a file and closes the screen.
The button that shows file name will display the file in the Data View screen.

Data View Screen

The content of items, such as attached files, can be viewed.

The close button, Home button, SD button, file name, file size, and display mode are all displayed on the first line, in that order.
The close button closes the screen.
The Home and SD buttons save the currently displayed data to the home directory in the Wii console NAND memory and the misc directory on the SD card, respectively.
If the target data is determined to be UTF16-BE text, "UTF16BE" is shown in the display mode; otherwise, "ascii" is shown.

Beginning at the second line, up to 10KB of the data's content is displayed as text. It will be displayed as UTF16-BE if the display mode is "UTF16BE", and as ASCII if the display mode is "ascii". Wrapping is done as appropriate.

Message Box Screen

Displays a list of messages stored in the message box.

The create new message button and close button are displayed on the first line. From the second line on, messages in the outbox are displayed first, and then messages in the inbox are displayed.
Click on the create new message button to open the Message Create screen.
The close button closes the screen.

Beginning at the second line, a single message is displayed for each line. For each message box, "(empty)" is displayed if there is not even a single message. The del button is displayed at the beginning of each line, followed by the button displaying the message ID, sender's address, receiver's address, and subject.
The del button deletes the corresponding message. The button that includes the message ID displays the Message View screen for the corresponding message.

Message View Screen

Displays message details.

The copy & create button opens the Message Create screen, with the same contents as the currently displayed message already input.
The close button closes this screen.

For details on the Message Create screen and the common display items, see the Message Create screen description. Parts that differ from the Message Create screen are described here.

Detailed parameters are not displayed for items that are set as "no". For example, when "MBDelay" is "no", the value of delay time parameter is not displayed.

Download Task List Screen

Displays a list of registered download tasks.

The eight tasks for IDs 0-7 are reserved by the system and therefore not displayed.

Each of the following buttons are placed on the first line.

Numbers to the right of the optout all button show the number of tasks that have already been registered and the number of tasks that can be registered, respectively. The task count shown here includes system-reserved tasks. The number of tasks that can be registered is 32 (24 excluding system-reserved tasks) for version 2 of Wii Menu, and 120 (112 excluding system-reserved tasks) for version 3 of Wii Menu.

Beginning on the second line, the registration status for a single task is displayed on each line in the order of task ID. Each line is a button whose contents change depending on whether or not the task is registered. If a task is not registered, "empty" is displayed following the task ID. If a task is registered, the task ID, ID of the application that registered the task, and URL of the task are displayed, respectively. Additionally, the del button is displayed to the left of buttons that display a task ID.

A button that displays a task ID opens the Edit Download Task screen for that download task.
Click on the del button to delete the task.

Download Task Copy Screen

Download tasks can be copied.

First, select the copy source. Only the task ID with a registered task is displayed as a button. Select the task ID of the copy source and click on the button.

The task that has been selected as the copy source will turn into orange text, and all other tasks will turn into buttons. To copy a task from the copy source, click on the button for task ID of the copy destination. If you press the A Button anywhere other than on a button, you will return to the copy source selection.

The close button closes the screen.

Edit Download Task Screen

Details of a download task can be edited.

The CANCEL button discards edited values and closes the screen without changing the download task.
The OK button sets the edited value in the download task and closes the screen.
The do download button actually executes the download task.

(Items with [Ver.3] are features that require Wii Menu Version 3 or later)

Revision History

2007/09/03 Added the previously missing text about SD and controller operation.
2007/08/27 Initial version.

CONFIDENTIAL