Talon

Install and set up Talon, the all-in-one Discord bot with 21 modules, a web dashboard and an embed builder.

Talon | Discord Bot

Features

  • 21 modules in one bot: tickets, moderation, automod, logging, backups, leveling, economy, games, giveaways, suggestions, roles, verification, welcome messages, music, stream alerts, temporary voice, applications, sticky messages, custom commands, a product panel and utility commands.
  • Web dashboard to change every setting per server, build messages with the embed builder and see activity, ticket and community statistics. It works on desktop, tablet and mobile.
  • Built-in storage: everything is stored in one local file. You do not need MySQL, MongoDB or Redis.
  • Commands are grouped per feature, for example /tickets panel, /music play and /mod warn.

Requirements

  • Node.js 24 or newer.
  • A Discord application with a bot user. You create it in the next section.
  • For the dashboard: a port the bot can listen on, and a domain or IP address you reach it on.

Creating the Discord application

  1. Open the Discord developer portal and click New Application.
  2. Open Bot, click Reset Token and copy the token. Keep it private.
  3. On the same page, turn on Server Members Intent and Message Content Intent. Talon needs both for welcome messages, leveling, logging and automod.
  4. Open OAuth2 and copy the Client ID and the Client Secret. The dashboard uses them to sign you in.
  5. Invite the bot with this link, replacing CLIENT_ID:
    https://discord.com/oauth2/authorize?client_id=CLIENT_ID&scope=bot+applications.commands&permissions=8
    Administrator is the simplest choice. Without it, give Talon the permissions for the modules you use, such as Manage Roles, Manage Channels, Moderate Members and Ban Members, and keep its role above the roles it should manage.

Installation

  1. Unzip Talon v1.0.zip and upload the talon-1.0.0 folder to your host.
  2. Install the dependencies in that folder:
    npm install --omit=dev
  3. Copy .env.example to .env and fill in at least TALON_TOKEN. You can also put the token in config/config.yml under Token.
  4. Start the bot:
    npm start
    Slash commands register on their own when the bot comes online.

To keep Talon running after you close the terminal, run it with a process manager such as pm2 or a systemd service.

Hosting on Pterodactyl or another game panel

  1. Create a server with a Node.js egg set to Node 24 or newer.
  2. Upload the contents of talon-1.0.0 to the server and set the startup file to src/index.js.
  3. Fill in .env, or set the same names as variables in the panel.
  4. For the dashboard, give the server a port allocation, set TALON_DASHBOARD_HOST to 0.0.0.0 and TALON_DASHBOARD_PORT to that port.

Configuration

Talon creates its config files on the first start. Changes to the files in config/modules are picked up the moment you save them. Restart the bot after changing config.yml or .env.

FileWhat it holds
.envToken, dashboard login details and other secrets. Values here win over config.yml.
config/config.ymlBot owners, the accent colour, the bot status, the dashboard, music limits, Twitch and Kick keys, prefix commands and the update check.
config/modules/*.ymlThe default settings of each module. Settings you change in the dashboard are stored per server and win over these files.
data/talon.dbAll data: tickets, levels, economy, warnings, giveaways and dashboard settings. Back this file up.

Environment variables

NameUse
TALON_TOKENThe bot token.
TALON_CLIENT_ID, TALON_CLIENT_SECRETFor signing in to the dashboard.
TALON_DASHBOARD_URLThe address you open the dashboard on, for example https://bot.example.com.
TALON_DASHBOARD_HOST, TALON_DASHBOARD_PORTWhere the dashboard listens. Keep 127.0.0.1 behind a reverse proxy, use 0.0.0.0 to listen on every address.
TALON_OWNER_IDSYour Discord user ID, comma separated for more owners.
TALON_GUILD_IDSOptional. Register commands only in these servers, which makes them appear instantly.

Web dashboard

  1. Set TALON_CLIENT_ID, TALON_CLIENT_SECRET and TALON_DASHBOARD_URL.
  2. In the developer portal, open OAuth2 and add TALON_DASHBOARD_URL followed by /callback as a redirect, for example https://bot.example.com/callback.
  3. Restart the bot and open the dashboard URL. Sign in with Discord and pick a server.

Only members with Manage Server in a server can change its settings. For a public address, put the dashboard behind a reverse proxy with HTTPS, such as Nginx, Caddy or Nginx Proxy Manager.

Embed builder

Build messages as Components V2 or as classic embeds. In V2 you stack bricks: cards with an accent colour, text, sections with a thumbnail or button, image galleries, dividers and link buttons. Save drafts, post them in any channel and update every posted copy later. Import JSON accepts Discord message JSON, for example from Discohook.

Commands

CommandModule
/ticketsTicket panels, claiming, priorities, transcripts and statistics
/modWarnings, timeouts, kicks, bans, purge, notes and reports
/scamfilterKnown scam images for automod
/backupServer backups and restores
/levelRank cards, leaderboards and level changes
/economyCoins, jobs, shop, casino games, pets, heists and the lottery
/funWordle, hangman, connect four, 2048, tic tac toe and fun commands
/giveawayGiveaways with requirements and rerolls
/suggestionsSuggestions and staff answers
/reactionroles, /invitesRole panels and invite tracking
/verificationVerification panel with a button, a sum or an image captcha
/welcomePreview of the welcome and leave messages
/musicPlay, queue and control music in voice
/voiceControl your temporary voice channel
/streamsStream alerts
/applications, /sticky, /custom, /productsApplications, sticky messages, custom commands and the product panel
/utilHelp, server and user info, polls, reminders, announcements and more

Notes per module

  • Music plays YouTube, Spotify, SoundCloud, Apple Music, Deezer and Vimeo links or a search. It downloads its audio helper on the first song, which takes a few seconds.
  • Stream alerts for Twitch and Kick need an application on their developer sites; put the keys under Twitch and Kick in config.yml. YouTube and TikTok work without keys.
  • Welcome images are off by default. Turn on Generate a welcome image in the Welcome module; the dashboard shows a live preview.
  • Temporary voice is off by default. Pick one or more join channels in the dashboard and turn it on.
  • Statistics count from the moment Talon is in your server.

Addons and translations

Put your own modules in an addons folder next to src. A module exports its name, settings, commands and events, the same way the built-in modules do. To change bot texts, add a language file in config/lang and set Language in config.yml.

Updating

  1. Stop the bot and back up data, config and .env.
  2. Replace everything else with the files from the new zip.
  3. Run npm install --omit=dev and start the bot.

The console tells you when a new version is available. Turn this off with UpdateCheck: false.

Troubleshooting

  • "Used disallowed intents" when starting: turn on Server Members Intent and Message Content Intent in the developer portal.
  • Commands do not show up: global commands can take a while to appear. Set TALON_GUILD_IDS to register them in your server right away, and check that the bot was invited with the applications.commands scope.
  • Dashboard login fails: the redirect in the developer portal must match TALON_DASHBOARD_URL plus /callback exactly.
  • Talon cannot give a role: move the Talon role above that role in the server settings.
  • "Application did not respond": check the console for an error. Open a ticket on our Discord with that error and we will help you.