XLoot

From Turtle WoW Wiki

XLoot is a customizable loot frame replacement , offering enhanced visual features, flexible options, and improved loot handling.

Installation

GitAddonsManager The easiest way to keep XLoot up to date is by using GitAddonsManager.

  1. Add the Repository: Add the following URL to GitAddonsManager: https://github.com/Road-block/XLoot_AddOns.git
  2. Select the Branch: Ensure that the master branch is selected.
  3. Update: Using GitAddonsManager, you can check for and install updates for all your AddOns with a single click.

Manual Installation

If you prefer manual installation, follow these steps:

  1. Go to the Release page of the repository.
  2. Get the XLoot_AddOns-x.yy-11200.zip from Latest.
  3. Unpack the .zip and move these folders into your Interface/AddOns directory and restart the game.
  • XLoot
  • XLootGroup
  • XLootMaster
  • XLootMonitor

Note:

  • XLootGroup, XLootMaster and XLootMonitor are optional and can be disabled or removed if their functionality is not required.
  • XLoot is a requirement for any of the other plugins to function.
  • XLoot will probably not play nice with other addons that modify the lootframe.



Git Links


Usage

Opening the Options Menu

  • /xloot options Opens the configuration menu in-game for customizing XLoot.

Loot Frame Interaction

  • Left-click on loot items to pick them up.
  • Shift + Left-click on an item to preview/equip.
  • Right-click on loot items to dismiss or perform alternative actions if configured.

Linking Loot

  • Click the Link All button to share loot links in chat channels.
  • The addon can send loot info via chat channels like raid, party, or custom channels.

Auto-Closing Loot Frame

  • The loot frame automatically closes when all items are looted or can be forced to close via scripts or commands.


Commands

Command Description
/xloot Prints help and available subcommands.
/xloot options Opens the configuration options menu.
/xloot advanced Options you may not want to mess with, but can anyway.
/xloot appearance Coloring, scaling, and skin of XLootFrame and each individual loot button.
/xloot behavior Change how XLoot behaves.
/xloot group A stack of frames for showing group loot information.
/xloot history Loot History.
/xloot lock [On] Makes loot frame unmoveable.
/xloot master XLoot Master plugin, replacement for the standard Master Looter dropdown.
/xloot monitor XLootMonitor plugin configuration.
/xloot profile [Default] Set profile for this addon.
/xloot standby [Active] Suspend/resume this addon.
/xloot about Print out addon info.



Preview

Options:


XLoot:



Configuration Options

Accessing Options

  • Use /xloot options to open the configuration menu.
  • Alternatively, right-click the loot frame or use the in-game menu if integrated.

Main Settings

  • Lock Frame: Locks/unlocks the loot frame position.
  • Scale: Adjust the size of the loot frame.
  • Cursor Positioning: Enable/disable frame positioning at cursor.
  • Collapse Loot: Collapse multiple loot items into a single row.
  • Loot Expand: Show detailed loot info.
  • Quality Borders & Frames: Highlight items based on quality with colored borders and frames.
  • Auto Loot: Enable swift/auto-looting during specific actions like fishing or container opening.

Appearance

  • Background & Border Colors: Customize the frame's background and border.
  • Loot Quality Borders: Toggle borders around loot items based on quality.
  • Highlight Loot: Show highlight frames for high-quality loot.
  • Text Colors: Set text colors for item names and info.

Behavior

  • Snap to Cursor: Frame will appear at cursor position.
  • Smart Snap: Frame adjusts position intelligently.
  • Link All Visibility: When to show the link button (always, raid, party).
  • Link Threshold: Minimum quality level for loot to be linked/shared.
  • Channel Selection: Choose chat channels for sharing loot links.

Advanced & Debug

  • Enable debug mode for troubleshooting.
  • Force compatibility mode if encountering errors.
  • Reset to default settings.



Usage Tips

  • Positioning: Drag the loot frame to your preferred screen location. Use /xloot options > Frame to lock/unlock.
  • Looting: Click items directly to loot. Use shift-click for preview.
  • Linking Loot: Use the Link All button to share loot in chat channels.
  • Auto Close: The frame auto-closes when no more loot is available unless configured otherwise.
  • Swift Looting: Enable Swiftloot for faster looting during container or corpse looting.




Additional Features

  • Loot Quality Highlighting: Items of higher quality can be highlighted with borders or frames.
  • Custom Channels: Share loot links in custom chat channels.
  • Item Info & Tooltips: Hover over loot items for detailed info, with options to display additional info text.
  • Collapse & Expand: Control loot display with collapse or expand options for cleaner UI.



Troubleshooting

  • Addon Not Displaying Properly: Make sure all dependencies (like Ace libraries and Dewdrop) are installed.
  • Performance Issues: Enable debug mode only for troubleshooting.
  • Compatibility Errors: Use the forcecompat option in /xloot options if errors occur on different WoW versions.



Frequently Asked Questions

Q: How do I change the loot frame position?

A: Drag the frame or set position via /xloot options > Frame settings.

Q: How do I enable or disable loot quality borders?

A: In the options menu, toggle Loot Quality Border under Appearance.

Q: How to share loot links?

A: Click the Link All button or use /xloot link in chat.

Q: How to reset settings?

A: Use /xloot defaults command or reset in the options menu.



Support & Feedback

  • For bug reports, feature requests, or translations, visit the GitHub repository.