Skip to content

Gem Combinations

Nischhelm edited this page Feb 26, 2025 · 7 revisions

Gems can be combined to gem combinations. Gem combinations are defined in the gemcombinations folder.

Properties

Gem Types

This is a list of gems found in the gemtypes folder (file names). The gem combination will be applied if an item has the gems named in this list.

Display Name

required, lang key recommended

Works the same as for gems, this is how the gem combination will be called in the items tooltip

Text Color

default gray

Also the same as in gems, the color of how the combination and its effects will be rendered in the item tooltip

Effects

Also the same as in gems, list of Gem Effects

Application options

Socketed allows for various ways of how gem combinations work.

Strict Order

default false

If set to true, the defined gems have to be in the given order to create the gem combination effect

Strict Count

default false

If set to true, the defined gems have to fit exactly into the items sockets. So a gem combination that is made from three gems will require the item to have exactly three sockets.

Allows Wrapping

default false

Sockets are placed circularly around the item in the socketing gui. However, there is a start and end of the socket list, starting from the top socket and going clockwise. If this option is set to true, the defined order of gems can wrap around the end point of the sockets, using an actual circular system. Only matters if using strict order.

Replaces Original Effects

default true

If set to false, the defined effects of this combination will add on top of the individual gem effects. In the default case, the combination effects replace the original gem effects.

Example:

{
  "Display Name": "socketed.tooltip.wiki.testcombination",
  "Text Color": "BLACK",
  "Strict Order": true,
  "Strict Count": true,
  "Allows Wrapping": true,
  "Replaces Original Effects": false,
  "Gem Types": ["wikigem1","wikigem2","wikigem3"],
  "Effects": [
    {
      "Effect Type": "Attribute",
      "Equipment Slot Type": "ALL"
      "Attribute Name": "generic.armor",
      "Modifier Amount": 1,
      "Modifier Operation": 0,
    }
  ]
}

Clone this wiki locally