Guilds

[aVrix] Guilds is a complete guild and clan management system for XenForo 2.3, allowing community members to create, customize, and manage their own guilds directly on the forum. With customizable profiles, flexible roles, membership management, private chat, and optional progression powered by [aVrix] Bits, Guilds provides a fully integrated community system.

Guild Creation & Customization

Give every guild its own identity.

• Custom guild names, tags, and descriptions.

• Uploadable avatars and banners.

• Default avatars and banners configured by administrators.

• Automatic letter-based avatars when no image is available.

• Custom guild emblems.

• Dedicated guild pages with member lists and statistics.

• Interactive guild profile cards.

• Configurable image upload limits.

Guild tags appear alongside usernames in forum posts, member profiles, and user cards.

Members, Roles & Permissions

Guilds includes three membership roles:

• Leader — Full control over guild management.

• Deputy Leader — Configurable administrative permissions.

• Member — Standard membership with customizable permissions.

Guild leaders can configure permissions for deputies and members independently.

Available permissions include:

• Editing guild information.

• Inviting and removing members.

• Managing membership applications.

• Sending and moderating chat messages.

• Managing guild upgrades.

• Changing member roles.

• Configuring role permissions.

Leadership can be transferred to another member. Important actions, including leaving, removing members, and disbanding a guild, require confirmation.

Applications & Invitations

Manage guild membership through a dedicated application and invitation system.

• Apply to join a guild with an optional message.

• Approve, reject, or cancel applications.

• Invite forum members directly.

• Accept, reject, or cancel invitations.

• Track application and invitation history.

• Automatically enforce guild membership limits.

• Restrict users to one guild at a time.

Private Guild Chat

Each guild has its own private chat integrated with XenForo's widget system.

• Messages delivered without page reloads.

• Automatic checking for new messages.

• BBCode and user mentions.

• Notifications for guild member mentions.

• Unread message counters.

• Message read tracking.

• Pinned messages.

• Message deletion and chat moderation.

• Temporary chat restrictions for members.

• Anti-spam message cooldowns.

• Collapsible chat interface.

• Personal chat visibility and height settings.

Administrators can disable the chat system globally.

Guild Levels & Upgrades

An optional progression system allows guilds to unlock additional features using [aVrix] Bits.

Available upgrades include:

• Additional guild levels.

• Increased member capacity.

• Unlimited member capacity at configured levels.

• Private chat access.

• Custom guild avatars.

• Custom guild banners.

• Additional guild emblems.

Upgrade Management

• Purchase upgrades using the shared guild balance.

• Configure individual upgrade prices.

• Unlock and select additional emblems.

• Sell purchased upgrades and return their recorded value to the guild balance.

• Sell the current guild level to return to the previous level.

• Configure paid guild creation.

Administrators can configure guild levels, member limits, and upgrade prices.

The system includes 31 configurable guild emblems, each with its own name and optional price.

Guild Balance & Transactions

With [aVrix] Bits installed, guilds can maintain a shared balance for upgrades and progression.

• Transfer Bits from personal balances to guild balances.

• Purchase upgrades using guild funds.

• Receive refunds when selling upgrades.

• Manually adjust guild balances with appropriate permissions.

• Record reasons for manual balance adjustments.

• View detailed financial transaction history.

• Track transaction amounts, dates, users, and balances before and after operations.

• Control access to financial history through permissions.

Financial operations include protection against conflicting simultaneous balance changes.

Guild Rankings & Forum Integration

Guilds integrates with XenForo's existing interface.

• Guild tags displayed alongside usernames.

• Guild information in member profiles and user cards.

• Interactive guild cards with avatars, banners, leaders, and statistics.

• Guild level and member count information.

• Guild links in user menus and account settings.

• Guild rankings based on member count.

• Rankings available through XenForo's notable members section and widgets.

Notifications

Guilds supports XenForo notifications for:

• Guild invitations.

• New membership applications.

• Application approvals and rejections.

• Members leaving a guild.

• Member removals.

• Leadership transfers.

• Guild disbandment.

• Chat mentions.

Notifications integrate with XenForo's alert preferences and push notification templates.

Administration & Moderation

Administrators can manage guilds through the Admin Control Panel and authorized forum moderation tools.

• View, edit, and delete guilds.

• Manage guild leaders, members, and roles.

• Configure guild permissions.

• Adjust guild levels and balances.

• Grant or remove upgrades.

• Configure level requirements and member limits.

• Set upgrade prices.

• Manage available guild emblems.

• Configure avatar and banner upload limits.

• Enable or disable progression and chat features.

Appearance & Style Customization

Guilds includes 64 XenForo style properties for customizing the interface.

Available customization options cover:

• Guild tags and emblems.

• Guild cards, avatars, and banners.

• Chat appearance and message styling.

• Guild statistics and buttons.

• Member lists and management panels.

• Guild upgrades and progression interfaces.

• Default guild images.

The interface supports XenForo's light and dark themes and responsive layouts.

Installation

1. Download the latest version of Guilds.

2. Extract the downloaded archive.

3. Upload the contents of the upload directory to your XenForo installation root, preserving the directory structure.

4. Log in to your XenForo Admin Control Panel.

5. Navigate to Add-ons.

6. Find Guilds in the list of available add-ons.

7. Click Install and follow the on-screen instructions.

8. Configure the add-on settings and permissions as needed.

Updating

1. Download the latest version of Guilds.

2. Upload the updated files to your XenForo installation, replacing existing files.

3. Navigate to Admin Control Panel → Add-ons.

4. Click Upgrade if an upgrade is available.

5. Review the add-on settings after updating.

Note: Back up your forum files and database before installing or updating any add-on.