Splinter Counter - ZulgAuras

Splinter of Atiesh Counter - ZulgAuras Addon

Description:

Splinter Counter - ZulgAuras is a World of Warcraft addon designed to help raid groups track the number of splinters collected by each player. This addon provides a user-friendly interface to display, add, remove, and sync splinter counts across the group or raid. It ensures that everyone in the raid is up-to-date with the latest splinter counts, making it easier to manage and distribute splinters efficiently.

Features:

• Display Window: A movable and resizable window displaying the splinter counts for each player.
• Color-Coded Display: The display uses color gradients to indicate the number of splinters left to collect, from red (40 left) to green (0 left).
• Slash Commands: Easy-to-use slash commands for showing/hiding the display, adding/subtracting splinters, removing players, checking collected splinters, and syncing data.
• Syncing: Automatic syncing of splinter data across the group or raid to ensure everyone has the latest information.
• Master Looter Announcements: Automatic announcements in raid chat when a player loots a splinter, if the user is the master looter.

Functions:

1. Display Window:

   • The addon creates a movable and resizable window that displays the splinter counts for each player.
   • The window has a title, close button, and a content area to display the splinter data.
   • The content area is updated dynamically based on the splinter data.

2. ReportToChat:

   • Sends a message to the raid or guild chat, depending on the user's current group status.

3. ShowRemoveConfirmation:

   • Displays a confirmation dialog to remove a player from the splinter list.
   • Requires the user to type "REMOVE" to confirm the removal.
   • Updates the display and prints a message to the chat upon successful removal.

4. UpdateDisplay:

   • Clears the previous content and updates the display with the latest splinter data.
   • Sorts the data in descending order by count and applies color gradients to indicate the number of splinters left to collect.
   • Creates buttons for each player to display their name, count, and remaining splinters.
   • Allows users to report splinter counts to the chat by shift-clicking on player names.

5. SyncData:

   • Sends the splinter data to the group or raid as an addon message to keep everyone updated.

6. OnEvent:

   • Handles various events such as loot detection, player login, addon messages, and group roster updates.
   • Updates the splinter data and display based on the detected events.
   • Automatically announces splinter loots in raid chat if the user is the master looter.

7. Slash Command Handler (/SCZA):

   • Provides several slash commands for managing the splinter data:
     • /SCZA show: Shows the splinter counter window.
     • /SCZA hide: Hides the splinter counter window.
     • /SCZA add <Name> <#>: Adds the specified number of splinters to the given player's count.
     • /SCZA subtract <Name> <#>: Subtracts the specified number of splinters from the given player's count.
     • /SCZA remove <Name>: Removes the player from the list (confirmation required).
     • /SCZA received: Lists all players and their collected splinters.
     • /SCZA sync: Manually syncs the splinter data with the group or raid.

Usage:

1. Installing the Addon:

   • Download and extract the addon files into your World of Warcraft Interface/AddOns folder.
   • Restart the game or reload the UI to enable the addon.

2. Using the Addon:

   • Use the /SCZA show command to display the splinter counter window.
   • The window will automatically update with the latest splinter data as players collect splinters.
   • Use the provided slash commands to manage the splinter data as needed.
   • The addon will automatically sync the data with the group or raid and announce looted splinters if you are the master looter.

With Splinter Counter - ZulgAuras, managing splinter collection in your raid has never been easier. Keep track of who has collected how many splinters, and ensure your raid is always in sync with the latest data. Enjoy a more organized and efficient raiding experience!