# Home Use the multi-purpose and feature-rich Asagi bot for your awesome servers/projects!

**Asagi** — is a versatile bot that is winning the hearts of Discord server owners. With a wide range of functionalities, it provides an easy and enjoyable way to manage your projects. Immerse yourself in a world of versatile features and enhance your users' experience with Asagi! ## Our social media: TikTok — [https://www.tiktok.com/@asagi.bot]()\ YouTube — \ Instagram — \ Threads — \ X (Twitter) — \ Telegram — ## To add the bot to your server, follow these steps: 1. Authorize in [Discord](https://discord.com/login). 2. Click on the [link](https://discord.com/api/oauth2/authorize?client_id=1053580838945693717\&permissions=8\&scope=bot). 3. Select your wonderful server. 4. Click the "Continue" button. 5. Press "Authorize". # How to use the Asagi bot? ## Primary Method Use `/help` to see a list of commands.

You can choose a category to see descriptions of commands.

# Configuring Bot Features ## Automatic Roles This feature is responsible for assigning roles to new members. To enable it, type the command `/settings` and choose **Automatic Roles**. {% hint style="info" %} The "Full list of roles" button appears when 5 or more roles are selected. By clicking on this button, you will get a complete list of roles in the format `@role.mention`` ``(role.name — role.id)` {% endhint %}

### Result:

## [Moderation](/guides/configuring-bot-features/moderation) This feature provides a variety of filters for automatic moderation on the server. You can learn more about each filter by clicking on the item's name. ## [Love Rooms](/guides/configuring-bot-features/love-rooms) {% hint style="danger" %} #### Requires Asagi Premium subscription Discover new horizons with **Asagi Premium** - a premium subscription that unlocks additional features and enhances your experience. Gain access to cutting-edge tools and functionalities to unleash your full potential. Don't miss the opportunity to enhance your interaction with **Asagi** - subscribe to **Asagi Premium** right now. Learn more about available subscriptions [here](https://www.patreon.com/asagibot), and about the features of **Asagi Premium** [here](/guides/prices-and-features-of-asagi-premium). {% endhint %} When Love Rooms are enabled, users have the ability to create voice channels after getting married. These channels will be accessible only to the specific couple who got married. # Interactive Messages Interactive Messages allow interaction with the bot through custom buttons and select menus, making the bot usage more intuitive and convenient. ## Custom Buttons **Custom Buttons** provide the ability to add buttons to messages that perform various actions with the user upon clicking. For example, the bot can: * Assign or remove roles from the user * Send messages to channels * Execute other customizable actions Each button can be tailored to the specific needs of your server, enhancing the overall interaction. ## Custom Select Menus (Coming Soon) **Custom Select Menus** are dropdown menus that allow users to select one or multiple options from a list. This feature is currently in development and will be available in future updates. Select Menus are suitable for situations where flexible choices need to be provided to users. # Moderation ## Automatic Moderation Settings ### General {% hint style="info" %} Each filter has its own settings. {% endhint %} ### Punishments for Violations You have three types of punishments to choose from: **Timeout**, **Kick**, **Ban**.

{% hint style="info" %} You can only set a duration for the "Timeout" type of punishment. {% endhint %} {% hint style="warning" %} Time Format: \ d - days \ h - hours \ m - minutes \ s - seconds Example: 21d15h9m20s \ The punishment will be applied for 21 days, 15 hours, 9 minutes, 20 seconds. {% endhint %}

#### Result:

### Ignoring Channels Imagine you have a dedicated text channel for sending links, and you don't want to apply any sanctions to users in that channel.

### Ignoring Roles Imagine you have members with certain roles who should be allowed to send links, and you don't want to apply any sanctions to them.

### Notify Member about Violation Members may not understand what happened, so we recommend notifying them about violations they may not be aware of. {% hint style="info" %} There are two notification options: * The channel where the violation occurred. * Direct messages. {% endhint %}

{% hint style="info" %} There is no default violation message, so you need to specify the text yourself. Both plain text and [JSON ](/guides/json-builder-in-the-asagi-bot)code are supported. [Variables](/other/message-templates/variables) are also available. {% endhint %}

## Automatic Moderation Filters ### Links The default penalty type is "Timeout" for 15 minutes when any link is found. #### How does it work? This filter reacts to messages containing any links. You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

#### How do I enable this filter? To enable this filter, type the command `/settings` and choose *Moderation*. In the dropdown menu, select "Links".

### Invitations The default penalty type is "Timeout" for 15 minutes when any Discord invitation found. #### How does it work? This filter reacts to messages containing any Discord invitation. You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

#### How do I enable this filter? To enable this filter, type the command `/settings` and choose *Moderation*. In the dropdown menu, select "Invitations".

# Love Rooms When Love Rooms are enabled, users have the ability to create voice channels after getting married. These channels will be accessible only to the specific couple who got married. {% hint style="danger" %} #### Requires Asagi Premium subscription Discover new horizons with **Asagi Premium** - a premium subscription that unlocks additional features and enhances your experience. Gain access to cutting-edge tools and functionalities to unleash your full potential. Don't miss the opportunity to enhance your interaction with **Asagi** - subscribe to **Asagi Premium** right now. Learn more about available subscriptions [here](https://www.patreon.com/asagibot), and about the features of **Asagi Premium** [here](/guides/prices-and-features-of-asagi-premium). {% endhint %} ## Love Rooms Installation To enable it, type the command `/settings` and choose **Marriage**, click "Enable", then "Enable Love Rooms Creation".

### Result:

## Love Rooms Settings ### Change Control Panel Style You can change the color of the control panel. To change the style, use the `/settings -> Marriage -> Love Rooms Settings -> Change Control Panel Style` command.

#### Result:

### Change Default Room Name You can change the default name when creating each new love room. [Variables](/other/message-templates/variables#love-rooms) can be used. To change the default room name, use the `/settings -> Marriage -> Love Rooms Settings -> Change Default Room Name` command.

### Control Panel Components Management You can manage components in the love room control panel (enable/disable components). To manage components, use the `/settings -> Marriage -> Love Rooms Settings -> Control Panel Components Management` command.

### Reserve Categories Useful if Love Rooms are in huge demand on your servers (50 channels per category). When the main category is full, new rooms will be automatically moved to free reserve categories. Up to 25 categories can be specified in total. To set reserve categories, use the `/settings -> Marriage -> Love Rooms Settings -> Reserve Categories` command.

#### Result:

# JSON Builder in the Asagi bot ## Where is JSON code used? This code can be inserted into commands such as: `/say` **-** Send a message on behalf of the bot `/settings` **-> Notifications -> Greetings to new members on the server** `/settings` **-> Notifications -> Greetings to new members in DM** `/settings` **-> Notifications -> Farewells** `/settings` **-> Moderation** (all filters) {% hint style="info" %} Using any Embed Builder, you risk not getting the expected result. We recommend using [https://oldeb.nadeko.bot](https://oldeb.nadeko.bot/) {% endhint %} ## Description of the website fields

## Changing the color of the embed bar To choose the color for the bar, click on it.

You can select from a range of basic colors, but if you prefer a custom color, visit [htmlcolorcodes.com](https://htmlcolorcodes.com/), choose your desired color, copy the code (#), and then paste it into the builder.

## Inline parameter The "Inline" parameter controls the arrangement of fields (in line or column).

Fields with "Inline" disabled:

Fields with "Inline" enabled:

## Getting Image URL {% hint style="info" %} Image can be either static (**png**, **jpeg**, **jpg**, **webm**) or dynamic (**gif**). {% endhint %} {% hint style="info" %} Example: The website is used. You can choose any other website, but copying the link may be done differently, including using your browser's right-click menu (PC). {% endhint %} \ To copy the image link, follow these steps: 1. Find the image you're interested in. 2. Click on the "Share" button on the right sidebar. 3. Click on the "Copy GIF Link" button. To use the image link, follow these steps: 1. Go to the Embed Builder. 2. Paste the image into the fields you need. {% hint style="info" %} Image insertion is available for the following fields: * Icon URL * Thumbnail URL * Image URL * Footer icon URL {% endhint %} {% hint style="danger" %} Example: All fields are filled, including where an image can be inserted. {% endhint %}

## Completing the Editing After finishing the editing, click the "Copy" button, and the JSON code will be copied to your clipboard for use. {% hint style="danger" %} The example demonstrates copying the code. This code still requires additional modifications. it won't work as shown! {% endhint %}

To use our JSON code, follow these steps: 1. Enter the command `/say` 2. Paste the copied text.

# Verification ## Step 1: Assigning an Automatic Role Assign an automatic role to users who join your server. This can be the “Unverified” role or any other role that restricts access to the server's main channels.

Example: Assigning the "Unverified" role

## Step 2: Setting Up Channel and Category Permissions Configure the permissions for channels and categories. Ensure that the role assigned in the previous step (e.g., “Unverified”) has restricted access to most channels. Specifically, remove the "View Channels" permission for the "Unverified" role in channels where access should be restricted, and add the same "View Channels" permission for the @everyone role.

Example: Configuring category permissions

## Step 3: Creating a Verification Channel Create a private text channel for verification. Set the channel permissions so that only the role assigned in the first step (e.g., “Unverified”) has the "View Channels" permission. This ensures that only new users can access the verification process, while other roles do not see this channel.

Example: Creating a verification channel

## Step 4: Sending a Message Send a message in the verification channel using the `/say` command from our bot. You can also use JSON code to generate an embed for a more customized message. For detailed instructions on how to create embeds using JSON, refer to the [JSON Builder Guide](/guides/json-builder-in-the-asagi-bot).

Example: Message with verification instructions

## Step 5: Using Reactions or Interactive Messages ### **Example 1: Using Reactions** For verification via reactions: 1. **Configure Reaction**: Set up our bot to respond to a specific reaction on the verification message. 2. **Role Management**: When a user reacts, the bot will: * Remove the "Unverified" role * Assign the "Verified" role #### **Example Setup:** * **Reaction**: A specific emoji (e.g., ✔️) * **Role to Remove**: "Unverified" * **Role to Assign**: "Verified"

**Example: Reaction-based verification**

### **Example 2: Using Interactive Messages** For verification via interactive messages: 1. **Configure Interactive Message**: Use buttons in your interactive messages to handle verification. 2. **Role Management**: When a user clicks a button, the bot will: * Remove the "Unverified" role * Assign the "Verified" role #### **Example Setup:** * **Button Emoji**: e.g., ✔️ * **Role to Remove**: "Unverified" * **Role to Assign**: "Verified"

# Prices and Features of Asagi Premium ## Types of subscriptions: * Subscription for **3** servers — **$3/month**; * Subscription for **5** servers — **$5/month**; You can subscribe through the **Patreon** service - . {% hint style="danger" %} Before subscribing to Premium, please ensure you link your Discord account to your Patreon account! {% endhint %}

{% hint style="danger" %} To receive additional bonuses, you need to be on the[ Asagi Support](https://discord.gg/Pc3QfCwryz) server. {% endhint %} ## Limits | Feature | Without Asagi Premium | With Asagi Premium | | -------------------- | --------------------- | ------------------ | | Interactive Messages | Max 1 | Max 25 | ## List of features that are available to servers with Asagi Premium: ### 1. Control Panel Styles for Private Rooms You can change the color of the control panel to premium. To change the style, use the `/settings -> Private Rooms -> Change Control Panel Style` command.

### 2. Reserve Categories for Private Rooms Useful if Private Rooms are in huge demand on your servers (50 channels per category). When the main category is full, new rooms will be automatically moved to free reserve categories. Up to 25 categories can be specified in total. To set reserve categories, use the `/settings -> Private Rooms -> Reserve Categories` command.

### 3. Owner Profiles for Private Rooms Your saved settings are automatically applied when you create a new room — no need to redo everything every time. Each profile can include:\ • room name\ • user limit\ • privacy settings\ • trusted users\ • distrusted users It’s a simple way to keep your favorite setup on every server — ready to go in seconds. ### 4. Thread on a message for Starboard Creation a thread on a message with customizable options: thread title, content of the sent message (possibly using [variables](/other/message-templates/variables#server)), and pinning the message. To enable thread on a message, use the `/settings -> Starboard -> Create Threads` command.

### 5. Role Assignments for Starboard Assigning a role upon reaching a certain number of reactions on a message. To enable role assignments, use the `/settings -> Starboard -> Assign Roles` command.

### 6. Automatic Reactions to a message for Starboard The bot automatically adds a reaction to messages. When counting the number of reactions, the bot's reactions are not counted. To enable automatic reactions, use the `/settings -> Starboard` command.

### 7. [Love Rooms](/guides/configuring-bot-features/love-rooms) When Love Rooms are enabled, users have the ability to create voice channels after getting married. These channels will be accessible only to the specific couple who got married. To enable it, type the command `/settings` and choose **Marriage**, click "Enable", then "Enable Love Rooms Creation".

### 8. Music The bot allows you to play high-quality music directly in your voice channels from various sources, including **SoundCloud**, **Spotify**, and **Twitch streams**. To play music, use the `/play` command followed by the name or URL of the song you want to play.

### 9. Anonymous Comments Allows members to comment on anonymous messages without revealing their identity.\ Useful for honest feedback, confessions, or appreciation messages. Comments can be left using the `/confession comment` command and moderated with the same commands used for regular anonymous messages.

### 10. Reminders Premium allows creating recurring reminders on a schedule with **interval**, **daily window** (start/end), **date range**, and/or **weekdays**.\ **Limits**: up to **50** active reminders (**one-time and recurring**) with a scheduling horizon of **up to 2 years** (730 days). Examples:\ • **Every day at 09:00** — morning check-in in #general.\ • **Every 2 hours on weekdays from 10:00 to 18:00** — remind mods to review reports.\ • **Every Saturday at 12:00** — weekend plans post.\ • **On the 1st of every month at 10:00** — birthdays list. Use `/reminder create` to set up reminders and `/reminder edit` to manage them. # Message Templates ## [Variables](/other/message-templates/variables) Variables in the template are represented as: `category.type` ### For example: **Template**: Welcome to the server, member.username! **Result**: Welcome to the server, vollar! # Color Names This section presents various color names that can be used in embeds. Each color is provided in HEX and RGB formats, along with a color sample.

Color Name	Hex Code	RGB Code
AliceBlue	`#F0F8FF`	`rgb(240, 248, 255)`
AntiqueWhite	`#FAEBD7`	`rgb(250, 235, 215)`
Aqua	`#00FFFF`	`rgb(0, 255, 255)`
Aquamarine	`#7FFFD4`	`rgb(127, 255, 212)`
Azure	`#F0FFFF`	`rgb(240, 255, 255)`
Beige	`#F5F5DC`	`rgb(245, 245, 220)`
Bisque	`#FFE4C4`	`rgb(255, 228, 196)`
Black	`#000000`	`rgb(0, 0, 0)`
BlanchedAlmond	`#FFEBCD`	`rgb(255, 235, 205)`
Blue	`#0000FF`	`rgb(0, 0, 255)`
BlueViolet	`#8A2BE2`	`rgb(138, 43, 226)`
Brown	`#A52A2A`	`rgb(165, 42, 42)`
Burlywood	`#DEB887`	`rgb(222, 184, 135)`
CadetBlue	`#5F9EA0`	`rgb(95, 158, 160)`
Chartreuse	`#7FFF00`	`rgb(127, 255, 0)`
Chocolate	`#D2691E`	`rgb(210, 105, 30)`
Coral	`#FF7F50`	`rgb(255, 127, 80)`
CornflowerBlue	`#6495ED`	`rgb(100, 149, 237)`
Cornsilk	`#FFF8DC`	`rgb(255, 248, 220)`
Crimson	`#DC143C`	`rgb(220, 20, 60)`
Cyan	`#00FFFF`	`rgb(0, 255, 255)`
DarkBlue	`#00008B`	`rgb(0, 0, 139)`
DarkCyan	`#008B8B`	`rgb(0, 139, 139)`
DarkGoldenRod	`#B8860B`	`rgb(184, 134, 11)`
DarkGray	`#A9A9A9`	`rgb(169, 169, 169)`
DarkGreen	`#006400`	`rgb(0, 100, 0)`
DarkKhaki	`#BDB76B`	`rgb(189, 183, 107)`
DarkMagenta	`#8B008B`	`rgb(139, 0, 139)`
DarkOliveGreen	`#556B2F`	`rgb(85, 107, 47)`
DarkOrange	`#FF8C00`	`rgb(255, 140, 0)`
DarkOrchid	`#9932CC`	`rgb(153, 50, 204)`
DarkRed	`#8B0000`	`rgb(139, 0, 0)`
DarkSalmon	`#E9967A`	`rgb(233, 150, 122)`
DarkSeaGreen	`#8FBC8F`	`rgb(143, 188, 143)`
DarkSlateBlue	`#483D8B`	`rgb(72, 61, 139)`
DarkSlateGray	`#2F4F4F`	`rgb(47, 79, 79)`
DarkTurquoise	`#00CED1`	`rgb(0, 206, 209)`
DarkViolet	`#9400D3`	`rgb(148, 0, 211)`
DeepPink	`#FF1493`	`rgb(255, 20, 147)`
DeepSkyBlue	`#00BFFF`	`rgb(0, 191, 255)`
DimGray	`#696969`	`rgb(105, 105, 105)`
DodgerBlue	`#1E90FF`	`rgb(30, 144, 255)`
FireBrick	`#B22222`	`rgb(178, 34, 34)`
FloralWhite	`#FFFAF0`	`rgb(255, 250, 240)`
ForestGreen	`#228B22`	`rgb(34, 139, 34)`
Fuchsia	`#FF00FF`	`rgb(255, 0, 255)`
Gainsboro	`#DCDCDC`	`rgb(220, 220, 220)`
GhostWhite	`#F8F8FF`	`rgb(248, 248, 255)`
Gold	`#FFD700`	`rgb(255, 215, 0)`
GoldenRod	`#DAA520`	`rgb(218, 165, 32)`
Gray	`#808080`	`rgb(128, 128, 128)`
Green	`#008000`	`rgb(0, 128, 0)`
GreenYellow	`#ADFF2F`	`rgb(173, 255, 47)`
HoneyDew	`#F0FFF0`	`rgb(240, 255, 240)`
HotPink	`#FF69B4`	`rgb(255, 105, 180)`
IndianRed	`#CD5C5C`	`rgb(205, 92, 92)`
Indigo	`#4B0082`	`rgb(75, 0, 130)`
Ivory	`#FFFFF0`	`rgb(255, 255, 240)`
Khaki	`#F0E68C`	`rgb(240, 230, 140)`
Lavender	`#E6E6FA`	`rgb(230, 230, 250)`
LavenderBlush	`#FFF0F5`	`rgb(255, 240, 245)`
LawnGreen	`#7CFC00`	`rgb(124, 252, 0)`
LemonChiffon	`#FFFACD`	`rgb(255, 250, 205)`
LightBlue	`#ADD8E6`	`rgb(173, 216, 230)`
LightCoral	`#F08080`	`rgb(240, 128, 128)`
LightCyan	`#E0FFFF`	`rgb(224, 255, 255)`
LightGoldenRodYellow	`#FAFAD2`	`rgb(250, 250, 210)`
LightGray	`#D3D3D3`	`rgb(211, 211, 211)`
LightGreen	`#90EE90`	`rgb(144, 238, 144)`
LightPink	`#FFB6C1`	`rgb(255, 182, 193)`
LightSalmon	`#FFA07A`	`rgb(255, 160, 122)`
LightSeaGreen	`#20B2AA`	`rgb(32, 178, 170)`
LightSkyBlue	`#87CEFA`	`rgb(135, 206, 250)`
LightSlateGray	`#778899`	`rgb(119, 136, 153)`
LightSteelBlue	`#B0C4DE`	`rgb(176, 196, 222)`
LightYellow	`#FFFFE0`	`rgb(255, 255, 224)`
Lime	`#00FF00`	`rgb(0, 255, 0)`
LimeGreen	`#32CD32`	`rgb(50, 205, 50)`
Linen	`#FAF0E6`	`rgb(250, 240, 230)`
Magenta	`#FF00FF`	`rgb(255, 0, 255)`
Maroon	`#800000`	`rgb(128, 0, 0)`
MediumAquamarine	`#66CDAA`	`rgb(102, 205, 170)`
MediumBlue	`#0000CD`	`rgb(0, 0, 205)`
MediumOrchid	`#BA55D3`	`rgb(186, 85, 211)`
MediumPurple	`#9370DB`	`rgb(147, 112, 219)`
MediumSeaGreen	`#3CB371`	`rgb(60, 179, 113)`
MediumSlateBlue	`#7B68EE`	`rgb(123, 104, 238)`
MediumSpringGreen	`#00FA9A`	`rgb(0, 250, 154)`
MediumTurquoise	`#48D1CC`	`rgb(72, 209, 204)`
MediumVioletRed	`#C71585`	`rgb(199, 21, 133)`
MidnightBlue	`#191970`	`rgb(25, 25, 112)`
MintCream	`#F5FFFA`	`rgb(245, 255, 250)`
MistyRose	`#FFE4E1`	`rgb(255, 228, 225)`
Moccasin	`#FFE4B5`	`rgb(255, 228, 181)`
NavajoWhite	`#FFDEAD`	`rgb(255, 222, 173)`
Navy	`#000080`	`rgb(0, 0, 128)`
OldLace	`#FDF5E6`	`rgb(253, 245, 230)`
Olive	`#808000`	`rgb(128, 128, 0)`
OliveDrab	`#6B8E23`	`rgb(107, 142, 35)`
Orange	`#FFA500`	`rgb(255, 165, 0)`
OrangeRed	`#FF4500`	`rgb(255, 69, 0)`
Orchid	`#DA70D6`	`rgb(218, 112, 214)`
PaleGoldenRod	`#EEE8AA`	`rgb(238, 232, 170)`
PaleGreen	`#98FB98`	`rgb(152, 251, 152)`
PaleTurquoise	`#AFEEEE`	`rgb(175, 238, 238)`
PaleVioletRed	`#DB7093`	`rgb(219, 112, 147)`
PapayaWhip	`#FFEFD5`	`rgb(255, 239, 213)`
PeachPuff	`#FFDAB9`	`rgb(255, 218, 185)`
Peru	`#CD853F`	`rgb(205, 133, 63)`
Pink	`#FFC0CB`	`rgb(255, 192, 203)`
Plum	`#DDA0DD`	`rgb(221, 160, 221)`
PowderBlue	`#B0E0E6`	`rgb(176, 224, 230)`
Purple	`#800080`	`rgb(128, 0, 128)`
RebeccaPurple	`#663399`	`rgb(102, 51, 153)`
Red	`#FF0000`	`rgb(255, 0, 0)`
RosyBrown	`#BC8F8F`	`rgb(188, 143, 143)`
RoyalBlue	`#4169E1`	`rgb(65, 105, 225)`
SaddleBrown	`#8B4513`	`rgb(139, 69, 19)`
Salmon	`#FA8072`	`rgb(250, 128, 114)`
SandyBrown	`#F4A460`	`rgb(244, 164, 96)`
SeaGreen	`#2E8B57`	`rgb(46, 139, 87)`
SeaShell	`#FFF5EE`	`rgb(255, 245, 238)`
Sienna	`#A0522D`	`rgb(160, 82, 45)`
Silver	`#C0C0C0`	`rgb(192, 192, 192)`
SkyBlue	`#87CEEB`	`rgb(135, 206, 235)`
SlateBlue	`#6A5ACD`	`rgb(106, 90, 205)`
SlateGray	`#708090`	`rgb(112, 128, 144)`
Snow	`#FFFAFA`	`rgb(255, 250, 250)`
SpringGreen	`#00FF7F`	`rgb(0, 255, 127)`
SteelBlue	`#4682B4`	`rgb(70, 130, 180)`
Tan	`#D2B48C`	`rgb(210, 180, 140)`
Teal	`#008080`	`rgb(0, 128, 128)`
Thistle	`#D8BFD8`	`rgb(216, 191, 216)`
Tomato	`#FF6347`	`rgb(255, 99, 71)`
Turquoise	`#40E0D0`	`rgb(64, 224, 208)`
Violet	`#EE82EE`	`rgb(238, 130, 238)`
Wheat	`#F5DEB3`	`rgb(245, 222, 179)`
White	`#FFFFFF`	`rgb(255, 255, 255)`
WhiteSmoke	`#F5F5F5`	`rgb(245, 245, 245)`
Yellow	`#FFFF00`	`rgb(255, 255, 0)`
YellowGreen	`#9ACD32`	`rgb(154, 205, 50)`

# Variables ## **User**

Variable	Description
`{{ user.id }}`	The unique identifier of the user
`{{ user.username }}`	The username of the user
`{{ user.mention }}`	A mention of the user, which can be used to notify them in a message
`{{ user.avatarUrl }}`	The URL of the user's avatar
`{{ user.bannerColor }}`	The color of the user's banner
`{{ user.globalName }}`	The global name of the user

Variable	Description
`{{ member.nickname }}`	The nickname of the member on the server
`{{ member.displayName }}`	The display name of the member, which is their nickname if they have one, or their username otherwise
`{{ member.serverAvatarUrl }}`	The URL of the member's server avatar
`{{ member.roles.highest.name }}`	The name of the member's highest role on the server

{% hint style="info" %} These variables can be used in the following modules: Automatic Moderation, Interactive Messages, Love Rooms, Notifications, Private Rooms. {% endhint %} {% hint style="warning" %} For Love Rooms, use `member1` and `member2` variables. {% endhint %} ## **Guild** | Variable | Description | | ------------------------- | ----------------------------------------- | | `{{ guild.id }}` | The unique identifier of the server | | `{{ guild.name }}` | The name of the server | | `{{ guild.iconUrl }}` | The URL of the server's icon | | `{{ guild.bannerUrl }}` | The URL of the server's banner | | `{{ guild.memberCount }}` | The number of the members on the server | | `{{ guild.nameAcronym }}` | The abbreviated form of the server's name | | `{{ guild.boostsCount }}` | The number of server boosts | {% hint style="info" %} These variables can be used in the following modules: Automatic Moderation, Interactive Messages, Love Rooms, Notifications, Private Rooms, Starboard. {% endhint %} ## Roles

Variable	Description
`{{ roles.added }}`	The roles that were added to the member
`{{ roles.removed }}`	The roles that were removed from the member

{% hint style="info" %} These variables can be used only in the Interactive Messages module! {% endhint %} ## **Timestamp**

Variable	Description
`{{ timestamp.now }}`	The current Unix timestamp
`{{ timestamp.userCreatedAt }}`	The Unix timestamp for the date and time when the user's account was created
`{{ timestamp.memberJoinedAt }}`	The Unix timestamp for the date and time when the member joined the server
`{{ timestamp.guildCreatedAt }}`	The Unix timestamp for the date and time when the server was created

{% hint style="info" %} These variables can be used in the following modules: Automatic Moderation, Interactive Messages, Notifications. {% endhint %} ## **Color**

Variable	Description
`{{ color.default }}`	The default color of the embed, set in the bot's configuration for system messages
`{{ color.embed }}`	The color of the embed, taken from the bot settings
`{{ color.error }}`	The error color of the embed, set in the bot's configuration for error messages

{% hint style="info" %} These variables can be used in the following modules: Automatic Moderation, Interactive Messages, Notifications, Starboard. {% endhint %} ## Birthday

Variable	Description
`{{ birthday.date }}`	The member's birthday date, formatted according to the server language. The year is not included
`{{ birthday.day }}`	The day of the member's birthday
`{{ birthday.month }}`	The localized name of the member's birthday month
`{{ birthday.monthNumber }}`	The number of the member's birthday month, from `1` to `12`
`{{ birthday.timestamp }}`	The Unix timestamp of the birthday occurrence, based on the server timezone

{% hint style="info" %} Birthday variables are available in birthday-related message templates, including birthday messages and birthday reminders. {% endhint %} ## Handling Conditional Expressions with || and ? Operators * `||`: This operator is used to handle expressions of the form `{{ identifier || 'default' }}`. If `identifier` is defined and not `null`, it is replaced with the corresponding value. If `identifier` is undefined or `null`, it is replaced with `'default'`. * `?`: This operator is used to handle ternary expressions of the form `{{ identifier ? 'value if true' : 'value if false' }}`. If `identifier` is defined and not `null`, it is replaced with `'value if true'`. If `identifier` is undefined or `null`, it is replaced with `'value if false'`. {% tabs %} {% tab title="Examples with the || operator" %} 1. `{{ roles.added || 'No roles have been added.' }}`

{% endtab %} {% tab title="Examples with the ? operator" %} 1. `{{ roles.added ? 'New roles have been added: {{ roles.added }}' : 'No roles have been added.' }}`

2. `{{ roles.added ? 'Role has been added: {{ roles.added }}' : '' }}{{ roles.removed ? 'Role has been removed: {{ roles.removed }}' : '' }}`

{% endtab %} {% endtabs %} **Note:** You can use both single `'` and double quotes `"` for strings in these expressions. Additionally, it is possible to include variables inside these conditional expressions. # Mentions and Custom Emojis In order to use mentions of any kind, or custom emojis in an embed you will need to make use of IDs. ## Mention Types and Formats | Mention Type | Mention Format | | ---------------- | ------------------------ | | Roles | `<@&role_id>` | | Channels | `<#channel_id>` | | Users | `<@user_id>` | | Emojis | `<:emoji_name:emoji_id>` | | Slash commands | `` | | Server Guide | `` | | Browse Channels | `` | | Channels & Roles | `` | ## Getting IDs: ### Copy IDs by Enabling Developer Mode: 1. Go to **`Settings`** and locate **`App Settings`**. 2. Click on **`Advanced`** and enable **`Developer Mode`**. 3. You can now right-click on channels, users, and roles and select **`Copy ID`**. 4. Use the format seen above to incorporate these IDs into your embeds. ### Copying Emojis IDs 1. Send the emoji in a chat. 2. Right-click on the emoji and select **`Copy Link`**. 3. Paste the link into the chat box; it will look like `https://cdn.discordapp.com/emojis/emoji_id.webp?size=96&quality=lossless`. 4. Copy the emoji ID from the URL. **Note**: In order to use custom emojis in embeds, Asagi needs to be a member of the server where the emoji is from. ### Examples: | Mention Format | Result | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `<@&1080151142299873372>` |

| | `<#1155016551347535872>` |

| | `<@1053580838945693717>` |

| | `<:asagi:1272462968847859762>` |

| | `` |

| # Timestamps ## **What is a timestamp?** A timestamp is a marker that indicates a specific moment in time, such as when a message was sent or an event occurred. ## What is Unix time? Unix time, or Epoch time, is a system for measuring time starting from January 1, 1970. It shows the number of seconds that have passed since this point. Discord uses this standard for managing time. ## How to Format a Timestamp in Discord? To create a timestamp in Discord, use the following format: ``` ``` * **`unix`**: The Unix time (epoch time) in seconds. It represents the specific moment you want to display. * **`format`**: The format you want to use for displaying the timestamp (e.g., `t`, `T`, `d`, `D`, `f`, `F`, `R`). ## Timestamp Formats in Discord | Format | Description | | ------ | --------------------------------------------------------------------- | | `t` | Time in `HH:MM` format | | `T` | Time in `HH:MM:SS` format | | `d` | Date in `DD/MM/YY` format | | `D` | Date in `Day Month, Year` format | | `f` | Date and time in `Day Month, Year HH:MM` format | | `F` | Full date and time in `Day of the week, Day Month, Year HH:MM` format | | `R` | Relative time, showing how long ago the timestamp was | ### Examples: | Example Usage | Result | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `` |

| | `` |