FLUXTILITY Admin Guide
Setup Guide User Guide Admin Panel Dashboard
FLUXTILITY ADMIN GUIDE

Everything you need to configure, manage, and get the most out of Fluxtility Pro in your Discord server. From initial setup to advanced reward systems.

🤖 Overview

What Fluxtility Pro does and how it works

Fluxtility Pro is an advanced on-chain Discord automation suite built on the Solana blockchain. It handles raid-to-earn campaigns, NFT raffles, on-chain giveaways, auctions, holder reward systems, and more — all operating directly within your Discord server using real Solana wallets assigned to each user.

Every user who joins a server with Fluxtility Pro automatically receives a Flux Discord Wallet — a real Solana wallet managed by the bot. Prize distributions, raid rewards, and raffle winnings are all delivered on-chain with no manual intervention required.

Core Features
Raid-to-Earn
Automated Twitter/X raid campaigns with on-chain SPL token rewards to verified participants.
NFT Raffles
On-chain ticket-based raffles using any SPL token as currency. Automatic NFT delivery to winner.
Giveaways
On-chain or off-chain giveaways with automatic winner selection and prize distribution.
Auctions
Time-based NFT auctions with real-time bidding and automatic settlement on close.
Holder Rewards
Daily claim system with streak tracking, activity goals, and configurable milestone rewards.
Leaderboards
Persistent raid winner and participant leaderboards with manual point management.
📨 Invite & Permissions

Adding Fluxtility Pro to your server and configuring bot permissions

Inviting the Bot

Use the official onboarding invite link to add Fluxtility Pro to your server. Alternatively, find the bot in any server where it is active, view its profile, and use the invite button from there.

⚠️

Your server must be whitelisted before the bot will respond. Contact the Fluxtility team to get your server added to the allowlist.

Configuring Permissions
  1. Go to Server Settings → Integrations and find Fluxtility Pro.

  2. Click Manage. Set @everyone to disabled but leave All Channels enabled.

  3. From here you can restrict individual commands to specific roles or channels.

The bot requires the following permissions in every channel it operates in:

View Channel
Send Messages
Send Messages in Threads
Create Private Threads
Manage Threads
Manage Messages
Mention @everyone / @here
Embed Links
Attach Files
Add Reactions
Use External Emoji
Read Message History
Recommended Permission Restrictions

For a well-managed server, apply these restrictions through Integrations:

CommandsRecommended Access
/setup-raid, /raid-draw, /trackModerators + Raid Leaders only
/setup-raffle, /setup-giveaway, /setup-auctionModerators only
/config, /reset, /snapshotAdmins only
/lbpoints, /announceAdmins only
/setupdatechannel, /setup-mint-watcherAdmins only
/leaderboard, /balance, /floorEveryone
/wheelModerators only
⚙️ Initial Configuration

Required setup steps after inviting the bot

Step 1 — Set Up the Twitter Verification Panel

This is the first thing to do after inviting the bot. The verification panel allows users to connect their Twitter/X account to their Discord identity, which is required to participate in raids.

  1. Create a read-only channel named something like #verify or #flux-verify.

  2. Run the command and select that channel:

    /setup-panel type:twitter-verification channel:#flux-verify
  3. The bot will post a persistent verification panel in that channel. Users click the button to begin the verification flow.

💡

Make the verify channel read-only for @everyone so users can only interact with the bot's panel and not post messages.

Step 2 — Configure Winner Channels

Set dedicated channels where Fluxtility will announce raid, raffle, and giveaway winners. This keeps your main channels clean.

/config option:raid-winner-channel channel:#raid-winners
/config option:raffle-winner-channel channel:#raffle-winners
/config option:giveaway-winner-channel channel:#giveaway-winners

Create these channels first, then run each command and select the appropriate channel.

Step 3 — Configure Leaderboard Tracking

Enable tracking so Fluxtility records raid participants and winners for the leaderboard.

/config option:track-raid-winners
/config option:track-raid-participants
⚠️

These must be configured before running /setup-raid with add_to_leaderboard: True, otherwise participant data will not be recorded.

Step 4 — Set Leaderboard Type

Choose whether your server's primary leaderboard tracks raid winners or participants.

/config option:leaderboard-type type:winners

Options: winners or participants.

Step 5 — Set Daily Raid Limit (Optional)

Limit how many raids can be active per day to prevent spam.

/config option:daily-raids-limit limit:5
💎 Guild Wallet

The DAO Discord wallet used to fund raids, raffles, giveaways, and auctions

When Fluxtility Pro joins your server, it automatically creates a DAO Discord Wallet — a dedicated Solana wallet associated with your server. This wallet is the source of all on-chain prize distributions.

Viewing Your Guild Wallet

Get your server's wallet address and current balances:

/balance wallet:dao

The bot responds with the public address as copyable text and as a QR code — useful when switching between devices.

What to Keep in the Guild Wallet
FeatureWhat's Needed
Raid-to-Earn rewardsSufficient balance of the SPL token(s) you award to raid winners
NFT RafflesThe NFT you want to raffle must be in this wallet before creating the raffle
On-chain GiveawaysThe NFT(s) to give away must be in this wallet
AuctionsThe NFT being auctioned must be in this wallet
Holder RewardsDaily claim tokens and streak reward tokens/NFTs
Transferring Out of the Guild Wallet

To move SOL or tokens from the guild wallet to an external address:

/dao-withdraw token:SOL amount:1.5 to:WalletAddress...
/dao-transfer token:USDC amount:100 to:@username

Both commands have a fee of 0.0005 SOL. The difference: /dao-withdraw sends to an external wallet address; /dao-transfer sends to another user's Flux Discord wallet.

💡

You can also view and manage the guild wallet from the Web Admin Panel. The NFT picker for raffles/giveaways/auctions pulls directly from this wallet.

⚔️ Raids

Setting up Twitter/X raid campaigns with automatic verification and rewards

A raid is a coordinated Twitter/X engagement campaign. Users interact with a target tweet (like, retweet, reply, or a combination), verify their participation through the bot, and receive SPL token rewards automatically on-chain.

Creating a Raid
/setup-raid url:https://x.com/... duration:2h winners:5 type:Like+Retweet+Reply description:Raid and earn!
ParameterRequiredDescription
urlRequiredThe full URL of the tweet to raid
durationRequiredHow long the raid runs. Format: 5s 10m 2h 3d. Minimum: 10 minutes.
winnersRequiredNumber of winners to select from verified participants
typeRequiredWhat actions participants must complete (see raid types below)
descriptionRequiredMessage shown in the raid post
tagsOptionalHashtags or mentions that auto-populate in participant replies
mentionOptionalRole to ping when the raid is posted
prizeOptionalSPL token to award to winners
amountOptionalAmount of the token each winner receives
add_to_leaderboardOptionalTrue or False — whether to track this raid on the leaderboard
Raid Types
Like
Participants must like the tweet
Retweet
Participants must retweet the tweet
Reply
Participants must reply to the tweet
Like + Retweet
Both like and retweet required
Like + Reply
Both like and reply required
Retweet + Reply
Both retweet and reply required
Like + Retweet + Reply
All three actions required
Like + Retweet + Image
Like, retweet, and image detection verification
Like + Reply + Image
Like, reply, and image detection verification
All + Image
All actions plus image detection — maximum engagement
💡

Image detection types verify that participants posted a specific image from a curated set. If a participant leaves the photo selection blank, Fluxtility randomly picks 2 photos for them.

Drawing Winners with /raid-draw

After a raid ends (or at any time), use /raid-draw to select winners from accumulated leaderboard data across a timeframe. The bot uses a wheel mechanism to randomly select the configured number of winners and can automatically distribute token rewards from the guild wallet.

/raid-draw
⚠️

Ensure the guild wallet has sufficient token balance before drawing winners with automatic rewards enabled.

Tracking Raids

Use /track to view and manage active raid tracking data — including who has verified participation and current winner candidates.

/track
🎟️ Raffles

On-chain NFT raffles where users buy tickets with SPL tokens

⚠️

Before creating a raffle, the NFT prize must be in the guild wallet. Use /balance dao to verify it's there.

Creating a Raffle
/setup-raffle

The bot guides you through a multi-step selection process:

  1. Select NFT — choose the NFT from your guild wallet to raffle off

  2. Select currency — pick which SPL token users will pay with

  3. Set price per ticket — how much of the selected token each ticket costs

  4. Set duration — how long the raffle runs (e.g. 24h, 3d)

  5. Set total tickets — maximum number of tickets available

  6. Set max per person — ticket purchase limit per user

  7. Write a description — message shown in the raffle embed

  8. Review & confirm — the bot shows a preview before posting

After confirmation the raffle is posted and users can purchase tickets immediately. The NFT is delivered automatically to the winner's Flux wallet when the raffle ends.

Refunding a Raffle

If something goes wrong after a raffle is posted, use /refund-raffle to automatically return all ticket purchases to buyers.

/refund-raffle message_id:1234567890

Get the message ID by right-clicking the raffle post in Discord → Copy Message ID.

💡

Raffles can also be created from the Web Admin Panel with a visual NFT picker showing everything currently in the guild wallet.

🎁 Giveaways

On-chain and off-chain giveaways with automatic winner selection

Fluxtility supports two types of giveaways:

  • On-chain — NFT prize is sent directly from the guild wallet to the winner's Flux Discord wallet automatically when the giveaway ends.
  • Off-chain — Winners are selected by the bot but prize delivery is handled manually by the admin (whitelist spots, physical items, etc.).
Creating a Giveaway
/setup-giveaway
  1. Select NFT (on-chain only) — choose from guild wallet

  2. Quantity — number of prizes available

  3. Duration — how long the giveaway runs

  4. Winners — number of winners to select

  5. Title — giveaway name shown in the embed

  6. Description — additional context or instructions

  7. Emoji — reaction emoji users click to enter

  8. Mention — optional role ping

  9. Review & confirm

For on-chain giveaways, prize delivery is fully automatic. The NFT transfers to the winner's wallet the moment the giveaway closes — no manual action required.

🔨 Auctions

Time-based NFT auctions with live bidding in Discord

Auctions let your community bid on NFTs in real time. The highest bidder when the auction closes wins, and the NFT is transferred from the guild wallet to their Flux Discord wallet automatically.

⚠️

The NFT being auctioned must be in the guild wallet before creating the auction.

Creating an Auction
/setup-auction

The bot walks you through the setup:

  1. Select NFT — choose the NFT from the guild wallet to auction

  2. Starting bid — the minimum opening bid amount

  3. Minimum increment — the minimum amount each new bid must exceed the previous by

  4. Currency — which SPL token bids are placed in

  5. Duration — how long bidding stays open

  6. Description — text shown in the auction embed

  7. Review & confirm

Once posted, users bid directly from the Discord embed. Bids are held on-chain. When the auction ends, the winner receives the NFT and non-winning bids are returned automatically.

Fee: 0.0005 SOL per auction creation.

🏆 Holder Rewards

Daily claim system with activity tracking, streaks, and milestone rewards

The Holder Rewards system lets your NFT holders earn daily SPL token rewards by meeting activity goals (messages sent, voice time) and maintaining multi-day streaks for bonus rewards.

Step 1 — Set the Holder Role

Define which role qualifies users to claim daily rewards. This should be your NFT holder verification role.

/config_holder_role role:@Holder
Step 2 — Configure the Daily Reward

Set which SPL token to award and how much per daily claim.

/config_daily_claim token:JELLY amount:10
Step 3 — Set Activity Goals

Define how much activity a user needs to complete to qualify for that day's claim.

/config_activity_goals messages:5 voice_minutes:15

Users must send at least the specified number of messages and spend at least the specified minutes in voice channels during the day to unlock their claim.

Step 4 — Configure Streak Settings

Set how many days of grace a user gets before their streak resets (e.g. if they miss a day).

/config_streak_grace days:1

With a grace period of 1, missing a single day won't break the streak — they have until the following day to catch up.

Step 5 — Set Bonus Multipliers (Optional)

Reward users more on weekends or during special events.

/config_bonus_multiplier type:weekend multiplier:2

A multiplier of 2 doubles the daily reward on weekends.

Step 6 — Set Streak Milestone Rewards (Optional)

Give bonus rewards when users hit specific streak day milestones.

/set_streak_reward day:7 type:SPL token:JELLY amount:100
/set_streak_reward day:30 type:NFT mint:NFTMintAddress...

Reward types: SOL, SPL, or NFT. The NFT must be in the guild wallet.

To remove a streak reward:

/remove_streak_reward day:7
Managing User Streaks

Freeze or unfreeze a specific user's streak (e.g. if they had technical issues):

/freeze_streak user:@username action:freeze

A frozen streak doesn't progress or reset until unfrozen.

💡

All Holder Rewards settings can also be managed from the Web Admin Panel without using Discord commands.

💡 Raid Suggest

Let community members suggest tweets for the next raid

The Raid Suggest system allows your community to submit tweet URLs as raid candidates. Admins can then review and launch raids from approved suggestions. Optionally, reward users for suggestions that get selected.

Configuring Raid Suggest
/config_raidsuggest

Configure the following options:

OptionDescription
channelThe channel where raid suggestions are posted for review
roleWhich role is allowed to suggest raids (or leave open to everyone)
daily_limitMax suggestions per user per day
reward_tokenSPL token to reward users when their suggestion is selected
reward_amountAmount of the token to award

Once configured, users submit suggestions using:

/suggest_tweet url:https://x.com/...
🚀 Boost Rewards

Reward users who boost your Discord server

Configure a monthly SPL token reward for server boosters. Users who have boosted the server can claim once per month.

Setting the Boost Reward
/setboostreward token:JELLY amount:50

After this is set, server boosters can claim their reward with:

/boostclaim

The reward comes from the guild wallet. Make sure there is sufficient token balance to cover claims.

📊 Leaderboard

Managing raid leaderboards, points, and resets

Viewing the Leaderboard
/leaderboard type:winners

Options: winners or participants. This command can be made available to everyone — it's safe to leave unrestricted.

Adjusting Points

Use /lbpoints to correct leaderboard data — for example, if a raid had a misconfiguration or a user was incorrectly counted.

/lbpoints type:add user:@username amount:5
/lbpoints type:remove user:@username amount:2
🚫

Restrict /lbpoints to admins only. Unrestricted access could allow manipulation of leaderboard standings.

Resetting Data

Use /reset to clear specific data sets at the start of a new season or campaign period.

/reset type:leaderboard

Reset options: leaderboard, verifications, wallet-collection, all.

🚫

This action is irreversible. Resetting the leaderboard permanently removes all accumulated points. Use with extreme caution.

🎫 Ticket System

Setting up a support ticket system in your server

The /tickets command sets up and manages a Discord-native ticket system where users can open private support threads with your moderation team.

Setting Up Tickets
/tickets action:setup

Configure the following during setup:

OptionDescription
support_channelChannel where the ticket open button is posted
ticket_categoryDiscord category where ticket threads are created
support_roleRole that gets access to opened tickets
log_channelChannel where ticket activity is logged
💡

Ticket configuration can also be managed from the Web Admin Panel under the Ticket Config section.

🎡 Wheel Spin

Spin a wheel to randomly select winners from a list of names

The /wheel command posts an interactive spinning wheel in Discord. Moderators add participants by name and spin for a random result.

Using the Wheel
/wheel names:Alice, Bob, Charlie, Diana

Enter participant names separated by commas. Press enter to confirm and the bot posts the interactive wheel. Spin to reveal the winner.

💡

Restrict /wheel to moderators to prevent misuse.

📢 Announce

Post announcements through Fluxtility with rich embed formatting

/announce channel:#announcements message:Your announcement text here

The bot posts a formatted embed announcement to the specified channel. Restrict this command to admins or a dedicated announcements team role.

📸 Snapshot

Export wallet addresses for role holders, collection owners, or custom filters

The /snapshot command generates a CSV or list of wallet addresses based on your specified criteria — useful for airdrops, whitelist generation, or off-chain record keeping.

Snapshot Types
/snapshot type:role role:@Holder
/snapshot type:owner
/snapshot type:collection collection:CollectionAddress...
TypeDescription
roleExport wallets of all users who hold a specific Discord role
ownerExport wallets of all users with verified Flux wallets in the server
collectionExport wallets of verified holders of a specific NFT collection
🛒 Shop

Set up an in-Discord token shop where users spend SPL tokens for items

/setup-shop

The shop system lets users spend earned SPL tokens on items you define — WL spots, NFTs, roles, real-world items, or anything else. The bot handles on-chain payment verification automatically.

💡

See the full Shop setup guide for adding items, mystery packs, and managing inventory.

🔔 NFT Watchers

Automatic NFT update and mint announcement feeds for your Discord server

NFT Update Watcher — /setupdatechannel

Polls the Fluxtility API every 3 minutes for trait/metadata changes on your project's NFTs and posts a notification embed to your configured channel. The watcher activates only when both a channel and project ID are set.

/setupdatechannel channel:#nft-updates project_id:your-project-id
OptionRequiredDescription
channelNoThe channel where update embeds will be posted
project_idNoProject ID used by the recentlyUpdated API to scope results
ping_roleNoRole to mention when a new update is posted
disableNoSet to True to turn off the watcher for this server

Running the command without options shows the current configuration status. The bot replies with a status embed showing the channel, project ID, ping role, and whether the watcher is enabled or disabled. All options are individually updatable — you can change the channel or role without re-entering the project ID.

💡

The watcher only enables when both channel and project_id are set. Setting just one will save the value but leave the watcher in a disabled state until both are configured.

NFT Mint Watcher — /setup-mint-watcher

Polls the mint API every ~3 minutes and posts an announcement embed each time a new NFT mint is detected. The embed shows the NFT name, owner, image, and the list of NFTs that were burned as part of the mint.

/setup-mint-watcher channel:#mint-announcements
OptionRequiredDescription
channelNoChannel where mint announcement embeds will be posted
disableNoSet to True to stop mint announcements in this server
backfillNoPost all existing mints from the API to the configured channel immediately
⚠️

Use backfill:True with care — it posts every existing mint in the API to the channel at once. A short delay is applied between posts to avoid rate limits, but this can still generate significant channel activity.

🌐 Web Admin Panel

Manage your server's Fluxtility settings from a browser — no Discord commands needed

The Web Admin Panel at /admin provides a visual interface for managing all core Fluxtility settings. It's accessible to any Discord user with the Administrator permission in the selected server, or users with the configured admin panel role.

Accessing the Panel
  1. Log in at fluxtility.fluxinc.io with Discord OAuth.

  2. Click the ⚙️ Admin button in the dashboard header (only visible to users with Administrator permission).

  3. Select your server from the guild dropdown.

What You Can Do from the Panel
SectionWhat's Configurable
Server ConfigWinner channels, leaderboard type, daily raid limit, admin panel role
Create EventCreate Raids, Raffles, Giveaways, and Auctions with a visual NFT picker
Active EventsView and cancel all currently running events
Holder RewardsAll holder reward settings — token, amount, role, activity goals, multipliers
Raid SuggestChannel, role, limits, and rewards for raid suggestions
Ticket ConfigSupport channel, ticket category, support role, log channel
💡

The NFT picker for events shows everything currently in the guild wallet as a visual grid. Search by name or enter a mint address manually if the NFT isn't listed.

📋 Admin Command Reference

Complete list of all admin and moderation commands

CommandAccessDescriptionFee
/setup-panelAdminDeploy Twitter verification or shop/staking panels to a channel
/configAdminConfigure winner channels, leaderboard type, raid tracking, and daily limits
/setup-raidModCreate a new raid-to-earn campaign0.005 SOL
/raid-drawModDraw winners from leaderboard data and distribute rewards
/trackModView and manage active raid tracking
/setup-raffleModCreate an on-chain NFT raffle0.005 SOL
/refund-raffleModRefund all ticket purchases for a raffle
/setup-giveawayModCreate an on-chain or off-chain giveaway0.005 SOL
/setup-auctionModCreate a time-based NFT auction0.0005 SOL
/lbpointsAdminAdd or remove leaderboard points for a user
/resetAdminReset leaderboard, verifications, wallets, or all data
/setboostrewardAdminSet monthly SPL token reward for server boosters
/config_daily_claimAdminSet daily claim token and amount for holder rewards
/config_holder_roleAdminSet the role required to earn holder rewards
/config_activity_goalsAdminSet message and voice minute targets for daily activity
/config_streak_graceAdminSet grace period days before a streak resets
/config_bonus_multiplierAdminSet weekend or event reward multipliers
/set_streak_rewardAdminSet a SOL/SPL/NFT reward for a specific streak milestone day
/remove_streak_rewardAdminRemove the configured reward for a streak day
/freeze_streakAdminFreeze or unfreeze a user's streak
/config_raidsuggestAdminConfigure raid suggestion channel, role, limits, and rewards
/ticketsAdminSet up and manage the Discord ticket system
/wheelModSpin a wheel to randomly select from a list of names
/announceModPost a formatted announcement embed to a channel
/snapshotAdminExport wallet addresses by role, owner, or collection
/setup-shopAdminSet up an in-Discord SPL token shop
/update-royaltyAdminUpdate royalty settings on your project's NFTs
/dao-withdrawAdminWithdraw SOL/SPL tokens from the guild wallet to an external address0.0005 SOL
/dao-transferAdminTransfer SOL/SPL from the guild wallet to a user's Flux wallet0.0005 SOL
/balance daoAdminView the guild wallet address and current balances
/setupdatechannelAdminConfigure the NFT update watcher — set channel, project ID, ping role, or disable
/setup-mint-watcherAdminConfigure the NFT mint announcement watcher — set channel, disable, or backfill existing mints