• For issues you find with the Switch and Console releases, please follow this link and give as much detail as possible. This is the speediest way to get info to Pipeworks and get a hotfix in the works.
  • 1.4 will bring many changes to the PC version. We strongly advise making plans to back up your worlds and players prior to updating your game. More details here.
  • Begin your search for Journey's End information here and here. Please report bugs and issues for Journey's End here.
  • For issues you find with the Mobile 1.3 update, please follow this link and give as much detail as possible. This is the speediest way to get info to DR Studios to look at your issue. Also, some troubleshooting hints here.

Tool [Discontinued] TCCL - Terraria Custom Content Loader

Eikester

Official Terrarian

Terraria Custom Content Loader
Current Version 1.2.1
for Terraria 1.2.4.1



Note:
The Installer only works for Steam users, a GOG.com compatible version may be released in the future (probably after the 1.3 release)

Important:
since 1.2 Terraria has a huge amount of Files and due the way this Wrapper works all Files needs to be loaded, this is different to how Vanilla Terraria works and requires more Ram!


This Tool lets you load any Custom Content like Sprites/Fonts/Music/Sounds and allows to use multiple Texturepack at the same time

Features ^
  • Loads png files (also with XP Transparency Issue Fix!)
  • Loads fonts (xnb Format)
  • Loads Custom Music (Wave Banks)
  • Loads Custom Sounds (from wav)
  • while ingame using F5 reloads the whole Content, useful to see the changes without restarting the Client
  • converting xnb to png, simple drag the Content Folder over the exe, you will find the pngs in "Terraria\Content\PngImages"
  • allows using of more than one Packages at the same Time
  • change the loadorder of the Packages
  • Skip Splashscreen Option
  • Drag a zip/rar/7z file onto the exe to let the program install the Package
  • F1 Show/Hide the Package Selection Dialog whenever/wherever you want
  • F2 switches between Day/Nighttime, only for Singleplayer
  • F3 Starts Tetrarria if installed

Installation ^
Just download (e.g. to your Desktop) and run the Installer
Start the Program and right after the Splashscreen you should see the Dialog showing all
the available Packages. "Close" only hides the Dialog, to show the Dialog again use F1

This is the structure inside the Terraria Dir:



each Package has its own Folder stored in "Custom Content" as you see on the Screenshot.
the Subfolders of an Package have the same names as the Original Content Folders

"images" is used for "png" Files
"sounds" is used for "wav" Files
"fonts" is used for "xnb"-Font Files
and "Wave Bank.xwb" placed in Main Package Dir, "Example Package\Wave Bank.xwb"


Wave File Specifications ^
  • PCM-Wave-File
  • Only Mono and Stereo
  • 8 or 16 Bit
  • Samplerate between 8.000 Hz and 48.000 Hz

Downloads ^

Do Not Replace the 7z.dll that comes with this Download!

Changelog ^
Version 1.2.1
  • Updated for Terraria 1.2.4.1
  • Fixed crash when summoning Frost/Pumpking Moon
Version 1.2.0.8
  • Updated Installer to let you Install TCCL for Terraria 1.2.3.1
Version 1.2.0.7
  • Updated for Terraria 1.2.2
  • Added support for new Christmas Textures (Santank etc.)
Version 1.2.0.6
  • Updated for Terraria 1.2.1.2
  • Added missing Pumpking Textures
Version 1.2.0.5
  • Updated for Terraria 1.2.1.1
  • Added jackHatTexture
  • Added treeFaceTexture
Version 1.2.0.4
  • fixed Blue/Purple Screen if Window is resized/minimized/maximized
Version 1.2.0.3
  • possibly fixed invisible Textures in Fullscreen Mode
  • added "hidden" setting for the Cursor
    • you can now manipulate the Cursor Size by editing the TCCL.settings file
    • Cursors will overlap Mouse text if the Cursor is to large
  • Added 2 additional Buttons, the 3 Buttons are:
    • "Apply": changes only take effect after clicking this Button
    • "Close": simply closes the TCCL Window but keeps the selected Options
      • the changes will only take effect after the next start
    • "Cancel": closes the window and resets the previous settings
      • doesn't reset the Settings after clicking "Apply"
  • disabled Loading Dialog, causes the Window to minimize in Fullscreen
    • instead now shows a hourglass Cursor to indicate that the program is busy
Version 1.2.0.2
  • Improved Loading Time
  • reduced Ram usage
  • Added more Options to the Terraria's Cursor Menu
    • Cursor Type (4 different Cursors)
    • Cursor Border (On/Off)
    • Cursor Border Color
    • saved in Content\Images\ as Cursor_x.xnb
      • can be changed trough Texture Packs
  • new Config File (TCCL.settings)
  • new Look for the Loading Dialog
Version 1.2.0.1
  • Updated for Terraria 1.2.0.3.1
  • Added Old Furnace Pack
  • Changed Skin to a more Terraria style one
  • Added option to Install gli3 (Add to Game Launcher List)
Version 1.2
  • Updated for Terraria 1.2
Version 1.1.1.1
  • Added some missing Images
  • Added some missing Sounds
  • Updater: Should now run the Downloaded Installer if Download was succesful
Version 1.1.1.0
  • Added Support for Terraria 1.1.1 Update
Version 1.1.0.1
  • Installer:
    • Changed Shortcut from Url to Lnk, Music should now work when started trough the Shortcut
Version 1.1
  • Added Support for Terraria 1.1 Update
  • Added F2 switch Day/Night
  • Added F3 Starts Tetrarria (if available)
  • Saved last scrollbarvalue
  • Added Mousewheel support to Scrollbar
  • Improved Splash/Loading Screen
  • Simpler Install process, just run TCCLInstaller.exe and choose your Terraria Dir, creates a Shortcut on your Desktop
Version 1.0.6.7
  • Added ability to load outdated Wave Banks, missing Tracks will be replaced by default Terraria Tracks
Version 1.0.6.6
  • Added Loading/Splashscreen
  • Fixed Music started with small delay
  • Fixed Music sometimes doesn't load
Version 1.0.6.5
  • removed outdated Packages
  • Added last Version of WarStalkers HD Texturepack
  • Added "white box problem" solution, Thanks to player2k for sharing
Version 1.0.6.4
  • renamed to TCCL.exe
  • Added: compatibility to Game Launcher by player2k
  • Removed: unused code, resourcefiles and such things
  • Added: Manifest, now requires to run as Administrator
  • some reloading improvements
Version 1.0.6.3
  • Fixed Sounds
Version 1.0.6.2
  • Music should now work correctly without restart
Version 1.0.6.1
  • hopefully Fixed some DirectoryNotFound Exceptions on XP
Version 1.0.6.0
  • Renamed to TerrariaCustomContentLoader
  • Replaced GUI with Neoforce GUI
  • F1 shows/hides the Package Selection Dialog wherever/whenever you want
  • Added Method to Check if a new Update is available
  • Added Log Function
Version 1.0.6.0 pre Release
  • complete new GUI
  • "dynamic" Backgroundpreview (experimental)
  • alot of Bugfixes
  • it is now possible to change the Loadorder
  • fixed some problems/Errors when Reading Settings
  • changed back to Original Splash to support Custom Splashes/Logos
  • Added "Smooth Background"
  • Now you can drag a zip/rar/7z File onto the exe and it installs the Package automatically
Version 1.0.5.2
  • Added GUI
  • Disabled Updatemethod because i have trouble to fix some Errors, maybe added in again in an future Update
  • Mods now Stored in "Terraria/Custom Content", each mod has its own dir (like "Terraria/Custom Content/Example")
Version 1.0.5.1
  • Added Update method (checks on Programstart if a new version is available)
  • Added option to convert the Images to Pngs, output folder is "Content/PngImages"
  • Added support for custom sounds, atm only soundeffects, sounds have to be in folder "Content/wavs"
Version 1.0.5.0
  • Added support for Terraria 1.0.5
Version 1.0.4.3
  • Fixed a possible crash if using F5 in Splashscreen
  • Changed the Splashscreen
  • now F5 affects only pngs/images
Version 1.0.4.2
  • Fixed wrong assigned Treetops Texture
  • Added Reloadoption
Version 1.0.4.1
  • Added missing Image (Ninja, dont saw it <.<)
  • Added a second option telling the program the folder from where to load the pngs, simple give the program the same name the folder have, for example "eike.exe" loads from folder "content/eike"
  • again renamed to "TerrariaPngLoader", thats the final name xD
Version 1.0.4.0
  • Added support for Terraria 1.0.4 Update
Version 1.0.3.2
  • fixed some paths that causes some errors
  • supports now all images
  • added simple option to allow more than one pngs folder
Version 1.0.3.1
  • added some missing images
  • removed Console Window
  • removed widescreen function because Terraria now supports multiple Resolutions now
Version 1.0.3.0
  • Added support for Terraria 1.0.3 Update

Credits ^
  • Codeproject.com for 7zip wrapper
  • TomShane for NeoForce GUI System

Donations ^
You can donate to my Paypal if you like my work, i'd very much appreciate it, Thanks :)
 
Last edited:

N1NJ4M4573Rftw

Plantera
Well I don't know if the 1.2.4.1 Tccl Installer is Malware or not but to be on the safe side you need to check that out Eikester, i did try to download it, Norton removed it saying it was a un-safe file so i am not sure
 

N1NJ4M4573Rftw

Plantera
True I know, but norton keeps on removing the installer :/ so I can't really get Tccl...

Ok got it fixed nothing to see here move along xD
 
Last edited:

Snickerbobble

The Painter
TCCL opens normally for me, but as soon as I try to join a world, TCCL crashes. Started it again and joined a different world.. same thing, crashed again. Help?
 
Sorry to say I've got a problem I'm looking to solve as well.
5b306f1cb224c04f4e9290529e0243d7.png
This happens when I try installing tccl. I was wondering if having gamelauncher installed was causing this problem. I'll appreciate any help you can give. Thank you.
 

Snickerbobble

The Painter
So TCCL doesn't seem to play nicely with the auto-target cursor. Whatever cursor is selected obscures it.
That reminds me.. TCCL also seems to mess up the corona of the sun's texture. It gets all dark.

EDIT: Now TCCL doesn't load up at all.. I click on the desktop icon and it just brings up a crash error bug immediately, doesn't even open Terraria for a second.
 
Last edited:
I've tried installing TCCL again. I received the same error, but I did notice that when it attempted to add it to game launcher it said the version was 1.2.1, even when I used the 1.2.4.1 download link. Are the links mislabeled at the moment?
 

Darqfalls

Eye of Cthulhu
Am I the only one without bugs and issues?

Well, that isn't entirely true. Every time I reload something in-game, my music breaks and I have to restart TCCL

Now, I use a texture pack that replaces every texture, along with custom music, so it takes a bit to start up.

If there's a fix for this, please let me know. It prolly has something to do with load order, but that's the Skyrim modder in me speaking.

If I have to live with it, that's not a problem. I've lived through worse. It's just an inconvenience, y'know?
 

Snickerbobble

The Painter
Am I the only one without bugs and issues?

Well, that isn't entirely true. Every time I reload something in-game, my music breaks and I have to restart TCCL

Now, I use a texture pack that replaces every texture, along with custom music, so it takes a bit to start up.

If there's a fix for this, please let me know. It prolly has something to do with load order, but that's the Skyrim modder in me speaking.

If I have to live with it, that's not a problem. I've lived through worse. It's just an inconvenience, y'know?
IIRC the rain sound effect takes up a spot on the list, so leaving that out may mess up the music. I've never tried changing musics but I think I've heard of this problem before.
 

Darqfalls

Eye of Cthulhu
IIRC the rain sound effect takes up a spot on the list, so leaving that out may mess up the music. I've never tried changing musics but I think I've heard of this problem before.
I'm sorry but I have no idea what IIRC means.

Also, I'm pretty sure if you leave out something then you won't get any music at all. The volume will get stuck at zero. Case in point, try using some older music packs sometime.
 

Darqfalls

Eye of Cthulhu
I can't install it. says that I have an incorrect directory.
Did that for me at first too. Uninstall your Terraria folder in your steamapps or whatever, and then verify the cache.

Keep in mind that TCCL only works with the Steam version.
 

TCRanch

Steampunker
Did that for me at first too. Uninstall your Terraria folder in your steamapps or whatever, and then verify the cache.

Keep in mind that TCCL only works with the Steam version.
WHAT?!?!?! at 150 kbps download speed, I think i'll do without having to reinstall terraria!
 

Pseudoname

Terrarian
says I don't have a legal copy of terraria. I do it is for steam fully updated and it even found the folder because thats where it wanted to install to in the first place.
 
Top Bottom