AlliedModders - [TF2] Custom Weapons 2 (Beta 2, Mar 12 2014)

Valve still not adding new weapons to TF2? No problem. Custom Weapons 2 allows you to create your own weapons and let your players use them.

Once you've installed the plugin and some weapons, all players have to do is say /custom, /cus or /c for the list of custom weapons for that class.

It's somewhat like Advanced Weaponiser, except the creation, modification, and selection of weapons is not limited to a certain group of people; it's up to whoever installs the plugin.

You can create your own weapons with unique stats, and share them with other servers using Custom Weapons 2. Apply any Valve attribute you'd like onto your weapon.

Valve attributes not unique enough? Create your own attributes sub-plugin with ease. Each custom attribute added allows for more and more unique weapons to be created with it!

COMMANDS / CVARS

HOW TO MAKE CUSTOM WEAPONS

Creating a new custom weapon is plain easy. Simply duplicate a custom weapon's config file, and fill out its info with your own.

The weapon's name goes right at the top, in "quotes".
"classes" is the array of player classes the weapon should be available for; the number next to each class is the weapon slot (0 = Primary, 1 = Secondary, 2 = Melee)
"baseclass" is the classname of the weapon, without "tf_weapon_".
"baseindex" is the item index of the base weapon, see above classname link. If unsure, stick within the 0-30s.
If it uses ammo (i.e. most non-melee weapons) it should have "mag" and "ammo" keys with the intended starting ammo.
"logname" will be displayed in client consoles when a kill is made with the weapon. Not currently implemented.
"killicon", also not implemented yet, will be able to change the weapon's icon in the kill feed.
"description" is the stat list that players will see when selecting the weapon. \n = Newline. "\n \n" will skip an entire line.
"attributes"; the bread-n-butter. Each attribute has:
- An identifier, to set what attribute it is. This will either be a case-sensitive name (Custom Weapons, TF2Attributes) or an attribute index (TF2Items).
- "plugin": Who will provide the attribute's functionality?
  - For official Valve attributes, you'll usually want to use TF2Attributes, so put "tf2attributes". A select few attributes require "tf2attributes.int" instead.
  - If TF2Attributes doesn't work for said attribute (so far I've only seen "alt-fire is vampire" not work with TF2Att) then try "tf2items" instead, with the identifier being the number beside the attribute's name. (e.g. "move speed penalty" should instead be "54")
  - Or, of course, a custom attribute! In which case, "plugin" should be set to the name of the attributes plugin, minus ".smx". The starter pack includes "basic-attributes" and "custom-attributes".
- And of course, a value. Most attributes are multipliers; with "damage bonus/penalty", "2.0" is double (+100%), and "0.5" is halved (-50%). With time-based attributes such as "Reload time increased/decreased", "0.5" is half time (good), whereas "2.0" makes it take twice as long (bad). And some attributes are simply "1.0 = on, 0.0 = off".
  If you're unsure about values, check out a weapon that already has that attribute (Ctrl+F the official weapon's name in tf/scripts/items_game.txt, or just look at the custom weapon's config)

To Do: ~~Make a fancy schmancy guide for all that.~~ Make a weapon creator webform.

HOW TO MAKE CUSTOM ATTRIBUTES

QUESTIONS N' ANSWERS

INSTALLATION
Your server needs both TF2Items and TF2Attributes loaded.
1. Install customweaponstf.smx into your sourcemod/plugins/ directory.
2. Install tf2items.randomizer.txt into your sourcemod/gamedata/ directory.
3. Install whatever custom weapons/attributes/packs you'd like. You need at least one custom weapon for this to work, and most likely, that weapon will require an attributes plugin.
4. sm plugins load customweaponstf, or sm plugins reload customweaponstf when you install more.
5. Done!

DLC!
You need custom weapons (which usually require custom attributes) in order to run Custom Weapons. Why not start with these?

Weapons + Attributes
Starter Custom Weapons + Basic Attributes + Custom Attributes

Weapons
Half-Life 2 Weapons (requires Starter Pack)
WIP Weapon Pack (requires Starter Pack)
Workshop Weapons Pack

Attributes
NergalPak

CURRENT BETA STATUS

UPDATES

---
This is a beta of Custom Weapons 2. Think twice before adding it to your production server(s). It hasn't been fully tested in actual "combat" servers, and I'd like to get a better idea of what everyone thinks about specific features, weapons, and attributes.
Things might change completely, but I doubt it.
let's see if something's broken this time