AlliedModders (
-   TF2Items (
-   -   TF2Items FAQ (

DarthNinja 02-28-2012 20:08

TF2Items FAQ
TF2Items FAQ
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~

I'm writing this because I frequently see the same questions being asked in the main TF2Items thread and IRC channel.
This post is intended to provide quick answers to the most frequently asked questions.

To install TF2Items on your TF2 server, you must first have SourceMod and by extension MetaMod installed.
After installing SM and MM and verifying they are running, download the TF2Items binaries from the Main Thread.
Extract the zip file and upload the folders to your server's sourcemod directory.
Modify the config file to do what you want. Details on this below.

Setting up your config:
You can tell the tf2items_manager what items to modify using the tf2items.weapons.txt config file. Items will be modified when they are equipped.
The included tf2items.weapons.example.txt includes some example syntax, but is non-functional. Create your own config file.
All attributes that can be used are found in the tf/scripts/items/items_game.txt file on your server. You may also view attributes in other ways, such as by adding ?d=1 to the end of a backpack link.

OPTF2 has a very nice attributes list, here:

Click here for an image showing most of the components of the config: TF2Items config explained

As said above, all the items and attributes in the game are listed in the items_game.txt file.
Here is an example to show you how to read it:
(I have added comments to the important lines)

Attributes listed in items_game look like this:


The "88" and "89" shown above are the attribute index you would use in your config.
What are valid values? The best way to find out is to try them yourself.
To make testing values for the configs easier, I have written a plugin that allows you to give or edit an item by command. This allows you to make quick changes without having to edit/upload/reload your config: [TF2Items] Item Designer.

Note on wildcarding:
You can use wildcards to apply a set of attributes to all items or all players using an asterisk (*) in place of a steamid or item index.

However, it should be noted that the plugin will stop when it finds the first applicable attribute set.
Because of this, any configs added below a wildcard will not be used since the wildcard handles the request before a more specific config is read.
By the same token, a specific config entry will override a wildcard if the former is higher in the config file then the latter.

It should also be noted that there is no way to wildcard only hats/wearables or only weapons using the base plugin. Such functionality is possible, but would require a custom plugin.
Q & A:
  • Question: Does TF2Items "give" me items?
    Answer: No. No plugin can give you items in the sense that they exist in your backpack.
    The bundled tf2items_manager plugin can edit items you have. The [TF2Items] Give Weapon plugin will allow you to equip weapons you do not have (although only you will be able to see them).
  • Question: How can I edit item names (like nametags do)?
    Answer: You can't.
  • Question: Where can I find a list of item qualities?
    Answer: They are listed at the top of the items_game.txt file, under "qualities". See also:
  • Question: I see min_value and max_value in items_game.txt... Can I set a value higher/lower than the min/max?
    Answer: Yes you can!


DarthNinja 02-28-2012 20:09

Reserved ~

FlaminSarge 03-20-2012 15:06

Re: TF2Items FAQ
You might want to add that the config is on a first-come-first-serve basis, so that wildcards will override anything beneath them.

Leonardo 03-20-2012 15:16

Re: TF2Items FAQ
may should make a wiki..?

xomp 05-18-2012 20:17

Re: TF2Items FAQ
Can you explain what preserve-attributes does? I'm in the process of making all my weapons have the turn to gold attribute and I would like to do so by simply adding that to there existing attributes that way I don't have to specify each and every weapons attributes + the gold.

FlaminSarge 05-24-2012 05:27

Re: TF2Items FAQ
That's exactly what preserve does, yes.

KnoXviLLe 08-02-2012 17:26

Re: TF2Items FAQ
How do change my hat colour ?

josko 08-17-2012 13:55

Re: TF2Items FAQ
Also, you can view attributes using this site:

Baklap4 03-05-2016 09:16

Re: TF2Items FAQ
Instead of a SteamID or Asteriks (*) can you also focus Groups (listed in Admin_groups.cfg)
If so, how?

asherkin 03-05-2016 20:17

Re: TF2Items FAQ

All times are GMT -4. The time now is 10:28.

Powered by vBulletin®
Copyright ©2000 - 2021, vBulletin Solutions, Inc.