Skip to content

44emy/Fluxboard-bot

Repository files navigation

Fluxboard-bot - Manage your community the right way

9aefd812-0e6b-4a7f-92ac-376755b1362f
  • IN DEVELOPMENT

Add to Your Server


Advanced Moderation

  • Multi-target ban system with reason tracking and optional time limits
  • Flexible timeout system (10m, 1h, 1d, or custom durations)
  • Warning system with persistent history
  • Bulk message purge (up to 100 messages)
  • Channel lock/unlock for emergency situations
  • Comprehensive audit logging for all moderation actions

Role Management

  • Reaction roles with support for unlimited emoji-role pairs
  • Message link or ID-based setup for maximum flexibility
  • Automatic role assignment for new members
  • Interactive setup wizard with .setupreact
  • Bulk role assignment with .roleall

Leveling System

  • Optional XP-based progression (disabled by default)
  • Customizable level-up notifications (silent or dedicated channel)
  • Server leaderboards with .leaderboard
  • Individual rank checking with .rank
  • Configurable XP rates and level thresholds

Server Utilities

  • Custom command prefix per server
  • Fluxboard bridge integration via webhooks
  • Command enable/disable system
  • Server statistics and member tracking
  • Ping and uptime monitoring

Command Reference

Use .help to view all commands in-server. Below is a comprehensive overview:

Moderation Commands

Requires appropriate moderation permissions

Command Description Example
.ban <user> [reason] [time] Ban one or more users with optional duration .ban @user spam 7d
.unban <user_id> Remove a ban by user ID .unban 123456789
.kick <user> [reason] Remove a user from the server .kick @user disruptive
.mute <user> <duration> [reason] Timeout a user temporarily .mute @user 1h spamming
.unmute <user> Remove timeout from a user .unmute @user
.warn <user> [reason] Issue a warning to a user .warn @user language
.purge <amount> Delete multiple messages (1-100) .purge 50
.lock Lock current channel .lock
.unlock Unlock current channel .unlock

Logging Configuration

Requires Manage Server permission

Command Description Example
.logs set <type> <channel> Configure log channel .logs set moderation #mod-logs
.logs remove <type> Disable specific log type .logs remove join
.logs status View current logging setup .logs status

Available log types: moderation, join, leave, message_delete, message_edit

Role Management

Requires Manage Roles permission

Command Description Example
.reaction <link> <role> <emoji> Create reaction role .reaction https://fluxer.app/... @Member 👍
.reactrole <id> <role> <emoji> Create reaction role by message ID .reactrole 123456 @VIP ⭐
.setupreact Interactive reaction role wizard .setupreact
.listreactions <link> View all reaction roles on a message .listreactions https://fluxer.app/...
.removereact <link> [emoji] Remove reaction role(s) .removereact https://fluxer.app/... 👍
.autorole set <role> Auto-assign role to new members .autorole set @Member
.autorole remove Disable auto-role .autorole remove
.roleall <role> Assign role to all members .roleall @Verified

Leveling System

Requires Manage Server permission for configuration

Command Description Example
.leveling enable Enable XP system .leveling enable
.leveling disable Disable XP system .leveling disable
.levelchannel set <channel> Set level-up notification channel .levelchannel set #levels
.levelchannel silent Disable level-up messages .levelchannel silent
.rank [user] Check rank and XP .rank @user
.leaderboard View server leaderboard .leaderboard

Server Configuration

Requires Manage Server permission

Command Description Example
.prefix <new_prefix> Change command prefix .prefix !
.resetprefix Reset to default prefix .resetprefix
.bridge setup <id> <webhook> Connect to Fluxboard .bridge setup 12345 https://...
.bridge status View bridge configuration .bridge status
.bridge remove Disconnect bridge .bridge remove
.commands disable <command> Disable a command .commands disable bump
.commands enable <command> Enable a command .commands enable bump
.commands list View command status .commands list

General Commands

Command Description
.help [command] Display help information
.ping Check bot latency
.info View bot information
.stats Display server statistics
.bump Bump server on Fluxboard
.createinvite Generate server invite link

Quick Start

  1. Invite the bot to your server
  2. Grant permissions (Manage Roles, Manage Messages, Kick Members, Ban Members, Moderate Members)
  3. Run .help to explore available commands
  4. Configure logging, roles, and other features as needed

Reaction Roles Configuration

Choose your preferred setup method:

Method 1: Message ID (Recommended for same-channel setup)

  1. Enable Developer Mode in Fluxer settings
  2. Right-click target message → Copy ID
  3. Execute: .reactrole <message_id> @Role emoji

Method 2: Message Link (Works from any channel)

  1. Right-click target message → Copy Message Link
  2. Execute: .reaction <message_link> @Role emoji

Method 3: Interactive Wizard

  • Run .setupreact for step-by-step guidance

Examples:

.reactrole 1234567890 @Member 👍
.rr 1234567890 @VIP ⭐
.reaction https://fluxer.app/channels/123/456/789 @Gamer 🎮

Troubleshooting

Common Issues

Issue Solution
Bot not responding Verify bot online status and channel permissions
Commands not working Check prefix with .prefix status
Reaction roles failing Ensure message link uses fluxer.app format
Auto-role not assigning Verify bot role hierarchy and permissions
Logs not appearing Confirm log server running on port 3001

Quick Configuration

  • Enable leveling: .leveling enable
  • Change prefix: .prefix <new_prefix>
  • Setup reaction roles: .setupreact (interactive wizard)
  • Configure logging: .logs set <type> <channel>

Permission Requirements

Bot Permissions

The bot requires the following permissions to function properly:

Permission Purpose
Manage Roles Reaction roles, auto-roles, role assignment
Manage Messages Message purge, reaction management
Manage Channels Channel lock/unlock functionality
Kick Members User kick command
Ban Members User ban/unban commands
Moderate Members Timeout (mute) functionality
Send Messages Command responses and notifications
Embed Links Rich embed formatting
Add Reactions Reaction role setup
View Audit Log Enhanced logging features

User Permissions

Command execution requires appropriate permissions:

Permission Commands
Manage Server Prefix, leveling, bridge, logging configuration
Manage Roles Reaction roles, auto-roles, role management
Manage Channels Lock, unlock
Manage Messages Purge
Kick Members Kick
Ban Members Ban, unban
Moderate Members Mute, unmute, warn

Important Notes

  • Leveling is disabled by default — Enable with .leveling enable if desired
  • All configurations persist — Settings automatically save and survive restarts
  • Reaction roles support any emoji — Standard Unicode and custom server emojis
  • Bridge uses webhooks — Fast, reliable message forwarding to Fluxboard
  • Per-server command control — Disable unwanted commands with .commands disable
  • Core commands protectedhelp and commands cannot be disabled
  • Fluxer-exclusive — Built specifically for Fluxer.app, not compatible with Discord

Links & Resources


📝 Version Info Current Version: 1.0.3 Release Date: 2026-02-19 Status: Production Ready

0962b4e8-611a-49ab-bbf6-af88f5537f4e

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published