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 and Suicide Kings 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
== 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 history - opens the loot assignment history window
/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 addloot itemlink - adds the specified item to the loot list (for manually adding loot items)
/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".
Change Log - Konfer Suicide Kings Edition
Changes in r217:
Fixed the user delete dialog to correctly display the "Delete all alts of user" option.
Pop up a visible warning rather than just printing a line of text if you receive protocol messages from a user whose mod is out of date.
Increased the protocol version number to force all users to upgrade. Users with older versions of the mod will still only see the printed warning, not the popup dialog.
Fixed a nasty bug in the user delete code where it was skipping over every second alt when you deleted a user and all their alts. Also fix corrupted user lists on startup if you had been affected by this bug.
Changes in r209:
Fixed importing of SKG and SuicideKings lists.
Fixed a Lua aerror that was popping up when you tried to add a new user.
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.
Originally posted by Eneswar I have a question. You see, we use 3 lists, one for 25 man normal, one for 25 man tier and one for 10 man. Now the problem is we run 2x 10 mans which is led by 2 different persons, and this 2x 10 mans is running on 2 different days, fridays and saturdays. Sometimes the person who is leading the raid on saturday cant be online on fridays which means he wont have the latest update, and so on. What would you recommend us to do?
Regards
Makes absolutely no difference. since no raider can be in two raids due to raid locks, and you only become raid locked once a boss is killed and loot is distributed, there is no issue at all. If users A-J were in the one raid and users K-T were in teh other raid, the person leading either raid doesnt need to be up to date with respect to each other, as the users all move relative to who is actually in the raid. Raiders who are not in the raid have their position fixed.
Originally posted by Eneswar
Id like a feature where you can regret a suicide, or a history page where it shows what spot the last few persons were on a specific list.
/ksk loot - the loot manager window. Big-ass button at the bottom called "Undo" should do what you want Keeps history for as long as your wow session is open. The actual history window shows who won what, as you know, but there is no convenient way to either record or display anywhere what their previous positions were.
I have a question. You see, we use 3 lists, one for 25 man normal, one for 25 man tier and one for 10 man. Now the problem is we run 2x 10 mans which is led by 2 different persons, and this 2x 10 mans is running on 2 different days, fridays and saturdays. Sometimes the person who is leading the raid on saturday cant be online on fridays which means he wont have the latest update, and so on. What would you recommend us to do?
Id like to request something, or maybe its already there but I cant find it.
Id like a feature where you can regret a suicide, or a history page where it shows what spot the last few persons were on a specific list.
You see sometimes misstakes can happen and we suicide someone on the wrong list, and then we cant see on what position that person were... So it would help a lot
Originally posted by jkasquires If I am not the "Admin" of a list does /ksk do anything for me? Or is this just something the person responsible for the Looting need? At the moment when ever I type in /ksk I get no list or loot listings. Just a default frame on both tabs.
Yeah it "does something" for you. If your admin broadcasts the config before raid, you will see all of the lists, and exactly what position everyone occupies on the list. Once he has broadcast the list, as the raid progresses, you will see all of the same movement on the lists that the admin sees. It will also pop up the KSK loot frame when the admin loots a corpse, where you can see what item is being bid on, who is bidding, and you can place and retract your own bids.
Get your admin to broadcast the config at the start of every raid. Its just good policy. Broadcasting does not affect other admins, just normal users. Other admins get their data by syncing.
If I am not the "Admin" of a list does /ksk do anything for me? Or is this just something the person responsible for the Looting need? At the moment when ever I type in /ksk I get no list or loot listings. Just a default frame on both tabs.
Added main-spec and off-spec roll buttons to the UI for both admins and normal users. Please note that as these buttons are used for other purposes when bidding, the tooltips for the buttons reflect the usage for bidding, not for rolling. Hopefully the button text is obvious enough that this wont bother people.
Added /ksk suspend and /ksk resume to suspend and resume normal mod execution respectively. When suspended KSK will not issue missing user warnings, and will not auto-open when a corpse is looted. Typically you want to suspend KSk when you are running a PUG.
Fixed a minor error in the German translation.
Fixed a bug where /roll was not working correctly for German locales. The new fix will now work in any locale, thanks to LibDeformat by cknight.
Several updates to reflect recent chages to KKore.
Added tooltips for most configuration options.
Added "End Roll" option when using the open roll tool so that you can end a roll without wiating for the timer to expire if you have the timeout set quite long and all the users hawho care have already rolled.
Added German translation. Special thanks to Stefan Junghanns (Tynia, Die Silberne Hand) for this. Some initial work was done by "Mephir". Thanks.
Pause the roll countdown if you switch to another KSK window during a roll.
Fixed a bug where the the role and rank filter changes were not being broadcast correctly.
Allow players to /roll 1-1 to cancel a roll if they change their minds.
Allow the master looter to remove a roll from the list.
Fixed a problem where strict armor filtering and strict role filtering was not being sent to other users of the mod correctly when the ML changed them for a loot item.
To any of the German people who use KSK, I am in need of a little help. A kind user partially translated KSK into German but is no longer responding to emails, and I would like to finish the translation before I release the next version, which is now complete and just waiting this translation. If you have the time, and are able to quickly download and test new beta versions and report bugs and respond to emails, please email me at cruciformer at gmail.com. Many thanks in advance.
Significantly improved UI library code that is much more compact and uses a lot fewer resources.
Removed unused strings from translation files.
Fixed a problem with co-admins not having their last event set.
Fixed status indicators (E for enchanter, F for frozen etc) not being displayed in the loot members list.
Fixed the "Suicide on Additional List" optin in the list config to actually suicide on the additional list. This will, however, create two undo records, one for the original list and one for the additional list.
Fixed a problem where undo events were not showing up in the loot history list correctly.
Add the item from an undo event back into the loot list so it can be re-rolled or bid on.
Correct the list position display for the loot list.
Do not obey the "frozen" setting for SuicideKings imports as it does not seem to do the same thing that KSK uses it for and it was setting all imported users as frozen.
Added the /ksk resetpos command to reset the window position if you manage to move it off-screen.
Display the current list in the import dialog so you know what list you are importing members into.
Fixed the assigning of enchanters so that selecting "None" from the dropdown menu now correctly removes that user from the enchanter list.
Always display enchanters class colors in the config screen.
Use secure hooks for UI elements to help prevent taint.
Correct display of list position when using the "suicide" whisper command.
Keeps history for as long as your wow session is open. The actual history window shows who won what, as you know, but there is no convenient way to either record or display anywhere what their previous positions were.
