francescoDiscord bot wiki

francesco wiki

Set up tickets, temporary voice rooms, activity logs and moderation in your Discord server.

Getting started

Type / in your Discord server and select francesco to see the commands available to you. Give the bot permissions in the channels where it needs to work and place its role above roles it should manage.

Voice rooms

Use /voice setup to choose a lobby. When a member joins, francesco creates a temporary voice channel and posts a control panel in its chat. The room owner can rename it, set a member limit, lock or hide it, manage member access, or transfer ownership. A connected member can claim the room once the owner leaves. Empty rooms are deleted automatically.

Use /voice disable to stop creating rooms. Allow the bot to manage channels and permissions in the category, move members from the lobby, and post embeds in the room chat.

Tickets

Use /ticket panel to pick a channel, a text or embed layout, and buttons, reactions, or a dropdown. In the private editor, choose Add / edit section to set up each section with its own category and staff role, then choose Publish. Each section has its own ticket number sequence. Use /ticket limit to set the maximum open tickets per member. Zero means unlimited.

Set a private staff channel with /ticket transcript_channel. The Close Ticket button sends a TXT transcript containing the conversation to that channel. Use /ticket transcript_dm enabled:false to turn off copies by DM. Use /ticket closed_category to set an archive, with an optional override per section. Staff can use /ticket reopen to restore access or /ticket purge to clear a closed ticket after saving a TXT backup.

Activity logs

Use /logs setup to select a private channel and choose Text or Embed. One channel works for all events. To split them, use /logs route category:Voice channel:#voice-logs. Repeat for any categories you want to separate.

Categories are Chat, Voice, Tickets, Roles, Members, Channels, Moderation, Giveaways, Audit and Server. Use /logs routes to see destinations. Omit the channel in /logs route to restore the default destination for that category.

Chat covers sent, edited and deleted messages. When Discord only supplies an ID for a deleted message, francesco includes it and links the original log if available. Server owners can opt in to eligible private chat logging with include_private:true. Ticket conversations stay in their transcript archive.

Anti-nuke & honeypot

Anti-nuke

Run /antinuke setup to enable protection. By default francesco allows up to three messages that ping @everyone and up to three channel deletions per member in a rolling 60-second window. On the fourth event of either kind, francesco attempts to remove the member’s manageable roles that grant sensitive permissions. Use /antinuke status to view settings or /antinuke disable to turn it off.

The bot needs Manage Roles and View Audit Log. It must sit above roles it manages. Channel deletion is recorded after it happens, and this feature does not restore deleted channels.

Honeypot

Choose a dedicated channel with /honeypot channel:#honeypot. Posting there triggers a ban if Discord’s role hierarchy lets francesco moderate the member. The bot needs to see the channel and have Ban Members. For the trap to work, members must be able to send a message. Run /honeypot with no channel to disable it.

Moderation & cleanup

Use /ban, /kick, /timeout, /mute and /warn to moderate members. Use /untimeout or /unmute to lift a timeout. Use /lock and /unlock to manage chat posting permissions.

/purge and /clear delete recent messages after confirmation. Use /autoclear setup to set an interval and message retention. Manual and automatic cleanup save a TXT backup before deletion.

Giveaways

Use /giveaway start to choose a channel, prize, duration and winner count. Members enter using the giveaway button. The bot chooses distinct eligible winners and updates the original post. Use /giveaway end or /giveaway cancel with the giveaway message ID.

Voice audio

Join a voice channel and use /music play with an audio attachment up to 25 MiB or /music radio for a SomaFM stream. Use the music commands to queue, pause, resume, skip, stop or leave. /music link opens Spotify, Apple Music or YouTube in their own players.