Collection

Overview

The Collection schema defines gatherable resources in the game world such as herbs, ores, and other harvestable nodes. Each entry specifies gathering requirements, proficiency gains, and visual/audio properties.

Version Support

Version	Status
v92	Full
v90	-
v86	-

Required Attributes

Attribute	Type	Since	Description
collectionId	int	v92	Unique collection identifier
typeName	string	v92	Resource type name (e.g., "herb_rare", "ore_common")
grade	int	v92	Collection grade/tier
pickSkillType	int	v92	Gathering skill type required
neededProficiency	int	v92	Minimum proficiency to gather
neededPickTimePoint	decimal	v92	Gathering time cost in points
proficiencySuccessIncrement	int	v92	Proficiency gained on success
height	int	v92	Node height
questCollection	bool	v92	Whether this is a quest-specific node
abnormalityProb	int	v92	Probability of triggering abnormality effects
plentifulPoint	int	v92	Plentiful harvest point threshold
plentifulProb	decimal	v92	Plentiful harvest probability

Optional Attributes

Identity

Attribute	Type	Since	Description
name	int	v92	String table reference ID (not a display name)

Effects & Visuals

Attribute	Type	Since	Description
effect	string	v92	Gathering visual effect name
effectId	int	v92	Effect ID
guideEffectId	int	v92	Guide marker effect ID
silhouette	string	v92	Silhouette mesh asset
showNamePlate	bool	v92	Display nameplate above node
collectingSound	string	v92	Sound played during gathering

Despawn

Attribute	Type	Since	Description
despawnDuration	int	v92	Time before node despawns
despawnEffectId	int	v92	Effect played on despawn
despawnStartTime	int	v92	Time when despawn sequence begins

Gathering Behavior

Attribute	Type	Since	Description
abnormalityList	list[int]	v92	Abnormality IDs applied on gather
extractorCollection	bool	v92	Extractor-only gathering node
failIncrement	int	v92	Proficiency gained on failure
isOverlapOn	bool	v92	Allow overlapping gather actions
minUserLevel	int	v92	Minimum character level to gather
plentifulGiftNum	int	v92	Number of bonus gifts on plentiful harvest
subFatiguePoint	int	v92	Fatigue points consumed per gather

DSL Examples

Create

collections:
  create:
    - collectionId: 90001
      typeName: "herb_rare"
      grade: 3
      pickSkillType: 1
      neededProficiency: 200
      neededPickTimePoint: 5.0
      proficiencySuccessIncrement: 10
      height: 100
      questCollection: false
      abnormalityProb: 0
      plentifulPoint: 500
      plentifulProb: 0.15
      name: 289401
      abnormalityList: [701100, 701101]
      effect: "EP_Collection_Herb"
      showNamePlate: true

Update

collections:
  update:
    - collectionId: 90001
      changes:
        neededProficiency: 250
        plentifulProb: 0.20
        grade: 4

Delete

collections:
  delete:
    - 90001

Upsert

Creates the entry if it does not exist; updates all data attributes if it does.

collections:
  upsert:
    - collectionId: 90002
      typeName: "ore_common"
      grade: 1
      pickSkillType: 2
      neededProficiency: 0
      neededPickTimePoint: 3.5
      proficiencySuccessIncrement: 5
      height: 80
      questCollection: false
      abnormalityProb: 0
      plentifulPoint: 300
      plentifulProb: 0.10

updateWhere

Bulk-update all entries matching a filter. All schema attributes are filterable.

collections:
  updateWhere:
    - filter:
        grade: 3
        pickSkillType: 1
      changes:
        neededProficiency: 300
        plentifulProb: 0.25

    - filter:
        grade: [1, 2, 3]
      changes:
        questCollection: false

Filter values can be a single value or a list. A list matches any entry whose attribute equals one of the listed values.

Notes

• The name attribute is an integer (string table reference ID), not a text string.
• abnormalityList is authored as a YAML list of integers (e.g., [701100, 701101]) and serialized to a semicolon-separated string in XML (e.g., "701100;701101").
• All properties are primitive types; there are no enums for this entity.
• The XML file is located at CollectionData/Collections.xml (single-file organization).
• See Operations for general CRUD and upsert semantics.
• See Filters for filter syntax details used in updateWhere.