RawStoneItem

Overview

RawStoneItem.xml defines raw stone items: upgrade stones and tier-up stones with their success rates, applicable equipment types, grade requirements, and material constraints for the equipment enhancement system.

Version Support

Version	Status
v92	Full
v90	-
v86	-

---

DSL Support

Entity: rawStoneItems Operations: create, update, delete, upsert

---

Quick Recipes

Create

spec:
  version: "1.0"

rawStoneItems:
  create:
    - id: 1
      type: TIERUP
      useEquipmentType:
        - EQUIP_WEAPON
        - EQUIP_ARMOR_BODY
      useGambleItemGrade: [1, 2, 3, 4, 5, 6, 7]
      useRareGrade: 1
      rate: 1.0
      succeedRate: 0.85
      needSameMaterial: true

Creates a tier-up raw stone (ID 1) applicable to weapons and body armor of rare grade 1, with 85% success rate. Requires same material type for enhancement.

Create with Multiple Equipment Types

spec:
  version: "1.0"

rawStoneItems:
  create:
    - id: 2
      type: UPGRADE
      useEquipmentType:
        - EQUIP_WEAPON
        - EQUIP_ARMOR_BODY
        - EQUIP_ACCESSORY
      useGambleItemGrade: [3, 4, 5]
      useRareGrade: 2
      rate: 0.8
      succeedRate: 0.75

Creates an upgrade raw stone (ID 2) applicable to all equipment types, usable on gamble grades 3-5 of rare grade 2, with 75% success rate. Optional needSameMaterial omitted (defaults to false).

Update

spec:
  version: "1.0"

rawStoneItems:
  update:
    - id: 1
      changes:
        succeedRate: 0.90
        rate: 1.2

Updates the success rate and rate multiplier for raw stone 1 while preserving all other attributes.

Delete

spec:
  version: "1.0"

rawStoneItems:
  delete:
    - 1
    - 2

Removes raw stone items with the specified IDs.

Upsert

spec:
  version: "1.0"

rawStoneItems:
  upsert:
    - id: 3
      type: TIERUP
      useEquipmentType:
        - EQUIP_ACCESSORY
      useGambleItemGrade: [5, 6, 7]
      useRareGrade: 3
      rate: 0.5
      succeedRate: 0.60
      needSameMaterial: false

Creates the raw stone if it doesn’t exist, or updates it completely if it does.

---

Properties Reference

Core Properties

Property	Type	Since	Required	Description
id	int	v92	Yes	Unique raw stone item ID
type	string	v92	Yes	Stone operation type. Enum. See RawStoneType.
rate	decimal	v92	Yes	Rate multiplier applied during the enhancement operation
succeedRate	decimal	v92	Yes	Success probability (0.0 to 1.0) for the enhancement attempt

Equipment Filtering

Property	Type	Since	Required	Description
useEquipmentType	list[string]	v92	Yes	Equipment types this stone can be applied to. Flags enum. See EquipmentTypeFlags.
useGambleItemGrade	list[int]	v92	Yes	Gamble item grades this stone is compatible with (semicolon-separated in XML)
useRareGrade	int	v92	Yes	Rare grade requirement for equipment (0=Common, 1=Uncommon, 2=Rare, etc.)

Enhancement Constraints

Property	Type	Since	Required	Description
needSameMaterial	boolean	v92	No	Whether the stone requires the same material type as the target equipment. Defaults to false if omitted.

---

Enum Reference

RawStoneType

Value
TIERUP
UPGRADE

EquipmentTypeFlags

Value
EQUIP_ACCESSORY
EQUIP_ARMOR_BODY
EQUIP_WEAPON

---

Common Pitfalls

• ID uniqueness: Raw stone IDs must be unique across all raw stone items. They typically reference ItemTemplate.xml item IDs.
• Enum casing: type values are case-sensitive. Use TIERUP and UPGRADE in uppercase.
• Flags enum casing: useEquipmentType values are case-sensitive. Use EQUIP_WEAPON, EQUIP_ARMOR_BODY, and EQUIP_ACCESSORY in uppercase.
• Success rate range: succeedRate is a decimal probability (0.0 to 1.0). A value of 0.85 means 85% success chance.
• YAML arrays to XML: The useEquipmentType and useGambleItemGrade YAML arrays are automatically converted to semicolon-separated strings in the XML output (e.g., useEquipmentType="EQUIP_WEAPON;EQUIP_ARMOR_BODY").
• Optional attribute behavior: When needSameMaterial is omitted, it defaults to false. Include it explicitly if same-material constraint is required.