Loot Roll-Addon

1. What is Vision Loot?

• Vision Loot is a loot add-on for World of Warcraft Classic / MoP Classic.
• It is designed for groups or raids using Master Looter.
• The add-on automatically starts a loot session when the Master Looter opens a loot window containing at least one epic item.
• Green, blue, or lower-quality items are ignored.
• Players receive a response window where they can choose one option per item:
  • Need
  • Greed
  • Pass
• When a player selects Need or Greed, the add-on automatically rolls a number from 1 to 100.
• The roll is announced in raid chat.
• The Master Looter can then see:
  • all responses
  • all rolls
  • received item counts
  • suggested winners
• The Master Looter can award loot directly through Vision Loot.

2. Basic Concept

• Vision Loot uses clearly separated roles.

Master Looter

• The Master Looter can:
  • use /vlc
  • enable or disable Vision Loot
  • scan loot
  • start loot sessions
  • view player responses
  • view suggested winners
  • award items
  • view the history
  • end sessions
  • use the export function
  • reset session data
  • open the settings

Normal Players

• Normal players can:
  • receive response windows for items
  • choose Need, Greed, or Pass
  • roll automatically
  • open the history with /vh
• Normal players cannot:
  • open /vlc as a management window
  • manage loot sessions
  • scan loot
  • award items
  • change settings
  • end sessions
  • reset data
  • generate test items
• For normal players, the following tabs are locked or greyed out:
  • Overview
  • Loot Session
  • Settings
• Only the History tab is available to normal players.

3. Add-on Activation for the Master Looter

• When a player becomes the Master Looter, Vision Loot asks:
  • “Use VisionLoot?”
• There are two options:
  • Yes
  • No

Yes

• If the Master Looter selects Yes, Vision Loot runs normally.
• This means:
  • epic loot automatically starts a session
  • the main window opens for the Master Looter
  • players receive response windows
  • rolls are processed
  • items can be awarded through Vision Loot

No

• If the Master Looter selects No, Vision Loot is not used automatically for the current Master Looter phase.
• This means:
  • no automatic popup appears
  • no automatic loot session starts
  • no automatic distribution happens through Vision Loot
  • the normal WoW loot system remains usable
• The Master Looter can activate Vision Loot again later.

4. When Does a Loot Session Start Automatically?

• A loot session only starts when all of the following conditions are met:
  • the player is the Master Looter
  • Vision Loot was enabled with Yes
  • the normal WoW loot window is opened
  • the loot window contains at least one epic item
  • the add-on correctly detects the item as epic
• If the loot window only contains green or blue items, nothing happens:
  • no main window opens
  • no response window opens
  • no session starts
  • no raid chat spam is sent
  • no broadcast is sent to players

5. Player Response Window

• When the Master Looter scans epic loot, players receive a response window.
• If there are multiple items, the window shows:
  • “Respond to all items”
• For each item, the player sees:
  • item icon
  • item name
  • item quality
  • item level
  • item type, such as cloth, leather, mail, plate, or trinket
  • buttons for Need, Greed, and Pass
• The player clicks one button directly for each item.
• There is no additional submit button.

6. Need, Greed, and Pass

Need

• When a player clicks Need:
  • the item is marked as Need
  • the add-on automatically rolls from 1 to 100
  • the roll is announced in raid chat
  • the player cannot click again for that item

Greed

• When a player clicks Greed:
  • the item is marked as Greed
  • the add-on automatically rolls from 1 to 100
  • the roll is announced in raid chat
  • the player cannot click again for that item

Pass

• When a player clicks Pass:
  • the item is marked as Pass
  • no roll is made
  • the player cannot receive the item
  • the player cannot click again for that item

7. Multiple-Click Protection

• Each player can only respond once per item.
• After Need, Greed, or Pass has been selected:
  • the buttons for that item are locked
  • a second click is not possible
  • no second roll is generated
  • no duplicate response is sent
• Once all visible items have been answered, the response window closes automatically.

8. Automatic Closing

• The response window has a timer of 5 minutes.
• If a player does not respond, they remain listed as Waiting in the evaluation.
• The Master Looter cannot award the selected item while relevant players are still marked as Waiting.
• The window can also be closed with ESC.

9. Player Status in the Master Looter Window

• In the Direct Award area, the Master Looter can see each player’s status.
• Possible status values are:
  • Need
  • Greed
  • Pass
  • Waiting
  • Not usable

Need

• The player wants the item and selected Need.

Greed

• The player wants the item, but only as Greed.

Pass

• The player passed and cannot receive the item.

Waiting

• The player has not responded yet.
• As long as a player is marked as Waiting, awarding the item is locked.

Not Usable

• The player cannot use the item according to the add-on filter.
• This can happen because of the wrong armor type.
• Examples:
  • Mage, Warlock, Priest: Cloth
  • Rogue, Druid: Leather
  • Hunter, Shaman: Mail
  • Warrior, Paladin, Death Knight: Plate
• Players marked as Not Usable do not need to respond.
• Players marked as Not Usable cannot receive the item.

10. Winner Logic

• Vision Loot calculates a suggested winner.
• The winner logic is:
  • Need wins over Greed
  • within the same response type, the player with fewer already received items is preferred
  • if both players have received the same number of items, the higher roll wins
• Example:
  • Player A:
    • Need
    • Roll 95
    • already received 2 items
  • Player B:
    • Need
    • Roll 50
    • already received 1 item
  • Winner:
    • Player B
• Player B wins because they have received fewer items.
• The roll only decides when the number of already received items is equal.

11. Item Count / Received Items

• Vision Loot counts how many items a player has received through the add-on.
• The table may show values such as:
  • 0x
  • 1x
  • 2x
  • 3x
• This number is included in the winner calculation.
• If one player has already received more items than another player, the player with fewer received items is preferred.

12. Awarding Items

• The Master Looter selects an item from the loot list on the left.
• The center and right areas then show the matching responses and candidates for that exact item.
• The Master Looter can select a player and click AWARD.
• Important requirements:
  • the normal WoW loot window must stay open
  • the player must really be the Master Looter
  • the selected player must be a valid loot candidate
  • players with Pass cannot receive the item
  • players marked as Not Usable cannot receive the item
  • awarding is locked while relevant players are still marked as Waiting
• When AWARD is clicked, Vision Loot attempts to select the correct WoW Master Loot candidate.
• The item is awarded using the real WoW loot function.
• After a successful award:
  • the item is removed from the active loot list
  • the item is written to the history
  • the player’s received item count is increased
  • the award is announced in raid chat
• Example announcement:
  • Zukû receives [Itemname] with roll 87 – received: 2x

13. Raid Chat Announcements

• Vision Loot uses raid chat when the player is in a raid.
• When a player selects Need or Greed, the roll is announced.
• Example:
  • [Vision Loot] Zukû rolls Need on [Itemname]: 87
• When an item is awarded, the winner is announced.
• Example:
  • [Vision Loot] Zukû receives [Itemname] with roll 87 – received: 2x

14. Loot History

• The history stores previous item awards.
• It shows:
  • time
  • item
  • winner
  • roll
  • received item count
• Normal players can view the history.
• The quick command is:
  • /vh

15. Commands

/vlc

• Opens the Vision Loot main window.
• Only the Master Looter can fully use this command.
• If a normal player enters /vlc, they receive a message saying that /vlc is only available to the Master Looter.

/visionloot

• Alternative command for /vlc.
• Also only works fully for the Master Looter.

/vh

• Opens the history directly.
• This command is intended for normal players.

/vlc ja

• Enables Vision Loot for the Master Looter.
• This can be used if the Yes/No prompt was skipped or if Vision Loot should be enabled later.

/vlc yes

• Same function as /vlc ja.

/vlc nein

• Disables Vision Loot for the current Master Looter phase.
• Vision Loot will not open automatically.

/vlc no

• Same function as /vlc nein.

/vlc reset

• Resets the current session.
• Useful if old test data or duplicate entries are present.
• This command is intended only for the Master Looter.

/vlc debug

• Shows debug information about Master Looter detection.
• This command is useful if the add-on detects the Master Looter incorrectly.

16. Tabs in the Main Window

Overview

• Only active for the Master Looter.
• Shows general information about the current session.

Loot Session

• Only active for the Master Looter.
• Shows:
  • current drops
  • responses
  • rolls
  • winners
  • direct award controls
  • current session data

History

• Available to the Master Looter and normal players.
• Players can open this area directly with /vh.

Settings

• Only active for the Master Looter.
• Normal players cannot use this tab.

17. Quick Actions

• The main window contains quick actions.

RND Item

• Generates a test item.
• Only available to the Master Looter.

Reset

• Resets the current session.
• Only available to the Master Looter.

Export

• Exports the loot history.
• Only available to the Master Looter.

End Session

• Ends the current session.
• Only available to the Master Looter.

18. Tooltip Function

• When a player or the Master Looter hovers over an item, the normal WoW tooltip is shown.
• The tooltip works through:
  • item name
  • item icon/image
• The tooltip is attached to the left side of the icon.
• This prevents it from appearing directly over the response window.

19. Duplicate Items and New Boss Loot

• Vision Loot separates new loot windows from old loot windows.
• When a new boss is looted, a new clean loot session should be created.
• Items from the previous boss should not be carried over into the new session.
• At the same time, the add-on protects against importing the same loot window multiple times.
• This is necessary because WoW can trigger several loot events in quick succession.

20. Requirements

• For Vision Loot to work correctly:
  • the Master Looter must have the add-on installed
  • players who should receive response windows must also have the add-on installed and enabled
  • the group or raid must use Master Looter loot mode
  • the normal WoW loot window must remain open while awarding items
  • the loot window must contain at least one epic item for Vision Loot to start automatically

21. What Happens If a Player Does Not Have Vision Loot?

• If a player does not have Vision Loot installed or enabled:
  • they do not receive a response window
  • they cannot automatically send Need, Greed, or Pass
  • they cannot roll automatically
  • they may appear as Waiting or without a valid response depending on the session status
  • they cannot be cleanly included in the automatic Vision Loot evaluation
• For fair loot distribution, all raid members should have Vision Loot installed and enabled.

22. Recommended Raid Flow

• Set the raid to Master Looter.
• The Master Looter receives the question:
  • “Use VisionLoot?”
• The Master Looter clicks Yes.
• The boss is killed.
• The Master Looter opens the loot window.
• Vision Loot checks whether epic items are present.
• If epic loot is found, the session starts automatically.
• Players receive their response window.
• Players choose Need, Greed, or Pass for each item.
• Vision Loot rolls automatically for Need and Greed.
• The Master Looter waits until all relevant players have responded.
• The winner is calculated.
• The Master Looter clicks AWARD.
• Vision Loot awards the item, writes it to the history, and announces the award in raid chat.
• The Master Looter continues with the next item.

23. Short Summary

• Vision Loot is a Master Looter add-on for epic raid loot.
• Only the Master Looter manages loot.
• Players only respond to items.
• Normal players only have access to the history.
• /vlc is for the Master Looter.
• /vh is for players to open the history.
• Green and blue items are ignored.
• Epic items start a session automatically.
• Need and Greed trigger automatic rolls.
• The winner is calculated based on:
  • Need or Greed
  • received item count
  • roll value
• Items are awarded through the real WoW Master Loot function.
• The history stores all awards.