FineCraft 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
Support for DamageCauseEnhancement

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

Hold an accessory in your hand.
Use the interaction you want to equip it.
Open /accessory to see your equipped slots.
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

These accessories are crafted at the dedicated Accessory Bench.

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"
    }
  ]
}

DamageCauseEnhancement example:

"DamageCauseEnhancement": {
  "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