Custom Commands

Custom Commands let you invent your own !commands for your Discord server. Pick a word, choose what the bot replies with, and it works straight away — no setup needed inside Discord.

Want a !gm that greets your members, a !roadmap that posts your roadmap image, or a !wen that fires back a random joke? That's this feature.

Where to set it up

Custom Commands are managed entirely from the TekTools dashboard:

1. Go to tektools.app and open your server's dashboard.
2. Select Custom Commands in the sidebar.
3. Click + New command.

info

You need the same permissions you use for the rest of the dashboard — only server admins can create or edit commands.

Creating a command

1. Pick a trigger word

The trigger is the word members type after !. Enter gm and your members run it as !gm.

Triggers can be 2–20 characters, using letters, numbers and dashes. They aren't case-sensitive: !GM and !gm both work.

warning

You can't reuse a built-in TekTools command name like flex or ping — those always take priority. The dashboard will tell you if a word is taken.

2. Choose what the bot does

Option	What happens
Reply with text	The bot replies with your message.
Reply with an image	The bot replies with an image, and an optional caption.
Reply with a random message	You give a list of messages; the bot picks one at random each time.

3. Fill in the reply

• Title (optional) — a heading shown above your reply.
• Reply message — the text of the reply.
• Image — upload a PNG, JPEG, GIF or WebP, or paste a link to an image already hosted on Discord, Imgur or Tenor.
• Reply options — for random replies, put one message per line.

4. Set the extras

• Cooldown per member — how many seconds a member must wait before using the command again. The default is 5 seconds, which stops the command being spammed. Set it to 0 to remove the cooldown.
• Only works in these channels — restrict the command to specific channels. Leave it empty to allow it anywhere.
• Command enabled — turn the command off without deleting it.

Click Create command and you're done. Try it in your server right away.

Personalizing replies with placeholders

Any text in your reply (including titles, captions and random options) can include placeholders that the bot fills in automatically:

Placeholder	Becomes
{user}	A mention of the member who ran the command
{username}	The member's name, without the mention
{server}	Your server's name
{membercount}	How many members your server has

For example, a !gm command with the reply:

gm {user}! You're one of {membercount} members on {server}. ☀️

…replies with "gm @alice! You're one of 4,213 members on Tekros. ☀️"

How many commands can I have?

Plan	Custom commands
Free	5
Premium	25

Your dashboard shows how many you've used. If you hit the limit, delete a command to make room or upgrade your server to premium.

Editing and deleting

Every command in the list has Edit and Delete buttons. The list also shows how many times each command has been used — handy for spotting which ones your community actually loves, and which ones to retire.

Deleting a command stops it working immediately and can't be undone. If you just want to pause one, edit it and switch Command enabled off instead.

Tips

• Use random replies to keep things fresh. A !gm with ten variations feels alive; one with a single canned line gets old fast.
• Give hype commands a cooldown. Fun commands get spammed — a 10–30 second cooldown keeps channels readable.
• Lock noisy commands to one channel. Restrict meme commands to your off-topic channel so they don't derail announcements.
• Document your commands. Pin a message listing your custom commands so new members can find them.