Raised This Month: $7 Target: $400
 1% 

TF2Items FAQ


Post New Thread Reply   
 
Thread Tools Display Modes
Author Message
DarthNinja
SourceMod Plugin Approver
Join Date: Mar 2009
Location: PreThinkHook()
Old 02-28-2012 , 20:08   TF2Items FAQ
Reply With Quote #1

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


Intro:
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.

Installing:
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 tf2items.com backpack link.

OPTF2 has a very nice attributes list, here: http://optf2.com/440/attributes

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)
Spoiler


Attributes listed in items_game look like this:

Spoiler


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: http://wiki.teamfortress.com/wiki/Item_qualities.
  • 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!

Notes:
~

__________________

Last edited by DarthNinja; 03-08-2014 at 02:51. Reason: OPTF2
DarthNinja is offline
DarthNinja
SourceMod Plugin Approver
Join Date: Mar 2009
Location: PreThinkHook()
Old 02-28-2012 , 20:09   Re: FAQ
Reply With Quote #2

Reserved ~
__________________
DarthNinja is offline
FlaminSarge
Veteran Member
Join Date: Jul 2010
Old 03-20-2012 , 15:06   Re: TF2Items FAQ
Reply With Quote #3

You might want to add that the config is on a first-come-first-serve basis, so that wildcards will override anything beneath them.
__________________
Bread EOTL GunMettle Invasion Jungle Inferno will break everything. Don't even ask.

All plugins: Randomizer/GiveWeapon, ModelManager, etc.
Post in plugin threads with questions.
Steam is for playing games.
You will be fed to javalia otherwise.
Psyduck likes replays.
FlaminSarge is offline
Leonardo
Veteran Member
Join Date: Feb 2010
Location: 90's
Old 03-20-2012 , 15:16   Re: TF2Items FAQ
Reply With Quote #4

may should make a wiki..?
Leonardo is offline
xomp
BANNED
Join Date: Jul 2008
Old 05-18-2012 , 20:17   Re: TF2Items FAQ
Reply With Quote #5

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.
xomp is offline
Send a message via Skype™ to xomp
FlaminSarge
Veteran Member
Join Date: Jul 2010
Old 05-24-2012 , 05:27   Re: TF2Items FAQ
Reply With Quote #6

That's exactly what preserve does, yes.
__________________
Bread EOTL GunMettle Invasion Jungle Inferno will break everything. Don't even ask.

All plugins: Randomizer/GiveWeapon, ModelManager, etc.
Post in plugin threads with questions.
Steam is for playing games.
You will be fed to javalia otherwise.
Psyduck likes replays.
FlaminSarge is offline
KnoXviLLe
Senior Member
Join Date: Nov 2011
Old 08-02-2012 , 17:26   Re: TF2Items FAQ
Reply With Quote #7

How do change my hat colour ?
__________________
Success is the ability to go from one failure to another with no loss of enthusiasm.

KnoXviLLe is offline
josko
Member
Join Date: Dec 2008
Old 08-17-2012 , 13:55   Re: TF2Items FAQ
Reply With Quote #8

Also, you can view attributes using this site:

http://wiki.teamfortress.com/wiki/Li...tem_attributes
josko is offline
Baklap4
Member
Join Date: Feb 2016
Old 03-05-2016 , 09:16   Re: TF2Items FAQ
Reply With Quote #9

Instead of a SteamID or Asteriks (*) can you also focus Groups (listed in Admin_groups.cfg)
If so, how?
Baklap4 is offline
Reply


Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT -4. The time now is 23:01.


Powered by vBulletin®
Copyright ©2000 - 2024, vBulletin Solutions, Inc.
Theme made by Freecode