Quickstart

DataSheetLang lets you describe changes in YAML and apply them to your game’s XML DataSheet in a repeatable way.

Prerequisites

• You have the dsl CLI available in your terminal.
• You have a local DataSheet folder (the folder that contains files like ItemTemplate.xml, etc.).

1. Create a spec file

   Create a new file, for example: items.yaml

   spec:
     version: "1.0"
   
   items:
     create:
       - id: 99001
         name: "Training Sword"
         level: 1
         rareGrade: "Common"
         combatItemType: EquipWeapon
         combatItemSubType: Twohand
         category: Lance
         buyPrice: 100
         sellPrice: 10
         maxStack: 1

2. Apply the spec to your DataSheet

   From the folder where items.yaml is located:

   dsl apply items.yaml --path ./DataSheet

   This will read your YAML spec and update the relevant XML files under ./DataSheet.