Note: This page is for creating weapons that will be actually be usable within the live build of Team Fortress 2. Simply want to make a weapon concept by creating the weapon card? Click here!

TF2 Custom Weapon File Creator and Editor

What is this?

This is a tool intended to facilitate the creation of custom weapons that can be used inside TF2. It utilizes mrphil2105's TF2 Server Manager app to easily create a lan or automatically port forwarded server. I've installed and packaged all the files required to mod said server using the SourceMod plugin and the Custom Weapons X plugin to that plugin (created by nosoop). These tools were NOT created by me. This app simply helps you generate the VDF (Valve Data File) that Custom Weapons X uses to make the custom weapons usable in-game.

Step 1: Creating the file.

You can either upload a file you've already downloaded with this site, or create a fresh one by clicking the "Add weapon" button.

Upload add weapon

File name:

Step 2: Downloading your file.

This part is simple. Simply download the file. Hold onto it as you will need it in the next steps.

download

Step 3: Setting up your server.

1. First you need to download the server file by clicking here. It should download a "TFServer.zip".
2. Extract the zip file so that you have a TFServer folder with a ServerManager.exe in it.
3. Execute the ServerManager.exe file. Click "Allow" if your firewall asks you something.
4. Once the server manager app is open, click on the "add" button on the top left.
5. Enter a name of your choosing in the Name slot under general settings.
6. Enter "TeamFortress" in the "Folder" slot under general settings.
7. Click on the "apply" button under general settings.
8. Click on "run updater". It will prompt you to install SteamCMD, click "YES".
9. Once steam CMD has installed, go back to the app. Click on "start".
10. Once the server has started, click on "connect". It should launch Team Fortress 2 and put you in your new server.
11. Once you've verified that it works, leave the server and click on "stop" in the server app.

Step 4: Installing the pre-packaged plugins.

1. Click here to install a pre-packaged "tf.zip" file. Note that, if this pre-packaged plugin bundle doesn't work, it is likely because it is outdated. To fix it, delete everything and repeat step 3. Then, follow the instructions to install SourceMod, and Follow the instructions to install Nosoop's Custom Weapons X Plugin. Be sure to also follow the installation instructions for each of the dependencies specified each of these programs.
2. Extract the contents of that folder and drag them into ~\TFServer\Servers\TeamFortress\Server\tf.
3. Once extracted, you can change the map to tr_walkway_fix under general settings. You also need to put tr_walkway_fix.bsp in your client's maps folder (Typically located at C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps).

Remember to redo the installation steps 3, 4, and 5 when I update the zip files due to one of the dependencies having been updated. Check our discord server for when I update it. I'll ping everyone when I do.

Step 5: Installing your file.

1. Remember that file you downloaded in step 2? It's time to use it. Simply put it in the folder located at ~\TFServer\Servers\TeamFortress\Server\tf\addons\sourcemod\configs\cwx.
2. And you're done! Simply open up your server again by clicking "start", and then clicking "connect" once it has started. Once you're in the game, use the chat command "/cwx" in the normal text chat to open up the UI to select the weapon you've created.

Pro tip! Made changes to your weapons file? No need to restart the server! Simply paste this command into the server console: sm plugins reload cwx.

We need your help!

We need your help to report bugs! Most of them are likely due to the source Spaghetti monster, so I most likely won't be able to fix it since this web app is simply an abstraction layer. This app is currently in very very early alpha, and most features haven't been added yet. Please join our discord server to report bugs and get help!

Please help write the documentation for each attribute. Learn how here.

Credits

• Thanks to nosoop for creating the SourceMod plugin Custom Weapons X.
• Thanks to mrphil2105 for creating the TF2 Server Manger app.
• Thanks to all the people involved in creating the SourceMod mod manager plugin.
• Thanks to p0358 for creating a VDF parser in JavaScript that lets you convert VDF into JSON files and JSON files into VDF.
• Thanks to the Team Fortress 2 wiki for creating a table of every attribute coded in TF2. I wrote a script to copy that table into a JSON file that I wrote documentation for.
• Thanks to this website for being a table of item schemas. It was useful in the creation of my web app for making the "inherits" property.