GuildAssist

GuildAssist is a modern, dependency-free World of Warcraft Retail addon that brings guild recruitment, roster administration, activity tracking, events, applications, and guild-bank management together in one responsive, entirely local interface.

A complete, modern guild-management workspace for World of Warcraft Retail—built for recruitment, leadership, organization, and growth.

Built for guild masters, officers, recruiters, event organizers, and community leaders, GuildAssist replaces a collection of disconnected guild tools with one organized workspace. It requires no external services or third-party libraries, and all of its data remains on your computer in World of Warcraft's SavedVariables. Retail • Dependency-free • Entirely local • Responsive interface • No telemetry • No external account required

GuildAssist brings recruitment, roster administration, member activity, events, applications, guild-bank monitoring, announcements, local member profiles, reports, and protected backups together in one polished interface.

Whether you lead a progression guild, organize a social community, recruit new players, or simply want fewer repetitive officer tasks, GuildAssist gives your leadership team a clear and practical place to work.

✨ At a Glance

Recruit smarter with candidate queues, background /who searches, personalized messages, whisper keywords, blacklists, and Wingman.
Manage confidently with searchable roster tools, permission-aware actions, current-member validation, and destructive-action safeguards.
Understand your guild through activity history, joins, departures, rank changes, inactivity review, and local health insights.
Stay organized with events, applications, welcome queues, announcements, alt/main links, tags, and extended notes.
Protect your work with checksum-validated backups, safe imports, CSV roster exports, and Markdown guild reports.
Keep your data private with local SavedVariables storage and no automatic uploads, synchronization, analytics, or telemetry.

Why GuildAssist?

Guild leadership often means switching between separate recruitment addons, spreadsheets, notes, calendar tools, guild-bank windows, and chat macros. GuildAssist replaces that fragmented workflow with one cohesive addon designed specifically for everyday guild administration.

It is built around four principles:

Useful: every section solves a real guild-management task.
Safe: protected, destructive, and imported-data operations are validated before use.
Private: everything remains on your WoW installation unless you intentionally copy an export.
Focused: GuildAssist has no external libraries, accounts, advertisements, analytics, or cloud services.

Quick Start

1. Open GuildAssist

Enter either command in chat:

/ga

/guildassist

Both commands toggle the GuildAssist window. The full /guildassist prefix supports every /ga subcommand documented below.

2. Configure Recruitment

Open the Settings tab and review:

Automatic invitations from matching whispers.
Comma-separated whisper keywords.
Recruitment whispers before manual invitations.
Wingman minimum and maximum delay.
Minimum and maximum /who scan levels.
Activity-retention period.
Inactivity-review threshold.
Application-detection keywords.

Select Save settings when finished.

Guild invitations require a guild rank with invitation permission. Blizzard-protected actions may also require direct keyboard or mouse input.

3. Save a Recruitment Message

Open Recruitment, write a message of up to 255 characters, and select Save message.

Use %player% to insert the candidate's short character name automatically:

Hi %player%! We're a friendly guild recruiting for events, group content, and an active community. Would you like an invite?

When Send recruitment message before manual invites is enabled, this message is whispered before Recruit-button and /ga invite actions.

4. Build Your Candidate Queue

Add candidates by:

Entering Character-Realm and selecting Add candidate.
Selecting Scan /who.
Entering /ga scan.

Each queued candidate can be Recruited, Skipped, or Blacklisted. Blacklisting removes the candidate from the active queue and prevents the same normalized character name from being re-added later.

For a direct invitation outside the queue, use:

/ga invite Character-Realm

5. Explore the Management Tabs

Dashboard: live guild overview, recruitment queue, bank status, recent activity, and an explicit Wingman step.
Recruitment: messages, manual candidates, /who scanning, queue actions, blacklist controls, and Wingman.
Roster: search, refresh, promotions, demotions, removal, public notes, and officer notes.
Activity: locally observed roster changes and GuildAssist administrative actions.
Events: local event creation, guild-chat announcements, and event history.
Guild Bank: read-only snapshots of bank tabs loaded during a valid bank interaction.
Applications: manually added and whisper-detected applications with invite and decline actions.
Guild Helpers: local profiles, alt/main links, tags, notes, welcomes, announcements, health insights, and inactivity review.
Data: backups, imports, CSV roster export, and Markdown reports.
Settings: recruitment behavior, Wingman timing, scan limits, retention, inactivity, and application keywords.

Recruitment and Wingman

GuildAssist provides a centralized workflow for finding, contacting, and inviting prospective guild members. GuildAssist turns recruitment into an organized workflow rather than a collection of one-off whispers and forgotten names.

Save a customizable recruitment message of up to 255 characters.
Send guild invitations with optional recruitment whispers.
Automatically invite players who whisper configured keywords.
Configure multiple invite keywords with duplicate-invite protection.
Maintain a candidate queue with sources, statuses, contact history, and notes.
Find guildless players through background /who searches.
Configure minimum and maximum search levels.
Control the interval between recruitment searches.
Blacklist players who should not be considered again.
Use Wingman mode for guided recruitment during normal gameplay.

Recruitment Features

Wingman advances eligible recruitment work following supported keyboard or mouse input while respecting a configurable randomized frequency window. Actions remain tied to player input and do not run as unattended automation.

Custom recruitment message with a strict 255-character maximum.
%player% personalization token.
Optional recruitment whisper before manual invites.
Candidate queue ordered by when players were added.
Manual candidate entry using Character-Realm.
Candidate source, class, level, zone, status, and contact information when available.
Background /who searches for guildless players in the configured level range.
Built-in scan cooldown and timeout recovery.
Contact history for completed recruitment attempts.
Skip and blacklist actions.
Duplicate and recent whisper-invite protection.
Automatic invitation from exact configured whisper keywords.
Application creation from broader interest-keyword matches.

GuildAssist routes its searches away from Blizzard's social interface and suppresses Who windows opened by its own searches. A Friends window that you opened intentionally remains untouched.

Background `/who` Searches

GuildAssist routes its searches away from Blizzard's social interface. It also suppresses a Who window opened by its own request before, during, and immediately after result processing.

If you intentionally had Blizzard's Friends window open before the scan, GuildAssist preserves it.

What Is Wingman?

Wingman is a player-assisted recruitment queue. It advances one eligible task following supported player input and never runs as unattended automation.

When Wingman receives an eligible step, it:

Looks at the oldest valid queued candidate.
Sends the saved recruitment whisper when that option is enabled.
Requests the guild invitation.
Marks the candidate as contacted only after the recruitment request succeeds.
Starts a background scan when the queue is empty and another scan is available.

Failed or restricted actions leave the candidate in place for a later attempt. They do not silently consume or reorder the queue.

Configuring Wingman

In Settings, choose a minimum and maximum interval between 1 and 30 seconds. GuildAssist selects a randomized delay inside that range after each successful Wingman action.

Wingman listens for supported world clicks and common action-button input, including normal action-bar use. A short input debounce prevents one physical action from producing duplicate steps.

You may also assign Run next Wingman action in World of Warcraft's Key Bindings → GuildAssist category or select Wingman step on the Dashboard.

Wingman in Restricted Instanced Content

Retail can enable chat-messaging restrictions in battlegrounds and other instanced content. When Blizzard reports that restriction:

Wingman cannot be enabled.
An already-enabled Wingman is turned off automatically.
The Recruitment control displays Wingman: locked.
No whisper editor is opened.
No candidate is contacted, removed, or reordered.
Wingman becomes available again after the restriction ends.

Players receive this clear message when activation is refused or Wingman is disabled:

Sorry, wingman mode does not work in certain instanced content.

Blizzard may also hide incoming whisper text or sender information from addons during restricted content. GuildAssist safely ignores protected whisper payloads instead of producing errors. Keyword invitations and whisper-created applications resume when the game exposes that information again.

Important: /ga wingman toggles Wingman on or off. It does not itself perform the next queue action.

Roster Administration

View and manage your guild roster through a searchable, responsive member list. The Roster tab provides a responsive, searchable view of your current guild membership.

Review member names, classes, levels, ranks, online status, and guild notes.
Filter online and offline members.
Search the roster quickly.
Promote or demote authorized members.
Remove guild members through the current Retail guild API.
Edit public and officer notes.
Organize alt and main-character relationships.
Add custom member tags and extended local notes.
Review inactive members.
Compare roster snapshots to identify membership changes.

Search and Review

Administrative actions include permission, combat, self-removal, stale-roster, and API-availability safeguards. GuildAssist resolves the current roster record immediately before an action, reducing the risk of operating on an outdated member entry.

Search by name, rank, class, zone, or guild note.
Review character level, class, rank, online status, zone, public note, and officer note when permitted.
Include online and offline members in the local roster view.
Refresh the roster manually when required.
Use virtualized rows so large rosters remain efficient.

Member Activity

Officer Actions

GuildAssist records locally available guild activity so officers can understand how the roster changes over time. Authorized users can:

Chronological guild activity feed.
Member join and departure tracking.
Rank and level change tracking.
Guild-note change detection.
Recruitment and invitation history.
Administrative action logs.
Contact history.
Inactivity review.
Local guild-health information.
Promote members.
Demote members.
Remove members after confirmation.
Edit public guild notes.
Edit officer notes where guild permissions permit.

These records are organizational aids and remain entirely local. Left-click Note to edit the public note. Right-click Note to edit the officer note.

Events and Attendance

Roster Safety

Plan guild activities without relying on an external calendar service. GuildAssist resolves the current roster member again immediately before every administrative action. This prevents an old row index or stale guild snapshot from targeting a different player after the roster changes.

Create and manage local guild events.
Record event titles, descriptions, dates, times, and organizers.
Validate dates and times strictly.
Announce events in guild chat.
Track attendance.
Retain event history.
Include attendance records in full GuildAssist backups. Additional safeguards cover:

Invalid dates are rejected instead of being silently converted to a different date or time.

Missing permissions.
Combat restrictions where applicable.
Self-removal prevention.
Missing or stale roster members.
Current GUID-based member removal.
Protected or unavailable Retail APIs.
Failed actions with clear chat feedback.

## Guild Applications

Track prospective members through a straightforward local application workflow.

Activity and Guild Health

Store applicant names and messages.
Assign pending, accepted, or declined statuses.
Recruit directly from an application.
Match applications with recruitment candidates.
Prevent an application from being marked as accepted when its invitation fails. GuildAssist records locally observable guild changes and administrative actions so leadership can understand what has happened over time.

Application records remain local and can be included in GuildAssist backups.

Activity History

Guild Bank Monitoring

Newly observed guild members.
Confirmed member departures.
Online and offline observations.
Rank changes.
Level changes.
Public-note changes.
Officer-note changes.
Recruitment actions.
Event creation and announcements.
Welcome and announcement activity.
Administrative actions performed through GuildAssist.

Review guild-bank information through a custom overview while interacting with the guild bank. Departure detection requires stable roster observations, reducing false leave reports caused by partial roster responses.

Capture per-tab guild-bank snapshots.
Query the currently selected tab.
Review item and quantity summaries.
Retain cached information for previously loaded tabs.
Refresh the selected tab manually.
See live connection and loading status.
Prevent unloaded tabs from being incorrectly recorded as empty.
Support current Retail guild-bank interaction events.

Inactivity Review

World of Warcraft exposes guild-bank contents only while you are actively interacting with the guild bank. GuildAssist updates its snapshots during valid bank sessions and retains the most recently available local information afterward. Set the inactivity threshold in Settings. GuildAssist then identifies offline members whose locally observed activity exceeds that threshold.

Additional Guild Helpers

This is intentionally a review list, not an automatic removal system. GuildAssist never removes inactive members automatically.

GuildAssist includes practical tools for everyday guild administration:

Guild Health

Welcome queues for recently joined members.
Reusable guild announcements.
Configurable helper profiles and messages.
Alt and main-character organization.
Member tags and extended notes.
Inactivity reviews.
Recruitment contact history.
Blacklist management.
Local guild-health reports.
Guild-scoped storage for characters belonging to different guilds. The Guild Helpers tab provides a local health score and action list derived from information available on your installation, including:
Current roster and online participation.
Members over the inactivity threshold.
Applications awaiting review.
Upcoming local events.
New members waiting for a welcome.
Time since the last full backup.

The score is an organizational signal—not a judgment or externally calculated ranking.

Events and Applications

Local Guild Events

Create events with:

Event title.
Local date and time.
Short description.
Guild-chat announcement action.
Local event history.
Backup-safe event and attendance records.

Dates use the exact format:

YYYY-MM-DD HH:MM

Example:

2026-08-14 20:30

GuildAssist validates the complete local date and time. Impossible dates, invalid leap days, hour 24, and overflow values are rejected rather than silently converted.

Announcements are shortened to World of Warcraft's 255-character chat limit and are sent only when you select Announce.

Applications

Applications can be:

Added manually with a character name and note.
Created from incoming whispers containing configured application keywords.
Reviewed in one organized list.
Invited directly.
Declined.
Included in full backups.

An application is marked accepted only after its recruitment invitation is successfully requested. Failed invitations leave the application available for review.

Guild Bank

GuildAssist provides a read-only local guild-bank overview while respecting Blizzard's bank-data availability rules.

Bank Features

Per-tab snapshots.
Selected-tab queries.
Item names, links, quantities, quality, and slot usage where available.
Guild-bank money summary.
Live connection and loading status.
Manual Refresh tab action.
Cached contents for previously loaded tabs.
Protection against unloaded tabs being recorded as empty.
Support for current Retail guild-bank interaction events.

How to Refresh Bank Data

Open Blizzard's guild bank.
Select the bank tab you want to capture.
Wait for its contents to load.
Open GuildAssist → Guild Bank.
Select Refresh tab if an additional request is needed.

World of Warcraft only exposes guild-bank contents during a valid guild-bank interaction. GuildAssist retains the latest available local snapshots after the bank closes, but it cannot retrieve new remote bank information while you are elsewhere.

Guild Helper Tools

The Guild Helpers tab gathers useful leadership tasks that do not belong in a traditional roster window.

Local Member Profiles

Link alts to a main character.
Add searchable tags such as raider, crafter, recruiter, or officer.
Store an extended local note of up to 500 characters.
Keep profile information separate from Blizzard's short public and officer notes.

These profiles are local GuildAssist records and do not alter the member's Blizzard guild notes.

Welcome Queue

When GuildAssist confirms a newly joined member, it adds that character to a local welcome queue.

Save a welcome message of up to 255 characters.
Use %player% for name personalization.
Send the next welcome only when you select Welcome next.
Remove the entry only after the guild message is successfully requested.

Reusable Announcements

Write a guild announcement of up to 255 characters.
Save it for later reuse.
Send the current message to guild chat.
Quickly resend the latest saved announcement.

Messages are never broadcast on a timer and are sent only through an explicit player action.

Import, Export, and Backups

Preserve, transfer, or review your locally stored GuildAssist information. GuildAssist provides robust local data portability without executing imported Lua or contacting an external service.

Create full GuildAssist backups.
Merge imported information or replace the active database.
Validate backups with checksums.
Receive warnings when imported data belongs to a different guild.
Migrate supported data from older GuildAssist versions.
Export roster information as CSV.
Export guild-health reports as Markdown.

Full Backups

Full backups can include settings, candidates, contacts, applications, events, attendance, activity records, announcements, tags, notes, alt/main relationships, roster history, and other GuildAssist data. A full backup can include:

Imports are validated and repaired before use. Schema checks and record limits help protect the active database from malformed or excessively large imports.

Settings.
Candidates and blacklist entries.
Recruitment contacts.
Member history.
Local profiles, tags, notes, and alt/main links.
Events and attendance data.
Applications.
Announcements and welcome queue.
Activity history.

GuildAssist does not automatically synchronize information between players. Exports are text-based backups that you can copy manually when desired. Backups include a checksum so GuildAssist can detect incomplete or modified text before importing it.

Modern, Responsive Interface

Safe Import Options

GuildAssist uses a completely custom interface designed to remain clear across different resolutions and UI scales.

Validate: inspect the backup before changing anything.
Merge: add and update records while retaining newer compatible local information.
Replace: replace supported GuildAssist collections after confirmation.
Modern dark visual style with custom GuildAssist branding.
Responsive pages and controls.
Resizable main window. Import safeguards include:
Known record types only.
Schema validation.
Checksum verification.
A 1 MB input limit.
A 10,000-record limit.
String and field-length limits.
Type repair and default restoration.
Guild and realm mismatch warnings.
Automatic disabling of imported Wingman and automatic whisper invitations.

Imports never call load, loadstring, or execute embedded Lua code.

Reports

GuildAssist can also generate:

Roster CSV: suitable for spreadsheets and offline review.
Guild report: a readable Markdown summary for Discord, forums, or leadership notes.

Nothing is uploaded automatically. Select Select all, copy the generated text, and store or share it only where you choose.

Interface and Accessibility

GuildAssist uses a completely custom interface designed for clarity across different resolutions and UI scales.

Modern dark visual style with custom navy, gold, and teal branding.
Responsive pages, cards, rows, columns, and controls.
Resizable main window with a visible resize grip.
Saved window position and dimensions.
Automatic scaling on smaller displays.
Searchable and virtualized lists.
Consistent padding for inputs, cards, buttons, rows, and scrollbars.
Bounded text that does not overlap neighboring controls.
Animated visual feedback and state transitions.
A protected minimum layout size that preserves usable spacing.
Automatic whole-window scaling on smaller displays.
Searchable and virtualized long lists.
Consistent input, card, button, row, and scrollbar spacing.
Dedicated text boundaries that prevent labels from overlapping controls.
Single-line clipping where wrapping would damage a row layout.
Animated page transitions and visual feedback.
Custom in-game and addon-manager icon assets.

Privacy and Dependencies

The logical minimum layout is 960 × 700. On smaller physical displays, GuildAssist scales the complete window rather than crushing fixed-height sections together.

Complete Command Reference

Command	What It Does	Example
`/ga`	Opens or closes GuildAssist.	`/ga`
`/ga help`	Prints the available command summary in chat.	`/ga help`
`/ga scan`	Starts one background `/who` search using the configured level range.	`/ga scan`
`/ga invite NAME`	Adds and immediately attempts to recruit a character. Use `Character-Realm` when needed.	`/ga invite Aria-MoonGuard`
`/ga wingman`	Toggles Wingman when the current game state permits it.	`/ga wingman`
`/ga export`	Opens GuildAssist directly to the Data tab. It does not generate or transmit anything automatically.	`/ga export`
`/ga reset`	Moves the GuildAssist window back to the center of the screen without erasing data or changing its saved size.	`/ga reset`

Every command also accepts the full prefix:

/guildassist
/guildassist help
/guildassist scan
/guildassist invite Aria-MoonGuard
/guildassist wingman
/guildassist export
/guildassist reset

Common Command Workflows

Open GuildAssist:

/ga

Run one player search:

/ga scan

Recruit a specific character:

/ga invite Character-Realm

Enable or disable Wingman:

/ga wingman

Open backup and reporting tools:

/ga export

Recover a window moved somewhere inconvenient:

/ga reset

Privacy, Safety, and Blizzard Compliance

Private by Design

GuildAssist is:

Entirely local
Dependency-free
Library-free
Designed specifically for World of Warcraft Retail
Built specifically for World of Warcraft Retail
Stored through World of Warcraft's SavedVariables system
Usable without an external account or service
Free from analytics, telemetry, advertising, and remote data collection
Usable without an external account
Free from advertisements
Free from analytics and telemetry
Free from automatic cloud uploads or officer synchronization

No guild information is uploaded automatically. Data leaves the addon only when you intentionally copy an export. No guild information leaves your installation unless you intentionally copy an export.

Safety and Blizzard API Compliance

Protected-Action Safety

GuildAssist operates within World of Warcraft's addon restrictions. Actions protected by Blizzard still require valid player interaction when the game requires it. GuildAssist operates inside Blizzard's addon rules. It assists with organization and prepares valid actions, but it does not bypass protected-action or chat-messaging restrictions.

Safeguards cover:

Guild permissions.
Protected or unavailable API calls.
Combat restrictions.
Stale roster entries.
Repeated whisper invitations.
Failed recruitment attempts.
Who-search timeouts.
Required player input.
Instanced chat restrictions.
Secret incoming whisper values.
Combat restrictions where applicable.
Stale roster rows and GUIDs.
Self-removal prevention.
Repeated keyword invitations.
Failed whispers and guild invitations.
Background /who timeouts.
Guild-bank availability.
Invalid event dates.
Impossible event dates.
Corrupted or outdated SavedVariables.
Potentially destructive roster actions.
Malformed or oversized imports.
Destructive roster and data-replacement confirmations.

GuildAssist helps with guild administration; it does not provide unattended gameplay automation. GuildAssist does not provide unattended gameplay automation.

## Slash Commands

Open GuildAssist with either command:

Troubleshooting

/ga

Wingman says it is locked

Blizzard has activated chat-messaging restrictions in your current instanced content. GuildAssist intentionally keeps Wingman off and preserves the queue. Leave the restricted content and try /ga wingman again when the game permits it.

A candidate was not invited

Check that:

You are currently in a guild.
Your guild rank can invite members.
The character name and realm are correct.
The candidate is not blacklisted.
Wingman is enabled and not restricted.
Your recruitment message is saved if pre-invite whispers are enabled.
Blizzard is not currently preventing the protected action.

Failed Wingman recruitment attempts remain queued for retry.

The Who window appeared

GuildAssist sends its own searches to the background and performs additional suppression around result processing. If Blizzard's Who window still appears, confirm that no other addon is issuing /who requests or explicitly opening the Social interface.

Guild-bank information is missing

Open Blizzard's guild bank, select the desired tab, and wait for its contents to load. GuildAssist cannot retrieve a tab the game has not exposed during the current bank interaction.

The GuildAssist window is off-screen

Enter:

/guildassist
/ga reset

Who Is GuildAssist For?

This restores the window to the center without deleting settings or guild records.

GuildAssist is built for:

Imported data is rejected

Use Validate first. GuildAssist will identify checksum, schema, size, record-count, or formatting problems before applying any changes. Recopy the entire backup if the checksum does not match.

Frequently Asked Questions

Does GuildAssist synchronize officers automatically?

No. GuildAssist is deliberately local-first. Use a full text backup when you want to transfer information manually.

Does it require Ace, LibStub, or another addon?

No. GuildAssist has no addon or library dependencies.

Does Wingman run while I am away?

No. Wingman advances through supported player input and respects randomized timing and Blizzard restrictions.

Can Wingman run in every battleground or instance?

No. When Retail reports restricted chat messaging, GuildAssist prevents Wingman from enabling and turns it off if it was already active. Your candidates remain queued.

Does GuildAssist automatically remove inactive members?

No. Inactivity is presented as a review tool only. Member removal always requires an authorized, confirmed action.

Can GuildAssist read the guild bank from anywhere?

No. Blizzard exposes bank contents during a valid guild-bank interaction. GuildAssist stores read-only snapshots of tabs that the client has actually loaded.

Are imports safe?

Imports are treated as data, never executable code. They are size-limited, record-limited, schema-checked, checksum-validated, and repaired before use.

Can I use GuildAssist across multiple guilds?

Yes. Saved information is scoped by faction, realm, and guild so characters in different guilds do not share the same active management records.

Built For Guild Leaders Who Care

GuildAssist is ideal for:

Guild masters managing an entire community.
Officers handling roster administration.
Recruiters searching for new members.
Event organizers tracking activities and attendance.
Social guilds welcoming and organizing their members.
Progression guilds reviewing activity and roster changes.
Any guild that wants a unified, private, local management toolkit.
Recruiters building a healthy candidate pipeline.
Event organizers planning guild activities.
Social guilds welcoming and organizing members.
Progression guilds reviewing roster changes and participation.
Communities that value private, local-first tools.
Anyone who wants one dependable guild workspace instead of several disconnected addons.

GuildAssist's goal is simple: reduce repetitive administrative work and give guild leadership one organized place to recruit members, manage the roster, plan events, review activity, monitor the guild bank, and keep the community moving forward.

GuildAssist 1.0.6

Version 1.0.6 includes the current Retail instanced-content safety behavior, explicit Wingman restriction messaging, queue-preserving recruitment retries, background Who-window suppression, custom GuildAssist artwork, responsive layout safeguards, modern guild APIs, and a full-project runtime and packaging audit.

Recruit with purpose. Lead with clarity. Keep your guild moving forward—with GuildAssist.