JewelOfHarmonyOption Configuration

This configuration file defines the available Jewel of Harmony (JoH) enhancement options, their bonus values at each level, and Zen restoration costs.

File Location#

Data/Item/JewelOfHarmonyOption.xml

Dependencies#

Depends On	Purpose
Item	Provides item categories and per-item Strength/Dexterity requirements used during option filtering

Related	Purpose
JewelOfHarmonyType	Controls which items can be smelted into Refining Stones in the Chaos Machine (separate system; not used to gate JoH application)
ItemOption	Related option fields stored on items
Item Option Index Reference	Reference for the option-index conventions used on items

How It Works#

Jewel of Harmony (Normal Items)#

Player applies a Jewel of Harmony to an eligible item
Server determines item type group: Weapon, Staff, or Armor (see Category Eligibility below)
Selects a random option from that group using Rate weights
Filters out options whose Level attribute exceeds the item's enhancement level
Filters out Sub Require Strength / Sub Require Dexterity options when the item has no such requirement
Stores option in the item's JoH option byte: upper 4 bits = option index, lower 4 bits = JoH level
Initial JoH level equals the option's Level attribute (a Level=7 option starts at JoH level 7 with Value7 bonus)
Smelt Stone can later increase the JoH level

Jewel of Elevation (Lucky Items)#

Works only on Lucky Items
Rejected if the target item is already JoH'd or is a Socket item
Set Item restriction is NOT enforced for Elevation (only for Jewel of Harmony)
Same option selection process as Jewel of Harmony
Initial JoH level is set to the item's enhancement level, capped at 15
Smelt Stone is effectively useless afterward because the JoH level already equals the item's enhancement level, and Smelt Stone refuses to raise the JoH level past the item's enhancement level
Allows high-Level options to start with high bonuses immediately on a high enhancement item

Smelt Stone Upgrade#

Increases the current JoH level by 1 on success
On failure, the JoH level is reset to the option's base Level attribute (not to 0, and not preserved)
Cannot upgrade if current JoH level is already at the item's enhancement level
Cannot upgrade if current JoH level is already 15 (maximum table index)
Lower Refining Stone uses one success rate, Higher Refining Stone uses a separate (typically higher) rate

Structure#

<JewelOfHarmonyOptionList>
    <WeaponOptions>
        <Option Index="1" Name="Add Min Physical Damage" Rate="50" Level="0"
                Value0="2" Value1="3" ... Value15="20"
                Money0="100000" Money1="110000" ... Money15="500000"/>
    </WeaponOptions>
    <StaffOptions>
        <!-- Staff-specific options -->
    </StaffOptions>
    <ArmorOptions>
        <!-- Armor-specific options -->
    </ArmorOptions>
</JewelOfHarmonyOptionList>

Attributes#

Attribute	Type	Description
`Index`	int	Option index within the section (1-15)
`Name`	string	Display name (informational)
`Rate`	int	Selection weight (higher = more likely)
`Level`	int	Minimum item enhancement level required to roll this option, and the initial JoH level once applied
`Value0-15`	int	Bonus value at each JoH level (0-15)
`Money0-15`	int	Zen cost to restore (remove) JoH at that level

Category Eligibility#

JoH application checks the item's category directly. JewelOfHarmonyType is NOT consulted for the application path; it only affects the Chaos Machine Smelt Mix that creates Refining Stones.

Group	Categories	Notes
Weapon	Categories 0-4	Excludes item 4/7 and item 4/15 (ammunition)
Staff	Category 5	All items
Armor	Categories 6-11	All items at the category check

Additional exclusions applied to ALL groups during Jewel of Harmony application:

Items that already carry a JoH option are rejected
Socket items are rejected
Set items are rejected unless SetItemAcceptHarmonySwitch=1 is set in server config
Lucky Items (Category 7-11 with Type between 62 and 72) are rejected; they use the Jewel of Elevation path instead

Weapon Options#

Index	Name	Effect	Level Req
1	Add Min Physical Damage	+value to min physical damage	0
2	Add Max Physical Damage	+value to max physical damage	0
3	Sub Require Strength	-value Strength requirement	0
4	Sub Require Dexterity	-value Dexterity (Agility) requirement	0
5	Add Physical Damage	+value to both min AND max physical damage	7
6	Add Critical Damage	+value to critical damage	7
7	Add Skill Damage	+value to skill damage	10
8	Add Attack Success Rate PvP	+value to attack success rate in PvP	11
9	Sub SD Rate	+value% to enemy SD decrease rate	10
10	Add SD Ignore Rate	+value% chance to ignore enemy SD	13

Staff Options#

Index	Name	Effect	Level Req
1	Add Magic Damage	+value to min and max magic damage	0
2	Sub Require Strength	-value Strength requirement	0
3	Sub Require Dexterity	-value Dexterity (Agility) requirement	0
4	Add Skill Damage	+value to skill damage	7
5	Add Critical Damage	+value to critical damage	7
6	Sub SD Rate	+value% to enemy SD decrease rate	10
7	Add Attack Success Rate PvP	+value to attack success rate in PvP	11
8	Add SD Ignore Rate	+value% chance to ignore enemy SD	13

Armor Options#

Index	Name	Effect	Level Req
1	Add Defense	+value to defense	0
2	Add Max BP	+value to AG (Stamina) pool	4
3	Add Max HP	+value to maximum HP	4
4	Add HP Recovery	+value to HP regeneration	7
5	Add MP Recovery	+value to MP regeneration	10
6	Add Defense Success Rate PvP	+value to defense success rate in PvP	11
7	Add Damage Reduction	+value% damage reduction (JoH slot)	10
8	Add SD Rate	+value% to SD absorption rate	13

Examples#

<Option Index="1" Name="Add Min Physical Damage" Rate="50" Level="0"
        Value0="2" Value1="3" Value2="4" Value3="5" Value4="6"
        Value5="7" Value6="9" Value7="11" Value8="12" Value9="14"
        Value10="15" Value11="16" Value12="17" Value13="20" Value14="20" Value15="20"
        Money0="100000" Money1="110000" Money2="120000" .../>

Rate=50: Common option
Level=0: Available at any item enhancement level
Initial JoH level when applied is 0 with +2 bonus
Smelt Stone can upgrade up to the item's enhancement level (max 15)

<Option Index="10" Name="Add SD Ignore Rate" Rate="10" Level="13"
        Value0="0" Value1="0" ... Value12="0" Value13="5" Value14="10" Value15="10"
        Money0="0" Money1="0" ... Money12="0" Money13="400000" .../>

Rate=10: Rare option
Level=13: Requires +13 (or higher) item to roll this option
When applied, initial JoH level is 13 with the Value13 bonus (5%)
Smelt Stone can still raise it toward 14 / 15 if the item is +14 or +15

<Option Index="3" Name="Sub Require Strength" Rate="40" Level="0"
        Value0="6" Value1="8" Value2="10" ... Value13="40" Value14="40" Value15="40"
        Money0="100000" Money1="110000" .../>

Reduces Strength requirement by Value at the current JoH level. At JoH 13, reduces by 40. This option is filtered out when rolling JoH on items that have no Strength requirement.