Subscribe to download
Composite Bonemerge Tool

The Composite Bonemerge Tool (CBT) is an advanced bonemerge tool that lets you modify bonemerged models with any vanilla or custom tool after bonemerging them with other model. The bonemerged models' data will be automatically available when you use your favorite tools, as if they truly were a single model. This includes the following data: body groups, skins, submaterials, flexes, eyes, bones and attachments.

Additional cool features:

• Models are added, removed or detached with menus in an intuitive way.
  
• We can change the position, angle and scale of child models from within a PAC3-style editor.
  
• Bonemerged models' color can be changed in the editor.
  
• Players, NPCs and NextBots preserve the models that were attached to them when they die.
  
• Everything is saved correctly in dupes and saves.
  
• Flawless ghost preview.

This tool fixes many of the bugs of the Easy Bonemerge Tool as well, for example:

• Halos are drawn smoothly across parent models and their children (see the images above).
  
• When you attach something to yourself, there aren't bugged shadows in first person view.
  
• When you remove a child model from its parent, the child's shadow is removed instantly.

• R-click: Select the model you want to add or remove models from.
  
• L-click: Add something to the model on which you right-clicked. Clicking on the selected model allows for removing the models that you merged with it before. KEEP IN MIND THAT THE MENUS WILL ONLY APPEAR WHEN YOU HOLD YOUR C KEY.
  
• Reload: Select yourself as the model you want to add or remove models from (click again to remove models from yourself).

It's possible to make very complex models with infinite depth. For example, you can bonemerge a prop to another prop that you've already bonemerged before, and so on.

• sv_compositeentities_enable: Enable/disable scripted models (those that are created with LUA scripts). See info for developers.
  
  
• sv_compositeentities_childboneediting: By default, the feature that lets you transform bones of child models using bone tools is disabled. It can be enabled with this ConVar (set it to 1). Anyway, some bone tools have built-in features for child bone editing (Ragdoll Mover), so you could just use them directly. You should disable this if it causes problems with other addons.

The CBT includes an internal system for bonemerging models automatically when they're spawned using small LUA scripts. The child models specified in these scripts will ALWAYS spawn, even in playermodel selectors. This way, we can make custom playermodels, NPCs, ragdolls, or whatever we want.

Personally, I use this feature for creating very complex models that couldn't have been compiled with Studiomdl (too many vertices, more than 32 materials...).

In order to use this system, you just need to call a special method called addModel in a hook called CompositeEntities_AddModels. This function is used to register a model and returns a registration ID. Then, you can add child models to that model by calling the function again. It has the following parameters:


As an example, this's the script I used for my Velikan playermodel. This code was added to a file within the "lua/autorun" folder.

Use this along with Overhauled Bone Tool to do head swaps. Enable the "Scale child bones" checkbox for better results. Remember that sv_compositeentities_childboneediting must be set to 1.