CUSTOM COMMAND DOCUMENTATION

Dynamic placeholders for NystBot responses.

Put these placeholders inside a custom command response. NystBot replaces them when the command runs. Custom commands also receive one optional args text field in Discord.

← Documentation Open Dashboard

EXAMPLE

Custom response

Hello {user}! Welcome to {server}.{newline}You ran /{command} in {channel} at {time}.

Mentions generated by custom templates use restricted allowed-mention settings, so a template cannot turn into an uncontrolled mass-ping tool.

👤 User

{user}User mention

{username}Discord display name

{user.id}Discord user ID

{user.avatar}User avatar URL

🏠 Server

{server}Discord server name

{server.id}Discord server ID

{server.membercount}Current member count

{server.icon}Server icon URL, or empty when no icon exists

#️⃣ Channel & bot

{channel}Current channel mention

{channel.name}Current channel name

{channel.id}Current channel ID

{bot}NystBot mention

{bot.name}NystBot display name in the server

⌨️ Command arguments

{command}Custom command name

{args}Everything entered in the optional args field

{arg1} – {arg9}First nine space-separated argument words

Example /announce args:Server maintenance at 20:00 📢 {args}

🕐 Date & time

{date}Current server-local date: YYYY-MM-DD

{time}Current server-local time: HH:mm:ss

{datetime}Current server-local date and time

{unix}Current Unix timestamp in seconds

Date/time placeholders use the time zone configured for the Discord server in NystBot.

✨ Utility

{newline}Insert a line break

{random:Yes|No|Maybe}Pick one value at random from the pipe-separated choices

ARGUMENT EXAMPLE

Make one command reusable.

Response:
📢 Announcement from {username}:{newline}{args}

Discord:
/announce args:Server maintenance starts in 30 minutes