SWTOR Terrain Extractor - SWTOR-Slicers/WikiPedia GitHub Wiki

The SWTOR Terrain Extractor is a Windows command line executable tool that converts SWTOR "heightmaps" (they aren't technically such) to .obj format models. It is the result of UltimaKaosXIII's ongoing research on how the heightmaps are encoded, and as such it is a provisional tool until we get a better understanding of that data.

This guide is about how to use this tool to convert all the terrain maps in the game so that our Area Assemblers can automatically import them. It's something that hardly takes a couple of minutes in a modern PC with SSD storage, and we only need to do it every time a Game Update adds new locations to SWTOR.

WARNING: the results of the conversion take about 8.3 GB. Check that you have enough storage space in the drive where your assets extraction resides, as they can't be moved elsewhere unless as part of a whole resources folder.

Installation.

We go to the tool's Github repository's Releases page and check its first, most recent post (STE2 Beta 2.2 as of this moment). WE CAN DISREGARD THE RELEASE'S INSTRUCTIONS (they aren't relevant to our use case) and go directly to the bottom of the post: there is an Assets section listing the downloadable files available (if it isn't showing its contents, click on the "Assets" line).

Among the files there is a STEAreaAssemblerVersion.exe:

alt text

We download it and save it anywhere we want in our PCs.

alt text

How to use it.

  1. We can just double-click the downloaded executable file. If Windows throws a warning about not knowing where this executable comes from and blocks its launch, clicking on the More Information link will let us bypass the block and launch it anyway.

    alt text alt text

    A command line window (from Windows' cmd.exe application) will appear:

    alt text

  2. We enter the location of our SWTOR assets extraction's resources\world folder. If we are using File Explorer's "copy as path" contextual menu option on that folder to paste it in the command line window, it might happen that the path is surrounded with quotes. If that's so, we need to delete the quotes.

    For example, my path is D:\3D SWTOR\SWTOR ASSETS\SWTOR EXTRACTION 64\resources\world.

    alt text

  3. We press Enter. Before proceeding, the tool will ask for a final confirmation:

    alt text

  4. Pressing y ("yes") will launch the conversion.

    alt text

    It only takes about a couple of minutes in a modern PC with decently fast NVMe storage drives.

    alt text

    And that's it: we are done 🙂. We can press Enter to close the command line window.

Terrains and the Area Assembler tools.

The converted heightmaps are stored in a new folder placed at resources\world\heightmaps, as .obj files. The Area Assemblers will automatically detect them, with no need for user intervention. We'll be able to see them import the terrain objects through Blender's console.

Limitations.

At the moment, the converted heightmaps have the following issues:

  • No UV coordinates for correctly mapping textures.

  • They aren't seamlessly contiguous: one can often see fissures where the terrain objects meet with each other. Luckily, oftentimes they are fairly unnoticeable, but they can get to be very blatant.

    alt text alt text