KonferSK (Suicide Kings)

Main Loot Distribution Window

Konfer (Suicide Kings Edition) implements the Suicide Kings loot distribution system. This mod is under active development so comments, good or bad, are welcome. I especially want to hear from you if you find any problems so that I can fix them ASAP. The official home for KSK is http:kahluamod.com/ksk. Also if you are able to translate KonferSK into other languages I would love to hear from you.

Features

• Supports multiple configurations, including guild configs and PUG configs. Each configuration is completely discrete.
• Quick and easy user and list management
• Simple, compact user interface
• Robust synchronization between administrators
• Item editor that allows you to auto-assign items to users or set default loot priorities
• User-only mode for non-administrators so they can see their list positions and watch looting take place
• Auto-assignment of loot when a bid is won
• Auto-assign loot to defined enchanters if no users bid on an item
• Supports open rolls that do not suicide users on lists
• Open roll system supports alt-spec rolls (/roll 101-200)
• Import of existing SKG users and lists
• Import users by guild rank or from a CSV list
• Export to CSV or XML formats
• Announces winners in guild or raid chat
• Supports silent bidding (highest bidder not announced)
• Filters out all mod-related messages for master looter so chat isn't cluttered
• Will support automatic list position decay (in a few weeks)
• Allows master looter to force bids and retractions
• Automatically assigns BOE items that are not bid on to the master looter
• Automatically supports class restrictions if an item is class specific
• Guild rank based filtering (allow only raiders and above to roll, then members and above etc)
• Allows you to define user "roles" such as tank, healer, spellcaster etc, and filter based on that role
• Detailed admin guide at http:kahluamod.com/ksk/admins.html (summarized below)

First Time Usage

To start using KonferSK you must first create a "configuration". KonferSK supports any number of configurations, each of which can be thought of as a completely different installation of KonferSK. They share no data whatsoever. To create a configuration type:

/ksk createconfig "Configuration Name"

Since this is your first configuration, it will also be the default. You can now use "/ksk" to access the main window. You can also type "/ksk config admin" to get to the configuration admin panel.

The first thing you need to decide is whether or not this is a guild or a PUG configuration. Guild configurations broadcast all of their information to the guild, and PUG configurations only to an active raid. Usually only the guild leader or an officer will create a guild configuration. You should then decide whether or not alts are "tethered". If alts are tethered, it means that only 1 entry will appear in any roll lists for a user. All of that user's defined alts will appear underneath that main user, and they all move on the lists as a group. Thus, no matter which toon they are playing, if they move on a list all of their toons move together. If you want each toon to be its own entity and move independently of each other, turn alt tethering off.

Once the configuration has been created, press the "Users" tab at the bottom or type "/ksk users". This will display the user editor. You can then either create each user by hand, import guild users by rank, or import an existing SKG players list if you were using SKG. When adding users you can assign each user a specific "role". The possible values for the role are "Healer", "Spellcaster", "Melee DPS", "Ranged DPS" and "Tank". It is possible to filter out bids based on which role a user has. If you don't care to do role filtering, leave this as "Not Set" (or you can define the roles for keeping track of who does what and simply not use role filters).

Once you have users defined, you should press the "Lists" button at the bottom or type "/ksk lists". This will show you the currently defined lists and the members on each list, in their correct order. Currently this will be empty. Press the "Config" tab at the top to display the list configuration window. At the bottom right are buttons you can use to create, delete, rename lists etc, or import users into the lists by rank or from an existing SKG roll list if you have SKG installed. Once a list has been created, you can change its sort order if you do not want lists to simply be sorted alphabetically (for example, you want the raiders list displayed before the members list). Lists with the lowest numbered sort order will be displayed first, and lists with the same sort order will be sorted alphabetically. If you do not import users from the guild roster or SKG, press the "Members" tab at the top, select the list you want to add users to, and press the "Insert" button to insert users into the list.

Commands

• /ksk or /ksk lists - opens the main window, which is the loot members list
• /ksk loot - opens the loot assignment window
• /ksk items - opens the item editor
• /ksk additem itemlink - adds the specified item to the item editor. You need to shift-click an item link from elsewhere to get the correct item link.
• /ksk users - opens the user editor
• /ksk sync - opens the sync manager
• /ksk config - opens the loot assignment options window
• /ksk help - shows all other commands you can use

Loot Assignment

There are things you can do to make your life easier when it comes time to distribute loot. First, if you have multiple lists that people roll on and you usually start with one particular list, set the default roll list in the loot configuration window (/ksk config). Second, if this is a guild configuration and your ranks are sanely assigned and you use rank filtering, set the default rank you want to start bidding with in each list's configuration. Third, correctly mark those users that are enchanters in the user editor.

When a user has been marked as an enchanter in the user editor, you can select them in the loot assignment options to receive loot that is not bid on. You can set up to 6 enchanters here. Whichever of these enchanters is in raid will be awarded any item that is not bid or rolled on (they will not be suicided).

By default "Auto assign loot when bids close" is enabled. What this means is that when users have bid on an item and a winner has been determined (or users have rolled, or no users have bid and a trusted enchanter is online), KSK will give you the option to automatically assign the item to the relevant user. You always have the option of canceling this auto-assignment, but if you accept, the item is immediately awarded to the user, there is no need to select the item in the standard Blizzard loot frame. In fact if you auto-assign the loot, it will be removed from the Blizzard frame.

Sometimes you may want a specific user to receive a specific item, either because they are collecting a set or because you made a loot mistake or correction and want to ensure that a user receives an item the next time it drops. To do this, add the item with /ksk additem, and in the item editor (/ksk items) select "Assign Next Drop to user", and then press the "Select" button to select the user that will receive the item. You can optionally cause this auto-assignment to suicide the user on a given list, and if this is to be a once-off auto-assignment, select "Auto remove when assigned". If you want the user to receive all drops of the item leave that option unchecked. A good use of this option is for items like the shards for the legendary mace out of Ulduar, you can use this to always assign them to the same healer until they have all 30 shards.

When you add an item to the item list you can also select a specific list to roll on for the item (for example, force Tier items to be rolled for on a Tier list). You can also set custom class restrictions, although the defaults are based on the item type, armor type, or any intrinsic class restrictions.

Each time you click on a lootable item (the top right hand window in the loot panel) it will set whichever list is appropriate as the default (either the global default list or a list specifically set for that item in the item editor). It will also set the initial class filters and guild rank, if you have set any of those values for the roll lists or for the item. You can change the list and filters as you see fit, and then press either "Open Bids" or "Open Roll". Opening bids will allow users to whisper you the word "bid" to bid on an item or "retract" to retract their bid. If they are also using KonferSK, they will see the same window you do and will be able to press the Bid or Retract buttons.

You can change the bid list while bidding is active to move from one list to another, and you can change various filters such as the guild rank filter to allow more and more users to bid. For my own guild, we always start bidding for "raiders", and then if none bid change the guild rank filter to "members", then "initiates" etc. There is a little red "-" next to the guild rank filter that will automatically move down one guild rank to make life easier for rank based filtering.

As the master looter you can select a member from the members list (bottom left panel) and press "Force Bid" to force that user to bid, or select a person who has already rolled and press "Force Retract" to force a retraction. When bid time is over, press "Close Bids" and if there was a winner, it will suicide the user on the list they bid on, and optionally automatically assign the item to them. If no users bid and there are enchanters online (and the option is enabled) it will assign the item to an enchanter to be disenchanted. If the item is a BoE item and the option is set (it is by default) it will assign the item to the master looter instead of an enchanter.

If you want users to be able to roll for an item and not be suicided, you can press "Open Roll" instead of "Open Bids". This starts a 10-second roll-off. Only the 5 highest rollers are shown. If a user types /roll within the last 5 seconds of the countdown, the timer will be automatically extended back to to 5 seconds. KSK supports the notion of "rolling for alts". Normal users who want the item for their main spec can use /roll as per normal. If a user is rolling for an alt, they can use /roll 101-200 to indicate they are rolling for an alt. KSK automatically recognizes that a main spec roll of 89 is higher than an alt-spec roll of 190. If a user rolled incorrectly (they typed just /roll instead of /roll 101-200 for an off-spec item), they can re-roll. However, they do not actually get another shot at rolling a higher number. Their original number is preserved. For example, if a user typed /roll and rolled 65, but realized they should have rolled for off-spec and type /roll 101-200, KSK will adjust their original roll and pretend they had rolled 165 initially, even if their new roll was 199. You can manually pause and resume the roll countdown timer by pressing "Pause" and "Resume".

• 

  Author

  Cruciformer

  (Project Manager)

  Downloads

  • KonferSK (Suicide Kings)
  • Konfer (PUG Edition)

Release 204:

• Removed the online detection code as it was causing people to lag out.
  

Release 200:

• Moved all roll related options, including broadcast message options, to a new rolls tab on the config panel. You can access this with /ksk config rolls.
  
• Made off-spec rolls optional. Disabling offspec rolls will only recognise normal /roll or /roll 1-1 to cancel a roll.
  
• Added a feature called "suicide rolls". This uses an open roll to determine a winner, but also suicides the user on the current list. Why anyone would want this is still a mystery to me but users have asked for it.
  
• You can make the "open roll" button be a suicide roll by default. Set the option in the roll options tab.
  
• Shift-clicking the open roll button will use a suicide roll instead of an open roll. If you have suicide rolls enabled by default, then shift-clicking will start a normal (non-suicide) roll.
  
• Added new 'Announce All' button to the list manager. This will announce the full list, not just the active raiders and their relative positions.
  
• Can now Shift-click either the Announce or the new Announce All button to make it announce the list in guild chat instead of raid chat.
  
• Added Emblem of Frost to the default list of items to be ignored.
  
• Detect other KahLua Konfer addons and allow you to select which one should be active. This will be shown each time you first log in or refresh your user interface. Only one Konfer addon can be active at a time.
  
• If you suspend the mod with /ksk suspend that setting is now "sticky". I.e it will survive a user interface reload or game restart. PLEASE BE AWARE OF THIS! If the mod is suspended it will not pop up when you loot a corpse in a raid. Of course you can always resume it at any time with /ksk resume and re-loot the corpse to have it pop up.
  
• Changed some internals to use better event names so as not to clash with other mods. Also corrected for the KKore fix to the events and messages API.
  
• The winning bidder's position is now displayed in [brackets] next to their name when the winning bid is announced in raid or guild chat.
  
• Handle the case where an item received in a sync message that isnt in the users item database fails more gracefully.
  
• Fixed an error that would pop up if the mod was suspended and you joined a raid.
  
• Fixed a bug where the mod was still poping up if you were not the ML and you had either suspended the mod or had auto-popup disabled.
  
• Added a feature where you can set the bid loot threshold. This can be (and probably should be) higher than the threshold set in the Blizzard UI. Anything at or above this threshold is bid on. Anything below it is optionally automatically sent to a disenchanter.
  
• In the loot lists and other convenient places, if a raider is offline, their class color is dimmed. Raiders that are online have their normal class colors.
  
• Two new options in the item editor: one will allow you to automatically assign an item to a raid enchanter to be disenchanted, and one to automatically loot the item to the master looter. Both options will completely bypass bidding and rolling for the item and simply assign the items to the relevant person.