EQ2 Guild Roster Data

Guilds have picked up some additional data since Census launched that folks may not be aware of. I'm going to go over all of the data, even some that has been present for some time.

Data Update Frequency

Data for a guild is updated each time a member logs in or out. A member who has been promoted, demoted, or left (voluntarily or otherwise) from a guild will not drop from the roster until the next time they login.

General Information


Example data:

Code:

<guild accounts="61" alignment="2" dateformed="1298556407" guildid="****" guildstatus="0" guildxp="31598900" id="*********" last_update="1360373593.601493" level="95" members="132" name="*********" name_lower="*********" ts="1360373593.601493" version="1" world="Antonia Bayle" worldid="104">

Accounts is the number of unique EQ2 accounts in the guild, while members is the number of characters joined to the guild.

Alignment has one of these values:

Code:

<alignment_list>
<alignment id="-1" name="unknown"/>
<alignment id="0" name="good"/>
<alignment id="1" name="neutral"/>
<alignment id="2" name="evil"/>
</alignment_list>

Guildstatus has been deprecated in favor of guildxp which (I believe) shows the guild's status towards the next level.

Guild Ranks

Guild ranks are from 0-7 and always use a specific set of icons which can be found in \EverQuest II\UI\Default\images\guild_ranks.dds.

Code:

<rank_list>
<rank id="0" name="Leader"/>
<rank id="1" name="Officer"/>
<rank id="2" name="Officer Alts"/>
.
.
<rank id="7" name="Recruit"/>
</rank_list>

Recruiting Info

Example data:

Code:

<recruiting flags="10" longtext="Do you think you have what it takes to be a truly hardcore crafter? Apply today at *************!<br />Classes needed:<br />Troubador<br />Monk<br /><br />Raid Times:<br />Sunday - 6:00 PM to 12:00 AM PST<br />Monday through Thursday - 8:00 PM to 12:00 AM PST" minlevel="95" playstyle="2" shorttext="*************, PST Hardcore Crafting Guild"/>

recruiting.flags is a bitfield:

• bit 0 = We offer training to new players
• bit 1 = Looking For: Fighters
• bit 2 = Looking For: Priests
• bit 3 = Looking For: Scouts
• bit 4 = Looking For: Mages
• bit 5 = Looking For: Tradeskillers
• recruiting.longtext is the Recruiting Message (long).
• recruiting.shorttext is the Recruiting Message (short).

Currently, linebreaks are represented by an escaped <br> tag, ie. &lt;br&gt;.

recruiting.minlevel is the minimum adventure level being considered for recruits.

recruiting.playstyle has one of the following values:

• 0 - Standard
• 1 - Casual
• 2 - Hardcore

Member List

Member list contains character names and old style dbids which are only unique to the server.

Code:

<member_list>
<member dbid="1234567" name="********"/>
<member dbid="2345678" name="*******"/>
.
.
</member_list>

To resolve the members of a guild to a modern GUID (Globally Unique ID), add &c:resolve=members to the URL:

Code:

<member_list>
<member dbid="******" id="1234567890123" name="***********"/>
<member dbid="******" id="2345678901234" name="*******"/>
<member dbid="******" name="*******"/>
.
.
</member_list>

You may also add other fields to &c:resolve inside the members collection such as &c:resolve=members(displayname,type).


Note: Characters which have not logged in since November 2011 will not have a GUID or resolve any other information.


Guild Cloak Heraldry

Code:

<heraldry cloak_color="7" edge="1" edge_color="7" icon="15" icon_color="13" pattern="0" pattern_color="35"/>

Your Guild's cloak heraldry can be customized by speaking to a Guild Cloak Designer in one of the major cities. There are 7 parameters which can be changed:

• cloak_color -- the cloak's base or background color (0-63)
• edge graphic (0-11)
• edge color (0-63)
• emblem (icon) graphic (0-38)
• emblem (icon) color (0-63)
• pattern graphic (0-9)
• pattern color (0-63)

There are a total of 64 * 64 * 64 * 12 * 39 * 10 or 1,226,833,920 possible cloak designs. These can be displayed on your website using overlaid PNG images or some other technique.


Personality Tags

There are 4 personality tag slots which may be selected in-game. These are returned like this:

Code:

<personalitytag_list>

<personalitytag text="We enjoy doing quests"/>
<personalitytag text="We are family friendly"/>
<personalitytag text="We're very funny (in our opinion)"/>
<personalitytag text="We play at odd hours"/>
</personalitytag_list>

Guild Achievements

Guild Achievements are only published if the "Hide Guild Achievements from Census" checkbox is not checked under Guild Options in the Guild Window.
Example data:

Code:

<achievement_list>

<achievement completedtimestamp="1361934477" id="616659975"/>
<achievement completedtimestamp="1361934925" id="755589334"/>
.
.
</achievement_list>

Guild Achievements are described in the Achievements collection (link). To distinguish them from player achievements, check for the presence of the isguildachievement flag.

Currently there is just one category of Guild Achievement -- Raid -- however more may be added in the future.