91 ratings
[Tool] ItemToast 1.3.1 : Easily repack your workshop models to create item replacements!
This is a guide to using the ItemToast tool, created for Workshop Contributors and modders who want to easily repack their workshop items or other mods as another model/skin or multiple models replacements.

The tool will assist making extremely easy and fast to take a model and recompile it into as many others models(items) replacements as you like.
Just in a few clicks, so you can easily pack and release your workshop items or any model as skin replacements for users.

Itemtoast also downloads the TF2 schema and backpack icons, so it always has the latest new items to recompile as.
ItemToast 1.3.1 Features
ItemToast downloads the TF2 item schema and backpack icons so its always up to date to be able to recompile your models as any items.

ItemToast can load workshop compiled files, even the ZIP file, it will get the models and materials, then you can make your selection of the items to recompile as from the TF2 schema items list and repack.

It will recompile the models, handle materials, backpack icon replacements and pack the replacements to VPK and then put everything into a ZIP file.

No need to manually compile, search for model paths, edit vmts etc with ItemToast you can recompile a model as many others and have it all packed for release, just in a few clicks!

Features list:
  • List and select cosmetic/weapon models by class and item slot type.
  • Download the TF2 Schema and icons to have all the latest items.
  • Easily load a model to recompile and pack models replacements for TF2.

  • Load models for repacking in several formats:
  • Workshop compiled ZIP
  • .VPK .MDL or QC
  • Drag and drop files to load models.

    Packing list:

  • Check the models replacement list, add remove and clear list
  • Define custom model paths and items name for replacements

    Packing options:

  • Define a packname for the pack and its VPK prefix name
  • Include backpack icons replacements

  • Pack models and materials to VPK
  • Pack models and materials to folders
  • Pack everything into a ZIP file for release
  • Automatically include a custom readme.txt in the pack

  • Pack materials individually to save space (this avoids duplicating VTFs for every model replacement)
Download & Installation
You will need to download and install the following in order:

Installing and Running ItemToast for the first time

Extract ItemToast zip file contents into a directory of your choice, make sure you have the "resources" folder in the same directory as ItemToast.exe.

The first time you will load ItemToast should automatically find your Steam and TF2 directories, if it doesn't you can always manually set the path with "select directory" in the "Settings" tab.

Click "Download Schema" at the bottom left, this will download the latest TF2 schema for the items list and icons.

You should be ready to use ItemToast if the SDK tools are properly installed, if problems come up see the "Troublshooting" section of the guide.

Using ItemToast Video
Using ItemToast
Itemtoast use goes like this:

  • 1-Load a model.
  • 2-Select items(models) to recompile as.
  • 3- Select backpack icons replacements if needed.
  • 4-Repack.
  • 5-Release your skin replacements!

ItemToast top Header

This section is divided in three parts, model selection, backpack icons, packing.

Loading a model:

You can load several types of files (ZIP, VPK, MDL, QC).

Workshop compiles in .ZIP files are supported and recommended for loading and repacking as they ensure a clean file structure and naming.

If you are loading an MDL or QC (the model should be compiled) make sure the model's materials exist in the directory structure "models/..." and "materials/models/...", if they do not exist the model won't be loaded since materials are obviously needed for repacking.
ItemToast analyses the MDL file in this case and looks for materials.

For VPKs, the vpk should only contain one model and its files to be properly loaded, this option is just there in case you download a model replacement and would like to repack it as something else.

Backpack icons:

If you load a workshop ZIP file the BP icons will automatically loaded and the selection buttons set to green with the corresponding VTF file name.

If you load something else, Itemtoast will try to look for the backpack icons, if none exist you can manually select the Small and Large VTF files for the backpack icon.
Itemtoast will generate the BP icons VMTs files for replacements.


Select your pack name, this will be the folder/zip name of the pack and the prefix name for the VPK files or folders containing a model replacement. (e.g: "MyMod_BonkHelm.vpk").

Selecting TF2 items to recompile as

When you load Itemtoast the icon list will be empty, you first need to select a class (Scout, soldier, pyro...) and then an item slot.
You can switch between item slots without loosing the selection and add other item types.

When an item is checked its added to the "repack models list" with its model name path and item name so these will be the models ItemToast will repack your model as.

How to install Packed items:

Once the items are packed the users should copy the VPKs into "Team Fortress 2\tf\custom\"

If the materials are packed individually (as default and recommended) they should also copy the "packname_Materials.vpk" at the root of the custom folder, along with the models replacements they would like to use.
I highly recommend packing materials invidivually, while its one extra file for the user to copy, it avoids duplicating materials files for every model, making the file size of your pack/download considerably smaller.
Updating the items list
Every time there's a TF2 update and new items are added ingame, you will need to click "download schema" (bottom left), ItemToast will download the new list of items and icons so that you can load all the new items.

If you are trying to update when the update is coming out, it is possible that the server is too busy may not respond sometimes during the update, ItemToast will throw an error, just wait a moment until the server is back up online to download the schema and icons.
  • ItemToast crashes when I start it!
    Make sure you have NetFramework 4[www.microsoft.com] installed.

  • ItemToast doesn't output files when packing
    If you are packing in VPK (see packing options in the settings tab) make sure the SDK Tools (in Team Fortress 2\bin\) are properly installed, the VPK packing tool comes with these tools and is needed to pack in VPK.

  • ItemToast cannot load a model
    If you are loading a QC:
    -Make sure the model is compiled and that the materials exist in the TF directory.

    If you are loading an MDL:
    -Make sure the model's materials exist in the same file structure where your model is and that they follow the TF structure "matetials/models/...".

    If you are loading an VPK:
    -The VPK should only contain one model, make sure the SDK tools (in Team Fortress 2\bin\) are installed so Itemtoast is able to unpack the VPK files.

  • Can't find the newest items
    You need to download the schema to get the latest items, click "download schema".

  • Problem/Solution is not listed here?
    Check the comments for solutions, if you still can't find it, post about it and I will try to help you, once a solution is found I'll add it to the troubleshooting section of the guide.

    If you found a bug and you see that it hasn't been already pointed out in the comments, post about it too.
< >
-=Lunk=- Dec 12, 2014 @ 8:06pm 
I have a question:
Can you use this to make item reskins? By this I mean making a mod that makes the Pirate Bandana into the Squids Lid.
Uncle Grumpskin Sep 26, 2014 @ 1:43pm 
hey, i get this error whenever i try to load a vpk or workshop zip http://i.imgur.com/QHuA5Mx.png
yo mama Sep 26, 2014 @ 11:05am 
nevermind i finally got it up and running
rockbone Sep 11, 2014 @ 7:36am 
Your pyro skin I mean
rockbone Sep 11, 2014 @ 7:36am 
Hey BANG! can you help me to install your skin in workshop please so I can play with your skin please
Queen Mary Poppins Aug 17, 2014 @ 1:59pm 
Can you make an alternative download link? The download is always unfinished every attempt I've tried to download it.
BANG!  [author] May 11, 2014 @ 4:40pm 
I think I found the problem, redownload itemtoast 1.3.1 I have updated the files and try it now, let me know, thanks!
norfolk terrier May 11, 2014 @ 1:51pm 
*That's whenever I repack, BTW
norfolk terrier May 11, 2014 @ 1:51pm 
Just upgraded to 1.3 and I keep getting this error: http://i.imgur.com/hOkuZhu.png
BANG!  [author] May 11, 2014 @ 1:41pm 
ItemToast 1.3 released:

-Backpack icons now properly packed when bp icons are manually defined when loading a .qc or .mdl (i.e for weapon mods)
-Fixed "Detect" steam/game folders unable to read "config.vdf" when "apps" not defined.
-Ionic zip DLL library no longer packed within the .exe to avoid anti viruses considering it a threat (now in the same folder as ItemToast.exe).