You need to create and upload your initialisation files before this plug-in will work. Once they’re uploaded, you can identify them in this settings page and then insert the text [roll-of-arms] anywhere in your website to generate a complete Roll of Arms.
The initialisation files follow the standard Windows .INI format. You can get a sample awards.ini from here, but you’ll need to make the op.ini yourself. This is a typical example with all the settings. Everything but the [SCA Name] is optional:
[Frederick von Flintschtone] mundane="Fred Nurk" branch="Bedrock" blazon="Bendy pean and Or hurty" device="Frederick_von_Flintschtone.gif" 1="AA,1996-09-14" 2="OST,1998-06-20" 3="RC,2004-01-3" 4="dob,1997-08-02"
In this example, Lord Frederick von Flintschtone is revealed to have a Silver Tear (OST) and a Royal Cypher (RC), as well as the local baronial award the Diamond of Bedrock. You would need to edit your awards.ini to include that and all other baronial awards. Because his device is registered, it is listed on the Lochac Roll of Arms website, and the filename Frederick_von_Flintschtone.gif is what it’s stored under. Go there to find your citizens’ arms if they exist.
The awards.ini file is simpler, and you can follow the example linked above to get it right. Don’t worry about the “precedence=” field; that’s reserved for future expansion. If you want to give your baronial awards an arbitrary precedence to save time later, bear in mind that higher numbers rank higher, so stick to numbers below 100. Initialisms are case-sensitive; stick to lower-case for baronial awards to avoid clashes with upper-case kingdom awards.
[dob] name="Diamond of Bedrock" precedence=10
That’s it! Sorry it’s not more streamlined, but I had to get version 1.0 out the door quickly. Improvements will come if enough people clamour for them.