1. What is N64DD ROM Builder?

N64 Disk Drive ROM Builder is a tool for creating image files for the 64DD ROM File System.


2. Names of Each Part

The window that is displayed when N64 Disk Drive ROM Builder is started is called the Main Window. Here we give the name and provide a general explanation for each control located in the Main Window.

image
3. Work Flow

The overall work flow can be divided into three steps:

  1. Edit the directory structure
  2. Edit the ID area
  3. Generate a disk image file.

The following sections describe these steps in detail.


3-1. Editing the Directory Structure
3-1-1. Creating Directories

First, select the directory in which the new directory will be created from the directory tree. Next, select "Create Directory" from "Edit" on the menu. An "Enter Name" dialog window will appear. Enter the name of the directory being created click OK . Confirm that the new directory has been created by looking for its name in the directory tree.


3-1-2. Creating Files

First, select the directory in which the new file will be created from the directory tree. Next, select "Create File" from "Edit" on the menu. An "Enter Name" window will appear. Enter the name of the file being created here and click the OK button. Confirm that the new file has been created by looking for its name in the entry list.

At this point a file entry has been created, but you must now specify the file on the PC side. Select the file from the entry list, then select "Properties" from "Edit" on the menu to open the "Entry Properties" window. Click the Browse button to the right of the Source File item. This opens the "Select Source File" dialog box. Use this dialog to select the corresponding file. Mark the checkbox in the Source File item in the Entry Properties window to view and confirm the path name for the selected file. Click OK to close the Entry Properties window.


3-1-3. Copying the PC Directory Structure

You can create a group of directories and files if the structure you want to create in the N64 Disk Drive ROM file system is the same as the structure on the PC. Start Explorer, and drag & drop the pertinent directories onto N64 Disk Drive ROM Builder. The entire directory structure under the directory you have dropped will be created under the currently selected directory. At the same time, the files corresponding to the files on the PC will be set. This is the recommended method.


3-1-4. Changing Entry Names

Select the entry you want to rename from the directory tree and the entry list, then select "Change Name" from the Edit menu. When this is done, the name of the selected file becomes editable on the screen. Type in the name change and press the Enter key.

editing mode
File Name iin Editable State


3-1-5. Deleting Unnecessary Entries

Select the unnecessary entry from the directory tree and the entry list, then select "Delete" from the Edit menu. A window appears to confirm the command, so press OK and the selected file will be deleted.


3-1-6. Moving Entries

In the directory tree or in the entry list, select the entry you want to move and then drag & drop it onto the new parent directory.

Moving an Entry

Moving an Entry


3-1-7. Changing Entry Attributes

Attributes such as the various flags and the game code and company code can be set for each separate entry. When an entry is created, the attributes are set with the default values.

To change the attributes of an entry, first select the entry from the directory tree or entry list, and then select "Properties" from the Edit menu. Set the various items to the values you want in the "Entry Properties" window that opens up. Put a checkmark next to the items you want to change, then click the Update or OK button. Only the items that were checked will be changed.

If the selected entry has sub direcotries, "Change all sub directories" will be enabled. Changed will be applied to all the sub directories when this check box is checked on.


3-2. Editing the ID Area

Place the focus on the ID Area. To do this, click anywhere inside the ID Area. Next, select "Properties" from the Edit menu to open the "ID Area Properties" window. Here you can set the various attributes of the ID Area, but if at all possible set the "File Management Area Block Size" to the recommended value. If you set a larger value, disk area will be wasted. If you set a smaller value, the image file will fail to be generated. This recommended value changes, depending on the number of entries, so if you do something to change the number of entries, please reset this value.

Recommended File Management Area block size value
Recommended File Management Area block size value


3-3. Generating Image Files

Select "Generate Image" from the "Run" menu. You can then use the "Generate Image" window which opens to set the output file settings.

"Files Output from System Area" refers to the files output by the ID area and the Directory Entry area. "File Output from Data Area" refers to the file output from the actual data area of the file. Here you can specify the LBA range to be output and set numerous settings.

Move the mouse cursor to the list view below the "File Output from Data Area" item and click the right mouse button. Then select "Add" from the pop-up menu to display the "File Output from Data Area" window. Specify the file's path name and the LBA range in which the file is registered. Click OK, then verify that the file has been added to the list under the "File Output from Data Area" item. To the right of the "File Output from Data Area" item is a sentence in parenthesis which reads: "Specify between XX ~ XX" Please specify the LBA range in accordance with the indicated values. These indicated values will change when the disk type changes, so be careful when the disk type is changed.

After "Files Output from System Area" and "File Output from Data Area" have been specified, click the Run button. When this is done, a window with the caption "Creating" will open, indicating the progress of the process. At the end, "Normal Termination" will be displayed and the caption will change to "End." Congratulations! Creation is complete.

Restriction on the LBA Specification
Restriction on the LBA Specification


3-4. Loading and Saving Project Files

The data concerning the directory structure created on N64DD ROM Builder and the entry attributes can be saved to a file and recreated by reading from a file. This file is called the Project File.

At startup, an "empty" Project File is targeted. Since this Project File has no name (actually, it has the name "<NONAME>", but this is ignored as a file name), please select "Save As..." from the File menu when saving the file.

To read a saved Project File in order to recreate a certain work environment, select "Open" from the File menu.

After saving a Project File with "Save As..." or after you have loaded an existing Project File with the Open command, then saving the file with Save from the File menu will overwrite the present Project File and save the current environment.


4. Setting the Default Values

Attributes such as the game code for entries made with the Drag & Drop function take on the already-set default values. However, these default values can be changed.

To do this, select "Set Default Values" from the Settings menu. Set the default values in the window that opens. After making the settings click the OK button to end the process.


5. Setting the Root Path

Each file has a corresponding source file on the PC. The source file path is specified by the file path, but when the path is handled as a relative path it can be more convenient, such as when sharing source files on a network.

For example, the source files could be collected under "c:/project/game" on Machine 1, and this could become a shared folder that is designated as the F: drive on Machine 2. Then if Machine 2 wants to read a Project File created on Machine 1, you simply substitute f:/ for the path c:/project/game. The "Set Root Path" function is designed specifically for this purpose

To use this function, select "Set Root Path" from the Settings menu. A window opens, enabling you to set the root path. Since numerous root paths can be set, a number of columns are provided, starting with path 0. Insert "c:/project/game" in the open space and push the Update button. Next, push the "Remove References" button in order to delete all source file root path references. Now press the "Restore References" button. When this is done, all source files under the root path registered in the current Project are handled relative to this root path. Thus, if you substitute "f:/" for "c:/project/game" and press the Update button, then all the source files which up to this point were located under "c:/project/game" are now handled as if they were located under "f:/".


6. Reflecting Only Specified Files in the Image File

As the number of files increases, the time needed to generate the image file also increases. If you only make changes to one or two files, it would be a waste of time to go back and redo the entire image file again. Thus, a function has been provided to rewrite only those files that have been changed in the image file.

To do this, first select the files you want to rewrite from the directory tree and the entry list. Next, right-click on either the directory tree or the entry list to open the pop-up menu. Now select "Update." The same window opens that is displayed when an image file is generated, indicating the progress of the process. At the end, "Normal Termination" is displayed, and the changes are complete when the caption changes to "End."

This function cannot be used if the file that is to be updated is larger than it was before the changes were made. But the function is useful when handling files with graphics data etc. which is frequently changed but does not change the file size.


7. File and Directory Names

File names have the format name.ext, where name is a string of 1 to 20 characters and the extension is a string of 0 to 5 characters. If the filename has no extension, then the dot delimiting the name and extension can be omitted.

Directory names comprise a string of 1 to 20 characters. These names have no extension.

Nearly all of the characters in the DD's internal font can be utilized for file and directory names, with the exception of the forward slash ("/"). In addition, the dot (".") cannot be used for the extension. Also note that N64DD does not support some symbols.

Characters Decimal Hexadecimal
2-byte characters
1st byte range
2nd byte range
129~152
64~126, 128~252
81~98
40~7e, 80~FC
Single-byte katakana
Byte range
161~223 A1~DF
ASCII/JIS Romanji
Byte range
32~126 20~7E

The Range of Usable Characters for Entry Names
8. Errors
8-1. "Incorrect name"

This error occurs when the name of the file you want to change or the directory name does not conform to the rules of the N64 Disk Drive ROM File System. Please use a correct name.


8-2. "Cannot open management information file"

This error arises when either the output file is not specified or the image file does not exist when updating.

The first thing to do when this error occurs is to select "Generate Image" from the Run menu, open the Generate Image window, and confirm that files are specified in the "Files Output from System Area" item and in the "File Output from Data Area" item. If either is missing an image cannot be generated.

Updating can only be performed for an image that has already been generated one time. So if specified output file is not there, generate the image file again.


8-3. "Data file is not defined"

The Data Area output file has not been specified. When this specification is not made, the system does not know which LBA to create data in, and the image data cannot be generated.

Select "Generate Image" from the Run menu, open the Generate Image window, and right-click inside the list view below the "File Output from Data Area" item. Select "Add" from the pop-up menu to specify the output file.


8-4. "No space in data area"

This error can occur when the image is being generated, or when the system tries to add a new file during updating.

Select "Generate Image" from the Run menu to open the Generate Image window, and then increase the space between the Register Start LBA and the Register End LBA in the "File Output from Data Area" item. You cannot specify a range larger than that indicated in the "Specify between XX ~ XX" message, so if you get the same error even after specifying the maximum value, that means you have insufficient disk space.