How to Crop a Texture Atlas into Individual Sprites (Atlas Cropper)

Warhammer: Vermintide 268 views1 favorites2 min readby ChadMasodinUpdated 2 JunView on Steam ↗

Step 1: Prepare the Files

To start, you will need to extract the texture atlas itself. You can find detailed instructions on how to do this in this guide.
https://steamcommunity.com/sharedfiles/filedetails/?id=2208764780
Personally, I use an old-school but proven method using NinjaRipper and Noesis Model Viewer.

Once everything is set up, find the texture atlas you need (for example, an icon atlas) using Noesis. Don't forget to export the atlas from .dds to .png format and give the file any name you like (e.g., atlas_123).

Next, you need to download the corresponding VT Lua atlas file:
  • For VT1, they can be found here[github.com]
  • For VT2, they can be found here[github.com]
As a result, you should have two essential files: the atlas itself (in .png format) and its configuration file (in .lua format).

Step 2: Set Up the Google Colab

Now, let's move on to the Atlas Cropper script itself. It is hosted on Google Colab at this link.
https://colab.research.google.com/drive/1f-5ycnvLnwCQTkbMSnAxUSH4gXAbo8r6?usp=sharing
  1. Make sure to log into your Google account and click the Connect button in the top right corner.

  2. Wait a moment for a green checkmark to appear, indicating a successful connection.
  3. Go to the Files tab (the content folder) on the left sidebar.

  4. Create a new folder there and name it gui_{atlas_name}_atlas_temp. Replace {atlas_name} with the actual type of the atlas, based on the name of the downloaded .lua file. In my case, it will be gui_icons_atlas_temp.

  5. Drag and drop the atlas (.png) and its config file (.lua) directly into the root content folder.

Step 3: Edit and Run the Script

After uploading the files, you need to update the {atlas_name} and {image_id} parameters in the script code:
  • For {image_id}, enter your image file name (in my case, atlas_123).
  • For {atlas_name}, enter the atlas type (in my case, icons).
Ultimately, the line of code should look like this:


Cell Execution Order:
  1. Run the very first code cell. If a warning from Google pops up, simply click Execute.

  2. Run the second cell.
  3. Don't rush to run the third cell! First, you need to change the image name and atlas type inside it. In my example, the final function call looks like this: extract_atlas_sprites("atlas_123", "icons").

  4. Now you can run the third cell. The sprite extraction process will begin.

Step 4: Download the Results

Once the script finishes running, a .zip archive containing the extracted sprites will appear in the Colab file manager. To download it, click on the three dots next to the file and select Download.


And you're done! All that's left is to unpack the archive on your computer to easily browse the images.

Bonus Information

On top of that, we have created a GitHub repository containing all the sprites extracted from the VT1 and VT2 atlases:
https://github.com/Vladm0z/Vermintide-2-Atlases

We will try to update it periodically so that you can view which images have been added or deleted.

If you have any questions left, feel free to ask them in the comments below!

This guide was created by its original author on the Steam Community. Are you the author and want it removed? Request removal.