Texture Pack

Desktop-Only Content: This information applies only to the Desktop version of Terraria.

This page describes experimental Terraria features.
Features described below may be subject to change or removal in future Terraria updates, and may not function perfectly. Use with caution. It is recommended that you back up your world and player files prior to enabling or using these features.

The Texture Pack feature enables the use of alternate graphics. This feature is experimental, and requires that "UseExperimentalFeatures" is set to "true" in the config.json settings.

Activating Experimental Features

To activate experimental features, you will need to edit your config.json file:

• To find your config.json file:
  • On Windows, the config.json file is found in Documents\My Games\Terraria ("%USERPROFILE%\Documents\My Games\Terraria")
  • On Mac open Finder and press "Go" on the top. Then press "Go to folder...". Type in ~Library/Application Support/Terraria. There you should find the config.json file.
  • On Linux, the config.json file is found in $XDG_DATA_HOME/Terraria​
    • This is typically ~/.local/share/Terraria
• Open config.json with a text editing program.
• Change the line labeled "UseExperimentalFeatures" to true. It should look like the image on the right when it's ready.
• The next time you launch Terraria, these features will now be functional.

Texture Pack Support

Texture packs, for those unfamiliar, are add-on files, usually created by players for themselves or others, which change the appearance of some or all of a game's content. This could include weapons, enemies, NPCs, furniture, even the player. This allows a range of options to a player, from as little as simple tweaks to an item or two, to a full, sweeping redesign of the entire game's art.

Creating and Installing a Texture Pack

• Texture pack files are saved as .zip files (with no password).
• Texture pack files must be placed in the following directory:
  • On Windows, Documents\My Games\Terraria (C:\Users\%username%\Documents\My Games\Terraria)
  • On Mac open Finder and press "Go" on the top. Then press "Go to folder...". Type in ~Library/Application Support/Terraria
  • On Linux, $XDG_DATA_HOME/Terraria​
    • This is typically ~/.local/share/Terraria
• For the texture pack to be detected and loaded it must be named Texture Pack.zip and be in the specified directory above. On Windows, the correct name and folder would look something like the image to the right.
• The texture pack needs to contain only an Images folder. In the Images folder, any texture you include will replace Terraria's texture of the same path and name.
• Replacement textures should be saved as png, gif, or jpg. These are the image formats currently supported for this experimental version of the feature.
• An example file can be found here. The zip file contains some basic texture images, as well as a sample zip file (named Texture Pack.zip) which can be installed to practice and test out the feature. The test pack replaces Wood blocks and walls.

Image File Names

The new images must share the same file name as the default images (albeit with a png extension). The default Terraria images can be located here:

• On Windows Steam version, C:\Program Files (x86)\Steam\steamapps\common\Terraria\Content\Images.
• On Linux Steam Version, ~/.steam/steam/steamapps/common/Terraria/Content/Images
• On macOS Steam version, Library/Application Support/Steam/steamapps/common/Terraria/Terraria.app/MacOS/Content/Images.
• On GOG version, C:\GOG Games\Terraria\Content\Images.
  • Tip for Mac users: To open and view the contents of Terraria.app, right click and select "Show Package Contents"

These default images are stored with the xnb file extension. TConvert can be used to extract the default xnb images as png files for viewing, editing, and saving.

History

 Desktop version

• Desktop 1.3.4.2: Introduced.