README.bbcode

[SIZE=5][B]Sami's Trial Helper[/B][/SIZE]

An Elder Scrolls Online addon that monitors group and say chat for item links, detects which ones you haven't collected yet, and gives you a one-click button to request them from the player who posted them.

[SIZE=4][B]Features[/B][/SIZE]

[LIST]
[*][B]Automatic detection[/B] — Scans group (and optionally say) chat for item links and checks each one against your set collection.
[*][B]HUD buttons[/B] — A draggable window shows one button per player who has items you need, labelled with their name and item count.
[*][B]One-click requests[/B] — Clicking a button drafts the request message in the chat box. Press Enter to send.
[*][B]Whisper or group[/B] — Send requests to group chat or directly whisper the player.
[*][B]Message splitting[/B] — If the item list exceeds ESO's 350-character limit, messages are automatically split and queued; each chunk is loaded into the chat box as soon as you send the previous one.
[*][B]Dismiss without sending[/B] — Click the X on any button to clear it without sending a message.
[*][B]Record updates[/B] — If the same player posts more items later, their button updates in place rather than duplicating.
[*][B]Auto-clear on zone change[/B] — All tracked records are cleared when you travel to a new zone (configurable).
[/LIST]

[SIZE=4][B]Dependencies[/B][/SIZE]

[LIST]
[*][URL=https://www.esoui.com/downloads/info7-LibAddonMenu.html]LibAddonMenu-2.0[/URL] ≥ 41
[/LIST]

[SIZE=4][B]Settings[/B][/SIZE]

Open [B]Settings → Addon Settings → Sami's Trial Helper[/B] to access:

[LIST]
[*][B]Enable Debug[/B] (default: Off) — Print diagnostic messages to the chat window
[*][B]Clear On Zone Change[/B] (default: On) — Clear all tracked records when changing zones
[*][B]Listen to Say Channel[/B] (default: Off) — Also scan the say channel for item links
[*][B]Listen to Group Channel[/B] (default: On) — Scan the group channel for item links
[*][B]Whisper Player[/B] (default: Off) — Whisper the player directly instead of posting in group chat
[/LIST]

[SIZE=4][B]How It Works[/B][/SIZE]

[LIST=1]
[*]The addon listens to [FONT=Courier New]EVENT_CHAT_MESSAGE_CHANNEL[/FONT] for messages in the configured channels.
[*]Each item link in the message is checked: is it a set collection piece, and have you unlocked it?
[*]Uncollected pieces are grouped by the player who posted them and shown as a button in the HUD window.
[*]Clicking a button drafts a message listing all the items you need from that player.
[*]If the full list exceeds 350 characters, it is split into sequential messages queued automatically.
[/LIST]

[SIZE=4][B]Version[/B][/SIZE]

0.0.1

[SIZE=4][B]Author[/B][/SIZE]

samihaize