Resource Pack

From Terraria Wiki
Jump to: navigation, search
Desktop version Desktop-Only Content: This information applies only to the Desktop version of Terraria.

Resource Packs are add-on files which allow players to customize the game's sprites, music and translation.

Installing a Resource Pack[edit | edit source]

The Resource Packs menu.

Resource Packs can be installed by either being placed in the ResourcePacks folder, or by being downloaded from the Steam Workshop, where they will be installed and updated automatically.

The ResourcePacks folder can be accessed by pressing the "Open Folder" option in the Resource Packs menu in-game. This folder is generated when the game is launched.

  • On Windows Vista and later, %USERPROFILE\Documents\My Games\Terraria\ResourcePacks
    • On Windows XP, %USERPROFILE\My Documents\My Games\Terraria\ResourcePacks
  • On Mac, open Finder and press "Go" on the top. Then press "Go to folder...". Type in ~/Library/Application Support/Terraria/ResourcePacks
  • On Linux, $XDG_DATA_HOME/Terraria/ResourcePacks​
    • This is typically ~/.local/share/Terraria

Installed Resource Packs can be enabled from the Workshop Hub or by selecting the "Resource Packs" option on the main menu, where they can be moved between "Available Packs" and "Enabled Packs".

Creating a Resource Pack[edit | edit source]

Contents[edit | edit source]

Resource Packs require a pack.json file; otherwise, it will be not be recognized by the game. It may optionally include an icon.png file for display in the Resource Packs menu. A valid pack.json file will look like the following:

{
	"Name": "Pack Name",
	"Author": "Author",
	"Description": "Place a brief description of your pack here, line breaks can be input with \n",
	"Version": {
		"major": 1,
		"minor": 0
	}
}

Example folder structure[edit | edit source]

  • Pack Name
    • icon.png (optional)
    • pack.json
    • Content
      • Images
        • Acc_Back_1.png
      • Localization
        • en-US_Content.json
      • Music
        • Music_77.ogg

Images[edit | edit source]

Images are placed inside the Content/Images folder of the Resource Pack. They must share the same file name (albeit with a png extension) and canvas dimensions as the default images. 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/Contents/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.

Music[edit | edit source]

Music files are placed inside the Content/Music folder of the Resource Pack. They can be in either wav, mp3 or ogg format.

Localization[edit | edit source]

Localization files are placed inside the Content/Localization folder of the Resource Pack. They can be in either a csv or json format.

See also[edit | edit source]

History[edit | edit source]

  • Desktop 1.4.2.1:
    • Fixed an issue where MP3s used for replacing Music tracks would not loop.
    • Fixed an issue where replaced Music tracks would be significantly louder than normal tracks.
    • Fixed an issue where replacing Music tracks did not work on Mac (and possibly Linux as well, unconfirmed).
    • Fixed an issue that prevented the Title Bar messages from being changed by Resource Packs.
    • Fixed a loading issue with XNB assets in Resource Packs that prevented them from working properly.
  • Desktop 1.4.2:
    • Renamed to Resource Packs.
    • Added Steam Workshop integration, allowing the downloading and sharing of Resource Packs via Steam.
    • Expanded functionality to include language and music replacement.
  • Desktop 1.4.0.3: Fixed a bug where Texture Packs would not work on tiles without a game restart.
  • Desktop 1.4.0.1: Introduced officially as Texture Packs and can now be accessed via an option in the main menu.