/TF2-Trifecta

A combination of Wardrobe, Merc Deployer, and Bonemerge

Primary LanguagePythonMIT LicenseMIT

alt text

TF2-Trifecta

Opening a whole new way to create TF2 art for the masses.

What is the TF2-Trifecta?

The TF2-Trifecta is a combination of Wardrobe, Merc Deployer, and Bonemerge.

Wardrobe lets you index through a catalog of almost 10000 cosmetic files.

Deploy any of the nine mercs with Merc Deployer. You can choose to spawn from my port or Hectoris919's phoneme port.

Bonemerge is a Blender version of the "Easy Bonemerge Tool" for GMod.

The Setup

Installing the TF2-Trifecta and its prerequesites is as easy as pressing one button, followed by a few minutes of waiting.

Download the lastest release of the TF2-Trifecta and install the addon as a .zip file. Head to the preferences and click on the Add-ons tab. Click Install...

Find TF2-Trifecta.zip and install the .zip file.

Once installed, go to the Scene Properties and locate the TF2-Trifecta tab and expand the panel. At the bottom, you'll find a box where you can install the TF2 Collection.

After setting the path to an empty folder, you should be able to install the TF2 Collection just by pressing the install button. Enable Include Rigs if you wish. Wait a few minutes for everything to install and you should be good to go!

Location

You can find each tool in the side panel of the viewport.

Wardrobe

Wardrobe is like the world's largest closet known for how easy it is to search through it. To search for something, enter something into the search bar and click Search for cosmetics.

Click on a cosmetic button to spawn one in. Having a class selected while spawning a cosmetic will automatically bind the cosmetic to said class.

To match the colors of a class, click Use Lightwarps (TF2 Style) in the Material Settings. However, if you plan to use cycles for a render, do not click anything.

To closely match the TF2 look, use the Standard color transform instead of the Filmic color transform.

If paintable regions of a cosmetic appear solid black, go to Material Fixer/Selector and attempt to fix the material that is causing issues.

You can paint the active material using the Paints window.

Not all cosmetics are named correctly yet! Please report a cosmetic you wish to be renamed.

Merc Deployer

Deploy any of the nine mercs into your scene. You can choose between an advanced rigify (New) rig or a taunt compatible (Legacy) rig. You can read on how to import animations onto a rig in the Source2Blender docs.

Bonemerge

Attach cosmetics to a class by choosing a target armature and and selecting the cosmetics to attach.

Face Poser

(Only supported for my rigs!) The Face Poser tool is designed to control faces using my HWM scheme. the control layout is inspired by SFM, and functions similarly as well.

Face Poser

The tool supports both stereo and mono flexing, and uses a weight slider for stereo flexes. Stereo flexes use one slider who's value will always remain at 0. Any value given to the slider will be taken as additive and applied to the flex controllers they control.

The circular button is a shortcut for the auto-keyframing option. The diamond creates a keyframe on all sliders on the current frame. Upper, Mid and Lower can be used to filter out sliders. Switching to Shapekeys view will show all undriven shapekeys. Using Optimize Merc will remove all drivers on the shape keys, giving a small boost in performance until you wish to restore facial movements. At which point you will press Restore Merc

Pose Library

The Pose Library allows users to save and apply face pose combinations. This is very useful for fast lipsyncing or emotions. Upon applying a saved face pose, you can choose to keyframe the change. Enabling Reset All will reset the face before applying the pose. Enabling Keyframe Unchanged will keyframe the entire face, despite some areas not having been moved.

Face Randomizer & Lock List

The Face Randomizer does what the name says. However, the Lock List will prevent locked sliders from getting randomized. Find the slider you want to lock and press the lock icon,

Rigs

There are three official rigs that can be used with Merc Deployer: Mine, Eccentric's and ThatLazyArtist's. All of them are the same except for how they control the face. And their core, they are all a Rigify rig.

My set of rigs is meant to be controlled just like how you would control faces in SFM. Therefore, I say that my rigs are recommended for users with experience in SFM.

Eccentric's rigs use a face panel with control points over the face, making it closer to the industrial standard for animating faces.

ThatLazyArtist's use a face panel with sliders and switches off to the side. Although each slider may be vague in what part of the face controls, you can see the name of the slider in the top right corner.

Updating Files

You can easily update The TF2 Collection and rigs by going to Scene Properties > TF2 Trifecta Updater

End

Thank you Unhelpful Git for coining the name "TF2 Trifecta"