Tutorial for rvglue

This is a very basic tutorial for the rvglue program.

Let's assume the following situation:

• You just downloaded that weird zip file.
• You just created a track with the track editor, and found out that it is in the 'USER_abcdefgh' directory.
• And you want your track to feel muddy, and have textured walls instead of the blue ones.

One way to achieve happiness would be:

(1) Installing the program

1. Unpack the zip file.
2. Open the 'System' folder inside your 'Windows' directory.
3. Copy the .dll file from the archive into this folder.
4. Open the 'Command' folder inside your 'Windows' directory.
5. Copy the program ('rvglue.exe') into this folder.

(2) Renaming track file

1. Open the track's folder, 'USER_abcdefgh'.
2. We have to rename the tracks body, since we want the current file to be a source only. Rename 'USER_abcdefgh.w' to 'editor.w'.

(3) Writing a command file for rvglue

1. We have to write a small 'command file' that tells rvglue what we want him to do. Start notepad.
2. Now we type in what the program should do. We want to create a new track's body, that is intended to replace the original one. The first command tells the program to write 'USER_abcdefgh.w' and 'USER_abcdefgh.ncp'. Write this into the notepad window:

   create USER_abcdefgh

3. We want the program to read the track body the track editor created. So we type some more:

   create USER_abcdefgh editor.w

4. We want to change some properties of the track body, and have to append a list of options within a block in brackets '(...)':

   create USER_abcdefgh editor.w( )

5. Now we can start to write our options. To make the track feel muddy, we use the 'surface' option:

   create USER_abcdefgh editor.w( surface mud )

6. Texturing the blue walls is a bit more complicated. We have to use the option wall_single or wall_double depending on how we exported the track. Let's assume the track is single-sized. We want the walls to use a part of texture sheet J.bmp, at the top left corner (0,0), and 128x128 pixels sized:

   create USER_abcdefgh editor.w( surface mud wall_single j:0,0:128x128 )

7. Now the command file is complete. Save it into the track folder with a name like 'command.txt'.

(4) Writing a batch file

1. Now we need another file to start rvglue. Start a new file with notepad.
2. This file contains only one line that starts rvglue and tells it that it's command file is named 'command.txt':

   rvglue command.txt

3. Save this file into the track directory with a name like 'runglue.bat'. The suffix '.bat' is important!

(5) Running rvglue

1. The program can now be executed by double-clicking the 'runglue.bat' icon in the folder view.
2. If there is an error message, check all previous steps.
3. You should now have all-new 'USER_abcdefgh.w' and 'USER_abcdefgh.ncp' files inside the track folder.