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 used to be standard Windows .INI format files. For some reason I changed that. Instead they follow this format, which at least is a little more readable.
Format Example: roll.txt
The colon at the end of the heading line is required, and at least one space or tab at the beginning of the data lines is also required. The mundane name, branch, blazon and device are optional, as are the asterisked award lines, though there’s probably not much point putting someone in if they don’t at least have some data!
Frederick von Flintschtone: mundane: Fred Nurk branch: Bedrock blazon: Bendy pean and Or hurty device: Frederick_von_Flintschtone.gif * AA: 1996-09-14 * OST: 1998-06-20 * RC: 2004-01-3 * 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.
Format Example: awards.txt
Initialisms are case-sensitive; stick to lower-case for baronial awards to avoid clashes with upper-case kingdom awards. The precedence field isn’t used in this version.
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.