Track Uploader

From BallisticNG Wiki
Jump to: navigation, search

The "Track Uploader" is a small program that allows you to convert your tracks into a workshop track file then upload them to the workshop.

It is also used to update already-uploaded tracks.

Before anything, ensure you have built track files for both Windows & Mac/Linux.

1. Open the program[edit | edit source]


  • You are logged into Steam
  • Steam is NOT in offline mode
  • The BallisticNG game is closed (you can only have the game OR this uploader program open)

Launch "Modding\Track Uploader\BallisticNG Track Uploader.exe" as admin.

Note: when the program first opens, it may ask you to select a folder. Select your "BallisticNG\UserData\MyTracks" folder then click OK.

Interface[edit | edit source]

The interface is split into two panels.

On the left side is your list of tracks in the MyTracks folder you selected and a local folder to the program that contains your workshop track files.

The right side is the settings panel.

  • When you select a .trk file it will present to you a convert button
  • When you select a .wtrk file you will be presented with the workshop settings

2. Prepare your track for the workshop[edit | edit source]

  1. Select your track name on the left pane
  2. Click "convert to workshop file" (on the right pane)

Technical remarks[edit | edit source]

  • If you have already "converted" the track file in the past, you will be given the option to just go to the converted file.
  • TRK is a Unity Asset Bundle and nothing else. This is the file that you get when you compile your track.
  • The WTRK file (workshop TRK) is a file that contains information for the file on the Steam Workshop, a file location for the preview image and the whole Unity Asset Bundle.

3. Workshop item settings[edit | edit source]

  1. The thumbnail
    1. Click "Select image"
    2. Choose a PNG file (JPEG is not supported)
  2. Set the track files to be uploaded
    1. Click the "Update DX9" button
    2. Navigate to your "BallisticNG\UserData\MyTracks" folder
    3. Double-click your DX9 track (this is a track file loaded on Windows machines)
    4. Click the "Update OGL" button
    5. Navigate to your "BallisticNG\UserData\MyTracks" folder
    6. Double-click your OGL track (this is a track file loaded on Mac/Linux machines)
  3. Set the title and description
  4. Add the "Track" tag (to help people search for your track on the workshop)
    1. Click the "+" button
    2. Type in "Track"
    3. Click "OK"

4. Upload data to workshop[edit | edit source]

  1. Click the "Save" button
  2. Click the "Upload" button
  3. Tell the workshop why you are uploading (example: "initial upload", "made hill steeper")
  4. Click "OK"
  5. Wait for the upload to finish. 6 MegaByte TRK files can take 1 - 3 minutes.
  6. When your internet browser opens to your new workshop item, the upload is done

Troubleshooting "E_LIMIT_EXCEEDED"[edit | edit source]

  • Sometimes you may get an error popup saying something like "E_LIMIT_EXCEEDED".
  • In this case:
    • Close the Track Uploader program.
    • Quit (not close) steam entirely. This means clicking "Steam > Exit", and not just closing the window.
    • Logout & log into Windows again.
    • Re-login into Steam.
    • Re-launch the Track Uploader.
    • Follow steps 1 - 2 again.
    • For step 3, only set the DX9 track file and title. This means NOT setting the OGL track file, a tag or a thumbnail.
    • Follow step 4.
    • When it successfully uploads, you can finally add the:
      • OGL track file
      • The "Track" tag
      • A thumbnail
    • Then follow step 4 again to upload these new changes.
  • If you still get the error, you'll need to reduce the size of your thumbnail (either by making the image smaller, or reducing the PNG quality)