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 On | Purpose |
|---|---|
| Item | Item definitions by Category/Type |
| Related | Purpose |
|---|---|
| JewelOfHarmonyOption | Defines the options and bonuses applied by Jewel of Harmony / Jewel of Elevation (separate system; does NOT consult this file) |
| ItemOption | Related option fields stored on items |
| Item Option Index Reference | Reference for the option-index conventions used on items |
How It Works#
Chaos Machine Smelt Mix (What This Config Controls)#
- Player places exactly one eligible item in the Chaos Machine and chooses "Jewel of Harmony Item Smelt Mix"
- 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)
- The mix success rate is read from server config (separate rate for normal vs. excellent items)
- 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
- 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#
| Attribute | Type | Description |
|---|---|---|
Category | int | Item category (0-14) |
Type | int | Item type index within category |
Level | int | Minimum item level (+0 to +15) required to smelt this item into a Refining Stone |
Item Index Calculation#
ItemIndex = Category * 512 + Type
Category Reference#
| Category | Item Type |
|---|---|
| 0 | Swords |
| 1 | Axes |
| 2 | Maces/Scepters |
| 3 | Spears |
| 4 | Bows/Crossbows |
| 5 | Staffs |
| 6 | Shields |
| 7 | Helms |
| 8 | Armor |
| 9 | Pants |
| 10 | Gloves |
| 11 | Boots |
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.
<!-- Require +7 for high-tier items -->
<Item Category="0" Type="22" Level="7"/> <!-- Rune Blade -->
<Item Category="5" Type="10" Level="7"/> <!-- Grand Soul Staff -->
High-tier items may require higher enhancement levels before smelting. This prevents players from easily farming Refining Stones from powerful items without significant enhancement investment.
If an item is NOT listed in this file but has an eligible category, it can be smelted at any level (+0 and up):
<!-- If Gladius (0/3) is not in the file, it can be smelted at +0 -->
This allows admins to control which items require enhancement investment before smelting.