OpenDKP is a Dragon Kill Point (DKP) and Attendance tracking system designed to be highly performant and reliable by leveraging Amazon Web Services.
All links provided in this documentation will point to the Demo Client. You can replace the "demo" part with your guild's subdomain to reach the appropriate url for your guildCommon Definitions
AWS Cognito manages user accounts on behalf of OpenDKP. When you register an account, you get access to additional features. You are NOT required to register an account to use OpenDKP to view your DKP or Attendance.
Demo Client Registration Link: https://demo.opendkp.com/#/register
The request system is designed such that users can perform certain actions that require Administrators to approve or deny before the operation can happen. These types of operations are being added and developed over time. See the list of types currently supported by OpenDKP
There are 3 statuses a request can be in:
Characters represent entities that earn DKP by attending raids, purchasing items or having adjustments applied to them. It is possible that a single person has multiple characters and each are treated independently. Most games or guilds use the attributes tied to a character to determine a status such as "ALT" or "BOX" versus "MEMBER" etc. See the attributes section for more details
A character contains multiple attributes, many which are configurable for multiple game types:
A quick summary view is available for the character's DKP information if it is available. The summary will only be provided if the character is considered Active and has attended raids recently.
Adjustments are an adhoc way to apply DKP bonuses or penalties to Characters. An adjustment can be positive or negative in terms of value. Adjustments have no expiration date at this time, so adjustments will always be applied and only impacted potentially by DKP Decay (if enabled)
Example: Leeroy Jenkins was given a -500 Adjustment for rushing without the group.
A raid is the primary form of earning DKP and Attendance in OpenDKP
A Raid Tick can represent anything you want. It can signify a time period that has elapsed (30 minutes, 1 hour, etc) or the death of a boss. Each Raid Tick will count as 1 / N attended raids for attendance purposes. A raid tick also contains a DKP value that will be assigned to every Attendee. Each Raid Tick has a collection of Attendees (characters). You decide how many Raid Ticks are assigned to a raid and at what frequency.
Raid Ticks allow you to keep track of which Characters attended the event (time period, boss kill, etc) so it is expected that Characters may or may not be present on all raid ticks. If a character misses a raid tick, their attendance and total DKP will be impacted as such.
The below diagram represents an example raid which contains 5 raid ticks, awarding 50 DKP total if someone had attended all raid ticks
Each Raid Tick contains a collection of Attendees which are Characters who were present at the time of the Raid Tick
A list of Items that are earned during the raid. This could be items looted, bid off, or simply items you want to charge DKP for.