Garry's Mod

Garry's Mod

Tool Trees
 This topic has been pinned, so it's probably important
dim sum un  [developer] 18 Jan @ 7:37pm
Frequently Asked Questions/Concerns
Are saves/dupes supported? If so, what is saved?
Entities (and their bonemerged props), which are modified by the Color, Model, and Material Trees, will save their appearance (color, advanced color, skin, bodygroups, (sub)materials, models) between GMod saves and dupes. Dupes with some effects (such as hat paint, crit glow, or cloak effects) will only load if the addon has been installed. Otherwise, those effects will not occur.

Where can I find these tools?
These tools are found in the Render category, along with their OG counterparts.

Why may I need these tools?
Previously, users who needed to modify a bonemerged prop would need to
  1. Remove the bonemerged prop from the entity,
  2. (Spawn, and then) Modify the bonemerged prop, and
  3. Bonemerge the prop back to the entity.
These tools remove step 1 and 3 of this process, instead allowing the user to directly modify the prop on the entity. Depending on if your scene contains props bonemerged onto props bonemerged onto entities, these tools, nonetheless, can access and modify these nested props in one step. If you are interested in saving time, perhaps you might find this tool useful!

Notably, if the right addon is installed, the Color Tree tool supports material proxy modification and submaterial coloring (through the Advanced Colour Tool), allowing one to directly paint a hat or apply a cloak effect on multiple entities in one step. Previously, the user would need to removed bonemerged props and set these effects per prop or before the bonemerge. Again, if you like to save time, you could consider using this tool.

For animators: I originally made these tools as anticipation for animating bonemerged entities, particularly their color, skin, bodygroups, and materials. Currently, Stop Motion Helper does not support this feature, but it will soon; stay tuned!

What is the difference between this tool and the OGs?
These tools closely resemble their OG GMod counterparts, but with some differences.
  • The user can modify an entity's bonemerged props.
  • The user must right-click on an entity to start modifying it; in contrast, they no longer need to left-click on an entity to set a color or material.
  • Colors and material changes happen immediately upon clicking on the color mixer in the Color Tree or by clicking on any of the materials in the Material Tree.
  • Submaterials are presented in a gallery, rather than a list like the SubMaterial or Advanced Colour tools.
I moved the toolgun's left-clicking and right-clicking actions to the UI. Changes to the UI, either by clicking on the color mixer, selecting a material, or moving the skin and bodygroup sliders, are immediately reflected on the entity. This is intentional because I think the user would benefit from an immediate one-step change, rather than two trial-and-error steps.

As for the Color Tree's supported addons, it can also modify the proxy colors and access some of their console variables (such as the Cloak Effect Tool's cloak factor and refraction values). I did not provide the list of TF2 paints from the Hat Painter because I think one can obtain these colors by simply referencing the original list.

How do I use these tools?
While the video demonstrates the use of these tools, the best way to learn how to use them is to play around with them. The UI in these tools closely resemble the GMod tools and some popular Workshop tools, such as the bonemerged entities panel in Advanced Bonemerge Tool, the color mixer from the OG Color Tool, and the material list in the OG Material Tool. Hover over the UI and read the tooltips for more details.

How do I remove material proxies, colors, materials, etc.?
In one of the Tree Tools' entity hierarchy panels, right-click on the name of the entity or bonemerged prop. A context menu will pop up, which provides options to Reset colors, remove material proxies, reset skins and bodygroups, and reset (sub)materials.

I found a bug! Where should I report this?
If this is a small bug, you can report it in the forum here. If this is a severe bug, report it in the issue tracker[github.com]. Try to visualize the problem with screenshots or describe it in words, and give me a list of steps to reproduce the bug.

I still have problems with trying to do 'X' with the tool. What can I do about it?
You are allowed to post a thread about it in discussions. Of course, you can post it in comments, but it will be inconvenient to have to scroll through other comments to find the one that has the problem.
Last edited by dim sum un; 19 Jan @ 6:23am