FLUXTILITY Setup Guide
Admin Reference User Guide Admin Panel Dashboard
Step-by-Step
FLUXTILITY SETUP GUIDE

Follow these phases in order to go from a fresh invite to a fully configured server. Check off each step as you complete it.

📋 5 phases
0 steps total
⏱️ Est. 30–45 min for core setup
Setup Progress
0 / 0 completed
Phase 1
Phase 2
Phase 3
Phase 4
Phase 5
1
Phase 1
Prerequisites
~5 min
Step 1.1
Get your server whitelisted

Fluxtility Pro is not an open-access bot. Your server must be added to the allowlist before the bot will respond to any commands.

  1. Join the Fluxtility Discord server.
  2. Contact the Fluxtility team and provide your Discord server ID and server name.
  3. Once confirmed, you'll receive notification that your server has been whitelisted.
⚠️

Skip this step and the bot will join your server but silently ignore all commands. Whitelisting must happen before anything else.

Step 1.2
Invite Fluxtility Pro to your server

Use the official onboarding invite link provided by the Fluxtility team, or find the bot in any server where it is already active, view its profile, and click the invite button.

Grant the bot the permissions it requests during the OAuth invite flow. These are the minimum permissions needed for it to operate correctly.

Step 1.3
Configure bot permissions in Discord

Go to Server Settings → Integrations → Fluxtility Pro → Manage. Disable @everyone access at the top, then configure command access by role:

CommandsRecommended Role Access
/config, /reset, /snapshot, /lbpointsAdmins only
/setupdatechannel, /setup-mint-watcherAdmins only
/setup-raid, /raid-draw, /setup-raffle, /setup-giveaway, /setup-auctionModerators
/wheel, /announce, /trackModerators
/leaderboard, /balance, /floor, /swapEveryone
💡

The bot also requires View Channel permission in every channel it will post in. Check your channel permission overrides if it seems unresponsive in a specific channel.

→ Full permissions reference
2
Phase 2
Core Server Setup
~15 min
Step 2.1
Create required channels

Create these channels in Discord before running any setup commands. You'll reference them in the next steps.

# flux-verify Twitter verification panel Required
# raid-winners Raid winner announcements Required
# raffle-winners Raffle winner announcements Required
# giveaway-winners Giveaway winner announcements Required
# raids Where raid posts are created Recommended
# raffles-giveaways Raffles, giveaways, auctions Recommended
# nft-updates NFT trait/metadata update announcements Recommended
# mint-announcements New NFT mint announcements Recommended
💡

Make #flux-verify read-only for @everyone so users can only interact with the bot's panel.

Step 2.2
Deploy the Twitter verification panel

This is the most important first command. The verification panel lets users link their Twitter/X account — required to participate in raids. Run this in any channel (not necessarily the verify channel), and select the verify channel when prompted.

/setup-panel type:twitter-verification channel:#flux-verify

The bot posts a persistent button panel in #flux-verify. Users click it to begin the one-time verification flow.

⚠️

Do not delete the bot's message in the verify channel. If it's accidentally deleted, re-run the command to restore it.

→ More about the verify panel
Step 2.3
Get your guild wallet address and fund it

Your server was automatically assigned a Solana guild wallet when the bot joined. Retrieve the address and fund it with the tokens and NFTs you plan to use for raids, raffles, and giveaways.

/balance wallet:dao

The bot displays your wallet address as text and as a QR code. Send to this address from any Solana wallet.

Fund it with:

  • SOL — for transaction fees (keep at least 0.1 SOL at all times)
  • SPL tokens — whatever you plan to award as raid prizes
  • NFTs — any you want to raffle, give away, or auction
⚠️

The guild wallet must have sufficient SOL to pay Solana network fees for each prize payout. Running out of SOL will cause automatic reward distribution to fail.

→ Full guild wallet guide
Step 2.4
Set winner announcement channels

Point Fluxtility to the winner channels you created in Step 2.1. Run each command and select the appropriate channel.

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

Winner posts will now go to these dedicated channels instead of wherever the event was originally created.

Step 2.5
Enable leaderboard tracking

Enable tracking so Fluxtility records who wins and who participates in each raid. This powers the leaderboard and is required for /raid-draw to work correctly.

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

Then set which type your leaderboard primarily shows:

/config option:leaderboard-type type:winners
⚠️

Do this before your first raid. Raids run before tracking is enabled will not appear on the leaderboard retroactively.

Step 2.6
Set a daily raid limit (optional)

Prevent raid spam by capping how many raids can be created per day. Skip this step if you don't need a limit.

/config option:daily-raids-limit limit:5
3
Phase 3
Run Your First Raid
~5 min
Step 3.1
Create your first raid

Run this command in your #raids channel (or wherever you want the raid post to appear). Fill in all required parameters:

/setup-raid url:https://x.com/your-tweet duration:2h winners:3 type:Like+Retweet+Reply description:Raid and earn tokens! prize:JELLY amount:50 add_to_leaderboard:True

The bot posts the raid embed with action buttons. Users can start participating immediately.

💡

For your first test raid, use a short duration like 10m so you can verify the full flow quickly without waiting hours.

→ All raid parameters and types
Step 3.2
Test the user verification flow

Before your community raids, verify the full user flow works end-to-end:

  1. Go to #flux-verify and click the Verify Twitter button as a regular user.
  2. Complete the Twitter/X authentication flow.
  3. Navigate to the raid post and click each required action button.
  4. Click Verify Raid — you should receive a success confirmation.
  5. Click Participants on the raid to confirm your entry was recorded.
💡

If verification fails, check that the bot has permission to send DMs to users and that the verify panel is still present in #flux-verify.

Step 3.3
Verify automatic winner selection and payout

When the raid ends (or after your test duration expires), verify that:

  1. A winner announcement appears in your #raid-winners channel.
  2. The winner's Flux wallet received the prize token — they can check with /balance own.
  3. The leaderboard updated — run /leaderboard to confirm.

If prizes didn't arrive, check the guild wallet balance with /balance dao — it may be out of the required token.

4
Phase 4
Set Up Events
~10 min
Step 4.1
Move prizes into the guild wallet

Before creating any raffle, giveaway, or auction, the NFT prize must be sitting in the guild wallet. Check what's there with /balance dao and transfer any needed NFTs from your project wallet.

💡

You can also see everything in the guild wallet visually in the Web Admin Panel — the NFT picker shows a grid of all NFTs available for raffles and giveaways.

Step 4.2
Run a test raffle

Create a raffle to confirm the NFT picker, ticket purchases, and auto-delivery all work correctly.

/setup-raffle

The bot guides you through selecting the NFT, currency, ticket price, duration, total tickets, and per-person limit. After confirming, the raffle posts live and users can buy tickets immediately.

When the timer ends, the bot selects a winner automatically and delivers the NFT to their Flux wallet. The winner is announced in #raffle-winners.

→ Full raffle setup guide
Step 4.3
Run a test giveaway

Create an on-chain giveaway to confirm emoji entry and automatic NFT delivery work end-to-end.

/setup-giveaway

Select your NFT, set the duration and winner count, write a title and description, and confirm. Users enter by reacting with the specified emoji.

→ Full giveaway setup guide
Step 4.4
Try the Web Admin Panel

Log in at fluxtility.fluxinc.io with Discord and click ⚙️ Admin in the header. From here you can manage all server config, create events with a visual NFT picker, and view or cancel active events — all without Discord commands.

  1. Open the Web Admin Panel and select your server.
  2. Go to Server Config and verify your winner channels populated correctly.
  3. Try creating a raid or raffle from the Create Event tab — confirm the NFT picker shows your guild wallet contents.
→ Open Admin Panel
5
Phase 5
Optional Features
~10 min each
Step 5.1
Configure Holder Rewards

Set up daily SPL token claims and streak rewards for your NFT holders. Run these commands in order:

/config_holder_role role:@Holder
/config_daily_claim token:JELLY amount:10
/config_activity_goals messages:5 voice_minutes:15
/config_streak_grace days:1

Optionally set milestone streak rewards:

/set_streak_reward day:7 type:SPL token:JELLY amount:100
→ Full Holder Rewards guide
Step 5.2
Configure Raid Suggest

Let community members submit tweet suggestions for the next raid. Create a suggestions channel first, then run:

/config_raidsuggest

Set the review channel, eligible role, daily submission limit per user, and optional reward for selected suggestions.

→ Raid Suggest guide
Step 5.3
Set up the Ticket System

Give your community a support ticket system with private threads and a dedicated mod team.

/tickets action:setup

Configure the support channel (where the ticket button appears), ticket category, support role, and log channel. The ticket config is also available in the Web Admin Panel under Ticket Config.

→ Ticket System guide
Step 5.4
Configure Boost Rewards

Reward your server boosters with a monthly SPL token claim.

/setboostreward token:JELLY amount:50

Boosters run /boostclaim to collect their monthly reward. Ensure the guild wallet holds enough of the token to cover all your boosters.

→ Boost Rewards guide
Step 5.5
Set up Auctions

Run live NFT auctions where the highest bidder wins. No additional configuration needed — just make sure the NFT is in the guild wallet, then run:

/setup-auction

The bot walks you through selecting the NFT, starting bid, minimum increment, currency, and duration. The NFT transfers automatically to the winner when the auction closes.

→ Auctions guide
🎉
YOU'RE ALL SET!

Fluxtility Pro is fully configured and ready to run. Your community can now raid, earn, buy tickets, and win prizes on-chain.