items.csv editing

Introduction

Editing the items.csv file to add entries is a simple matter, thus this page mostly explains the logic revolving around it.

Firstly, the format of an items.csv entry is simply

preferredname,itemID,itemDataValue

and is shown in the items.csv above the entries.

Overwriting

Of course, there are conditions in which items.csv is overwritten.

  • If the version number on the first line or the plugin version number cannot be parsed the items.csv will be overwritten
  • If the version number on the first line is lower than the plugin version number the items.csv will be overwritten
  • If the version number on the first line is equal to the plugin version number the items.csv will not be overwritten
  • If the version number on the first line is higher than the plugin version number the items.csv will not be overwritten but the admin is notified it's better to set it to the below option
  • If the version number on the first line is -1 then the items.csv will never be overwritten.

Item Displayed Name Lookup

This is simple; the first entry listed in items.csv is what is shown as the item name in command output.

Name Overriding

Two sets of logic here:

  • items.csv names override material names
  • alias names override items.csv names