CollectionCommonData

Version support

Version	Status
v92	Full
v90	-
v86	-

CollectionCommonData.xml defines shared collection system settings: nameplate visibility, difficulty probability curves, experience tables, and icon path mappings.

This schema has five DSL sections sharing one XML file:

collectionShowNamePlate — singleton update-only (visibility distances)
collectionDifficulty — singleton update-only (difficulty probability curves)
collectionExpTable — CRUD list of experience-per-level entries
collectionExpLimitTable — CRUD list of grade-to-level-cap entries
collectionIconPathTable — CRUD list of icon type-to-path mappings

DSL support

Singleton sections

Entity	Operations
`collectionShowNamePlate`	`update`
`collectionDifficulty`	`update`

CRUD sections

Entity	Operations	Key
`collectionExpTable`	`create`, `update`, `delete`, `upsert`	`userLevel`
`collectionExpLimitTable`	`create`, `update`, `delete`, `upsert`	`grade`
`collectionIconPathTable`	`create`, `update`, `delete`, `upsert`	`typeName`

Quick recipes

Update show nameplate

spec:
  version: "1.0"
  schema: v92

collectionShowNamePlate:
  update:
    - changes:
        distance: 50
        extractorDistance: 100

Update difficulty

spec:
  version: "1.0"
  schema: v92

collectionDifficulty:
  update:
    - changes:
        hardProbOver: 30
        normalProbOver: 50
        easyProbOver: 80

Create experience entry

spec:
  version: "1.0"
  schema: v92

collectionExpTable:
  create:
    - userLevel: 65
      exp: 5000

Create experience limit entry

spec:
  version: "1.0"
  schema: v92

collectionExpLimitTable:
  create:
    - grade: 10
      maxUserLevel: 65

Create icon path entry

spec:
  version: "1.0"
  schema: v92

collectionIconPathTable:
  create:
    - typeName: "herb"
      path: "img/collection/herb_icon.dds"

Upsert icon path

spec:
  version: "1.0"
  schema: v92

collectionIconPathTable:
  upsert:
    - typeName: "mineral"
      path: "img/collection/mineral_icon.dds"

Delete experience entry

spec:
  version: "1.0"
  schema: v92

collectionExpTable:
  delete:
    - 65

Properties reference

ShowNamePlate attributes

Attribute	Type	Since	Description
`distance`	`int`	v92	Nameplate visibility distance
`extractorDistance`	`int`	v92	Extractor nameplate visibility distance

CollectDifficulty attributes

Attribute	Type	Since	Description
`hardProbOver`	`int`	v92	Hard difficulty probability (over proficiency)
`hardProbUnder`	`int`	v92	Hard difficulty probability (under proficiency)
`normalProbOver`	`int`	v92	Normal difficulty probability (over proficiency)
`normalProbUnder`	`int`	v92	Normal difficulty probability (under proficiency)
`easyProbOver`	`int`	v92	Easy difficulty probability (over proficiency)
`easyProbUnder`	`int`	v92	Easy difficulty probability (under proficiency)

ExpParam attributes

Attribute	Type	Since	Required	Description
`userLevel`	`int`	v92	Yes	Player level (key)
`exp`	`int`	v92	No	Experience points awarded

ExpLimit attributes

Attribute	Type	Since	Required	Description
`grade`	`int`	v92	Yes	Collection grade (key)
`maxUserLevel`	`int`	v92	No	Maximum player level for this grade

IconPath attributes

Attribute	Type	Since	Required	Description
`typeName`	`string`	v92	Yes	Icon type name (key)
`path`	`string`	v92	No	Icon file path

XML structure

CollectionCommonData.xml
└── CollectionCommonData (root)
    ├── ShowNamePlate (singleton)
    │   @distance, @extractorDistance
    ├── CollectDifficulty (singleton)
    │   @hardProbOver, @hardProbUnder, @normalProbOver, ...
    ├── ExpTable (0..∞)
    │   @userLevel (required), @exp
    ├── ExpLimitTable (0..∞)
    │   @grade (required), @maxUserLevel
    └── IconPathTable (0..∞)
        @typeName (required), @path

Common pitfalls

Singleton sections: collectionShowNamePlate and collectionDifficulty only support update. Each has exactly one element in the XML.
Shared XML file: All five sections resolve to the same CollectionCommonData.xml file.
String key: collectionIconPathTable uses a string key (typeName) rather than the typical integer key.