Templates - Silverfeelin/Starbound-DrawablesGenerator GitHub Wiki

The generation methods Item Descriptor and Spawn Command use templates which they use to create an active item with drawables from.

In short, these templates are simply valid item descriptors for active items (weapons). The drawable parts are added on top of the template, which forms the complete and usable item descriptor.

Default Templates

Three templates are always available, and serve as the most basic templates you can use. Because rotations and other parameters are not set, the items will 'work' but most likely require additional configuration to match your desires.

• Common Pistol
• Common Shortsword
• Tesla Staff

Custom Templates

Custom templates can be found in the Templates folder. They're used to easily add (or change) templates. You can also share templates with other people this way.

LuAnimator.json

By default, one custom template is included.
This template can be used to quickly get the output from the LuAnimator tool into the game.

The items generated using this template can not be used as weapons, and will not rotate or change directions based on the position of your cursor. The template is based on a broadsword weapon.

LuAnimator Template

Adding Templates

To add your own templates, simply add JSON files to the Templates folder. The templates are only meant for active items, and must match a valid item descriptor.

A basic item descriptor that can be used as a template can be seen below. Note that the activeItemName must be changed to a valid vanilla active item name.

{
  "name" : "activeItemName",
  "count" : 1,
  "parameters" : {}
}

The tool adds generated drawable parts to /parameters/animationCustom/animatedParts/parts. If these parameters are not present, it will generate them. Existing parts will not be removed, to prevent vanilla item scripts from breaking.

Editing Templates

Templates can be edited in your favorite text editor, even with the Drawables Generator running.