Custom Commands allow you to extend Kaori’s functionality by creating your own slash commands. You can define triggers, responses (including rich embeds), argument options, and powerful actions like assigning roles.

Creating a Command

Go to your server’s Dashboard.
Navigate to Custom Commands in the sidebar.
Click the New Command button.

Configuration Tabs

The editor is split into several tabs to help you organize your command’s logic.

General

Enable Command: Toggle the command on or off instantly.
Name: The name used to trigger the command (e.g., welcome becomes /welcome). Must be lowercase and no spaces.
Description: A short help text shown in Discord’s command picker.
Cooldown: Minimum time (in seconds) a user must wait before using the command again.
Ephemeral: If enabled, only the user running the command will see the response.

Response

Define what the bot should say when the command is run.

Message Content: Simple text response. Supports Variables.
Embed: Create a rich embed with title, description, color, fields, and images.

Options (Arguments)

Add arguments to your command to make it dynamic. For example, a user argument lets you target a specific member.

Type	Description
Text	Simple string input.
Integer	Whole numbers.
True/False	Boolean toggle.
User	Select a server member.
Channel	Select a server channel.
Role	Select a server role.

Example: Create an option named target of type User. You can then use {option:target} in your response to mention them.

Actions

Perform server actions when the command is executed.

Add Roles: Assign specific roles to the user.
Remove Roles: Remove specific roles from the user.
Send DM: Send the response to the user’s Direct Messages instead of the channel.

More Actions will be added with the future updates!

Permissions

Control who can use the command and where.

Allowed Roles: Whitelist specific roles (only they can use it).
Denied Roles: Blacklist specific roles (they cannot use it).
Allowed/Denied Channels: Restrict usage to specific channels.

Variables

You can use these placeholders in your Message Content and Embed fields. They will be replaced automatically.

Variable	Description
`{user}`	Mentions the user who ran the command.
`{user.tag}`	The user’s Discord handle (e.g., `User#1234`).
`{user.id}`	The user’s specific ID.
`{user.username}`	The user’s username.
`{guild.name}`	The name of the server.
`{guild.id}`	The ID of the server.
`{channel}`	Mentions the current channel.
`{channel.name}`	The name of the current channel.
`{option:name}`	The value of an argument option (e.g., `{option:target}`).

Example: Welcome Command

Goal: Create a command /greet that mentions a user and gives them a role.

General: Name = greet.
Options: Add option target (Type: User).
Response: “Hello {option:target}! Welcome to {guild.name}, invoked by user.”
Actions: Add Role “Member”.

Usage: User types: /greet target:@NewUser Bot responds: “Hello @NewUser! Welcome to MyServer, invoked by @Admin.” (And @Admin receives the “Member” role if configured, or @NewUser if the action logic targets the invoker - Note: Current implementation targets the executor).

Advanced Mode (TagScript)

For power users, Advanced Mode unlocks a full code editor using TagScript (powered by the tagscript engine). This allows for conditional logic, randomness, math, and complex embed building.

Enabling Advanced Mode

In the General tab of the command editor, toggle Advanced Mode.
A new Code (TagScript) tab will appear, replacing the Response and Actions tabs.

Scripting Features

Variables

All standard variables ({user}, {channel}, etc.) work here. Additionally:

Arguments: Use {args} to get all user-provided arguments joined together.
Specific Options: Use {option_name} (without the option: prefix used in simple mode) to access specific argument values.

Logic & Control Flow

If Statements: Check conditions.

{if({args}==):You didn't say anything!|You said: {args}}

Random: Generate random numbers or pick random items.

Your lucky number is {random:1,100}
I choose: {5050:Heads|Tails}

Embed Builder

You can build embeds directly in the script using {embed} tags.

{embed(title):My Embed Title}
{embed(description):This is a description with {user.mention}}
{embed(color):#5865F2}
{embed(field):Field Name|Field Value|true}

Complete Example

Here is a “Magic 8-Ball” command script:

{if({args}==):You need to ask a question!|
  {embed(title):Magic 8-Ball 🎱}
  {embed(desc):Question: {args}}
  {embed(field):Answer|{5050:Yes, absolutely!|My sources say no.|Ask again later.}|false}
  {embed(color):#5865F2}
  {embed(footer):Asked by {user.tag}}
}

​Creating a Command

​Configuration Tabs

​General

​Response

​Options (Arguments)

​Actions

​Permissions

​Variables

​Example: Welcome Command

​Advanced Mode (TagScript)

​Enabling Advanced Mode

​Scripting Features

​Variables

​Logic & Control Flow

​Embed Builder

​Complete Example

Creating a Command

Configuration Tabs

General

Response

Options (Arguments)

Actions

Permissions

Variables

Example: Welcome Command

Advanced Mode (TagScript)

Enabling Advanced Mode

Scripting Features

Variables

Logic & Control Flow

Embed Builder

Complete Example