Importing Racer tracks

From VDrift
Jump to: navigation, search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Directions for importing Racer tracks

Note: These instructions are meant for Linux
  • Unzip and put racer files in temporary folder RACER_TP (temporary track path). Make sure the path has no spaces (dof2joe doesn't like spaces).
  • Create new folder for track in track editor folder TRACKEDITOR_TP.
  • Convert all texture names to lowercase in RACER_TP via
find . -type f -name \*.tga|sort -r|awk '{f=tolower($1);
if(f!=$1 && p[f]!=1){print "mv "$1" "f}p[$1]=1}' | /bin/sh
  • Make folder TRACKEDITOR_TP/objects/
  • Run the following command:
dof2joe/dof2joe -p TRACKEDITOR_TP/objects/ RACER_TP/*.dof

If there are thousands of .dof files, you may have to do this in steps to avoid a "too many arguments" error from your shell. This will take a while. Textures are automatically converted using nconvert. No filenames should have spaces.

  • Open track editor data/tracks/editor.config and set active track to TRACKEDITOR_TP.
  • Run the track editor. Trace the roadways and mark the starting position (press H for help).
  • cd to the TRACKEDITOR_TP/objects folder (this is important, the packfile stores relative paths) and run
joepack/joepack -c objects.jpk *.joe
  • Copy TRACKEDITOR_TP into the main VDrift tracks folder VDRIFT_TP. Erase VDRIFT_TP/objects/*.joe (since they are in the pack file).
  • Add VDRIFT_TP/about.txt and ensure that the first line is the name of the track.
  • Run VDrift and check out what the track looks like in-game. Note that you will only be able to drive on the roadways you defined in the track editor since no other surfaces have been flagged as collideable. Also take a screenshot for the track selection screen.
  • Add the track selection screenshot to VDRIFT_TP/trackshot.png (hopefully these png files will be moved into the folders of the individual tracks soon).
  • Open up all of the texture files in TRACKEDITOR_TP/objects and review which textures belong to objects that should be collide-able (roads and walls), have full brightness (trees), be mipmapped (fences and fine transparent objects should not be mipmapped), or be skyboxes.
  • Any textures that have transparent areas are usually colored #FF00FF in the Racer textures. You'll need to make these truly transparent in the PNG files. An easy way to do this is to use ImageMagick. Use the commands
mogrify -transparent rgb\(255,0,255\) *.png
mogrify -fill rgb\(128,128,128\) -opaque rgba\(255,0,255,0\) *.png

This can be scripted to speed things up of course.

  • Set the correct object properties using the trackeditor/listedit Listedit tool.
  • Done!