Team Fortress 2

Team Fortress 2

103 ratings
[Tool] ItemToast 1.3.1 : Easily repack your workshop models to create item replacements!
By neodos
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 automatically recompile a model 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[] 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.
< >
neodos  [author] Jul 15, 2016 @ 11:45pm 
Yeah, Valve changed how the all class items are listed in the schema since the last update, not sure if I'll update itemtoast anymore though, its pretty old code, maybe if I can port some of the TFMV code into itemtoast, but I have no idea of how many people use this tool atm.
bazooka Jul 15, 2016 @ 7:43pm 
I noticed that all class items are slightly broken. They don't have their paths translated correctly. If I select "Ellis Hat_demoman" from the Item Schema tab, it still uses the scout model's path, "models/player/items/scout/scout_ellis.mdl". You can get around this by manually adding the correct model path in the Repack Models List tab.
[PLB] Suprito Burrito Dec 11, 2015 @ 2:52pm 
Bang, can I get a little assistance here with the materials thing? Either I'm not logically thinking or it refuses to work, whenever I attempt to load up a .mdl, it says I need to put the /materials in the tf/materials/... format, can you explain it/make it a little clearer, please?
^q^ king killer Oct 24, 2015 @ 5:31am 
We examined the problem. When press the button, it is not load page. It is loaded with only badge page.
neodos  [author] Oct 23, 2015 @ 4:09am 
Try using the "Select Directory" for steam and TF directory manually.
neodos  [author] Oct 23, 2015 @ 4:08am 
That's probably the issue, I see your windows is in Korean, so many the paths having these odd characters are causing the problem.

Can't fix that right now, see if you can change your windows settings so the paths have the "\" symbol instead of that W character.
neodos  [author] Oct 23, 2015 @ 4:06am 
What is wrong with your settings directory paths? the slashes \ are placed by a crossed W ?
neodos  [author] Oct 23, 2015 @ 3:37am 
Oh yes, don't run itemtoast while TF2 is running, restart itemtoast too.
^q^ king killer Oct 23, 2015 @ 3:31am 
um...Infinite loading....