CollectionSkill

Version support

Version	Status
v92	Full
v90	-
v86	-

---

CollectionSkill.xml defines gathering system configuration: global environment settings and per-grade skill definitions for resource collection.

This schema has two DSL sections sharing one XML file:

• pickEnvironment — singleton update-only section for global settings
• pickSkills — CRUD list of skill grade entries with composite key

---

DSL support

PickEnvironment

Entity: pickEnvironment Operations: update (singleton, update-only)

PickSkill

Entity: pickSkills Operations: create, update, delete, upsert Key attributes: pickSkillType + skillGrade (composite key)

---

Quick recipes

Update environment settings

spec:
  version: "1.0"
  schema: v92

pickEnvironment:
  update:
    - changes:
        reuseDelay: 5000
        alwaysIncProf: true
        correctionValue: 10

Create skill grade

spec:
  version: "1.0"
  schema: v92

pickSkills:
  create:
    - pickSkillType: 1
      skillGrade: 3
      gradeProficiencyLimit: 500
      gatherPoint: 100
      pickSkillName: "Expert Mining"
      pickSkillIcon: "icon_mining_03"
      toolTipText: "Advanced mining technique."

Update skill grade

spec:
  version: "1.0"
  schema: v92

pickSkills:
  update:
    - pickSkillType: 1
      skillGrade: 3
      changes:
        gradeProficiencyLimit: 750
        toolTipText: "Master mining technique."

Upsert skill grade

spec:
  version: "1.0"
  schema: v92

pickSkills:
  upsert:
    - pickSkillType: 1
      skillGrade: 4
      gradeProficiencyLimit: 1000
      gatherPoint: 200
      pickSkillName: "Master Mining"
      pickSkillIcon: "icon_mining_04"

Delete skill grade

spec:
  version: "1.0"
  schema: v92

pickSkills:
  delete:
    - pickSkillType: 1
      skillGrade: 3

---

Properties reference

PickEnvironment attributes

Attribute	Type	Since	Description
reuseDelay	int	v92	Cooldown between gathering attempts (ms)
alwaysIncProf	bool	v92	Always increment proficiency on gather
correctionValue	int	v92	Proficiency correction value
bonusIncrement	int	v92	Bonus proficiency increment
maxProficiencyLimit	int	v92	Maximum proficiency cap
gatherPointValue	decimal	v92	Base gather point value
bonusGatherPoint	int	v92	Bonus gather points
minGatherTimeValue	int	v92	Minimum gathering time (ms)
failIncrementProb	int	v92	Proficiency increment chance on failure (%)
profCorrectionDivier	decimal	v92	Proficiency correction divisor

PickSkill attributes

Attribute	Type	Since	Required	Description
pickSkillType	int	v92	Yes	Skill type identifier (part of composite key)
skillGrade	int	v92	Yes	Skill grade level (part of composite key)
gradeProficiencyLimit	int	v92	No	Proficiency threshold for this grade
gatherPoint	int	v92	No	Gather points awarded at this grade
pickSkillName	string	v92	No	Display name
pickSkillIcon	string	v92	No	Icon resource path
toolTipText	string	v92	No	Tooltip description

---

XML structure

CollectionSkill.xml
└── CollectionSkill (root)
    ├── PickEnvironment (singleton)
    │   @reuseDelay, @alwaysIncProf, @correctionValue, ...
    └── PickSkill (0..∞)
        @pickSkillType (required)
        @skillGrade (required)
        @gradeProficiencyLimit?
        @gatherPoint?
        @pickSkillName?
        @pickSkillIcon?
        @toolTipText?

---

Common pitfalls

• Composite key: PickSkill entries are identified by both pickSkillType AND skillGrade. Both must be specified for update and delete operations.
• Singleton section: pickEnvironment only supports update. There is exactly one PickEnvironment element in the XML.
• Shared XML file: Both sections resolve to the same CollectionSkill.xml file.