Bits

[aVrix] Bits is a virtual currency and rewards system for XenForo 2.3. It allows members to earn points through forum activity, complete daily tasks, purchase additional Bits, and track their transactions. Administrators can configure rewards, manage user balances, control permissions, and customize the forum's virtual economy.

Daily Tasks & Rewards

Reward members for participating in your community through configurable daily tasks.

Supported Activities

• Create Threads — Reward members for publishing new discussion threads.

• Post Messages — Award Bits for replies in discussions.

• Publish Resources — Reward resource submissions through XenForo Resource Manager.

• Profile Posts — Reward posts on other members' profiles.

• Receive Reactions — Award Bits for positive reactions from other users.

Task Configuration

Administrators can customize:

• Task names and descriptions.

• Required actions and reward amounts.

• Maximum daily completions.

• Allowed forum nodes and resource categories.

• Task availability and display order.

• Individual task progress.

Example: Post 5 messages to earn 100 Bits, up to twice per day.

Balance Management

Manage user balances directly through XenForo's moderation tools.

• Grant or remove Bits with a specified reason.

• Notify users about balance adjustments.

• View detailed transaction history.

• Track transaction amounts, dates, reasons, and related content.

• Use BBCode in transaction descriptions.

• Control access through dedicated user permissions.

Each user has an individual balance, with a maximum of 2,592,000 Bits.

Point Purchases

Allow members to purchase additional Bits through XenForo's integrated payment system.

• Enable or disable point purchases.

• Configure purchase amounts and conversion rates.

• Set minimum and maximum purchase limits.

• Select permitted payment profiles.

Transaction History

Every balance adjustment is recorded for transparency and administration.

• Detailed records of earned, purchased, granted, and deducted Bits.

• Transaction reasons and timestamps.

• Information about moderators responsible for manual adjustments.

• References to related forum content.

• Paginated transaction history.

• Separate permissions for viewing other users' transactions.

Additional Features

• Double Points — Optional x2 reward multiplier.

• Automatic Reversals — Remove rewards when the original qualifying content is invalidated.

• Flexible Configuration — Customize task limits, reward values, purchasing rules, and permissions.

• Secure Transactions — Balance locking and transactional updates help prevent conflicting operations.

• Duplicate Reward Protection — Prevent repeated rewards when previously rewarded content is restored.

Permissions

Bits integrates with XenForo's permission system.

• Manage user bits — Grant and remove Bits from user balances.

• View bits — View other members' transaction history.

Users can access their own transaction history without additional permissions.

Installation

1. Download the latest version of Bits.

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 Bits 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.

Requirements

• XenForo 2.3 or newer

• PHP 8.0 or newer

Updating

1. Download the latest version of Bits.

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.