Tutorial for rvglue

Back to index.

This is a very basic tutorial for the rvglue program.

Let's assume the following situation:

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. Re-coloring the blue walls is a bit more complicated. We have to translate 'bright red' into a hexadecimal triplet. The result is 'ff8080'. Now we can use the 'tecolor' (for 'track editor color') option:
    
    create( USER_abcdefgh )            
    
    editor.w( surface(mud) tecolor(ff8080) )
    
    
  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.