MorgDKP2

Rollframe

MorgDKP2 is a full featured mod that allows the master looter (ML) to control the loot distribution process. Only one member is required to have this mod. MorgDKP2 is also capable of tracking DKP and outputting the DKP string for import into eqDKP using a custom php import script.

Please help localize here.

Troubleshooting

LDB shortcuts:

  • L-click => MorgBid2 query
  • Shift-L-click => Invite list
  • Ctrl-L-click => Raidtracker
  • R-click => Options
  • L-click itemlink => Add manual item for query
  • Shift-L-click Itemlink => Insert link into open chatframe message
  • Ctrl-L-click Itemlink => Add item to ignore list
  • Hover over itemlink => Show item tooltip
  • Shift-hover over itemlink => Show bid history for the item

Bag shortcut - Shift-Alt-L-click any item in your bug to add a manual query (ie a BOE item)


Video Tutorial
BlueWarlord has created a video tutorial for setting up and using the MorgDKP2 system to run a raid. Find it here.

BlueWarlord created another video tutorial for setting up and using MorgDKP2 with eqdkp/eqdkp+. Find it here.

Thanks BlueWarlord!


phpRaid Integration
If you use eqdkp+ for setting up raids you can export the raid attendees (choose lua format) and save the file to the MorgDKP2 folder. When you open the invite list (shift-click) the day of a scheduled raid the phpRaid data will pop open in its own frame.


ClassLoot Integration
If you have ClassLoot (r98 or higher) running as well as MorgDKP2 when a new item drops the classes/altclasses allowed to bid for the item will automatically be filled in if the item is in ClassLoot's database. Only if the classes are NOT already set. Thanks Pneumatis for allowing me to hook your DB:)


Importable item database
There is now and item DB included in the ImportItemDB folder of MorgDKP2. It has as many Northrend raid items I have seen so far with classes set. To import it copy the file to the main MorgDKP2 directory and load WoW. Once imported delete the file from the main directory. Note it will not overwrite any items you already have set.


Using MorgDKP2:
Basic use is identical to MorgDKP. Documentation for setting up the web scripts etc still applies. Will post more information when I have time.

Suggested to start:

  1. Install the webscripts to the plugins folder of your eqdkp install and install it through the admin plugin menu
  2. Export your DKP from the website save in MorgDKP2 folder (even if your database currently has no members!)
  3. Enter WoW and make sure there are no errors
  4. Track your raid etc
  5. Click export raid(s) and copy the string
  6. Click Import raids on the admin panel of edkp and paste the string into the window
  7. Win!

Webscript help

Export standings
Used to export member DKP, events, aliases, and database information (needed for proper import) to the in game mod. Access through the eqdkp admin menu (after installing plugin)

  1. Select your game timezone (may not match your actual timezone)
  2. Select if you want to export member ranks
    1. Ignore ranks - do not export ranks and hence do not use rank sorting for item rolls
    2. Use all ranks - export all ranks for all members and use rank sorting for item rolls (only way to activate rank sorting)
    3. Only export [rank] - only export the selected rank from the website. Caution will only export members of that rank so any unranked members or members of different rank will not be in the file.
  3. Enter the directory and in game name for up to 5 eqdkp installs (ie if your website is http://sodalityoftheconstant.com/aqdkp/listmembers.php? then you would enter aqdkp and whatever name you want it called in game.)
    1. For eqdkp+ multiple pool install only enter the main directory name the pool names will be your actual pool names
    2. For installs in base directory (ie http://eqdkptest.sodalityoftheconstant.com) enter - for the directory name
  4. Click export
  5. Right click the link and choose save as .. save in WOW/Interface/Addons/MorgDKP2 directory.
  6. Load into WoW or reloadui if already in game.

Import raids
Used to import raids recorded with the MorgDKP2 in game mod. Click export raids in the LDB tooltip or export raid in the raidtracker for a single raid. Copy the DKP string (Ctrl-C) and paste it into the editbox. When editing names or adding people you do not need to capitalize them.

  1. Click parse DKP string
  2. Check the data and make sure the import looks correct:
    1. If you have any aliases to import they will be shown with ADD beside them. To not import the alias simply erase the editbox.
    2. If you have any DKP changes they will be listed. As above erase the value or the names to not import. Can add/remove names as well.
    3. For each event the name, note, value, attendees, and any items will be shown. Edit them if necessary. To not import a whole event (including items) erase it's name. Erase and item or item value to not import the item.
  3. If you are using zerosum or skall with zerosum check the use zerosum checkbox.
  4. Click enter final data:)

Note: - Ranks will only be used in sorting if you export all ranks and set the weight of each rank in the in game options (database options) Higher values should be higher ranks. Also rank sorting is ONLY used on the lootframe rolling window. It is not used anywhere else such as the MorgBid2 check or raid invite tab. This means that the MorgBid2 results frame may show a different winner.


Loot window help:
Here is how the loot window is designed to work for those having trouble understanding it. When you loot a corpse if any items are above the loot threshold the mod will:

  1. Check each item and if any have not had their classes set (who gets to roll for the item) it will automatically open the item edit page to that item. This takes priority over all other possibilites. ie You edit this item and start the roll for it. The mod checks again and there is still another item with its classes unset so it opens the item edit page for that 2nd item NOT the roll window for the auction you started. If you want to see the roll window simply right click on the 1st item again.
  2. If no items have unset classes the mod next checks if any items are currently in auction. If so it opens: roll summary window if more than 1 item being rolled for or the single item roll window if only 1 item.
  3. If none of above conditions apply no window automatically opens (ie not roll window or item edit window) and you can right click any item to open edit window (or roll window if auction started) or alt-right click any item to start ALL queries which will cause the roll summary window to open.

Note: - If you want to use MorgDKP2 with fubar you need to have Broker2Fubar installed or it will only show a minimap icon.


Whisper commands: - whispered to someone running morgdkp2.
Waitlist
mbid wait[+/-] [main] => main only necessary if you are whispering from an unknown alt

Bidding
mbid itemid/itemlink [need/take/pass/offspec] [bid] => itemid/link must be included - bid only for BidWar

Dkp queries
dkplist [pool/s] [class/all] [class] ... => pools only if you want to see what pools are available. pool to get the dkp for that pool (leave out for default pool). all for all members in the raid (if person running morgdkp2 is in a raid), guild otherwise. You own class is automatically included so a pally whispering dkplist rogue will get paladin and rogue.


Webscript note: - The MorgDKP2 webscript requires:PHP 5.2.3 or greater and MySQL 5.0.7 or greater. If you are having issues with special characters make sure your MYSQL database is in UTF-8.


Supported DKP modules:

  • Fixed DKP
  • Zerosum DKP
  • Percent DKP
  • Relational DKP
  • Random
  • SKall
  • TakeBid
  • BidWar

Syncing:

Options

  • Broadcast - enable to send sync messages out during a raid to registered listeners. Usually one person will probably broadcast to the backup people in the raid but you can have more than one broadcaster.
  • Receive - enable so your mod will act as a listener and receive syncing events from MorgDKP2 installs which are broadcasting.
  • Overwrite raid - enable to overwrite the current raid with the new raid info (in the initial sync) if you have already started a raid. Useful when you zone in to the instance late after raid is already in progress to get the raidlog from the whole run. If you haven't started a raid overwrite is done by default.
  • Manual Syncs - ie Sync options/members/items/all/initial sync. Click one of these buttons to manually sync to the current raid.

Sync Details

  1. Syncing will not be enabled until a raid has started and then the mod will check for sync necessity every 60s.
  2. When the raid starts or someone joins the raid with receive enabled the broadcaster will send out his eqdkp data (boss events/values, aliases, current pool, certain options, current raid data, and current member DKP) Current member DKP will only be updated in the listener client if it has a newer timestamp or if they are members of your current raid. The broadcasters current raid will overwrite the receivers current raid unless Overwrite raid is off.
  3. When you make changes to important values the mod will schedule a sync and send those changes to the listeners throughout the raid.

What is synced?

  • item database changes (value/classes)
  • raid tracker changes to items (value/winner/event)
  • custom events
  • event changes (value/name/note/deletion)
  • alias additions
  • BOE items (ie hand out through your inventory and manually trade)
  • DKP change events
  • item costs different from actual DB cost (ie TakeBid or offspec auctions)
  • items incorrectly assigned to ML/DE in listener client
  • full current raid sync
  • initial waitlist and waitlist changes

NOTE: - There is generally no need for the manual syncs unless you specifically want to transfer the complete itemDB or the listener wants ALL of your MorgDKP2 options. The complete member DKP and necessary options are transferred when the initial sync is sent at the start of the raid (if you have Broadcast enabled and there are listeners present in the raid)


MorgDKP2 Features:

  • Allows ML to query raid for interest in loot.
  • Tracks DKP including raid attendees, start bonus, and all drops.
  • DKP systems supported include zero-sum, relational, random, fixed, percent, and skall.
  • Options to award DKP/unit of time, include a start bonus, and include custom events such as boss attempts.
  • BidWar mode for item auctions.
  • Custom php scripts to export/import/change DKP and add aliases to eqDKP/eqdkp+ website. (can import multiple raids/pools in one string)
  • Allows a ML and disenchanter (DE) to be set so that they are not charged for items. (Toggle)
  • Remembers what raid members have equipped and will not send a query to them for loot they already have. (Exceptions for some non-unique items included.)
  • Sends query results to MorgBid2 (for players in that auction)
  • Displays top 5 DKP members for the moused over item in the tooltip.
  • Automatically hands out items to the winning player if the loot window is still open. Note: It asks with the standard blizzard confirmation dialogue.
  • Allows ML to easily set which classes are eligible and DKP value. Also remembers these values.
  • Scans for base installs of MorgBid in the current raid. Automatically outputs a link to MorgBid site on click.
  • Allows ML to record BOE items before trading them to member. (Alt-shift click item in your inventory)
  • Can load up to 5 separate DKP pools. Ie. MC1, MC2, BWL, AQ40, NAXX. These raids can be named whatever you wish.
  • multiPool feature allows up to 5 DKP pools to be used in one raid. (ie separate pool for class items)
  • Can change loot threshold on the fly.
  • Item history for easy recall of current raid item winners.
  • Allows raid members to whisper ML for current DKP for own class or specified classes in all 5 DKP pools. (sent to MorgBid2)
  • Lets you know it is working by displaying boss kills, raid changes, and looting events.
  • Automatically links items to raid chat.
  • Edit item values from item history (Allow you to track DKP without being ML)
  • Whisper system for those crazy people who hate mods:P
  • Fubar/LDB support
  • Main and offspec DKP rolling
  • Waitlist including DKP awarding and alt whispering.
  • ListDKP - shows guild members online and in/out of group and allows 1 click inviting
  • Custom item ignore list
  • Automatic loot method switching for certain encounters. (Vashj/MH)
  • Boss attempt mode asks if you want to record a boss attempt after dying
  • Custom loot frame with buttons for self-loot/random rolling items (loot frame can be used with mod in standby mode)
  • Importable item database
  • Built in xloot like loot frame which can be used with mod on standby
  • New itemframe/rollframe built into loot window
  • Customisable font/frame options
  • Modular so can disable what you don't need
  • Web script can handle offbase/eqdkp installs in main directory
  • Imports MorgDKP database data (be sure to run both at same time if you want to mport your database the first time)
  • Fully eqdkp/eqdkp+ compatible
  • In game raid browser

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Morgalm Morgalm Dec 23, 2008 at 19:30 UTC - 0 likes

    No, thank you:) I hate doing docs takes time away from coding lol.

  • Avatar of BlueWarlord BlueWarlord Dec 23, 2008 at 17:33 UTC - 0 likes

    Thanks, I will start updating next week.

  • Avatar of Morgalm Morgalm Dec 23, 2008 at 03:34 UTC - 0 likes

    Alright BlueWarlord I added you as a documentor of the project. So you should be able to edit the project pages:)

  • Avatar of BlueWarlord BlueWarlord Dec 20, 2008 at 11:24 UTC - 0 likes

    Okidoki, could you setup such a wiki? Preferable here on WoWAce, or should I setup one on my own server? If you setup one, please define a way for me to start pouring in some knowledge :-)

  • Avatar of Morgalm Morgalm Dec 19, 2008 at 23:30 UTC - 0 likes

    Man you are a lot more organized about docs then me:P Looks great so far I especially like the stick men:P

    For form I would think wiki would be best and ideally right on these pages would probably work well. Could revamp the morgdkp website I guess but I'm not the greatest at setting up websites. Thanks for the hard work and ideas:)

  • Avatar of BlueWarlord BlueWarlord Dec 19, 2008 at 21:25 UTC - 0 likes
    Hi all, I was a bit bored this week while writing an article. Hence, I made a first stab at getting some ideas down for documenting MorgDKP2. This X-mas I have very little time, as I just moved to a new country. However, see this as a first attempt at getting somewhere :-) Form I'm leaving the choice of the form of documentation in the hands of Morgalm. I was thinking about using something like a wiki, so more people can contribute to the docs. Using the pages of the MorgDKP2 project might also be an option. Another form is that we e-mail stuff to Morgalm and he processes it further. Intended audiences I foresee three different type of readers for this documentation. In short, they are the following:
    • Webmaster, setting up the eqdkp(+) website and making the initial config for a Guild.
    • Master looter, a person having MorgDKP2 installed that wants to use it to hand out loot.
    • Raider, a person in the raid using MorgBid2 or the whisper system to interact with MorgDKP2.

    Structure Based on these three different type of readers, the first version of the overall structure of the docs I came up with is:

    • Initial setup
      • eqdkp(+) setup
      • installation of MorgDKP2 plug-ins
      • eqdkp accounts
    • Master looting with MorgDKP2
      • Configuration
      • Importing DKP standings
      • Starting a raid
      • Earning DKP
        • Boss kills
        • Time based DKP
        • Wait list
      • Spending DKP / Handing out Loot
        • Fixed item DKP
        • Bid item DKP
      • Exporting Loot+Standings
    • Raiding with MorgDKP2 and MorgBid2
      • MorgBid2 (buttons, dkp ranking, etc.)
      • MorgBid2 commands (dkplist all etc.)
      • Whisper system
    Overview One thing lacking in the current documentation is a clear overview of how stuff fits together. Hence, I made the following picture to present the overall idea behind this add-on: MorgDKP2 consists of two parts. The first one being an add-on inside WoW, which the MasterLooter uses to keep track of DKP during raids. The second part is the MorgDKP plug-in into eqdkp(+), which allows a master looter to import or export DKP information to a website. Individual raiders can see their DKP standings outside wow on the eqdkp(+) website. Inside WoW, they have two ways to interact with the Master Looter, e.g. to need/take/pass an item. Either they use an additional add-on called MorgBid2 or they use the so-called whisper system.
  • Avatar of Sarothe Sarothe Dec 18, 2008 at 21:42 UTC - 0 likes

    Two nights of using MorgDKP2 fixed price DKP and it is going awesomely! DKP has never been so easy. Even the guildies are starting to get the hang of it. I'm putting together documentation for the guild so I'll pass that onto Morgalm and hopefully it will help others.

    @morgulhir - After right-clicking on the item and bringing up the window to the right with the value-box and all the check boxes next to classes, you need to tick which classes you want to offer the loot to. I just click 'all' so that no one in the raid is left wondering what is happening. After selecting any box you will see that the yellow triangle graphic changes to dice. Clicking on the dice starts the auction.

    Your window to the right of the loot will then change to the tick boxes for the next item in the loot window. To monitor your the auction you just started, right-click on that item again. You should see a list of bidding/passing players and their bids. When you have finished the auction, clicking on the persons name should post a 'winning bid' comment in raid chat and bring up the standard Blizz "Loot <item X> to <player Y>" conformation box. Clicking yes should loot the item to them.

    Make sure you have masterlooter, not using Xloot, not using Pitbull, and all should be fine!

  • Avatar of Morgalm Morgalm Dec 18, 2008 at 21:37 UTC - 0 likes

    First added some lootwindow help above so it's more clear just how the loot window works. Some "bugs" are actually design features I think.

    1. Yes for eqdkp+ you do it as mantys said. For eqdkp as long as it is on the same website you just enter its directory name/in game name on next line just as you do for 1 pool and it will load both.

    2. If you run zero sum it will take care of giving other members the correct number of DKP. Read the loot window help above. If you left click any members name it will try give the item to that member. A window should popup saying give "item" to "member"? and you click yes or no. If that isn't working you must have an error and get me that error please.

    4. Yeah NO MORE BUGS! then I can finish raidtracker:P

  • Avatar of morgulhir morgulhir Dec 18, 2008 at 13:11 UTC - 0 likes

    thanks, Mantys!

    1. Never tried to sync it yet, just was trying to get it to work first - obviously a bad idea, as much seems to be adjusted during the import to EQDKP.

    2. it's actually fixed 0sum-DKP so when someone gets the loot for 20 DKP, everyone will get 2 DKP. Gets messy when the value of the loot was actually 25 and i'd like to correct this for the addon to re-do the calculations, as later i most probably have to do it myself manually for everyone. right?

    3. Thanks for this one. I always looked at the part /morgdkp2> and thought what the hell should that mean - now I got it, it's actually the end of a big log that i need to copy, thanks ;)

    4. OK it's cool, looking forward for the tool ingame ;) BTW i hope there will be a tool implemented for changing the DKP value of someone with dividing it between others also, for 0DKP ;)

    Thanks a lot, made it clear for me for now :D

  • Avatar of MANTYS MANTYS Dec 18, 2008 at 12:05 UTC - 0 likes

    Ive been using it for some time now so I'll just anwser what I can.

    1: as far as I know you set up dkp pools in your eqdkp+ website. mine has 2 and they are both imported correctly. thing is the syntax of the dkpdata uses(just short global view):

    dkppoolname {name, class, values etc. for every char}
    dkppoolname {name, class, values etc. for every char}
    

    so if you open the export file you should be able to see that kind of information (multiple pools). I'm not sure about normal eqdkp website because I don't use it myself.

    2: Not to sure about this one but have you set the addon to use "fixed dkp" because it seems to be the type of looting you're using. (could be that its not set or maybe wrong)

    3: When you click export raid you get a small widnow with the question to clear raid db .. what you need to do is press CTRL-C (copy) everything in that little box. its automatically selected so ctrl-c is enough. then paste it to the import plugin of morgdkp2 on your website and thats all. Haven't heard of an export file from the addon just this XML code you get when clicking export raids.

    4: during import it first parses the log I mentioned above and shows a list of whats being imported into your eqdkp system. Here you can edit the items and their looter/dkp value if needed. you can delete events/raids/attandees everything before finalizing the import. If you read this part about the addon above he says he's still busy getting the tracker as it used to be in morgdkp1(which was very nice)

    extra question: no lib = no library version. for people who install libraries for their addons seperatly (correct me if I'm wrong about this)

    hope this helps you.

Facts

Date created
Oct 15, 2008
Category
Last update
Jul 01, 2013
Development stage
Release
Language
  • enUS
License
All Rights Reserved
Curse link
MorgDKP2
Downloads
32,620
Recent files
  • R: v5.06 for 5.3.0 Jul 01, 2013
  • A: r251 for 5.3.0 Jun 30, 2013
  • R: v5.05 for 5.2.0 May 06, 2013
  • A: r249 for 5.2.0 May 02, 2013
  • A: r248 for 5.2.0 Mar 24, 2013

Authors