Accessories

Adds a lightweight accessory system with a dedicated interface to manage your equipped accessories.

Equip accessories directly from your hand, manage them through /accessory, and start a first low-level progression with four starter accessories tied to life essence.

What the plugin adds

• A /accessory command
• A /acc alias
• An interface to manage equipped accessories
• Accessory bonuses
• Support for StatModifiers
• Support for Effects
• Support for DamageResistance

Available slots

The plugin currently supports 6 slots:

• 2 rings
• 1 necklace
• 1 belt
• 2 earrings

How to equip an accessory

Accessories are equipped directly from the item in your hand.

Single-slot accessories

• Necklace
• Belt

For those accessories, Primary and Secondary equip the same slot.

Double-slot accessories

• Ring
• Earring

For those accessories:

• Primary equips slot 1
• Secondary equips slot 2

Examples:

• a ring with Primary goes into Ring 1
• a ring with Secondary goes into Ring 2
• an earring with Primary goes into Earring 1
• an earring with Secondary goes into Earring 2

In game

1. Hold an accessory in your hand.
2. Use the interaction you want to equip it.
3. Open /accessory to see your equipped slots.
4. Remove an accessory directly from the interface if needed.

Current content state

The plugin currently provides a playable first low-level tier with four accessories:

• Iron Ring: small Health bonus
• Iron Earring: small Mana bonus
• Iron Necklace: some Health plus minor regeneration
• Leather Belt with an iron buckle: some Stamina plus light protection

The models are not cosmetic attachments and do not visually attach to the character.

Quick tutorial: add a new accessory

If you want to extend the plugin with your own accessory, here is the shortest path.

1. Create the item JSON

Place your item in an appropriate folder, for example:

• Server/Item/Items/Accessories/Ring/
• Server/Item/Items/Accessories/Necklace/
• Server/Item/Items/Accessories/Belt/
• Server/Item/Items/Accessories/Earring/

Minimal example:

{
  "TranslationProperties": {
    "Name": "caccessories.items.Accessory_Ring_Mythril.name",
    "Description": "caccessories.items.Accessory_Ring_Mythril.description"
  },
  "Quality": "Rare",
  "ItemLevel": 20,
  "Categories": [
    "Items.Accessories"
  ],
  "Icon": "Icons/MyAccessoryIcon.png",
  "Model": "Items/MyAccessory.blockymodel",
  "Texture": "Items/MyAccessory_Texture.png",
  "AccessoryProperties": {
    "Slot": "Ring",
    "StatModifiers": {
      "Health": [
        {
          "Amount": 15,
          "CalculationType": "Additive"
        }
      ]
    }
  },
  "Interactions": {
    "Primary": "Root_CA_Equip_Accessory_Primary",
    "Secondary": "Root_CA_Equip_Accessory_Secondary"
  },
  "InteractionConfig": {
    "AllEntities": true
  }
}

2. Choose the right slot type

Useful values for AccessoryProperties.Slot:

• Ring
• Necklace
• Belt
• Earring

3. Add translations

Add the keys to:

• Server/Languages/fr-FR/caccessories.lang
• Server/Languages/en-US/caccessories.lang

Example:

items.Accessory_Ring_Mythril.name = Mythril Ring
items.Accessory_Ring_Mythril.description = A fine ring that strengthens vitality.

4. Add bonuses

You can combine several types of bonuses:

• StatModifiers
• DamageResistance
• Effects

Resistance example:

"DamageResistance": {
  "Physical": [
    {
      "Amount": 0.05,
      "CalculationType": "Multiplicative"
    }
  ]
}

Effect example:

"Effects": [
  "FineCraft_CA_MythrilRing_Regen"
]

5. If the accessory grants an effect, also create the effect asset

Effects should be placed under:

• Server/Entity/Effects/...

Important notes

• For rings and earrings, make sure to use Primary and Secondary to target both slots.
• For a necklace or belt, both interactions can point to the same equip roots.

Planned next steps

• new accessory sets
• richer effects, variants, and progression