[FlaminSarge]

Allows players to equip custom models. Let's not get Valve to shut this down, now, shall we?

Thanks to Damizean, this is basically his TF2 Equipment Manager plugin except with a model changer instead of a hat equipper.
Thanks to Sazpaimon for model conversion research.
Thanks to Pimpinjuice for reskin conversion research.

UPDATE 01/12/2012. SMX only.

Cvars

• tf_models_admin - Only administrators can use the models.
• tf_models_admin_flags - Having one of these flags marks you as an administrator.
• tf_models_admin_override - Administrators can override the model restrictions.
• tf_models_announce - Announces usage and tips about equippable models.
• tf_models_announce_plugin - Announces information of the plugin when joining.
• tf_models_force_admins - Forces the default model for admin users.
• tf_models_force_users - Forces the default model for common users.
• tf_models_delayonspawn - Amount of time to wait to re-equip a model after spawn. Apparently for compatibility with old melee plugins
• tf_models_blocktriggers - Hides the chat (!mm) plugin triggers so they won't be spammed on the chat.
• tf_models_list - Change the config file used to make the item list. Useful if you want to have a different set of models for each map.

Commands:

• tf_models - Shows the model management menu.
• equip - Shows the model management menu (Alias).
• mm - Shows the model management menu (Alias).
• em - Shows the model management menu (Alias).
• equipmodels - Shows the model management menu (Alias).
• tf_models_equip <target> <name> - Forces to equip a model onto a client. Don't need quotes around <name>, and it searches for a model in the list. Exact matches come first, then if more than one is found, it tells you what it found and asks for the command again.
• tf_models_remove <target> - Forces to remove a model on the client.
• tf_models_lock <target> <1/0> - Locks/unlocks the client's model so it can't be changed.
• tf_models_override <target> <1/0> - Enables restriction overriding for the client.
• tf_models_reload - Reparses the items file and rebuilds the model list.

Installation:

• Unsupported for anything below SM 1.4
• You need to have the clientprefs extension for SourceMod (it's a stock SourceMod extension, if I remember correctly)
• Place TF2_ModelManager.smx in addons/sourcemod/plugins/
• Place TF2_ModelManager.phrases.txt in addons/sourcemod/translations/
• Place TF2_ItemList.cfg in addons/sourcemod/configs/TF2ModelManager/
• Once all of these are placed, either do 'sm plugins refresh' in console, change the map, or restart the server. Then, go to tf/cfg/sourcemod/TF2_ModelManager.cfg and change any cvars you want to change.
• If you're compiling yourself, you need exvel's colors.inc file. You'll also need the latest SM 1.4 tf2.inc and tf2_stocks.inc file.
• Ignore the tag mismatches when compiling, I have no idea :/

Add items using the instructions in the TF2_ItemList.cfg file. You NEED to populate this config with models to have models. You can create more cfg files in the same folder with different names and change the tf_models_list cvar to those names, in order to change up the model list. Basically, multiple item lists, but TF2_ItemList.cfg is the default. The one provided comes with an example model.
READ ABOUT .dep FILES HERE. YOU NEED THESE FOR CUSTOM MODELS (models that aren't already in the game files. models/gman.mdl IS already in the game files, FYI)

CHANGELOG
01/12/2012(v1.0.2)
*Fixed admin checks not working
*Allowed /mm, /em, /equip, /equipmodels, and /tf_models to be overridden in admin overrides.
*Changing class without respawning should now be accounted for in the plugin (will check on regen/locker touch)
*Accounted for Bootlegger not being a hat

08/17/2011(v1.0.1)
*Changed up the way items are found when using tf_models_equip
*Fixed IsValidClient
*If an admin forces a client to equip a model, and the client has the override flag, the model equips as opposed to rejecting based on class/team/etc.
*Brought back the /em alias because I am so used to it.
08/13/2011(v1.0.0)
*First release

Demonstration (created by Rowedahelicon, ONLY FOR PEOPLE WHO DO NOT DISLIKE PONIES AND STUFF)
http://www.southerncrossgaming.org/updates/modelplugin/

[FlaminSarge]

===TUTORIAL FOR CONVERTING MODELS/SKINS===
Another something put here for safekeeping, relevant, do not attempt without professional supervision

While the tutorial says to use the stockmodels files, the TF2 update on October 8, 2012 broke this method. You will have to use the files from models/player/<class>.mdl, e.g. models/player/sniper.mdl. In addition you will have to use the MDL Hexer to change the model's path internally to your custom model path. Finally, you will have to grab the .sw.vtx, .dx90.vtx, .dx80.vtx, .vvd, and .phy files from the same place, copy them to your custom model location, and rename them to your custom model name (if you didn't just use the stock model name but in a custom folder).

For example: I want to reskin the Sniper to the Christian Brutal Sniper.
I copy the following files from tf/models/player/ to tf/models/player/saxton_hale/
sniper.mdl
sniper.phy
sniper.vvd
sniper.sw.vtx
sniper.dx90.vtx
sniper.dx80.vtx
I rename all the files to be "cbs_v9" instead of "sniper".
I use the MDL Hexer to edit the skin in sniper.mdl.
I use the MDL Hexer's second tab to edit the model that "player/sniper.mdl" is to be "player/saxton_hale/cbs_v9.mdl".
Done.

When using custom SKINS (as in, texture-only replacements), please use the following models as a base, with this plugin to make them download to clients. With this, then even people who use custom-model skins for their stock classes will be able to see the skins. Otherwise, they'd normally be invisible.

http://dl.dropbox.com/u/9948007/stockmodels.zip
The paths are the same as the default models, except with _stock appended (so models/player/scout_stock.mdl).

SO, USE THESE .mdl FILES INSTEAD OF GRABBING THE STOCK TF2 ONES FROM THE GCF WHEN PORTING SKINS.
For some reason these models' mouths don't animate for vocalizations. Nothing I can do about it.
This is still a better solution for the issue with people using clientside skins than making each model have its own extra files.

stockmodels.sp last updated 06/18/2012

[eraserhead]

Excellent work Flamin Sarge.

[jameless]

Glad to see this. Can't wait to have some fun with it.

[SmackDaddy]

Where would be a good place to find/download models to use with this? A list of places could be helpful in promoting this plugin as well Sarge. Thanks for the time you take for these plugins!

[Snaggle]

Gonna check this out tonight and have some fun, thanks very much.

[loranger]

is latest sm 1.4 files (tf2.inc & tf2 stock.inc) compatible with saxtonhale 1.35?

[FlaminSarge]

Loranger: yes. But this isn't the saxton hale thread.

Smackdaddy: I'll put up info on how to make custom models. Hopefully we can get it so that we don't have a million unique filepaths for what really is the same model. Mecha the Slag's model hexing plugin is a nice shortcut of the method I use to convert skins to custom models for use with this plugin.

[r3dw3r3w0lf]

This plugin looks very interesting, i will be testing it out soon as well. :]

[scopesp]

wow great
thank you will try later