JewelOfHarmonyType Configuration

This configuration file defines which items can be used in the Chaos Machine "Jewel of Harmony Item Smelt Mix" to create Refining Stones. It sets minimum item level requirements for items to be eligible for smelting. This config does NOT affect applying Jewel of Harmony to items; that is controlled by engine-level item category checks.

File Location#

Data/Item/JewelOfHarmonyType.xml

Dependencies#

Depends OnPurpose
ItemItem definitions by Category/Type
RelatedPurpose
JewelOfHarmonyOptionDefines the options and bonuses applied by Jewel of Harmony / Jewel of Elevation (separate system; does NOT consult this file)
ItemOptionRelated option fields stored on items
Item Option Index ReferenceReference for the option-index conventions used on items

How It Works#

Chaos Machine Smelt Mix (What This Config Controls)#

  1. Player places exactly one eligible item in the Chaos Machine and chooses "Jewel of Harmony Item Smelt Mix"
  2. Server enforces these checks on the item in the box:
    • Must not be a Set item
    • Must not already have a JoH option applied
    • If the item's Category/Type appears in this file, its enhancement level must be at least the Level attribute
    • If the item is NOT listed in this file, it passes the level check automatically (no level restriction)
  3. The mix success rate is read from server config (separate rate for normal vs. excellent items)
  4. On success, the item is consumed and a Refining Stone is produced:
    • Lower Refining Stone (14/43) if the source item is NOT excellent
    • Higher Refining Stone (14/44) if the source item IS excellent
  5. On failure, the Chaos Box is cleared and no stone is produced

Applying Jewel of Harmony (NOT Controlled by This Config)#

When players use a Jewel of Harmony to add options to equipment, eligibility is determined by the item's Category directly, not by this file:

  • Weapon: Categories 0-4, excluding items 4/7 and 4/15 (ammunition)
  • Staff: Category 5
  • Armor: Categories 6-11
  • Rejected: items already carrying a JoH option, Socket items, Lucky items (Category 7-11 with Type 62-72), Set items (unless SetItemAcceptHarmonySwitch=1)
  • NO enhancement level requirement is enforced here; items at +0 can receive JoH
  • See JewelOfHarmonyOption for the option pool and level-based option filtering

Structure#

<JewelOfHarmonyTypeList>
    <Item Category="0" Type="0" Level="4"/>
</JewelOfHarmonyTypeList>

Attributes#

AttributeTypeDescription
CategoryintItem category (0-14)
TypeintItem type index within category
LevelintMinimum item level (+0 to +15) required to smelt this item into a Refining Stone

Item Index Calculation#

ItemIndex = Category * 512 + Type

Category Reference#

CategoryItem Type
0Swords
1Axes
2Maces/Scepters
3Spears
4Bows/Crossbows
5Staffs
6Shields
7Helms
8Armor
9Pants
10Gloves
11Boots

Examples#

<!-- Swords must be +4 or higher to smelt -->
<Item Category="0" Type="0" Level="4"/>  <!-- Kris -->
<Item Category="0" Type="1" Level="4"/>  <!-- Short Sword -->
<Item Category="0" Type="2" Level="4"/>  <!-- Rapier -->

<!-- Axes must be +4 or higher to smelt -->
<Item Category="1" Type="0" Level="4"/>  <!-- Small Axe -->
<Item Category="1" Type="1" Level="4"/>  <!-- Hand Axe -->

<!-- Helms must be +4 or higher to smelt -->
<Item Category="7" Type="0" Level="4"/>  <!-- Bronze Helm -->
<Item Category="7" Type="2" Level="4"/>  <!-- Pad Helm -->

Most items require +4 enhancement before they can be smelted into Refining Stones.

Important Behavior#

Common Issues#

Last updated April 21, 2026