# Home Got questions while using John-Bot? The documentation has you covered. Learn about John-Bot and how to navigate its documentation. ## :question: About John-Bot **John-Bot is a Discord bot designed to simplify the management of Discord servers.** It comes packed with a wide range of useful features, including a ticketing system, a logging system, join & leave actions, an XP-based leveling system, a giveaway system, and an advanced moderation system, among others.¹ ## :book: Documentation John-Bot's documentation is here to help you get familiar with everything John-Bot has to offer. It provides quick, written answers to the many questions that may come up while using the bot — especially during setup and configuration. Each documentation page is tied to a video tutorial. You can find all official tutorials in this YouTube playlist: [Tutorials - John-Bot](https://jnbt.xyz/tutorials) ## :gear: How It Works The documentation is organized into several categories, each containing pages and sub-pages. These sub-pages are broken down into sections and even sub-sections. While this structure may seem complex at first, it actually makes it easy to find what you're looking for in just a few clicks. You can narrow down to the exact answer you need without having to dig through the entire documentation. Some icons may also help you quickly identify certain information: * :gem: : feature reserved for [John-Bot Premium](https://johnbot.app/premium) members ## :no\_entry\_sign: Limitations The documentation may not always cover every question you have. If that's the case, feel free to reach out to John-Bot's support team through the Discord support server or any other available method². *** 1: this list is not exhaustive\ 2: see the [Contact](/en/contact) page # Contact Discover the different ways to contact the John-Bot team and choose the one that works best for you. ## :speech\_balloon: Discord Support Server The Discord support server is the fastest way to reach the team and covers most types of requests. Through a ticket system¹, every support team member is instantly notified and can respond directly in a temporary channel using their own Discord account. To submit a request, join the [John-Bot Discord server](https://discord.com/invite/YgRbfQ3Mkg), head to the [#support](https://discord.com/channels/959269961572962314/960211222211489903) channel, and click the ":flag\_gb: English" button on the corresponding message. The pop-up window lets you specify the reason for your request to save time. If you'd rather skip this step, just click the blue "Submit" button at the bottom right of the window. After a few seconds, you'll receive a confirmation message in the channel with the name of the channel where your request was created. Simply click on that channel name. You'll now be in the text channel where you can communicate with the team. Wait for a response or start the conversation to describe your request. ## :e\_mail: Email John-Bot has two email addresses — one for general inquiries, and one for legal matters. **General inquiries:** **Legal inquiries:** To submit a request, simply send an email to the appropriate address. *** 1: [Ticket system](/en/configuration/tickets) powered by John-Bot # FAQ Before reaching out for help, check this page — it answers the most frequently asked questions about John-Bot. ### :rocket: Introduction While using John-Bot, you may run into some common questions. This page lists the most frequently asked ones so you can find answers instantly without having to contact support. If you can't find what you're looking for, check [the documentation](/en), [the video tutorials](https://jnbt.xyz/tutorials), or [contact the support team](/en/contact). ### :question: Frequently Asked Questions
What is John-Bot? John-Bot is a Discord bot designed to simplify the management of Discord servers. It comes packed with a wide range of useful features, including a ticketing system, a logging system, join & leave actions, an XP-based leveling system, a giveaway system, and an advanced moderation system, among others.¹
Why can't I select the role I want? When setting up autoroles or leveling reward roles, you may notice that some roles appear grayed out, are unselectable, and are marked with a red indicator. This can be caused by one of two issues: * **Role not accessible by John-Bot**: John-Bot doesn't have enough permissions to manage this role. To fix this, move the role named "John-Bot" (the application role) above the desired roles in your server's role hierarchy. John-Bot must also have the Administrator permission (or at the very least, "Manage Roles"). * **Role not manageable by John-Bot**: Discord prevents bots from managing certain roles. This applies to other application roles and Server Booster reward roles.
*** ¹: this list is not exhaustive # Add the Bot To start using John-Bot, you need to invite it to your Discord server. Here's how to do it step by step. **Video tutorial related to this page:** [Adding John-Bot to Your Discord Server - Tutorial #1](https://jnbt.xyz/tutorials/add) ## :link: Access the Invitation Page To add John-Bot to your Discord server, head to John-Bot's invitation page. You can access it in several ways: * Through the website, then click the "Add to Discord" button; * Using the `/invite` command on a server that already has the bot (see image); * Through the direct link: [https://jnbt.xyz/invite](https://jnbt.xyz/invite/docs) ![/invite command on a Discord server with John-Bot](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-54e9f26e86a5dfd3c47d3ecbe68dad341efe4f13%2Fadd_command_invite.png?alt=media) ## :envelope: Invitation Process Once on the invitation page, select the server you want to add John-Bot to, then click "Continue." Make sure the "Administrator" permission is properly checked, then confirm by clicking "Authorize." You may be asked to enter your two-factor authentication code ([2FA Support](https://support.discord.com/hc/en-us/articles/219576828-Setting-up-Two-Factor-Authentication)) or complete a CAPTCHA to verify you're not a robot. ## :hourglass: Finalization After confirming the addition of John-Bot, check that it's online on your server. If it is, we recommend moving on to the next section of the getting started guide. If it isn't, this is usually caused by a misconfigured anti-raid bot or a permissions issue.\ If you run into any issues, feel free to [contact the John-Bot team](/en/contact). # Basic Setup Before you start configuring and customizing John-Bot on your server, here are a few basic tips to get you ready. **Video tutorial related to this page:** [Preparing Your Server for John-Bot Configuration (Prerequisites) - Tutorial #2](https://jnbt.xyz/tutorials/start) ## :clipboard: Verify Permissions For John-Bot to work properly, it needs certain permissions. We strongly recommend granting it the Administrator permission to avoid any conflicts.\ You likely already assigned these permissions when adding John-Bot, but it's worth double-checking. To do so, go to your Discord server settings, then to the "Roles" tab. Select the John-Bot role, go to its permissions, and make sure the Administrator permission is toggled on. ## :pushpin: Access the Dashboard To configure John-Bot, you need to access the dashboard.\ Here are the different ways to get there: ### Using the /dashboard command Go to the Discord server you want to configure and open any text channel. Type the `/dashboard` command and click the `Dashboard` button.\ You'll be redirected to your server's dashboard page. You may need to log in with your Discord account — if so, simply click `Authorize` at the bottom right. ![/dashboard command on a Discord server with John-Bot](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-53717598386757d6b682a32d5f0ed8a20e8bc8b5%2Fbase_command_dashboard.png?alt=media) ### Via the website Go to John-Bot's website at: and click the `Dashboard` button at the top. You may need to log in with your Discord account — if so, simply click `Authorize` at the bottom right. Then, pick the Discord server you want to configure and click on it. You'll be redirected to your server's dashboard page. ### Using the direct URL You can go directly to your server's dashboard by entering the following URL in your browser: `https://johnbot.app/dashboard/guildId`\ Replace `guildId` with your server's ID¹. ## :flag\_gb: Set the Language Before you start any configuration, we recommend choosing John-Bot's display language. Find out how: [Change Your Server's Language](/en/configuration/language) ## :gem: Activate John-Bot Premium John-Bot Premium is the paid version of John-Bot that unlocks additional features to take your Discord server to the next level. Subscribing to a Premium plan also helps cover the costs of running the bot, which is what makes it possible to offer a fully-featured free version of John-Bot to everyone. {% hint style="info" %} You can view the full list of Premium benefits compared to the free version at: {% endhint %} ### Subscribe to John-Bot Premium First, head to and choose the plan that suits you. You'll be redirected to the Patreon payment page, where you'll need to create an account. Follow the steps on Patreon until your subscription is confirmed. ### Link Your Patreon Account Next, you'll need to link your Patreon account on the John-Bot dashboard. To do this, go to the dashboard of one of your servers and click on your profile picture in the top left corner. Make sure your Patreon account is properly linked. ### Activate John-Bot Premium on a Server Finally, activate John-Bot Premium on the servers of your choice by running the `/premium` command on each one and confirming the activation. To deactivate John-Bot Premium, run the `/premium` command again and click `reset`. ### Manage or Cancel Your Subscription To switch plans, go to the [Subscription section on the John-Bot Patreon page](https://www.patreon.com/c/johnbot/membership). You'll see all three available plans and can pick the one that fits your needs.\ To cancel your subscription, go to the [Memberships section in your Patreon settings](https://www.patreon.com/settings/memberships). Expand the additional options and click `Cancel subscription`. *** 1: Find your server's ID: [Where can I find my User/Server/Message ID?](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID) # Join & Leave Here you'll find information about configuring John-Bot's join and leave system. **Video tutorial related to this page:** [Configure John-Bot's Join and Leave Actions - Tutorial #3](https://jnbt.xyz/tutorials/welcome) ### :rocket: Introduction John-Bot's join and leave system lets you announce when a member joins or leaves the server, and automatically assign roles to new members upon arrival. ### :tools: Accessing Configuration #### Accessing the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) #### Accessing Settings Next, look for `Join & Leave` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can access all settings for the join and leave system. ### :inbox\_tray: Join Message Join messages are automatically sent whenever a new member joins the server. They announce the arrival of a new member and are fully customizable — you can include details like the server's member count, a user mention, and more. ![Example of a join message](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-8ef6c0711af7ce2cc945e7c54305d4aa55caa21e%2Fwelcome_message%20d'arriv%C3%A9e_example.png?alt=media) #### Configuration **Sending Channel** In this field, select the channel that will receive join messages using the dropdown menu. **Formatting** In this section, you can customize the message that will be sent when a new member joins the server. {% hint style="info" %} To add dynamic elements like the server's member count, user mention, and more, you can use variables: [How to use variables](/en/resources/variables) {% endhint %} **Text Message** The text message is displayed outside the embed, just like a regular Discord message. You can use emojis and Markdown¹ to style your text. To disable the text message, leave the field blank. ![Example of a join message with the text message highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-f58043ff13bcbc5ba5a864f82f1597547fd19d25%2Fticket_message%20d'ouverture_partie%20texte.png?alt=media) **Embed** The embed is the part of the message that supports multiple customizable elements and appears below the text message. Regular Discord users can't send embeds — this is a bot-exclusive feature. Use the available fields to customize your embed. ![Example of a join message with the embed highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-a089cdcf2c7d670601c471441f33d59543c88e61%2Fticket_message%20d'ouverture_partie%20embed.png?alt=media) * **Enable Join Embed:** Check this box to enable the embed in your join message. Uncheck it to disable the embed. * **Embed Author Icon** :gem: **:** Add an image (can be animated) to your embed's author section — only visible when the author has a name. * **Embed Author Name** :gem: **:** Add an author to your embed, with any name you like. * **Embed Author Link** :gem: **:** Add a link to an external site on the author. * **Embed Title:** Add a title to your embed. * **Embed Description:** Add a description to your embed. * **Embed Color:** Pick a color for your embed using the color picker. * **Embed Thumbnail URL:** Add a thumbnail image to your embed. * **Embed Image URL:** Add an image to your embed. * **Embed Footer Icon** :gem: **:** Add a footer image to your embed. * **Embed Footer Text** :gem: **:** Add footer text to your embed. ### :outbox\_tray: Leave Message Leave messages are automatically sent whenever a member leaves the server. They announce the departure of a member and are fully customizable — you can include details like the server's member count, the username, and more. ![Example of a leave message](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-90e75e57478c64f8b99bb2bd7eee1ca486c91bef%2Fwelcome_message%20de%20d%C3%A9part_example.png?alt=media) #### Configuration **Sending Channel** In this field, select the channel that will receive leave messages using the dropdown menu. **Formatting** In this section, you can customize the message that will be sent when a member leaves the server. {% hint style="info" %} To add dynamic elements like the server's member count, user mention, and more, you can use variables: [How to use variables](/en/resources/variables) {% endhint %} **Text Message** The text message is displayed outside the embed, just like a regular Discord message. You can use emojis and Markdown¹ to style your text. To disable the text message, leave the field blank. **Embed** The embed is the part of the message that supports multiple customizable elements and appears below the text message. Regular Discord users can't send embeds. Use the available fields to customize your embed. * **Enable Leave Embed:** Check this box to enable the embed in your leave message. Uncheck it to disable the embed. * **Embed Author Icon** :gem: **:** Add an image (can be animated) to your embed's author section — only visible when the author has a name. * **Embed Author Name** :gem: **:** Add an author to your embed, with any name you like. * **Embed Author Link** :gem: **:** Add a link to an external site on the author. * **Embed Title:** Add a title to your embed. * **Embed Description:** Add a description to your embed. * **Embed Color:** Pick a color for your embed using the color picker. * **Embed Thumbnail URL:** Add a thumbnail image to your embed. * **Embed Image URL:** Add an image to your embed. * **Embed Footer Icon** :gem: **:** Add a footer image to your embed. * **Embed Footer Text** :gem: **:** Add footer text to your embed. ### :robot: Autoroles Autoroles are roles pre-selected by administrators that will be automatically assigned to any new member who joins the server. #### Configuration To set the roles that will be assigned, select the ones you want using the corresponding dropdown menu. *** 1: Learn about Markdown: [Markdown Text 101 (Chat Formatting: Bold, Italic, Underline)](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline) # Ticketing Here you'll find information about configuring John-Bot's ticketing system. **Video tutorial related to this page:** [Setting Up John-Bot's Ticketing System - Tutorial #4](https://jnbt.xyz/tutorials/tickets) ## :rocket: Introduction A ticketing system lets members reach out to the server's staff in a private channel created on demand. John-Bot takes this system to the next level by adding features like choosing the most appropriate reason for a support request and specifying it through a modal on Discord. To set up a ticketing system, you'll need to create one or more panels — each one representing a type of support request (e.g., one for contacting moderation, one for partnership requests, and another for administrative inquiries). Then, you'll create one or more embeds — these are the messages that members interact with to open a ticket. You can link multiple panels to each embed. Finally, you can create one or more modals — forms that appear when a member clicks a button to access a panel. ## :earth\_africa: Global Configuration ### Accessing the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) ### Accessing Settings Next, look for `Tickets` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can configure all your server's ticketing settings and view transcripts. ### Logs Logs record all ticket-related actions in a server channel. When a ticket is deleted, a message will be posted with key information about that ticket: the ticket ID, the user who opened it, the user who closed it, the user who deleted it, the opening date, the ticket name, the support team member who handled it, and a list of users who sent messages in the ticket (excluding John-Bot). Below this message, you'll also find a link to the ticket transcript — provided you've enabled the option as described later on this page. The transcript is attached to the message but can be hard to read and access directly. ![Example of a ticket log message](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-d2aa1e48f439cceeb726e6c8721c70300039505a%2Ftickets_logs_example.png?alt=media) To enable ticket deletion logs, simply check the `Enable logs` box and select the channel where you want these messages to be stored. {% hint style="info" %} It is strongly recommended to make the ticket logs channel private. Some information may be sensitive and should only be accessible to trusted team members. {% endhint %} ### Global Ticket Limit This option limits the total number of tickets a member can have open at the same time across all panels. If a per-panel ticket limit is set later, it will override this global limit for that specific panel. Simply choose the maximum number of tickets in the corresponding field. ### Transcripts A transcript lets you review the full conversation history of a ticket. They're incredibly useful for future reference, issue tracking, or even team training. John-Bot's transcripts display the conversation in a layout that mirrors Discord's native interface, making it easy and natural to read. #### Enabling Transcripts To enable transcripts, you must first have ticket logs enabled with a designated log channel. Once that's done, simply click the `Enable transcripts` button. #### Viewing Transcripts You can view transcripts in two ways: * Go to the dashboard, then to the `Tickets` page, and click the `View transcripts` button in the top right corner. You'll see a list of all stored transcripts for your server along with a search engine to help you find the one you're looking for. * Head to the ticket logs channel directly on your Discord server and find the message for the desired transcript. Click the `View transcript` button attached to the message, and you'll be redirected to John-Bot's transcript viewer. {% hint style="info" %} If you can't find a transcript, it's because the log message for that ticket was deleted, or the ticket was created before January 26, 2024. In the first case, the transcript is permanently lost. In the second case, look for the log message for the desired ticket, download the .html file attached to it, and open it in your browser. Web browsers (Firefox, Edge, Opera, Chrome, etc.) natively support this file type. {% endhint %} ### Exclusion Roles Exclusion roles prevent certain members from opening tickets. When a member has an exclusion role, they won't be able to create a ticket. Select one or more roles from your role list in the corresponding field. ## :jigsaw: Panel Configuration ### Create a Panel Before you start configuring panels, you need to create them. Simply click the `Create a panel` button located below the global settings. ### Duplicate a Panel You can also create a panel from an existing one to keep the same settings and customize it from there. This saves you from having to reconfigure everything when there's only a minor difference between two panels. Click the `Duplicate` button next to the desired panel and confirm. ### Edit a Panel To modify an existing panel's settings, click the `Edit` button next to it. ### Delete a Panel To delete an existing panel, click the `Delete` button next to it and confirm. ### Configure a Panel Once in a panel's settings, you can configure many options to customize the system to your needs. When you're done, click the green `Save` button at the bottom right. To discard your changes, click `Cancel`. #### Panel Name The panel name helps you organize and identify your panels — it won't be displayed to members. It's optional. If you don't set one, it will automatically be named something like `Panel #1`. #### Ticket Name The ticket name is the default name given to the channel created for the ticket. You can use variables to give it a unique name. If left blank, the default name will be `help-{user.name}`. #### Ticket Creation Category In this field, set the server category where ticket channels for this panel will be created. If the category reaches its channel limit, new tickets will be created outside the category. Choose the desired category from the dropdown or type to search. #### Ticket Closure Category :gem: The closure category lets you move closed tickets to a separate category to deal with them later. Closed ticket channels will be instantly moved to this category. Choose the desired category from the dropdown or type to search. #### Panel-Linked Modal In this field, you can set the modal (form) that will appear before a ticket is opened, when the member clicks the button. Choose the desired modal from the dropdown or type to search. {% hint style="info" %} To learn how to configure a modal, see the corresponding section on this page: [Modal Configuration](#modal-configuration). {% endhint %} #### Inactivity Reminder Delay :gem: You can choose how long a ticket must go without any messages before an inactivity reminder is sent. By default, this is set to one week (7 days). The accuracy is approximately 6 hours. Select the option that suits you from the dropdown. {% hint style="info" %} This option only takes effect when `**Enable inactivity reminder**` is turned on. To learn how, see: [Inactivity Reminder](#inactivity-reminder). {% endhint %} #### Panel Ticket Limit The panel ticket limit restricts the number of tickets a member can have open on this specific panel. For example, if the limit is 2, a member won't be able to open a third ticket until they close one of the other two. To set it, select `Enable` and enter a number in the `Ticket limit` field. If set, this overrides the global ticket limit. #### Team Roles Team roles let you define different permissions based on roles. Below is a detailed explanation of each assignable permission. To assign roles to a permission, click the field and select the desired role(s). You can also type to search. * **Support Team Roles:** Support team members have access to the ticket and can respond in it. By default, they can also claim, close, reopen the ticket, or use management commands. * **Responsible Team Roles:** Responsible team members have the same permissions as the support team, plus certain privileges such as bypassing exclusive ticket management. * **Roles to Mention on Opening:** These roles will be pinged when a ticket is opened, using the "ghost-ping" method (no visible message). The member who opened the ticket is always mentioned, but having a mentioned role won't cause a double ping. * **Exclusion Roles:** Exclusion roles prevent certain members from opening tickets on this panel. A member with an exclusion role cannot create a ticket on this panel. #### Ticket Assignment Ticket assignment helps the support team stay organized. When a support team member clicks the `Claim` button on the opening message, they'll be designated as the ticket's "Handler" and a message will be posted in the channel to announce it. To enable this, check the associated box. {% hint style="info" %} This option is required to use `**Exclusive Ticket Management**`. To learn how, see: [Exclusive Ticket Management](#exclusive-ticket-management). {% endhint %} #### Inactivity Reminder The inactivity reminder notifies all ticket participants that the ticket has been inactive by sending a message after a set period. To enable it, check the associated box. {% hint style="info" %} To set how long before the reminder is sent, see: [Inactivity Reminder Delay](#inactivity-reminder-delay). {% endhint %} ![Example of a reminder message](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-d153a07115dce06953cc1b73c2d0c191141563ec%2Fticket_rappel_example.png?alt=media) #### DM Notification The DM notification is a private message sent to the member who opened the ticket when it's deleted. It confirms the ticket has been deleted and provides some information, including the ticket transcript. To enable it, check the associated box. ![Example of a DM notification](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-cc8dcccbe5e4ab2117cd55096f1c5e04bcac5e9b%2Fticket_avertissement%20priv%C3%A9_example.png?alt=media) #### Exclusive Ticket Management Exclusive management restricts the ticket so only the support team member handling it can write in it — except for administrators and responsible team members. To enable it, check the associated box. #### Auto-Close on Member Leave :gem: This option automatically closes a ticket when the member who opened it leaves the server. To enable it, check the associated box. #### Button Appearance To make your button more appealing or easier to understand, you can customize it with the options provided. * **Button Label:** Customize the text displayed on the button. By default, it matches the panel name. * **Button Description** :gem: **:** Add extra context to your button. This is only visible when the dropdown display style is enabled. Learn how to enable it: [Panel Display Style](#customization) * **Button Emoji:** Add an emoji to your button. Choose from all Discord emojis using the picker. * **Button Color:** Pick from the four colors offered by Discord: blue, green, red, or gray. #### Role Permissions * **Create a Ticket:** Define who can create a ticket on this panel by selecting one or more roles. If left empty, all members can create a ticket — unless they have an exclusion role. * **Claim Ticket:** Define who can claim (process) a ticket on this panel. If left empty, all support team members can claim tickets. * **Close Ticket:** Define who can close an open ticket on this panel. If left empty, all members with access to the ticket can close it. * **Reopen Ticket:** Define who can reopen a closed ticket on this panel. If left empty, all support team members can reopen tickets. * **Delete Ticket:** Define who can delete a closed ticket on this panel. If left empty, all members with access to the closed ticket can delete it. #### Private Discussion Thread The private discussion thread lets the support team discuss the ticket's topic privately, without creating a new channel on the server. To enable it, check the associated box. Once enabled, you can customize a few settings. **Thread Name** Enter the name that will automatically be assigned when the thread is created. You can use [variables](/en/resources/variables). **Thread Opening Embed Title** When the private thread is created, an opening message is automatically sent. Customize the embed title of this message. **Thread Opening Embed Description** When the private thread is created, an opening message is automatically sent. Customize the embed description of this message. #### Opening Message The opening message is the first message sent when a ticket is opened and is also pinned. It contains essential ticket information and a message to guide the member. If the panel has a modal, the answers will also be attached here. You can customize several elements of this message. **Text Message** The text message is displayed outside the embed, just like a regular Discord message. You can use emojis and Markdown¹ to style your text. To disable the text message, leave the field blank. ![Example of an opening message with the text message highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-f58043ff13bcbc5ba5a864f82f1597547fd19d25%2Fticket_message%20d'ouverture_partie%20texte.png?alt=media) **Embed** The embed is the part of the message that supports multiple customizable elements and appears below the text message. Regular Discord users can't send embeds. Use the available fields to customize your embed. ![Example of an opening message with the embed highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-a089cdcf2c7d670601c471441f33d59543c88e61%2Fticket_message%20d'ouverture_partie%20embed.png?alt=media) * **Enable Opening Embed:** Check this box to enable the embed in your opening message. Uncheck to disable. * **Embed Author Icon** :gem: **:** Add an image (can be animated) to your embed's author section — only visible when the author has a name. * **Embed Author Name** :gem: **:** Add an author to your embed, with any name you like. * **Embed Author Link** :gem: **:** Add a link to an external site on the author. * **Embed Title:** Add a title to your embed. * **Embed Description:** Add a description to your embed. * **Embed Color:** Pick a color for your embed using the color picker. * **Embed Thumbnail URL:** Add a thumbnail image to your embed. * **Embed Image URL:** Add an image to your embed. * **Embed Footer Icon** :gem: **:** Add a footer image to your embed. * **Embed Footer Text** :gem: **:** Add footer text to your embed. ## :camera: Embed Configuration ### Create an Embed Before configuring your embeds, you first need to create them. Click the `Create an embed` button located below the panel settings. ### Duplicate an Embed You can create an embed from an existing one to keep the same settings and customize it from there. Click the `Duplicate` button next to the desired embed and confirm. ### Edit an Embed To modify an existing embed's settings, click the `Edit` button next to it. ### Delete an Embed To delete an existing embed, click the `Delete` button next to it and confirm. ### Configure an Embed Once in an embed's settings, you can configure many options to customize the system. When you're done, click the green `Save` button at the bottom right. To discard your changes, click `Cancel`. #### Embed Sending Channel Set which channel your embed will be sent to using the dropdown menu. #### Panels Linked to the Embed Choose which panels members will be able to use to open tickets from this embed. Arrange your panels in the order you want — they'll appear in the same order on the embed. Select your panel(s) using the dropdown. #### Customization * **Embed Author Icon** :gem: **:** Add an image (can be animated) to your embed's author section — only visible when the author has a name. * **Embed Author Name** :gem: **:** Add an author to your embed, with any name you like. * **Embed Author Link** :gem: **:** Add a link to an external site on the author. * **Embed Title:** Add a title to your embed. * **Panel Display Style:** Choose the display style for the panels by selecting the desired option. * **Embed Description:** Add a description to your embed. * **Embed Color:** Pick a color for your embed using the color picker. * **Embed Thumbnail URL:** Add a thumbnail image to your embed. * **Embed Image URL:** Add an image to your embed. * **Embed Footer Icon** :gem: **:** Add a footer image. Defaults to the bot's profile picture. * **Embed Footer Text** :gem: **:** Add footer text. Defaults to `Powered by johnbot.app`. ### Send an Embed Once your configuration is complete, publish your embed by sending it to the designated channel. Click the `Send embed` button next to the chosen embed. ## :bookmark\_tabs: Modal Configuration A modal is a form presented to the member via a native Discord pop-up, allowing them to answer up to 5 questions to specify the subject of the ticket. The answers will be attached to an embed in the ticket's opening message. ![Example of a modal](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-5537b0bb8bb75be85804235b034c2bf44accfb66%2Fticket_modele_example.png?alt=media) ### Create a Modal Before configuring your modals, you need to create them. Click the `Create a modal` button located below the embed settings. ### Duplicate a Modal You can create a modal from an existing one to keep the same settings and customize it from there. Click the `Duplicate` button next to the desired modal and confirm. ### Edit a Modal To modify an existing modal's settings, click the `Edit` button next to it. ### Delete a Modal To delete an existing modal, click the `Delete` button next to it and confirm. ### Configure a Modal Once in a modal's settings, you can add up to 5 questions and adjust a few settings. When you're done, click the green `Save` button at the bottom right. To discard your changes, click `Cancel`. #### Modal Title Set a title for the modal. This helps you stay organized and is also displayed at the top of the pop-up. ![Example of a modal with the title highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-00fb86a8c3bd98adc3a2cfd4f47558113c10742c%2Fticket_modele_titre.png?alt=media) #### Question Configuration For each question, you can customize several visual elements and reorder them. To add a new question, click the `+` button below the question list. To delete a question, click the red `Delete` button at the bottom right of that question. * **Text Field Label:** The label is the actual question being asked (no. 1 in the image). * **Text Field Style:** Choose whether the member can respond in a wide or shorter field (no. 2 in the image). This doesn't affect the character limit, which is 1024 for both. * **Text Field Placeholder:** The placeholder is the hint text displayed in the response field before the member types (no. 3 in the image). * **Required Question:** Specify whether the question must be answered or if the member can submit the form without filling it in (no. 4 in the image). If left unanswered, `None` will appear in place of the answer. ![Example of a modal with customizable elements highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-83fd25fac6add5420764f8e2d007dcb5aaeab804%2Fticket_modele_example%20aide.png?alt=media) {% hint style="info" %} Once your modal is configured, don't forget to link it to the panel of your choice: [Panel-linked modal, configure a panel](#panel-linked-modal) {% endhint %} ## :wrench: Command List | Command | Description | Example | | --------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /ticket add | Adds a member to the ticket. | ![Command /ticket add](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-3bff5324c57194db4c4f91fb94f7da9dd2c08c38%2Fticket_command_add.png?alt=media) | | /ticket claim | Assigns a support team member to handle the ticket. | ![Command /ticket claim](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-24422f91f066c56a641b2dcb141f9aa13a7e1843%2Fticket_command_claim.png?alt=media) | | /ticket close | Closes the ticket. | ![Command /ticket close](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-41df429a906d207d015a5f1d7f4ec41736c22833%2Fticket_command_close.png?alt=media) | | /ticket close-request | Requests ticket closure. | ![Command /ticket close-request](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-b0ad4ff9bdcd3ea0ab2ae764382ee6cb5d48e16f%2Fticket_command_close%20request.png?alt=media) | | /ticket create | Creates a ticket. | ![Command /ticket create](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-001cc0ebcd8a25fcfcb087cab7ad46379bd0de43%2Fticket_command_create.png?alt=media) | | /ticket delete | Deletes a closed ticket. | | | /ticket open | Reopens a closed ticket. | ![Command /ticket open](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-f14773026cdfcb1c5b0733acfa0c2693337f1adc%2Fticket_command_open.png?alt=media) | | /ticket remove | Removes a member from the ticket. | ![Command /ticket remove](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-63fb5511dd1430940b3b8c79dbca629f86765a86%2Fticket_command_remove.png?alt=media) | | /ticket rename | Renames the ticket. | ![Command /ticket rename](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-8f04c4a8a64e6464e5b940e049127bc0ad455062%2Fticket_command_rename.png?alt=media) | | /ticket transfer | Transfers ticket assignment to another support team member. | ![Command /ticket transfer](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-ca9d64004377b6428ce40aea783466e65606cd19%2Fticket_command_transfer.png?alt=media) | | /ticket unclaim | Removes the ticket assignment from the handler. | ![Command /ticket unclaim](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-b7929442c56038afd4a25c375facd1fb9593f103%2Fticket_command_unclaim.png?alt=media) | *** 1: Learn about Markdown: [Markdown Text 101 (Chat Formatting: Bold, Italic, Underline)](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline) # Auto-Moderation Learn how to set up John-Bot's auto-moderation system here! **Video tutorial related to this page:** [Effectively Moderate Your Server with John-Bot - Tutorial #5](https://jnbt.xyz/tutorials/moderation) ### :rocket: Introduction An auto-moderation system on Discord is an essential tool for maintaining a healthy and secure environment without requiring constant human oversight. It lets you define precise rules that John-Bot will automatically enforce based on detected behavior on the server. John-Bot's auto-moderation system is built around three main categories: automatic sanctions, reports, and moderation logs. You can also customize many settings to tailor the system to your needs: choice of sanctions, detection thresholds (e.g., number of repeated messages within a time window), ignored channels, and the presentation of reports and logs. ### :tools: Accessing the System Settings First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard). Next, look for `Moderation` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can access all settings related to the auto-moderation system. ### :hammer: Automatic Sanctions To create your first automatic sanction, you need to define its parameters. When a member accumulates a certain number of warnings, John-Bot will automatically apply the configured sanction against them. #### Choosing the Sanction First, choose a sanction that John-Bot will automatically apply when a member reaches a certain warning threshold. Select the one you want from the list and, if applicable, set a duration. A sanction can take several forms, some requiring a duration. Here is the full list of sanctions John-Bot can apply: * Warn: the member receives a DM informing them of the warning. John-Bot keeps a record of it, accessible via the `/warnings list` command or in the logs. * Mute (Timeout): the member is fully silenced on the server for a set duration (up to 28 consecutive days). They won't be able to send messages, join voice channels, react, or interact in any way. However, they can still read server messages. * Kick: the member is removed from the server, but not permanently. They can rejoin at any time if they have an invite or if the server is public. * Ban: the member is permanently removed from the server and cannot rejoin unless a moderator lifts the ban using the `/unban` command. * Temporary ban: same as a ban, but time-limited. After a set duration (up to 365 consecutive days), the user can rejoin the server if they have an invite or the server is public. #### Setting the Conditions For the selected sanction to be triggered, a member must have accumulated a certain number of warnings — whether applied automatically by John-Bot or manually by moderators. You can define the number of warnings required within a given time period to trigger the automatic sanction. ### 🚨 Reports The reporting system allows members to flag bad behavior that moderators might miss. It's very difficult for moderators to be present in every channel at the same time, or even in DMs. This system lets members report issues themselves. When a member notices bad behavior, they can click the three dots on a message, select the "Apps" category, and choose the "Report Message" option. John-Bot will then ask for the reason of the report. The moderators will receive this report in a pre-defined channel showing who made the report and who was reported. Moderators have several options: they can claim the report (signaling to other moderators that they're handling it), view the message context, or resolve the report. When resolving, the bot will offer several action options. ### Ignored Channels Any activity in ignored channels won't be logged, regardless of the event type. To set one or more ignored channels, select them from the list in the corresponding field. ### Global Color :gem: This option lets you set the color of the log embeds sent to your server. Choose from the 6 preset colors or use the color picker. ### Specialized Channels For each event type in the system, you can assign a dedicated channel. Select the event you want and assign a channel using the corresponding dropdown menu. {% hint style="warning" %} If the global log channel is set to the same channel as one or more specific events, log messages will be sent twice. {% endhint %} # Logging Here you'll find information about configuring John-Bot's logging system. **Video tutorial related to this page:** [Setting Up John-Bot's Logging System - Tutorial #6](https://jnbt.xyz/tutorials/logs) ### :rocket: Introduction A logging system on Discord is an essential tool for monitoring and recording all activity on your server. It logs everything — from messages, roles, and server changes, to member joins and leaves, member updates, moderation actions, channels, emojis, threads, and voice channel activity — directly into designated server channels.\ John-Bot lets you set a single channel to receive all logs, but also allows you to assign specific channels for specific event categories. You can also customize many aspects of the system to make it as useful as possible, such as the embed color, which events go to the global channel, and even which channels are ignored by the system. ![Example of a logging system on a Discord server](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-176d416c4e072a1be9ba11a665f3a6c76bcacdf8%2Flogs_example.png?alt=media) ### :tools: Configuring the System #### Accessing the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) #### Accessing Settings Next, look for `Logs` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can access all settings for the logging system. #### Enabling the System To reveal the system settings, toggle the system on using the associated button. #### Global Log Channel The global log channel receives all logged events in one place. First, set the global channel in the corresponding field. You can then choose which events are sent to this channel by checking the boxes in the list under the `global embed color configuration`. To enable all events at once, simply check the `Enable or disable all events` box. #### Ignored Channels Any activity in ignored channels won't be logged, regardless of the event type. To set one or more ignored channels, select them from the list in the corresponding field. #### Global Color :gem: This option lets you set the color of the log embeds sent to your server. Choose from the 6 preset colors or use the color picker. ![Example of a log message on a Discord server with the embed color highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-a99a02ad7ebf13c06d29524384579944b034235c%2Flogs_color_exeample.png?alt=media) #### Specialized Channels For each event type, you can assign a dedicated channel. To do so, select the event you want and assign a channel using the corresponding dropdown menu. {% hint style="warning" %} If the global log channel is set to the same channel as one or more specific events, log messages will be sent twice. {% endhint %} # Language Here you'll find information about configuring John-Bot's display language. **Video tutorial related to this page:** [Preparing Your Server for John-Bot Configuration (Prerequisites) - Tutorial #2](https://jnbt.xyz/tutorials/start) ## :rocket: Introduction You can set the language in which John-Bot interacts on your server. You can also change the language the website is displayed in. ## :robot: Server #### Access the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) #### Access Settings Next, look for `Settings` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can access all general settings for your server. #### Set the Language Once in the `Settings` category, look for the `Language` option. Choose your preferred language from the dropdown menu. {% hint style="warning" %} Currently, John-Bot is only available in two languages: French and English. {% endhint %} {% hint style="warning" %} John-Bot is translated by volunteers like you who contribute their free time to help internationalize the project. Join them: [Crowdin Project](https://crowdin.johnbot.app/)\ If you spot a translation error, contact us or correct it yourself. [Contact the John-Bot team](/en/contact) {% endhint %} ## :globe\_with\_meridians: Website The steps to change the website's display language (including the dashboard) depend on your device. ### Desktop On desktop, click the button at the top right of the website and select your language from the dropdown menu. If you're on the dashboard, click on your profile picture and select `Language`. ### Mobile On mobile, tap the button at the top right of the website and select your language from the dropdown menu. If you're on the dashboard, tap on your profile picture and select `Language`. {% hint style="warning" %} Currently, John-Bot is only available in two languages: French and English. {% endhint %} {% hint style="warning" %} John-Bot is translated by volunteers like you who contribute their free time to help internationalize the project. Join them: [Crowdin Project](https://crowdin.johnbot.app/)\ If you spot a translation error, contact us or correct it yourself. [Contact the John-Bot team](/en/contact) {% endhint %} # Leveling Here you'll find information about configuring John-Bot's leveling system. **Video tutorial related to this page:** [Setting Up John-Bot's Leveling System - Tutorial #7](https://jnbt.xyz/tutorials/levels) ## :rocket: Introduction To keep your Discord server active, the most effective approach is to reward your members — notably with levels and ranks. Building on this concept, John-Bot offers an enhanced leveling system where members earn experience points (XP), level up, and unlock virtual rewards in the form of roles when they hit specific milestones. ## :tools: Configuring the System ### Accessing the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) ### Accessing Settings Next, look for `Levels` in the right-hand column, under your server's logo and banner. You'll now be on a page where you can access all settings for the leveling system. ### Importing from Another Bot If you're currently using another bot to manage leveling on your server, you can import all your data in seconds with a simple command¹. Currently, only MEE6 is supported, but more bots may be added in the future.
Import from MEE6 Before running the import command, you need to make your server's MEE6 leaderboard public. * To do this, open your server's leaderboard with the `/levels` command via MEE6. Then log in with your Discord account on the MEE6 website and click the `Settings` button at the top right of the page. * On the leaderboard settings page, enable the `Make my server's leaderboard public` option at the top. Save your changes. "Make my server's leaderboard public" option on the MEE6 website Next, go to your server and run the `/xp import` command with John-Bot, then confirm the data replacement. Make sure John-Bot's leveling system is properly enabled and configured. The import only covers level data — it won't carry over announcement customization or other settings.
## :earth\_africa: Global System The leveling system is based on experience points earned by sending messages or spending time in voice channels. You can set the amount of XP gained per message or per minute, as well as a rate. Each level is a milestone unlocked by accumulating a specific amount of XP. For details on how XP is earned and the XP required to unlock each level, see [the Experience subpage](/en/configuration/levels/levels-xp). ### Level-Up Announcement When a member reaches a new level, John-Bot can instantly send a customized announcement in a designated channel. * **Enable announcement:** Toggle this to activate level-up announcements. * **Enable image:** With each announcement, a personalized image card is generated for the member, showing their new level.

Level-up announcement image

* **Channel choice:** You can send the announcement in the last channel where the member sent a message² by selecting `In the current channel`, or always send it to the same specific channel by selecting `In a custom channel` and then choosing the channel from the second dropdown. * **Level-up message:** In addition to the image, you can add a custom text message using [level variables](/en/resources/variables#level-variables). ### Additional Options **XP Ratio** This option sets the amount of XP awarded per message or per minute in voice chat. Choose a range from the dropdown — the exact amount will be randomly determined within that range. **Maximum Level** :gem: Set a cap on levels. Members who reach this level will no longer earn XP. Set it to `0` to disable. **Voice XP** :gem: Enable this to let members earn XP for time spent in voice channels. They must be in a channel with at least one other human member (bots don't count). **Level Loss on Leave** When enabled, a member's XP will be reset if they leave the server. If they rejoin, they'll start from scratch. **No XP Gain in Tickets** When enabled, no XP is awarded for messages sent in ticket channels.³ **XP Multiplier** :gem: To help members level up faster — for example, during a special event — you can award up to 3x the normal XP rate. ### Special Roles and Channels * **Bonus roles and channels:** Set roles and channels where messages or voice time earn bonus XP. You can adjust the bonus multiplier⁴ by clicking the number next to the role or channel name. * **No-gain roles and channels:** Set roles and channels where messages or voice time earn zero XP. ## :dart: Rewards To motivate members to reach higher levels, you can set up unlockable rewards — roles that are automatically assigned when a member reaches a specific level. ### Reward Unlock Announcement When a member reaches a new level and unlocks a reward, John-Bot can instantly send a customized announcement in a designated channel. * **Enable announcement:** Toggle this to activate reward unlock announcements. * **Enable image:** With each announcement, a personalized image card is generated, showing the unlocked reward.

Reward unlock announcement image

* **Channel choice:** You can send the announcement in the last channel where the member sent a message² by selecting `In the current channel`, or always send it to the same channel by selecting `In a custom channel` and choosing the channel from the second dropdown. * **Reward unlock message:** In addition to the image, you can add a custom text message using [level variables](/en/resources/variables#level-variables). ### Reward Role Types :gem: Reward roles are assigned when a member reaches the required level. You can choose between two modes: * **Progressive reward roles:** A member can only have one reward role at a time. When a new reward is unlocked, the previous role is removed and replaced by the new one. * **Cumulative reward roles:** The member keeps all earned reward roles, stacking them up as they progress. ### Reward Configuration To create a reward, click the button at the bottom of the page and set the following: * **Required level:** Enter the level a member must reach to unlock this reward. * **Reward role:** Select the role that will be assigned as a reward using the dropdown. ## :bar\_chart: Leaderboard Your server's leaderboard ranks members in descending order by XP, showing each member's level and total experience points. You can access it via the `/leaderboard` command, which shows the top 10 members. A full version is available online.
Example leaderboard using /leaderboard Example leaderboard using /leaderboard
Example of the full online leaderboard Example of the full online leaderboard
### Accessing the Leaderboard You can access the full online leaderboard in two ways: * **Direct URL:** The leaderboard URL follows this format: `https://www.johnbot.app/leaderboard/serverid`. Replace `serverid` with your server's ID⁵. * **Link via command:** You can get this link easily by running `/leaderboard`. ![Link to the full online leaderboard highlighted on the /leaderboard command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-19c07750395fb7cf1bc0b059a34016a5cb55834b%2Flevels_leaderboard_link.png?alt=media) ## :wrench: Command List | Command | Description | Example | | --------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /leaderboard | Shows the server's level leaderboard. | ![Command /leaderboard](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-42750149a52c386b4173ef153377451c7478fd46%2Flevels_leaderboard_exemple.png?alt=media) | | /rank or /level | Shows your level or another member's level. | ![Command /rank or /level](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-6edbd281a43f6f5ba760b42727d5e1388e54b174%2Flevels_commande_rank.png?alt=media) | | /xp add | Adds XP to a member. | ![Command /xp add](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-06bf9e311174753afaa0b4f0b9b1499234b7ce0e%2Flevels_commande_xp%20add.png?alt=media) | | /xp remove | Removes XP from a member. | ![Command /xp remove](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-24d9da33a88bf86694cc04272a5507ef1cb23ca6%2Flevels_commande_xp%20remove.png?alt=media) | | /xp import | Imports level data from another bot. | | | /xp reset | Resets the level data of a member or all members on the server. | ![Command /xp reset](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-f3934f1aef66529466b58f3d7007ba61ee8acfa7%2Flevels_commande_xp%20reset.png?alt=media) | | /xp user | Shows a member's total XP and level. | ![Command /xp user](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-f21c746e4e3820552db787cb9252c4b795812fc4%2Flevels_commande_xp%20user.png?alt=media) | | /rewards | Shows the list of unlockable rewards from the leveling system. | ![Command /rewards](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-ee5a6549b386c0d47668fe2df72272c6b21daef9%2Flevels_commande_rewards.png?alt=media) | *** 1: subject to the other bot's availability\ 2: the message will be sent to the voice channel chat if the member levels up in a voice channel\ 3: tickets must be managed with John-Bot's [ticketing system](/en/configuration/tickets)\ 4: limited to the following values: `1.5; 2; 2.5; 3`\ 5: Find your server's ID: [Where can I find my User/Server/Message ID?](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID) # Experience This page explains how the experience needed to reach each level is calculated. {% hint style="info" %} Most of the information on this page is sourced from the [MEE6 documentation on GitHub](https://github.com/Mee6/Mee6-documentation), specifically the [docs/levels\_xp.md page](https://github.com/Mee6/Mee6-documentation/blob/master/docs/levels_xp.md). {% endhint %} ### Calculating the XP Needed to Level Up The following formula is used: `5 * (lvl ^ 2) + (50 * lvl) + 100 - xp` Where: * `lvl`: current level * `xp`: current experience ### Experience Required per Level {% hint style="warning" %} This table only shows the first 100 levels. John-Bot can handle levels all the way up to 9,999. {% endhint %} | Level | Experience | | ----- | ---------- | | 0 | 0 | | 1 | 100 | | 2 | 255 | | 3 | 475 | | 4 | 770 | | 5 | 1,150 | | 6 | 1,625 | | 7 | 2,205 | | 8 | 2,900 | | 9 | 3,720 | | 10 | 4,675 | | 11 | 5,775 | | 12 | 7,030 | | 13 | 8,450 | | 14 | 10,045 | | 15 | 11,825 | | 16 | 13,800 | | 17 | 15,980 | | 18 | 18,375 | | 19 | 20,995 | | 20 | 23,850 | | 21 | 26,950 | | 22 | 30,305 | | 23 | 33,925 | | 24 | 37,820 | | 25 | 42,000 | | 26 | 46,475 | | 27 | 51,255 | | 28 | 56,350 | | 29 | 61,770 | | 30 | 67,525 | | 31 | 73,625 | | 32 | 80,080 | | 33 | 86,900 | | 34 | 94,095 | | 35 | 101,675 | | 36 | 109,650 | | 37 | 118,030 | | 38 | 126,825 | | 39 | 136,045 | | 40 | 145,700 | | 41 | 155,800 | | 42 | 166,355 | | 43 | 177,375 | | 44 | 188,870 | | 45 | 200,850 | | 46 | 213,325 | | 47 | 226,305 | | 48 | 239,800 | | 49 | 253,820 | | 50 | 268,375 | | 51 | 283,475 | | 52 | 299,130 | | 53 | 315,350 | | 54 | 332,145 | | 55 | 349,525 | | 56 | 367,500 | | 57 | 386,080 | | 58 | 405,275 | | 59 | 425,095 | | 60 | 445,550 | | 61 | 466,650 | | 62 | 488,405 | | 63 | 510,825 | | 64 | 533,920 | | 65 | 557,700 | | 66 | 582,175 | | 67 | 607,355 | | 68 | 633,250 | | 69 | 659,870 | | 70 | 687,225 | | 71 | 715,325 | | 72 | 744,180 | | 73 | 773,800 | | 74 | 804,195 | | 75 | 835,375 | | 76 | 867,350 | | 77 | 900,130 | | 78 | 933,725 | | 79 | 968,145 | | 80 | 1,003,400 | | 81 | 1,039,500 | | 82 | 1,076,455 | | 83 | 1,114,275 | | 84 | 1,152,970 | | 85 | 1,192,550 | | 86 | 1,233,025 | | 87 | 1,274,405 | | 88 | 1,316,700 | | 89 | 1,359,920 | | 90 | 1,404,075 | | 91 | 1,449,175 | | 92 | 1,495,230 | | 93 | 1,542,250 | | 94 | 1,590,245 | | 95 | 1,639,225 | | 96 | 1,689,200 | | 97 | 1,740,180 | | 98 | 1,792,175 | | 99 | 1,845,195 | | 100 | 1,899,250 | # Information Here you'll find the list and description of all John-Bot information commands. ## :rocket: Introduction Looking for information about a server, a user... or maybe the profile picture or banner of any user or server and much more? John-Bot's information commands have you covered! Explore every command described in detail on this page. ## :clipboard: Command List | Command | Description | Example | | --------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /bot-info | Displays some information about John-Bot. | ![/bot-info command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-1e5d39c5f4807e3d2e680b8d84b7271db310ca90%2Finformation_command_bot-info.png?alt=media) | | /user avatar | Displays a user's avatar. | ![/user avatar command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-bb0d5207c45f1d4d1e80ae8bd09d8318616a4a4d%2Finformation_command_user%20avatar.png?alt=media) | | /user banner | Displays a user's banner. | ![/user banner command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-3792b7d38ef2ae04015a29ecb972d6a581b2f4d2%2Finformation_command_user%20banner.png?alt=media) | | /user info | Displays some information about a user. | ![/user info command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-b807129c1d928333bd436ad7fbaebb9bc00fe855%2Finformation_command_user%20info.png?alt=media) | | /server icon | Displays the server icon. | ![/server icon command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-63e329550e4b24e8e5680199d4d217059820b85b%2Finformation_command_server%20icon.png?alt=media) | | /server banner | Displays the server banner. | ![/server banner command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-125af587ca7d0397554e318d25a820820fd4ceaf%2Finformation_command_server%20banner.png?alt=media) | | /server info | Displays some information about the server. | ![/server info command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-926cd94fbb174caef6727da1b3e566ed6702653c%2Finformation_command_server%20info.png?alt=media) | | /server members | Displays some information about the server's members. | ![/server members command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-5bb8797c5035f7fd91e2ce2f95b7a01148648286%2Finformation_command_server%20members.png?alt=media) | | /role info | Displays some information about a role. | ![/role info command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-665ff32173441118182c1dbf70919ed589adcee6%2Finformation_command_role%20info.png?alt=media) | | /role color | Displays a role's color. | ![/role color command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-66a30734d0408368069c35ad42f520484472d656%2Finformation_command_role%20color.png?alt=media) | | /channel-info | Displays some information about a channel. | ![/channel-info command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-b9a979d422a6181555cfcce8ab6befc321179f4a%2Finformation_command_channel-info.png?alt=media) | | /ping | Displays John-Bot's latency. | ![/ping command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-b502e642b591ceee6a7bc7d3a140c6da7d2e1825%2Finformation_command_ping.png?alt=media) | | /status | Displays the status of John-Bot's shards. | ![/status command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-8040517b6dc12aac83d7a7bd1e6adfe906598acd%2Finformation_command_status.png?alt=media) | | /uptime | Displays how long John-Bot has been running. | ![/uptime command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-629a034953487c69cc815988d43eec4c2cecd0bc%2Finformation_command_uptime.png?alt=media) | | /color | Displays some information about a color. | ![/color command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-7b835c57f3caa72c441cf2cdc9a972aeb95bac84%2Finformation_command_color.png?alt=media) | # Messages Creator Learn everything you need to know about John-Bot's message creator system. Learn how to set it up and understand how it works. **Video tutorial related to this page:** [Create and Send a Custom Embed on Discord - Tutorial #10](https://jnbt.xyz/tutorials/embeds) ### :rocket: Introduction The message creator system lets you send messages on behalf of John-Bot. These messages can be edited later and enhanced with various options that are not available to regular users directly through the Discord app. ### :tools: Accessing the Message Creator First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) Then, look for `Messages` in the right-hand column, under your server's logo and banner. You'll land on a page where you can access all the settings needed to create your first message. ### :pencil: Message Settings #### Creating a Message To create a new message, use the button at the bottom of the existing message list, or at the top of the page if it's your first one. #### Duplicating an Embed You can also create a message from an existing one to keep the same settings and customize it by duplicating it (also known as "copy-pasting"). This saves you from having to reconfigure every setting for a minor difference between two messages. Simply click the `Duplicate` button next to the desired embed and confirm your choice in the popup window. #### Editing a Message To adjust the settings of an existing message, simply click the `Edit` button next to the message of your choice in the list. You'll go straight to the selected message's settings to make your changes. #### Deleting a Message To delete an existing message, simply click the `Delete` button next to the desired message and confirm your choice in the popup window. #### Saving Changes Once in a message's settings, you can modify many options to customize it to your needs. When you're done configuring, click the green `Save & Edit` button at the top right of the configuration window. If you don't want to keep your changes, simply click `Cancel`. #### Saving and Sending an Embed Once your edits are done, if your message has never been sent, you need to create the corresponding embed in the predefined channel. To do so, use the green `Create` button at the top right. You'll then need to send it to the predefined channel using the `Send` button. #### Message Configuration **Message Name** The message name helps server administrators stay organized on the John-Bot dashboard. It won't be visible to members. To set it, type it in the corresponding field. **Sending Channel** The sending channel is the server channel where the message will be posted. To set it, choose the desired channel from the corresponding dropdown. **Sending Type** You can choose how your message will be sent. Simply select the option that best suits your needs: * **Single-send message:** This message will only be sent once and will gradually get buried among other messages in the channel. * **Persistent message:** Every time a new message is posted in the channel, John-Bot will re-send your message so it always stays visible and remains the last message in the channel. If the message was previously sent, only the most recent version will be kept to avoid flooding the channel. **Text Message** The text message is the text displayed outside the embed, like a regular Discord user's message. You can use emojis and markdown¹ to customize your text. To disable the text message, leave the field empty. ![Example message with the text portion highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-e4157514cd9e9ae3d8c639acbbc7d0721d21d1c7%2Fembed_message_partie%20texte.png?alt=media) **Embed** The embed is the part of the message that can contain several customizable elements, displayed below the text message. It's impossible to send as a regular Discord user. You can use the available fields to customize your embed. ![Example message with the embed portion highlighted](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-be7049333b3189f489d63e67638b0b7c1cd36c27%2Fembed_message_partie%20embed.png?alt=media) * **Embed author icon:** Illustrate your embed by adding an image (which can be animated) to your author, only visible when the author has a name. * **Embed author name:** Customize your embed by adding an author, which you can name as you wish. * **Embed author link:** Customize your embed by adding a link to an external website for the author. * **Embed title:** Customize your embed by adding a title. * **Embed description:** Customize your embed by adding a description. * **Embed color:** Choose a color to customize your embed using the color picker. * **Embed thumbnail link:** Illustrate your embed by adding a thumbnail image. * **Embed image link:** Illustrate your embed by adding an image. * **Embed footer icon:** Complete your embed with a footer image. * **Embed footer text:** Complete your embed with footer text. *** 1: Learn more about Markdown: [Markdown Text 101 (Chat Formatting: Bold, Italic, Underline)](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline) # Giveaway Here you'll find information about creating and configuring giveaways. **Video tutorial related to this page:** [Host a Giveaway on Your Server with John-Bot - Tutorial #8](https://jnbt.xyz/tutorials/giveaways) ## :rocket: Introduction A giveaway is the perfect way to reward your members by putting a prize up for grabs and letting a random draw decide the winner. Participants can enter with just one click, and the drawing happens automatically at the scheduled time. There are two ways to create a giveaway: one is quick but less customizable, while the other offers full customization but takes a bit more time. Compare both and pick the one that suits your needs. Also learn how members can interact with a giveaway to enter, and discover the commands for managing your giveaways. ## :zap: Quick and Simple Method If you want to launch a giveaway quickly and efficiently, go with this method. First, head to the server where you want to launch the giveaway. Make sure you have administrator permissions. Then, type the command `/giveaway create`. You'll have access to several options: * **Duration:** Set how long the giveaway will last before the automatic drawing and results announcement. Enter a number followed by a unit (`s` for seconds, `min` for minutes, `h` for hours, `d` for days). * **Number of winners:** Set how many winners will be drawn. Simply enter a whole number greater than 0. * **Prize:** Enter the name of the prize you want to put up for grabs. The field is freeform — it can be physical, virtual, or anything else. * **Channel (optional):** Choose the channel where the giveaway will be posted, if different from the one you're typing in. If left blank, the giveaway will launch in the current channel. ![Example configuration with /giveaway create](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-9f666a7092484c09c756c75fe32aaf62504ebb85%2Fgiveaway_command_create.png?alt=media) ## :tools: Full Customization Method If you want to create a detailed and polished giveaway with custom visuals, use this method. ### Accessing the Dashboard First, go to the John-Bot dashboard using your preferred method. Learn how: [How to access the dashboard](/en/getting-started/guide#pushpin-access-the-dashboard) ### Accessing Settings Next, look for `Giveaways` in the right-hand column, under your server's logo and banner. You'll see a page listing all your server's giveaways, whether ongoing or finished. ### Creating and Configuring Here's how to configure each setting for your giveaway: #### Name Choose a name to identify your giveaway. It will appear in the title of the sent message as well as on the dashboard so you can spot it among others. #### Sending Channel Choose the channel where the giveaway will be posted and visible to members. Once sent, the channel cannot be changed. #### Prize Enter the name of the prize you want to put up for grabs. The field is freeform — it can be physical, virtual, or anything else. Prize distribution is not automated; you'll need to handle it manually. #### End Date Set the exact date and time of the drawing. On this date, a message will automatically be posted in reply to the original giveaway message to announce the winner(s). #### Number of Winners Set how many members can be declared winners of the prize. #### Maximum Number of Participants :gem: Optionally limit the number of members who can enter the drawing. #### Participant List Display You can disable the participant list button by unchecking the associated box. {% hint style="info" %} Learn how this button works in the [direct interaction with the giveaway](#direct-interaction-with-the-giveaway) section. {% endhint %} #### Allowed & Ignored Roles Use these two fields to restrict the giveaway to certain roles or block certain roles from entering. Select the desired roles from the corresponding dropdown. #### Embed The `embed` section lets you format the message that will be sent and displayed to members. Customize it to your liking with the many options available. #### Button :gem: The `button` section lets you customize the participation button attached to the giveaway message. You can change its color, text, and emoji. ### Finalize and Send Once everything is set, double-check your configuration and click the green `Create & Send` button at the top left. Your giveaway will go live in the specified channel with all your customizations. Consider writing an announcement message if the giveaway is tied to a special event. ## :gear: How Giveaways Work ### Giveaway Information The embed message contains key information about the giveaway. Here's what each field means: * **Name / Title:** Found in the embed title (bold text at the top). * **End Date and Time:** Shows the remaining time and the exact end date/time. The field is labeled `Ends:` below the title. It changes to `Ended` once the giveaway is over. * **Giveaway Author:** Shows who launched the giveaway, identified by their Discord account in the `Launched by:` field. * **Number of Participants:** Shows how many members have entered, in the `Participants:` field. * **Number of Winners / Winner(s):** Shows how many winners will be drawn, in the `Winners:` field. After the drawing, this field displays the winner(s) by mention. ### Direct Interaction with the Giveaway #### Participation Button Enter the drawing by clicking the customizable button located below the giveaway embed, to the left of the `Participants` button. #### Participants Button View the list of everyone who has entered by clicking the `Participants` button located below the giveaway embed, to the right of the participation button. {% hint style="info" %} Learn how to configure this button in the [create and configure](#creating-and-configuring) section. {% endhint %} ![Example of a typical giveaway message](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-75110b8c655ae41136ee339e594a6df9b7b539b8%2Fgiveaway_example.png?alt=media) ### Commands | Command | Description | | ---------------- | ---------------------------------- | | /giveaway create | Launches a giveaway. | | /giveaway delete | Deletes a giveaway. | | /giveaway end | Ends a giveaway early. | | /giveaway list | Shows all giveaways on the server. | | /giveaway reroll | Picks new winners for a giveaway. | # Reminders Here you'll find information about John-Bot's command-based reminder system. Learn how it works with its many commands. ## Reminders **Video tutorial related to this page:** [Use John-Bot Reminders on Discord - Tutorial #11](https://jnbt.xyz/tutorials/reminders) ## :rocket: Introduction If you have a task you absolutely can't forget, you can use John-Bot's reminder system. With a simple command that works on any server or in DMs, you can schedule an alert that will be sent as a direct message at a specific time. ## :alarm\_clock: Managing Reminders ### Creating a Reminder To schedule a reminder, type the command `/reminder add`. Then fill in the provided fields with the reason (which will be sent back to you when the reminder fires) and the amount of time before it's sent. A confirmation message will then be sent to you. {% hint style="warning" %} Note that the delay before sending cannot be less than one minute or more than 365 days. {% endhint %} ### Deleting a Reminder If you no longer need a previously scheduled reminder, you can easily delete it. Type the command `/reminder remove` and select the reminder to delete. A confirmation message will then be sent to you. ### Listing Active Reminders To view all your reminders and keep track of them, type the command `/reminder list`. ## :clipboard: Command List | Command | Description | Example | | ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /reminder add | Sets a reminder. | ![/reminder add command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-049c0eac4f45ac6c6b15dca94db4cdd44dd46291%2Frappels_command_add.png?alt=media) | | /reminder list | Shows all your reminders. | ![/reminder list command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-27e10082bba7029ceecfdf24cadab6a99282c2a3%2Frappels_command_list.png?alt=media) | | /reminder remove | Deletes a reminder. | ![/reminder remove command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-1eec5d14d008069b886f809f2ea0c152f1a62769%2Frappels_command_remove.png?alt=media) | # Moderation Learn how John-Bot's command-based moderation system works and explore its features. **Video tutorial related to this page:** [Effectively Moderate Your Server with John-Bot - Tutorial #5](https://jnbt.xyz/tutorials/moderation) ### :rocket: Introduction John-Bot's command-based moderation system gives you the tools to efficiently moderate your Discord server. With powerful commands, you can simplify and speed up moderation to maintain a safe environment — all with advanced features through John-Bot that are unavailable to regular users. ### :clipboard: Command List | Command | Description | Example | | ----------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /ban | Bans a user from the server. | ![/ban command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-5800a12572c935e7e30181e232348da6b4fc6d10%2Fmoderation_command_ban.png?alt=media) | | /clear | Deletes a number of messages in a channel. | ![/clear command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-881cd6d8cdc2bb0479f619a5a07a4c3b85c5e553%2Fmoderation_command_clear.png?alt=media) | | /kick | Kicks a member from the server. | ![/kick command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-716c56b9b9712dabbf64481cb171e2b739ef85f4%2Fmoderation_command_kick.png?alt=media) | | /lock | Locks a server channel. | ![/lock command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-68aac074f2c64596f98a8cba4cb1f983ad5f0a91%2Fmoderation_command_lock.png?alt=media) | | /mute | Mutes a member for a certain duration. | ![/mute command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-aa2df96ad5d28ae88101a3615326482346b91cc5%2Fmoderation_command_mute.png?alt=media) | | /nickname | Changes a server member's nickname. | ![/nickname command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-54da55af2f8989718773af75d1f92b9d84b8070d%2Fmoderation_command_nickname.png?alt=media) | | /slowmode disable | Disables slowmode in a channel. | ![/slowmode disable command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-93e0bc38e4fc36f92e7b375653df319dea7a4e93%2Fmoderation_command_slowmode%20disable.png?alt=media) | | /slowmode set | Sets slowmode in a channel. | ![/slowmode set command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-52af526e8d728e8df985de305388666911f9f7da%2Fmoderation_command_slowmode%20set.png?alt=media) | | /unban | Unbans a user. | ![/unban command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-0ca1558d0585124bd239c7fe59e97627a6208551%2Fmoderation_command_unban.png?alt=media) | | /unlock | Unlocks a server channel. | ![/unlock command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-c9e1a8d4e311ec66e529720d197061e32ed8cdca%2Fmoderation_command_unlock.png?alt=media) | | /unmute | Unmutes a muted member. | ![/unmute command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-a482fcb9fc961948a3ca334db5db43389a55cbf3%2Fmoderation_command_unmute.png?alt=media) | | /warn | Warns a server member. | ![/warn command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-5111daa1fe2444eaa50d19b186ce8acc3c44d0c1%2Fmoderation_command_warn.png?alt=media) | | /warnings clear | Clears warnings for a member or all server members. | ![/warnings clear command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-2498ceb6a588c8dc5434136e743154b5848907e0%2Fmoderation_command_warnings%20clear.png?alt=media) | | /warnings list | Shows a member's warning list. | ![/warnings list command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-4578faf7d6b8ba3a49a74335d6929a6e31f47e2d%2Fmoderation_command_warnings%20list.png?alt=media) | | /warnings remove | Removes a warning from a member. | ![/warnings remove command](https://1037626089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAVmyrgTKWfHLmRDMeWs%2Fuploads%2Fgit-blob-193fe0a7cc1f7c9dc1853b7d59041c9f7d8142b0%2Fmoderation_command_warnings%20remove.png?alt=media) | # Variables List of available variables you can use across the configuration of John-Bot's various systems. ### Date Variables | Variable | Description | Example | | ----------- | ------------------------------------------------- | ---------- | | {date} | Displays the current date in `DD/MM/YYYY` format. | 04/03/2024 | | {date.time} | Displays the current time in `HH:MM` format. | 09:22 | | {timestamp} | Displays the current Unix timestamp. | 1741098205 | ### User Variables | Variable | Description | Example | | ------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------- | | {user} | Displays the user's mention. | @User | | {user.id} | Displays the user's ID. | 982054684481167410 | | {user.username} | Displays the user's unique name (or name and tag). | exampleuser (or User#0001) | | {user.global\_name} | Displays the user's display name. | User | | {user.nickname} | Displays the user's nickname on the server. | Moderator - User | | {user.avatar\_url} | Displays the URL of the user's avatar. | | | {user.banner\_url} | Displays the URL of the user's banner. | | ### Server Variables | Variable | Description | Example | | ---------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------- | | {server.name} | Displays the server name. | John-Bot | | {server.id} | Displays the server ID. | 959269961572962314 | | {server.icon\_url} | Displays the server icon URL. | | | {server.member\_count} | Displays the server's member count. | 100 | ### Panel Variables | Variable | Description | Example | | --------------------- | ---------------------------------------- | ------------------------ | | {panel.name} | Displays the panel name. | Support | | {panel.reopening\_at} | Displays the date the panel will reopen. | January 20, 2025 7:00 AM | ### Ticket Variables | Variable | Description | Example | | --------------- | --------------------------- | ------------------ | | {ticket} | Mentions the ticket. | #ticket | | {ticket.id} | Displays the ticket ID. | 959269961572962314 | | {ticket.name} | Displays the ticket name. | Ticket | | {ticket.number} | Displays the ticket number. | 10 | ### Level Variables | Variable | Description | Example | | ------------- | ------------------------------------------------------------ | ------------ | | {level} | Displays the member's new level when they level up. | 5 | | {reward.role} | Displays the role unlocked by the member when they level up. | Super Writer | ### Channel Variables (YouTube and Twitch) | Variable | Description | Example | | ------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | {channel.url} | Displays the YouTube/Twitch channel link. | **OR** | | {channel.name} | Displays the YouTube/Twitch channel name. | Les Cowboys Fringants | | {channel.icon\_url} | Displays the YouTube/Twitch channel icon. | **OR** | ### YouTube Variables | Variable | Description | Example | | ------------------- | ------------------------------- | ---------------------------------------------------------- | | {video.title} | Displays the video title. | My Awesome YouTube Video | | {video.description} | Displays the video description. | Subscribe to my channel and follow me on social media! | | {video.id} | Displays the video ID. | q5mUj4KBOb0 | | {video.thumbnail} | Displays the video thumbnail. | | | {video.duration} | Displays the video duration. | 2:46 | | {video.url} | Displays the video link. | | ### Twitch Variables | Variable | Description | Example | | ------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | {stream.title} | Displays the stream title. | My Awesome Twitch Stream | | {stream.thumbnail} | Displays the stream preview. | | | {stream.game} | Displays the game being streamed. | Minecraft | | {stream.game\_icon\_url} | Displays the stream's game cover art. | | | {stream.viewer\_count} | Displays the stream's viewer count. | 1000 | | {stream.url} | Displays the stream link. | | ### Bluesky Variables | Variable | Description | Example | | ------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | {profile.url} | Displays the Bluesky profile link. | | | {profile.name} | Displays the Bluesky display name. | Bluesky | | {profile.icon\_url} | Displays the Bluesky profile icon. | | | {profile.handle} | Displays the Bluesky handle. | bsky.app | | {post.content} | Displays the post content. | Welcome to my Bluesky account! | | {post.url} | Displays the post link. | | | {post.id} | Displays the post ID. | 3l6oveex3ii2l | # Domain Names List of official domain names used by John-Bot Some individuals create domain names similar to those used by John-Bot for malicious purposes. As of now, John-Bot only uses three domain names, listed below. | Domain Name | Usage | Example | | ----------------------------------------- | ------------------------ | ----------------------------------------------------- | | [(www.)johnbot.app](http://johnbot.app) | Website | [johnbot.app/dashboard](http://johnbot.app/dashboard) | | [(www.)john-bot.app](http://john-bot.app) | Redirects to johnbot.app | [john-bot.app/](http://john-bot.app/) | | [(www.)jnbt.xyz](http://jnbt.xyz) | Shortened links | [jnbt.xyz/jNnLmd](http://jnbt.xyz/jNnLmd) | Any other domain name claiming to be John-Bot does not belong to John-Bot and is likely run by malicious actors. # Accueil Vous avez des questionnements sur lors de l'utilisation de John-Bot ? La documentation vous apporte une réponse. Découvrez John-Bot et le fonctionnement de sa documentation. ## :question: A propos de John-Bot **John-Bot est un robot proposé sur la plateforme Discord destiné à faciliter la gestion des serveurs Discord sur lesquels il est présent.** Il propose un grand nombre de fonctionnalités utiles, entre autres un système de ticket, un système de logs, un système d'arrivée & départ, un système de niveaux par experience, un système de giveaways ou encore un système de modération avancé.¹ ## :book: La documentation La documentation de John-Bot est destinée à vous familiariser avec les diverses fonctionnalités que propose John-Bot. Elle permet de trouver rapidement une réponse écrite aux nombreux questionnements pouvant être rencontrés lors de l'utilisation de John-Bot, plus particulièrement lors de sa configuration. Chaque page de la documentation est liée à un tutoriel vidéo. Retrouvez tous les tutoriels officiels via cette playlist YouTube : [Tutoriels - John-Bot](https://jnbt.xyz/fr/tutorials) ## :gear: Fonctionnement La documentation est divisée en plusieurs catégories comprenant des pages puis des sous-pages. Ces sous-pages sont divisées en parties voir en sous-parties. Un tel fonctionnement peu paraitre superflu et trop complexe mais permet en fait de trouver en quelques instants la réponse à une question. En effet, vous pouvez vous orienter de plus en plus précisément vers la réponse attendue sans devoir parcourir toute la documentation à la recherche de votre réponse.\ Certains signes peuvent également vous aider à comprendre rapidement certaines informations : * :gem: : option réservée aux membres [John-Bot Premium](https://johnbot.app/premium) ## :no\_entry\_sign: Limites La documentation peut parfois ne pas être en mesure de répondre à l'une de vos questions, le cas échéant, pouvez contacter l'équipe support de John-Bot via le serveur Discord support ou tout autre moyen². *** 1 : la liste n'est pas exhaustive\ 2 : voir la page [Contact](/contact) # Contact Découvrez les différentes manières de contacter l’équipe de John-Bot et choisissez celle qui vous convient le mieux. ## :speech\_balloon: Serveur Discord de support Le serveur Discord support est le moyen le plus rapide de contacter l’équipe et permet de soumettre la plupart des demandes. Via un système de ticket¹, chaque membre de l’équipe d’assistance reçoit instantanément une notification et peut répondre directement dans un salon temporaire avec son propre compte Discord. Pour soumettre une demande, rejoignez le [serveur Discord de John-Bot](https://discord.com/invite/YgRbfQ3Mkg), rendez-vous dans le salon [#support](https://discord.com/channels/959269961572962314/960211222211489903) puis cliquez sur le bouton “:flag\_fr: Français” sur le message correspondant. La fenêtre qui apparaît vous permet de renseigner le motif d’assistance afin de gagner du temps. Si malgré tout vous ne souhaitez pas remplir ce champ, cliquez directement sur le bouton bleu “Envoyer” situé en bas à droite de la fenêtre. Après quelques secondes d’attente, vous recevrez un message de confirmation dans le salon. Il vous indiquera le salon dans lequel votre demande a été créée. Cliquez simplement sur le nom du salon correspondant. Vous arrivez à présent dans le salon textuel dans lequel la communication avec l’équipe peut s’effectuer. Attendez que l’équipe vous réponde ou engagez la conversation pour préciser votre demande. ## :e\_mail: Message électronique (e-mail) John-Bot dispose de deux adresses électroniques. L'une pour les questions générales et l'une pour les questions légales. **Questions générales :** **Questions légales :** Pour soumettre une demande, envoyez simplement un e-mail à l'adresse qui correspond dans le respect des normes de messagerie électronique. *** 1 : [Système de ticket](/configuration/tickets) propulsé par John-Bot # FAQ Avant de demander de l'aide, consultez cette page qui répond aux questions les plus fréquentes sur l'utilisation de John-Bot. ### :rocket: Introduction Lors de l'utilisation de John-Bot, vous pouvez être amené à vous poser certaines questions. Les questions fréquemment rencontrées par les utilisateurs sont répertoriées dans cette page pour permettre un accès instantané sans devoir passer par l'assistance. Cependant, si vous ne trouvez pas les réponses à toutes vos questions, consultez précisément [la documentation](/), [les tutoriels vidéo](https://jnbt.xyz/tutorials) ou [contactez l'équipe d'assistance](/contact). ### :question: Questions fréquemments posées
Qu'est-ce que John-Bot ? John-Bot est un robot proposé sur la plateforme Discord destiné à faciliter la gestion des serveurs Discord sur lesquels il est présent. Il propose un grand nombre de fonctionnalités utiles, entre autres un système de ticket, un système de logs, un système d'arrivée & départ, un système de niveaux par experience, un système de giveaways ou encore un système de modération avancé.¹
Pourquoi le rôle que je souhaite ne peut pas être séléctionné ? Lors de la configuration des rôles automatiques ou des rôles récompenses du système de niveaux, vous pouvez rencontrer un rôle qui ne peut pas être sélectionné. Il est grisé, non sélectionnable et suivi d'un indicateur rouge. Cela peut être lié à deux interférences : * **Rôle non accessible par John-Bot** : Pour certains rôles, John-Bot n'a simplement pas assez de permissions. Pour lui accorder ces permissions, placez le rôle nommé "John-Bot", qui est le rôle de l'application, au-dessus des rôles souhaités dans la hiérarchie des rôles du serveur. John-Bot doit également disposer de la permission administrateur (ou à minima "Gérer les rôles"). * **Rôle non gérable par John-Bot** : Pour certains rôles, Discord interdit aux applications comme John-Bot de les gérer. C'est le cas des rôles d'applications et des rôles de récompense pour les boosters du serveur.
*** ¹: la liste n'est pas exhaustive # Ajouter le bot Pour commencer à utiliser John-Bot, vous devez l'inviter sur votre serveur Discord. Découvrez comment procéder étape par étape. **Tutoriel vidéo lié à cette page :** [Ajouter John-Bot à son serveur Discord - Tutoriel #1](https://jnbt.xyz/fr/tutorials/add) ## :link: Accéder à la page d'invitation Pour ajouter John-Bot à votre serveur Discord, rendez-vous sur la page d'invitation de John-Bot. Vous pouvez y accéder de différentes manières : * Via le site web puis le bouton "Ajouter à Discord" ; * Via la commande `/invite` sur un serveur possédant le bot (voir image) ; * Via le lien direct : [https://jnbt.xyz/invite](https://jnbt.xyz/invite/docs) ![Commande /invite sur un serveur Discord possédant John-Bot](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-3c54310ba03f2b109e0a425d5faa736a2110b3dc%2Fadd_command_invite.png?alt=media) ## :envelope: Processus d'invitation Une fois sur la page d'invitation, sélectionnez le serveur sur lequel vous souhaitez ajouter John-Bot, puis cliquez sur "Continuer". Assurez-vous que la permission "Administrateur" est correctement attribuée, puis validez en cliquant sur "Autoriser". Il se peut que vous deviez entrer votre code d'authentification à deux facteurs ([Support sur l'A2F](https://support.discord.com/hc/fr/articles/219576828-Mise-en-place-de-l-authentification-multifacteurs)) ou valider un CAPTCHA pour prouver que vous n'êtes pas un robot. ## :hourglass: Finalisation Après avoir confirmé l’ajout de John-Bot, vérifiez qu’il est bien présent sur le serveur. Si c’est le cas, il est conseillé de passer à la section suivante du guide de démarrage. Sinon, cela est généralement lié à un bot "antiraid" mal configuré ou à un problème de permissions.\ En cas de problème, n’hésitez pas à [Contacter l'équipe de John-Bot](/contact). # Configurations basiques Avant de commencer la configuration et la personnalisation de John-Bot sur votre serveur, voici quelques conseils de base. **Tutoriel vidéo lié à cette page :** [Préparer son serveur à la configuration de John-Bot (prérequis) - Tutoriel #2](https://jnbt.xyz/fr/tutorials/start) ## :clipboard: Vérifier les permissions Pour fonctionner correctement, John-Bot doit posséder un certain nombre de permissions. Il est fortement conseillé d'attribuer la permission d'administrateur pour éviter tout conflit.\ Lors de l'ajout de John-Bot, vous avez probablement déjà attribué ces permissions, mais une vérification s'impose. Pour ce faire, rendez-vous dans les paramètres de votre serveur Discord. ## :pushpin: Accéder au tableau de bord Pour configurer John-Bot, vous devez accéder au tableau de bord (également appelé "dashboard").\ Voici les différentes manières d'y accéder : ### Utiliser la commande /dashboard Rendez-vous sur le serveur Discord que vous souhaitez configurer et accédez à un salon où vous pouvez exécuter des commandes. Tapez ensuite dans ce salon la commande `/dashboard` et cliquez sur le bouton intitulé `Tableau de bord`.\ Vous serez redirigé vers la page du tableau de bord de votre serveur et devrez peut-être vous authentifier avec votre compte Discord. Si c'est le cas, cliquez simplement sur le bouton `Autoriser` en bas à droite. ![Commande /dashboard sur un serveur Discord possédant John-Bot](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-cb3bd00e2bda7aea1d2616cce1816f0efa316c7e%2Fbase_command_dashboard.png?alt=media) ### Via le site web Rendez-vous sur le site web de John-Bot à l'adresse : et cliquez sur le bouton en haut intitulé `Tableau de bord`. Vous devrez peut-être vous authentifier avec votre compte Discord. Si c'est le cas, cliquez simplement sur le bouton `Autoriser` en bas à droite. Ensuite, choisissez le serveur Discord que vous souhaitez configurer et cliquez dessus. Vous serez alors redirigé vers la page du tableau de bord de votre serveur. ### Avec l'adresse web exacte Vous pouvez accéder directement au tableau de bord de votre serveur en entrant dans votre navigateur web l'adresse sous le format suivant : `https://johnbot.app/dashboard/guildId`\ Remplacez `guildId` par l'identifiant de votre serveur¹. ## :flag\_fr: Définir la langue Avant de commencer la moindre configuration, il est conseillé de choisir la langue d'affichage de John-Bot. Découvrez comment faire : [Changer la langue de son serveur](/configuration/language) ## :gem: Activer John-Bot Premium John-Bot Premium est la version payante de John-Bot qui permet d'obtenir plus de fonctionnalités pour rendre votre serveur Discord encore meilleur. Souscrire à un abonnement Premium permet également de contribuer à payer les frais engendrés par l'utilisation de l'application et donc de permettre une version gratuite complète de John-Bot pour tous, sans condition. {% hint style="info" %} Vous pouvez consulter la liste exhaustive des avantages de la version Premium par rapport à la version gratuite de John-Bot à l'adresse suivante : {% endhint %} ### Souscire à John-Bot Premium Tout d'abord, rendez-vous sur la page et choisissez le plan qui correspond à vos besoins. Vous serez redirigé vers la page de paiement Patreon, où vous devrez créer un compte. Suivez les étapes sur Patreon jusqu'à la validation de votre souscription. ### Lier votre compte Patreon Ensuite, vous devrez lier votre compte Patreon sur le tableau de bord de John-Bot. Pour cela, rendez-vous sur le tableau de bord de l'un de vos serveurs et cliquez sur votre photo de profil en haut à gauche. Assurez-vous que votre compte Patreon est bien lié. ### Activer John-Bot Premium sur un serveur Finalement, vous devrez activer John-Bot Premium sur les serveurs souhaités en utilisant la commande `/premium` sur les serveurs en question et en confirmant l'activation. Pour désactiver John-Bot Premium, vous pouvez entrer la commande `/premium` et cliquer sur `réinitialiser`. ### Gérer ou annuler votre abonnement Pour changer de plan, rendez-vous dans la [section `Abonnement` de la page de John-Bot sur Patreon](https://www.patreon.com/c/johnbot/membership). Vous aurez accès aux trois plans proposés et pourrez choisir celui qui correspond à vos besoins.\ Pour annuler votre abonnement, rendez-vous dans la [section `Abonnements` des paramètres de Patreon](https://www.patreon.com/settings/memberships). Vous pourrez annuler votre abonnement en affichant les options supplémentaires et en cliquant sur `Annuler l'abonnement`. *** 1 : Trouver l'identifiant de votre serveur : [Où trouver l’ID de mon compte utilisateur / serveur / message ?](https://support.discord.com/hc/fr/articles/206346498-O%C3%B9-trouver-l-ID-de-mon-compte-utilisateur-serveur-message) # Arrivée & Départ Ici, vous trouverez des informations relatives à la configuration du système d'arrivées et de départs de John-Bot. **Tutoriel vidéo lié à cette page :** [Configurer les actions d'arrivée et de départ de John-Bot - Tutoriel #3](https://jnbt.xyz/fr/tutorials/welcome) ### :rocket: Introduction Le système d'arrivées et de départs de John-Bot permet d'annoncer lorsqu'un membre rejoint ou quitte le serveur et de lui attribuer certains rôles automatiquement à son arrivée. ### :tools: Accéder à la configuration #### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) #### Accéder aux paramètres Ensuite, cherchez `Arrivées et départs` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez accéder à tous les paramètres relatifs au système d'arrivées et de départs. ### :inbox\_tray: Message d'arrivée Les messages d'arrivée sont des messages qui seront automatiquement envoyés lorsqu'un nouveau membre rejoint le serveur. Ils permettent d'annoncer l'arrivée d'un nouveau membre et sont entièrement personnalisables pour permettre d'inclure notamment le nombre de membres présents sur le serveur, la mention de l'utilisateur et bien plus. ![Exemple d'un message d'arrivée](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-1c8bdbf7aff04e56ffce85535e415b2250688e33%2Fwelcome_message%20d'arriv%C3%A9e_example.png?alt=media) #### Configuration **Salon d'envoi** Dans ce champ, sélectionnez le salon qui recevra les messages d'arrivée à l'aide du menu déroulant associé. **Mise en forme** Dans cette catégorie, vous pouvez personnaliser le message qui sera envoyé lorsque un nouvel utilisateur rejoindra le serveur. {% hint style="info" %} Pour ajouter des éléments changeants tel que le nombre de membres présents sur le serveur, la mention de l'utilisateur et bien plus, vous pouvez utiliser les variables : [comment utiliser les variables](/ressources/variables) {% endhint %} **Message texte** Le message texte est le texte qui sera affiché hors de l'embed, comme un utilisateur Discord classique. Vous pouvez utiliser les emojis et le markdown¹ pour personnaliser votre texte. Pour désactiver le message texte, laissez le champ vide. ![Exemple de message d'ouverture avec le message texte mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-47c3688990c38d8e0d330d634ee54e4ead79cd8e%2Fticket_message%20d'ouverture_partie%20texte.png?alt=media) **Embed** L'embed est la partie du message qui peut comporter plusieurs éléments personnalisables et qui sera affichée sous le message texte. Il est impossible à envoyer pour un utilisateur Discord classique. Vous pouvez utiliser les champs disponibles pour personnaliser votre embed. ![Exemple de message d'ouverture avec l'embed mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-682afc006194ceecb1bbd4960a59de35ad59bc65%2Fticket_message%20d'ouverture_partie%20embed.png?alt=media) * **Activer l'embed d'arrivée :** Vous pouvez cocher cette case si vous souhaitez activer l'embed dans votre message d'arrivée. Si vous souhaitez désactiver l'embed, décochez cette case. * **Icône de l'auteur de l'embed** :gem: **:** Vous pouvez illustrer votre embed en ajoutant une image (qui peut être animée) à votre auteur, uniquement visible lorsque l'auteur a un nom. * **Nom de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un auteur, que vous pouvez nommer comme bon vous semble. * **Lien de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un lien vers un site externe à l'auteur. * **Titre de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant un titre. * **Description de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant une description. * **Couleur de l'embed :** Vous pouvez choisir une couleur pour personnaliser votre embed à l'aide du sélécteur. * **Lien de la vignette de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une vignette. * **Lien de l'image de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une image. * **Icône du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide d'une image de footer. * **Texte du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide du footer. ### :outbox\_tray: Message de départ Les messages de départ sont des messages qui seront automatiquement envoyés lorsqu'un membre quitte le serveur. Ils permettent d'annoncer le départ d'un membre et sont entièrement personnalisables pour permettre d'inclure notamment le nombre de membres présents sur le serveur, la mention de l'utilisateur et bien plus. ![Exemple d'un message de départ](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-a64fce1c18cf13a561b8b18327a7d5415b32c147%2Fwelcome_message%20de%20d%C3%A9part_example.png?alt=media) #### Configuration **Salon d'envoi** Dans ce champ, sélectionnez le salon qui recevra les messages de départ à l'aide du menu déroulant associé. **Mise en forme** Dans cette catégorie, vous pouvez personnaliser le message qui sera envoyé lorsque un nouveau membre quittera le serveur. {% hint style="info" %} Pour ajouter des éléments changeants tel que le nombre de membres présents sur le serveur, la mention de l'utilisateur et bien plus, vous pouvez utiliser les variables : [comment utiliser les variables](/ressources/variables) {% endhint %} **Message texte** Le message texte est le texte qui sera affiché hors de l'embed, comme un utilisateur Discord classique. Vous pouvez utiliser les emojis et le markdown¹ pour personnaliser votre texte. Pour désactiver le message texte, laissez le champ vide. **Embed** L'embed est la partie du message qui peut comporter plusieurs éléments personnalisables et qui sera affichée sous le message texte. Il est impossible à envoyer pour un utilisateur Discord classique. Vous pouvez utiliser les champs disponibles pour personnaliser votre embed. * **Activer l'embed de départ :** Vous pouvez cocher cette case si vous souhaitez activer l'embed dans votre message de départ. Si vous souhaitez désactiver l'embed, décochez cette case. * **Icône de l'auteur de l'embed** :gem: **:** Vous pouvez illustrer votre embed en ajoutant une image (qui peut être animée) à votre auteur, uniquement visible lorsque l'auteur a un nom. * **Nom de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un auteur, que vous pouvez nommer comme bon vous semble. * **Lien de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un lien vers un site externe à l'auteur. * **Titre de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant un titre. * **Description de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant une description. * **Couleur de l'embed :** Vous pouvez choisir une couleur pour personnaliser votre embed à l'aide du sélécteur. * **Lien de la vignette de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une vignette. * **Lien de l'image de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une image. * **Icône du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide d'une image de footer. * **Texte du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide du footer. ### :robot: Rôles d'arrivée Les rôles d'arrivée sont des rôles sélectionnés au préalable par les administrateurs qui seront attribués instantanément à un nouveau membre qui rejoint le serveur. #### Configuration Pour définir les rôles qui seront attribués, choisissez ceux que vous souhaitez à l'aide du menu déroulant correspondant. *** 1 : Découvrir ce qu'est le Markdown : [Markdown de Texte 101 (Formatage du chat : gras, italique, souligné)](https://support.discord.com/hc/fr/articles/210298617-Markdown-de-Texte-101-Formatage-du-chat-gras-italique-soulign%C3%A9) # Tickets Ici, vous trouverez des informations sur la configuration du système de ticket de John-Bot. **Tutoriel vidéo lié à cette page :** [Configurer le système de tickets de John-Bot - Tutoriel #4](https://jnbt.xyz/fr/tutorials/tickets) ## :rocket: Introduction Un système de ticket permet aux membres de contacter l'équipe du serveur (staff) dans un salon privé créé sur demande. John-Bot permet de pousser ce type de système à son paroxysme en ajoutant notamment la possibilité de choisir le motif le plus approprié à une demande d'assistance et de le préciser à l'aide d'un modèle sur Discord. Pour créer un système de ticket, il faut créer un ou plusieurs panneaux, qui correspondent chacun à un type de demande d'assistance (par exemple, un pour contacter la modération, un pour demander un partenariat et un autre pour les demandes administratives). Ensuite, vous devrez créer un ou plusieurs embeds qui correspondent aux messages permettant aux membres d'interagir pour créer un ticket. Vous pouvez ajouter plusieurs panneaux à chacun. Enfin, vous avez la possibilité de créer un ou plusieurs modèles qui correspondent aux formulaires apparaissant lorsqu'un membre interagit avec l'un des boutons et accède donc à un panneau. ## :earth\_africa: Configuration globale ### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) ### Accéder aux paramètres Ensuite, cherchez `Tickets` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez configurer tous les paramètres de votre serveur relatifs au système de ticket et consulter les transcriptions. ### Logs Les logs permettent d'enregistrer toutes les actions relatives aux tickets dans un salon du serveur.\ À la suppression d'un ticket, un certain nombre d'informations relatives au ticket en question seront rendues disponibles sur un message. Vous retrouverez l'identifiant du ticket, l'utilisateur à l'origine du ticket, l'utilisateur qui a fermé le ticket, l'utilisateur qui a supprimé le ticket, la date d'ouverture du ticket, le nom du ticket, le membre de l'équipe d'assistance qui a pris en charge le ticket et la liste des utilisateurs ayant écrit un message dans le ticket (John-Bot exclu). C'est également sous ce message que vous pouvez retrouver le lien vers la transcription du ticket, sous réserve d'activation de l'option comme indiqué plus loin sur cette page. Cette dernière est jointe au message mais difficilement lisible et accessible. ![Exemple d'un message de logs de ticket](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-a7bc40c040183f6461b4f361ed5818577ab67b46%2Ftickets_logs_example.png?alt=media) Pour activer les logs à la suppression d'un ticket, cochez simplement la case `Activer les logs` et sélectionnez le salon dans lequel vous souhaitez stocker ces messages. {% hint style="info" %} Il est fortement conseillé de rendre le salon des logs de ticket privé. En effet, certaines informations pourraient s'avérer privées et ne doivent donc pas être accessibles au premier venu mais à l'équipe de confiance. {% endhint %} ### Limite de tickets globale Cette option permet de limiter le nombre de tickets total ouverts simultanément par un membre sur le serveur, tous panneaux confondus. Si une limite de ticket est appliquée plus tard à l'un des panneaux, cette dernière prendra le dessus pour le panneau en question. Choisissez simplement le nombre de tickets maximum avec le champ correspondant. ### Transcriptions Une transcription permet de remonter l'historique de la conversation du ticket. Elles peuvent s'avérer très pratiques pour référence future, suivi des problèmes ou même formation de l'équipe. Les transcriptions de John-Bot permettent de visualiser l'historique de la conversation dans une mise en page simulant l'originale de Discord pour rendre la lecture plus agréable et cohérente. #### Activer les transcriptions Pour activer les transcriptions, vous devez d'abord avoir activé les logs des tickets et défini un salon d'envoi des logs. Une fois cela fait, cliquez simplement sur le bouton `Activer les transcriptions`. #### Consulter les transcriptions Vous pouvez consulter les transcriptions de deux façons différentes : * Premièrement, vous pouvez vous rendre sur le tableau de bord puis sur la page `Tickets` et cliquer sur le bouton en haut à droite `Voir les transcriptions`. Vous retrouverez ensuite la liste de toutes les transcriptions stockées pour votre serveur ainsi qu'un moteur de recherche pour vous aider à trouver celle que vous cherchez. * Deuxièmement, vous pouvez vous rendre dans le salon de logs des tickets directement sur votre serveur Discord et chercher le message correspondant à la transcription souhaitée. Vous pouvez ensuite cliquer sur le bouton lié au message `Voir la transcription` et serez redirigé vers le lecteur de John-Bot. {% hint style="info" %} Si vous ne trouvez pas la transcription que vous cherchez, c'est qu'elle n'est plus stockée car le message de logs du ticket en question a été supprimé ou que votre ticket remonte avant le 26 janvier 2024. Dans la première situation, rien à faire, votre transcription est définitivement effacée. Dans la seconde situation, il suffit de chercher le message de logs associé au ticket souhaité, de télécharger le fichier .html joint au message et de l'ouvrir dans votre visionneuse de fichiers .html. Les navigateurs web (Mozilla Firefox, Microsoft Edge, Opera, Google Chrome...) supportent généralement ce type de fichiers. {% endhint %} ### Rôle·s d'exclusion Les rôles d'exclusion permettent d'empêcher certains membres d'ouvrir des tickets. Lorsqu'un membre possède un rôle d'exclusion, il sera impossible pour lui de créer un ticket. Choisissez un ou plusieurs rôles parmi votre liste de rôles dans le champ correspondant pour configurer cette option. ## :jigsaw: Configuration panneau·x ### Créer un panneau Avant de commencer à configurer votre ou vos panneaux, vous devez les créer. Pour cela, cliquez simplement sur le bouton `Créer un panneau` situé sous les paramètres globaux. ### Dupliquer un panneau Vous pouvez également créer un panneau à partir d'un déjà existant pour retrouver exactement les mêmes paramètres et le personnaliser. Cela permet d'éviter de devoir reconfigurer tous les paramètres pour une différence mineure entre les deux panneaux. Pour cela, cliquez simplement sur le bouton `Dupliquer` correspondant au panneau souhaité et validez votre choix via la fenêtre qui apparait. ### Modifier un panneau Pour modifier les paramètres d'un panneau existant, cliquez simplement sur le bouton `Modifier` correspondant au panneau souhaité. ### Supprimer un panneau Pour supprimer un panneau existant, cliquez simplement sur le bouton `Supprimer` correspondant au panneau souhaité et validez votre choix via la fenêtre qui apparaît. ### Configurer un panneau Une fois dans les paramètres d'un panneau, vous pouvez configurer de nombreuses options pour personnaliser selon vos besoins le système.\ Une fois les configurations terminées, il vous suffit de cliquer sur le bouton vert `Enregistrer` situé en bas à droite de la fenêtre de configuration. Si vous ne souhaitez pas conserver vos modifications, cliquez simplement sur `Annuler`. #### Nom du panneau Le nom du panneau permet de le nommer pour vous permettre de vous repérer parmi tous vos panneaux, mais il ne sera en aucun cas affiché aux membres. Il est facultatif. Si vous ne donnez pas de nom vous-même, il sera automatiquement nommé par un numéro tel que `Panneau #1`. #### Nom du ticket Le nom du ticket correspond au nom qui sera donné par défaut au salon créé spécifiquement pour le ticket. Vous pouvez lui donner un nom pour vous permettre de le différencier en utilisant les variables. Si vous ne remplissez pas le champ, le nom sera automatiquement `aide-{user.name}`. #### Catégorie de création des tickets Dans ce champ, définissez la catégorie du serveur dans laquelle les salons attribués aux différents tickets du panneau seront créés. En cas de débordement de la catégorie, c'est-à-dire lorsque la catégorie aura atteint son maximum de tickets, ils seront créés hors catégorie. Pour la définir, choisissez la catégorie souhaitée avec le menu de sélection du champ ou recherchez en tapant directement dans le champ. #### Catégorie de fermeture des tickets :gem: La catégorie de fermeture des tickets permet de se débarrasser des tickets fermés pour les traiter plus tard. Les salons correspondants à des tickets fermés seront instantanément déplacés dans la catégorie définie. Pour la définir, choisissez la catégorie souhaitée avec le menu de sélection du champ ou recherchez en tapant directement dans le champ. #### Modèle lié au panneau Dans ce champ, vous pouvez définir le modèle qui apparaitera avant l'ouverture du ticket, lorsque le membre cliquera sur le bouton. Pour cela, choisissez le modèle souhaité avec le menu de sélection du champ ou recherchez en tapant directement dans le champ. {% hint style="info" %} Pour apprendre à configurer un modèle, consulter la catégorie de la documentation correspondante, sur cette page : [Configuration modèle·s](#configuration-modele-s). {% endhint %} #### Période avant l'envoi du rappel d'inactivité :gem: Vous pouvez choisir pendant combien de temps le ticket doit n'avoir reçu de message avant l'envoir du rappel d'inactivité. Par défaut, cette durée est d'une semaine, soit 7 jours. Cette durée n'a une précision que d'environ 6 heures.\ Pour définir la période avant l'envoi du rappel d'inactivité, séléctionnez l'option qui vous convient le mieux dans le menu de séléction disponible dans le champ. {% hint style="info" %} Cette option n'est affective que lorsque l'option \`**Activer le rappel d'inactivité**\` est activée. Pour apprendre à l'activer, consultez cette catégorie, sur cette page : [Activer le rappel d'inactivité](#rappel-dinactivite). {% endhint %} #### Limite de tickets du panneau La limite de tickets du panneau permet de limiter le nombre de tickets ouverts par un membre sur ce même panneau. Par exemple, si la limite de tickets du panneau est de 2, une fois que le membre aura ouvert 2 tickets, il ne pourra plus ouvrir un troisième ticket avant d'avoir fermé l'un des deux autres. Pour la définir, choisissez `Activer` et entrez un nombre dans le champ `Limite de tickets`.\ Si cette limite est définie, elle prend le dessus sur la limite globale définie préalablement. #### Rôles des équipes Les rôles des équipes permettent de définir plusieurs permissions en fonction des rôles. Ci-dessous, retrouvez l'explication détaillée pour chaque permission qui peut être attribuée. Pour définir un ou des rôles pour une permission, cliquez sur le champ et sélectionnez le ou les rôles souhaités. Vous pouvez également entrer le nom du rôle pour le rechercher. * **Rôles de l'équipe d'assistance :** Les membres de l'équipe d'assistance sont désignés pour accéder au ticket et répondre dans celui-ci. Par défaut, ils peuvent également le traiter, le fermer, le rouvrir ou utiliser les commandes de gestion. * **Rôles de l'équipe responsable :** Les membres de l'équipe responsable ont les mêmes permissions que l'équipe d'assistance mais se voient attribuer certains privilèges comme le coutournement de la [gestion exclusive du ticket](#gestion-exclusive-du-ticket). * **Rôles à mentionner lors de l'ouverture :** Les rôles à mentionner lors de l'ouverture seront, comme leur nom l'indique, mentionnés à l'ouverture du ticket, sans message apparent, en utilisant la méthode dite du "ghost-ping". Le membre à l'origine du ticket sera toujours mentionné, mais choisir un rôle qu'il possède ne le mentionnera pas deux fois. * **Rôles d'exclusion :** Les rôles d'exclusion empêchent certains membres d'ouvrir des tickets dans le panneau. Lorsqu'un membre possède un rôle d'exclusion, il lui est impossible de créer un ticket dans le panneau. #### Assignation des tickets L'assignation des tickets permet à l'équipe d'assistance de mieux s'organiser. Au simple clic sur le bouton `Traiter` joint au message d'ouverture, le membre de l'équipe d'assistance en question sera désigné comme "Traitant" du ticket et un message sera envoyé dans le salon pour le signaler. Pour activer cette option, cochez simplement la case associée. {% hint style="info" %} Cette option permet d'utiliser l'option de \`**Gestion exclusive du ticket**\`. Pour apprendre à l'activer, consultez cette catégorie, sur cette page : [Gestion exclusive du ticket](#gestion-exclusive-du-ticket). {% endhint %} #### Rappel d'inactivité Le rappel d'inactivité permet de rappel à l'ensemble des participants du ticket que celui-ci est innactif à l'aide d'un message envoyé un bout d'une durée définie. Pour activer cette option, cochez simplement la case associée. {% hint style="info" %} Pour savoir comment définir le temps qui doit s'écouler avant l'envoi du rappel, consultez cette catégorie sur cette page : [Période avant l'envoi du rappel d'inactivité](#periode-avant-lenvoi-du-rappel-dinactivite). {% endhint %} ![Exemple de message de rappel](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-11a6622361dc160b4e9798fad45871abe1908662%2Fticket_rappel_example.png?alt=media) #### Notification en message privé La notification en message privé est un message envoyé en privé au membre à l'origine du ticket lors de la suppression de ce dernier. Il permet au membre en question de confirmer que son ticket a bien été supprimé et lui permet également d'obtenir quelques informations, dont la transcription du ticket. Pour l'activer, cochez simplement la case associée. ![Exemple de notification en message privé](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-23dcc4d832ef29e364c9468c81bb0af3d4878378%2Fticket_avertissement%20priv%C3%A9_example.png?alt=media) #### Gestion exclusive du ticket La gestion exclusive permet de n'autoriser que le membre de l'équipe d'assistance traitant le ticket à parler dans celui-ci, à l'exception des administrateurs et des membres de l'équipe responsable. Pour activer cette option, cochez simplement la case associée. #### Fermeture du ticket au départ du membre :gem: La fermeture du ticket au départ du membre permet de fermer automatiquement un ticket lorsque le membre qui en est à l'origine quitte le serveur. Pour activer cette option, cochez simplement la case associée. #### Visuel du bouton Pour rendre votre bouton plus attrayant ou compréhensible, vous pouvez le personnaliser à l'aide des nombreuses options proposées. * **Label du bouton :** Le label permet de personnaliser le texte affiché sur le bouton. Par défaut, il sera identique au nom du panneau. * **Description du bouton** :gem: **:** La description permet de donner plus d'indication à votre bouton. Elle n'est visible que lorsque l'option de menu de sélection est activée. Découvrez comment l'activer sur cette page, dans la section correspondante : [Style d'affichage des panneaux](#personnalisation) * **Émoji du bouton :** L'emoji ou émoticône permet d'illustrer votre bouton. Vous pouvez choisir parmi tous les emojis Discord à l'aide du sélecteur. * **Couleur du bouton :** Pour préciser votre bouton, vous pouvez choisir entre les quatre couleurs proposées par Discord : le bleu, le vert, le rouge ou le gris. #### Permissions des rôles * **Créer un ticket :** Pour définir qui peut créer un ticket sur ce panneau, choisissez un ou plusieurs rôles dans le champ correspondant. Si le champ est laissé vide, tous les membres pourront créer un ticket, à condition de ne pas posséder un rôle d'exclusion de ticket. * **Réclamer le ticket :** Pour définir qui peut réclamer ou traiter un ticket sur ce panneau, choisissez un ou plusieurs rôles dans le champ correspondant. Si le champ est laissé vide, tous les membres de l'équipe d'assistance pourront créer un ticket. * **Fermer le ticket :** Pour définir qui peut fermer un ticket ouvert sur ce panneau, choisissez un ou plusieurs rôles dans le champ correspondant. Si le champ est laissé vide, tous les membres ayant accès au ticket pourront le fermer. * **Rouvrir le ticket :** Pour définir qui peut ouvrir un ticket après sa fermeture sur ce panneau, choisissez un ou plusieurs rôles dans le champ correspondant. Si le champ est laissé vide, tous les membres de l'équipe d'assistance pourront rouvrir un ticket. * **Supprimer le ticket :** Pour définir qui peut supprimer un ticket fermé sur ce panneau, choisissez un ou plusieurs rôles dans le champ correspondant. Si le champ est laissé vide, tous les membres ayant accès au ticket fermé pourront le supprimer. #### Thread de discussion privé Le thread (ou fil) de discussion privé permet à l'équipe d'assistance de discuter autour du sujet spécifique du ticket à l'abri des regards et sans devoir créer un nouveau salon sur le serveur. Pour l'activer, cochez simplement la case associée. Une fois l'option activée, vous pourrez personnaliser quelques critères esthétiques. **Nom du thread** Dans ce champ, entrez le nom qui sera automatiquement donné lors de la création du thread (ou fil). Vous pouvez utiliser [les variables](/ressources/variables). **Titre de l'embed de création du thread** Lors de la création du thread privé, un message d'ouverture sera automatiquement envoyé. Dans ce champ, personnalisez le titre qui sera donné à l'embed de ce message. **Description de l'embed de création du thread** Lors de la création du thread privé, un message d'ouverture sera automatiquement envoyé. Dans ce champ, personnalisez la description qui sera donnée à l'embed de ce message. #### Message d'ouverture Le message d'ouverture sera le premier message envoyé dès l'ouverture du ticket et sera également épinglé. Il permet d'obtenir quelques informations essentielles pour le ticket ainsi qu'un message permettant de donner quelques indications au membre. Il contient également les réponses au modèle si le panneau en dispose. Vous pouvez personnaliser certains éléments de ce message, notamment pour vous permettre d'orienter le membre à l'origine du ticket. **Message texte** Le message texte est le texte qui sera affiché hors de l'embed, comme un utilisateur Discord classique. Vous pouvez utiliser les emojis et le markdown¹ pour personnaliser votre texte. Pour désactiver le message texte, laissez le champ vide. ![Exemple de message d'ouverture avec le message texte mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-47c3688990c38d8e0d330d634ee54e4ead79cd8e%2Fticket_message%20d'ouverture_partie%20texte.png?alt=media) **Embed** L'embed est la partie du message qui peut comporter plusieurs éléments personnalisables et qui sera affichée sous le message texte. Il est impossible à envoyer pour un utilisateur Discord classique. Vous pouvez utiliser les champs disponibles pour personnaliser votre embed. ![Exemple de message d'ouverture avec l'embed mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-682afc006194ceecb1bbd4960a59de35ad59bc65%2Fticket_message%20d'ouverture_partie%20embed.png?alt=media) * **Activer l'embed d'ouverture :** Vous pouvez cocher cette case si vous souhaitez activer l'embed dans votre message d'ouverture. Si vous souhaitez désactiver l'embed, décochez cette case. * **Icône de l'auteur de l'embed** :gem: **:** Vous pouvez illustrer votre embed en ajoutant une image (qui peut être animée) à votre auteur, uniquement visible lorsque l'auteur a un nom. * **Nom de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un auteur, que vous pouvez nommer comme bon vous semble. * **Lien de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un lien vers un site externe à l'auteur. * **Titre de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant un titre. * **Description de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant une description. * **Couleur de l'embed :** Vous pouvez choisir une couleur pour personnaliser votre embed à l'aide du sélécteur. * **Lien de la vignette de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une vignette. * **Lien de l'image de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une image. * **Icône du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide d'une image de footer. * **Texte du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide du footer. ## :camera: Configuration embed·s ### Créer un embed Avant de commencer à configurer votre ou vos embeds, vous devez d'abord les créer. Pour ce faire, cliquez simplement sur le bouton `Créer un embed` situé sous les paramètres des panneaux. ### Dupliquer un embed Vous pouvez également créer un embed à partir d'un embed existant pour conserver les mêmes paramètres et le personnaliser. Cela vous évite de devoir reconfigurer tous les paramètres pour une différence mineure entre les deux embeds. Pour ce faire, cliquez simplement sur le bouton `Dupliquer` correspondant à l'embed souhaité et validez votre choix via la fenêtre qui apparaît. ### Modifier un embed Pour modifier les paramètres d'un embed existant, cliquez simplement sur le bouton `Modifier` correspondant à l'embed souhaité. ### Supprimer un embed Pour supprimer un embed existant, cliquez simplement sur le bouton `Supprimer` correspondant à l'embed souhaité et confirmez votre choix via la fenêtre qui apparaît. ### Configurer un embed Une fois dans les paramètres d'un embed, vous pouvez configurer de nombreuses options pour personnaliser le système selon vos besoins. Une fois les configurations terminées, il vous suffit de cliquer sur le bouton vert `Enregistrer` situé en bas à droite de la fenêtre de configuration. Si vous ne souhaitez pas conserver vos modifications, cliquez simplement sur `Annuler`. #### Salon d'envoi de l'embed Dans ce champ, définissez dans quel salon votre embed sera envoyé en utilisant le menu de sélection associé. #### Panneaux liés à l'embed Choisissez quels seront les panneaux avec lesquels les membres pourront ouvrir un ticket. Organisez vos panneaux dans l'ordre que vous souhaitez, ils apparaîtront de la même manière sur l'embed. Pour cela, sélectionnez votre ou vos panneau(x) à l'aide du sélecteur associé. #### Personnalisation * **Icône de l'auteur de l'embed** :gem: **:** Vous pouvez illustrer votre embed en ajoutant une image (qui peut être animée) à votre auteur, uniquement visible lorsque l'auteur a un nom. * **Nom de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un auteur, que vous pouvez nommer comme bon vous semble. * **Lien de l'auteur de l'embed** :gem: **:** Vous pouvez personnaliser votre embed en ajoutant un lien vers un site externe à l'auteur. * **Titre de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant un titre. * **Style d'affichage des panneaux :** Vous pouvez choisir le style d'affichage des panneaux en sélectionnant l'option souhaitée. * **Description de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant une description. * **Couleur de l'embed :** Vous pouvez choisir une couleur pour personnaliser votre embed à l'aide du sélecteur. * **Lien de la vignette de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une vignette. * **Lien de l'image de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une image. * **Icône du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide d'une image de footer. Par défaut, l'image sera la photo de profil du bot. * **Texte du footer de l'embed** :gem: **:** Vous pouvez compléter votre embed à l'aide du footer. Par défaut, il sera `Propulsé par johnbot.app`. ### Envoyer un embed Une fois votre configuration terminée, vous pouvez publier votre embed en l'envoyant dans le salon défini préalablement. Pour ce faire, cliquez sur le bouton `Envoyer l'embed` associé à l'embed choisi. ## :bookmark\_tabs: Configuration modèle·s Un modèle est un formulaire qui sera proposé au membre via une pop-up native à Discord pour lui permettre de répondre à jusqu'à 5 questions, pour préciser le sujet du ticket. Les résultats des réponses seront joints à un embed au message d'ouverture du ticket. ![Exemple de modèle](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-6ad6ef822292a707df105c65a51a958ba7941872%2Fticket_modele_example.png?alt=media) ### Créer un modèle Avant de commencer à configurer votre ou vos modèle·s, vous devez les créer. Pour cela, cliquez simplement sur le bouton `Créer un modèle` situé sous les paramètres des embeds. ### Dupliquer un modèle Vous pouvez également créer un modèle à partir d'un déjà existant pour retrouver exactement les mêmes paramètres et le personnaliser. Cela permet d'éviter de devoir reconfigurer tous les paramètres pour une différence mineure entre les deux modèles. Pour cela, cliquez simplement sur le bouton `Dupliquer` correspondant au modèle souhaité et validez votre choix via la fenêtre qui apparaît. ### Modifier un modèle Pour modifier les paramètres d'un modèle existant, cliquez simplement sur le bouton `Modifier` correspondant au modèle souhaité. ### Supprimer un modèle Pour supprimer un modèle existant, cliquez simplement sur le bouton `Supprimer` correspondant au modèle souhaité et validez votre choix via la fenêtre qui apparaît. ### Configurer un modèle Une fois dans les paramètres d'un modèle, vous pouvez ajouter jusqu'à 5 questions selon vos besoins et définir quelques paramètres.\ Une fois les configurations terminées, il vous suffit de cliquer sur le bouton vert `Enregistrer` situé en bas à droite de la fenêtre de configuration. Si vous ne souhaitez pas conserver vos modifications, cliquez simplement sur `Annuler`. #### Titre du modèle Dans ce champ, vous pouvez définir un titre au modèle. Celui-ci permet de vous aider à vous organiser mais est également affiché en haut de la pop-up. ![Exemple de modèle avec le titre mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-c732a2ae52847a5dada065ec8d943775251d179d%2Fticket_modele_titre.png?alt=media) #### Configuration des questions Pour chaque question, vous pouvez personnaliser certains éléments esthétiques et réorganiser vos questions entre elles. Pour créer une nouvelle question, cliquez sur le bouton `+`, situé en dessous de la liste des questions. Pour supprimer une question existante, cliquez sur le bouton rouge `Supprimer` situé en bas à droite de la question correspondante. * **Label de la zone de texte :** Le label de la zone de texte correspond à la question posée (n°1 sur l'image). * **Style de la zone de texte :** En définissant le style de la zone de texte (n°2 sur l'image), choisissez si le membre pourra répondre dans un champ large ou plus court. Cela ne change rien à la limite de caractères qui sera de 1024 pour les deux. * **Placeholder de la zone de texte :** Le placeholder est le texte affiché en transparence dans le champ de réponse, pas dessus lequel le membre va écrire (n°3) sur l'image. * **Question obligatoire :** Vous pouvez définir si la question doit obligatoirement être remplie par le membre ou s'il pourra soumettre le formulaire sans y répondre (n°4 sur l'image). Si la question n'a pas de réponse, la formule `Aucun Objet` sera à la place de la réponse. ![Exemple de modèle avec les éléments personnalisables mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b7647916bbc0b56404897c72aeaefe2963f30f65%2Fticket_modele_example%20aide.png?alt=media) {% hint style="info" %} Une fois votre modèle configuré, n'oubliez pas de le lier au panneau de votre choix : [Modèle lié au panneau, configurer un panneau](#modèle-lié-au-panneau) {% endhint %} ## :wrench: Liste des commandes | Commande | Description | Exemple | | --------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /ticket add | Ajoute un membre au ticket. | ![Commande /ticket add](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-abc3f6a3ada13135e69f8af37ad228280ffd405c%2Fticket_command_add.png?alt=media) | | /ticket claim | Assigne un membre de l'équipe d'assistance au traitement du ticket. | ![Commande /ticket claim](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-234fe3e9cc28a3d40ba02009bcf48d287ff428b5%2Fticket_command_claim.png?alt=media) | | /ticket close | Ferme le ticket. | ![Commande /ticket close](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-e2c9c90ce2571e272202c78b6625f5374c41932e%2Fticket_command_close.png?alt=media) | | /ticket close-request | Demande la fermeture du ticket. | ![Commande /ticket close-request](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-2899d871ffb6b8d0501935202f4101358415eb35%2Fticket_command_close%20request.png?alt=media) | | /ticket create | Crée un ticket. | ![Commande /ticket create](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b961e457eba72a2a49ad58ead5d75bdf776bbad9%2Fticket_command_create.png?alt=media) | | /ticket delete | Supprime un ticket fermé. | | | /ticket open | Ouvre un ticket fermé. | ![Commande /ticket open](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-c87950cc8aec5e8934310a262af31010846336d3%2Fticket_command_open.png?alt=media) | | /ticket remove | Retire un membre du ticket. | ![Commande /ticket remove](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-50fcb12e8f8cf7276cd5c9dfc8f2c97cc63e4328%2Fticket_command_remove.png?alt=media) | | /ticket rename | Renomme le ticket. | ![Commande /ticket rename](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-4b36f2c99d8a7d0d4cf006cfca1b78d685c06e9a%2Fticket_command_rename.png?alt=media) | | /ticket transfer | Transfert l'assignation du ticket à un autre membre de l'équipe d'assistance. | ![Commande /ticket transfer](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-aafe879c4e848f0b8af7df677272992ae384cf98%2Fticket_command_transfer.png?alt=media) | | /ticket unclaim | Retire l'assignation du ticket au traitant. | ![Commande /ticket unclaim](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-60e914c4b6b97eb168941b0d2955b2be9e85107c%2Fticket_command_unclaim.png?alt=media) | *** 1 : Découvrir ce qu'est le Markdown : [Markdown de Texte 101 (Formatage du chat : gras, italique, souligné)](https://support.discord.com/hc/fr/articles/210298617-Markdown-de-Texte-101-Formatage-du-chat-gras-italique-soulign%C3%A9) # Auto-modération Découvrez ici comment configurer le système de modération automatique de John-Bot ! **Tutoriel vidéo lié à cette page :** [Modérer efficacement son serveur avec John-Bot - Tutoriel #5](https://jnbt.xyz/fr/tutorials/moderation) ### :rocket: Introduction Un système d’auto-modération sur Discord est un outil indispensable pour maintenir un environnement sain et sécurisé sans nécessiter une surveillance humaine constante. Il permet de définir des règles précises que John-Bot appliquera automatiquement en fonction des comportements détectés sur le serveur. Le système d’automodération de John-Bot s’articule autour de trois catégories principales : les auto sanctions ; les signalements et les logs de modération. Vous pourrez également personnaliser de nombreux paramètres pour adapter le système à vos besoins : choix des sanctions, configuration des seuils de détection (par exemple, nombre de messages répétés en un temps limité), salons exclus, ou encore la présentation des signalements et logs. ### :tools: Accéder aux paramètres du système Pour commencer, accédez au tableau de bord de John-Bot en utilisant la méthode de votre choix. Pour savoir comment faire, consultez ce guide : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord). Ensuite, cherchez `Modération` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez accéder à tous les paramètres relatifs au système de modération automatique. ### :hammer: Les sanctions automatiques Pour créer votre première sanction automatique, vous devez en définir les différents paramètres. Lorsqu’un membre atteint un certain nombre d’avertissements, John-Bot appliquera automatiquement la sanction prévue à son encontre. #### Choix de la sanction Vous devez d’abord choisir une sanction qui sera appliquée automatiquement par John-Bot lorsqu’un membre aura atteint un certain seuil d’avertissements. Pour cela, sélectionnez celle que vous souhaitez dans la liste et complétez éventuellement avec une durée si nécessaire. Une sanction peut prendre plusieurs formes et nécessiter une précision de durée. Voici la liste exhaustive des sanctions que John-Bot peut appliquer : * Avertir : le membre reçoit un message privé l’informant de son avertissement. John-Bot conserve une trace de cet avertissement, accessible via la commande `/warnings list` ou dans les logs. * Réduire au silence : le membre est totalement censuré sur le serveur pendant une durée déterminée (maximum 28 jours consécutifs). Il ne pourra ni envoyer de messages, ni rejoindre les salons vocaux, ni réagir, ni interagir d’aucune manière. Toutefois, il pourra toujours consulter les messages du serveur. * Expulser : le membre est éjecté du serveur, mais pas définitivement. Il peut le rejoindre à nouveau à tout moment s’il dispose d’une invitation ou si le serveur est public. * Bannir : le membre est éjecté du serveur de façon définitive et ne peut plus le rejoindre, sauf si un modérateur choisit de lever le bannissement avec la commande `/unban`. * Bannir temporairement : identique à un bannissement classique, mais limité dans le temps. Après une durée définie (maximum 365 jours consécutifs), l’utilisateur peut rejoindre à nouveau le serveur s’il possède une invitation ou si le serveur est public. #### Choix des conditions Pour que la sanction sélectionnée précédemment s’applique, un membre du serveur devra avoir accumulé un certain nombre d’avertissements, qu’ils soient appliqués automatiquement par John-Bot ou manuellement par des modérateurs. Vous pouvez définir le nombre d’avertissements à accumuler sur une période donnée pour déclencher la sanction automatique. ### 🚨 Signalements Le salon de réception global des logs permet d'accueillir un grand nombre d'événements au même endroit. Vous devez d'abord définir le salon de réception global dans le champ correspondant. Vous pouvez ensuite choisir les événements qui seront envoyés dans ce salon en cochant les cases associées dans la liste sous la `configuration globale de la couleur des embeds du système`. Si vous souhaitez activer tous les événements, cachez simplement la case `Activer ou désactiver tous les événements`. ### Salon⸱s ignoré⸱s Toutes les actions effectuées dans les salons ignorés ne seront pas répertoriées dans les logs, tous les événements confondus. Pour définir un ou plusieurs salons ignorés, sélectionnez-en parmi la liste dans le champ correspondant. ### Couleur globale :gem: Cette option vous permet de définir la couleur des embeds de logs qui seront envoyés sur le serveur. Pour ce faire, sélectionnez la couleur souhaitée parmi les 6 propositions ou à l'aide du sélecteur de couleurs. ### Salons spécialisés Pour chaque événement du système, vous pouvez définir un salon spécifique. Pour cela, choisissez l'événement que vous souhaitez et définissez un salon à l'aide du menu déroulant correspondant. {% hint style="warning" %} Si le salon de réception global est configuré sur le même salon qu'un ou plusieurs événements spécifiques, les messages de logs seront envoyés en double. {% endhint %} # Logs Ici, vous trouverez des informations relatives à la configuration du système de logs de John-Bot. **Tutoriel vidéo lié à cette page :** [Configurer le système de logs de John-Bot - Tutoriel #6](https://jnbt.xyz/fr/tutorials/logs) ### :rocket: Introduction Un système de logs sur Discord est un outil essentiel pour surveiller et enregistrer les activités qui se produisent sur un serveur Discord. Il permet d'enregistrer dans des salons du serveur toutes les activités relatives aux messages, aux rôles, au serveur, aux arrivées et départs, aux mises à jour des membres, à la modération, aux salons, aux emojis, aux threads (fils) et aux activités dans les salons vocaux.\ John-Bot permet de choisir un salon où tous les logs confondus seront envoyés mais permet également de spécialiser certains salons pour certains systèmes. Vous pourrez également personnaliser de nombreux éléments pour que votre système soit le plus utile et pratique possible, tels que la couleur, les événements du salon de réception globale et même des salons ignorés par le système. ![Exemple d'un système de logs sur un serveur Discord](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-fb0a3c58c6b3d0091f10dee164c2e7dd03146397%2Flogs_example.png?alt=media) ### :tools: Configurer le système #### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) #### Accéder aux paramètres Ensuite, cherchez `Logs` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez accéder à tous les paramètres relatifs au système de logs. #### Activer le système Pour dévoiler les paramètres du système, vous devez activer ce dernier à l'aide du bouton associé. #### Salon de réception global Le salon de réception global des logs permet d'accueillir un grand nombre d'événements au même endroit. Vous devez d'abord définir le salon de réception global dans le champ correspondant. Vous pouvez ensuite choisir les événements qui seront envoyés dans ce salon en cochant les cases associées dans la liste sous la `configuration globale de la couleur des embeds du système`. Si vous souhaitez activer tous les événements, cachez simplement la case `Activer ou désactiver tous les événements`. #### Salon⸱s ignoré⸱s Toutes les actions effectuées dans les salons ignorés ne seront pas répertoriées dans les logs, tous les événements confondus. Pour définir un ou plusieurs salons ignorés, sélectionnez-en parmi la liste dans le champ correspondant. #### Couleur globale :gem: Cette option vous permet de définir la couleur des embeds de logs qui seront envoyés sur le serveur. Pour ce faire, sélectionnez la couleur souhaitée parmi les 6 propositions ou à l'aide du sélecteur de couleurs. ![Exemple d'un message de logs sur un serveur Discord avec la couleur de l'embed mise en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-1d0ab567b3c33a6e726da4df82eceb8f6b394b9f%2Flogs_color_exeample.png?alt=media) #### Salons spécialisés Pour chaque événement du système, vous pouvez définir un salon spécifique. Pour cela, choisissez l'événement que vous souhaitez et définissez un salon à l'aide du menu déroulant correspondant. {% hint style="warning" %} Si le salon de réception global est configuré sur le même salon qu'un ou plusieurs événements spécifiques, les messages de logs seront envoyés en double. {% endhint %} # Langue Ici, vous trouverez des informations sur la configuration de la langue d'affichage de John-Bot. **Tutoriel vidéo lié à cette page :** [Préparer son serveur à la configuration de John-Bot (prérequis) - Tutoriel #2](https://jnbt.xyz/fr/tutorials/start) ## :rocket: Introduction En fonction de votre serveur, vous pouvez définir la langue dans laquelle John-Bot interagira. Vous pouvez également changer la langue dans laquelle le site web est affiché. ## :robot: Serveur #### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) #### Accéder aux paramètres Ensuite, cherchez `Paramètres` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez accéder à tous les paramètres généraux relatifs au serveur. #### Définir la langue Une fois dans la catégorie `Paramètres`, cherchez l'option `Langue`. Définissez la langue de votre choix à l'aide du menu déroulant associé. {% hint style="warning" %} À l'heure actuelle, l'ensemble des systèmes de John-Bot n'est disponible qu'en deux langues : le français et l'anglais. {% endhint %} {% hint style="warning" %} John-Bot est traduit par des gens comme vous, bénévoles sur leur temps libre, qui contribuent à une internationalisation des ressources du monde. Rejoignez-les : [Projet Crowdin](https://crowdin.johnbot.app/)\ Si vous remarquez une erreur de traduction, contactez-nous ou corrigez-la directement. [Contacter l'équipe de John-Bot](/contact) {% endhint %} ## :globe\_with\_meridians: Site web Les marches à suivre pour modifier la langue d'affichage de tout le site web (tableau de bord inclus) diffèrent en fonction du type de votre appareil. ### Ordinateur de bureau Sur ordinateur, cliquez sur le bouton en haut à droite du site web et sélectionnez votre langue à l'aide du menu déroulant. Si vous êtes sur le tableau de bord, cliquez sur votre photo de profil et sélectionnez `Langue`. ### Mobile Sur mobile, cliquez sur le bouton en haut à droite du site web et sélectionnez votre langue dans le menu déroulant. Si vous êtes sur le tableau de bord, cliquez sur votre photo de profil et sélectionnez `Langue`. {% hint style="warning" %} À l'heure actuelle, l'ensemble des systèmes de John-Bot n'est disponible qu'en deux langues : le français et l'anglais. {% endhint %} {% hint style="warning" %} John-Bot est traduit par des gens comme vous, bénévoles sur leur temps libre, qui contribuent à une internationalisation des ressources du monde. Rejoignez-les : [Projet Crowdin](https://crowdin.johnbot.app/)\ Si vous remarquez une erreur de traduction, contactez-nous ou corrigez-la directement. [Contacter l'équipe de John-Bot](/contact) {% endhint %} # Niveaux Ici, vous trouverez des informations sur la configuration du système de niveaux évolutifs de John-Bot. **Tutoriel vidéo lié à cette page :** [Configurer le système de niveaux de John-Bot - Tutoriel #7](https://jnbt.xyz/fr/tutorials/levels) ## :rocket: Introduction Pour maintenir une activité constante sur un serveur Discord, la méthode la plus recommandée est de récompenser ses membres avec notamment des niveaux et grades. En se basant sur ce système, John-Bot propose une version évoluée avec des niveaux acquis avec des points d'expérience et l'attribution de récompenses virtuelles via des rôles lorsque des paliers précis sont atteints. ## :tools: Configurer le système ### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/configuration/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) ### Accéder aux paramètres Ensuite, cherchez `Niveaux` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez accéder à tous les paramètres relatifs au système de niveaux. ### Importer depuis une autre application Si vous utilisez actuellement une autre application pour gérer le système de niveaux sur votre serveur, vous pouvez importer toutes vos données en quelques instants à l'aide d'une simple commande¹. À l'heure actuelle, seule l'application MEE6 est supportée mais cette fonctionnalité pourra évoluer en s'étendant à d'autres applications.
Importer depuis MEE6 Avant d'entrer la commande permettant d'importer vos données de niveaux depuis MEE6, vous devez rendre public le classement de votre serveur. * Pour ce faire, accédez au classement de votre serveur avec la commande `/levels` via l'application MEE6. Connectez-vous ensuite à votre compte Discord sur le site de MEE6 et cliquez sur le bouton `Paramètres`, situé en haut à droite de la page. * Une fois sur la page des paramètres du classement de votre serveur, activez l'option `Rendre public le classement de mon serveur`, située en haut de la page. Enfin, enregistrez vos modifications. Option "Rendre public le classement de mon serveur" sur le site web de MEE6 Ensuite, rendez-vous sur votre serveur et entrez la commande `/xp import` avec John-Bot, puis confirmez le remplacement des données actuelles par celles de MEE6. Assurez-vous que le système de niveaux de John-Bot est correctement activé et configuré. L'importation ne concerne que les données de niveaux, sans inclure la personnalisation des annonces ou d'autres éléments.
## :earth\_africa: Système global Le système de niveaux fonctionne avec de l'expérience acquérable lors de l'envoi d'un message ou d'une minute passée dans un salon vocal. Il est possible de définir la quantité de points d'expérience gagnée par message ou minute ainsi qu'un taux. Un niveau correspond à un palier, atteignable en accumulant un nombre précis d'unités d'expérience. Le détail du fonctionnement pour acquérir de l'expérience, ainsi que l'expérience nécessaire pour débloquer un niveau, est disponible dans [la sous-page liée à cette page](/configuration/levels/levels-xp). ### Annonce de passage de niveau Lorsqu'un nouveau niveau est débloqué, John-Bot permet d'envoyer instantanément une annonce personnalisée dans un salon défini. * **Activer l'annonce :** Pour activer l'annonce de passage de niveau, cochez cette option. * **Activer l'image :** Avec chaque annonce, une image à l'effigie du membre est générée, indiquant également le niveau atteint à cet instant.

Image d'une annonce de passage de niveau

* **Choix du salon :** Vous pouvez choisir d'envoyer l'annonce de passage de niveau dans le dernier salon où le membre a envoyé un message² en sélectionnant `Dans le salon actuel` via le menu déroulant, ou d'envoyer l'annonce dans un salon précis, toujours le même pour chaque annonce, en sélectionnant `Dans un salon personnalisé` via le menu déroulant, puis en définissant le salon à l'aide du second menu déroulant apparu plus bas ou sur la droite, selon votre appareil. * **Message de passage de niveau :** En plus de l'image de passage de niveau, vous pouvez ajouter un message personnalisé, compatible avec [les variables de niveau](/ressources/variables#variable-de-niveaux). ### Options supplémentaires **Ratio d'expérience** Cette option permet de définir la quantité de points d'expérience attribuée à un membre par message ou par minute passée en vocal. Vous pouvez choisir une tranche à l'aide du menu déroulant, la quantité exacte sera déterminée aléatoirement. **Niveau maximum** :gem: Vous pouvez définir un niveau maximal qui empêchera les membres ayant atteint ce niveau de gagner davantage d'expérience. Pour désactiver l'option, indiquez `0`. **Expérience en vocal** :gem: En activant cette option vous autorisez vos membres à gagner des points d'experience en vocal, à condition d'être au moins deux membres humains dans le salon vocal. **Perte des niveaux lors du départ** Avec cette option activée, si un membre quitte le serveur, son expérience sera réinitialisée. **Pas de gain d'experience en ticket** Avec cette option activée, aucun point d'expérience ne sera attribué aux membres envoyant des messages dans des tickets.³ **Taux d'experience** :gem: Si vous souhaitez augmenter l'expérience gagnée pour faciliter l'accès aux niveaux supérieurs, vous pouvez choisir d'attribuer des points d'expérience jusqu'à 3 fois plus rapidement. ### Rôles et salons spéciaux * **Rôles et salons bonus :** Vous pouvez définir des rôles et des salons dans lesquels les messages envoyés ou les minutes passées en vocal rapportent plus de points d'expérience. Vous pouvez ajuster le facteur de bonus⁴ en cliquant sur le nombre situé avant le nom du rôle ou du salon. * **Rôles et salons sans gain :** Vous pouvez définir des rôles et des salons dans lesquels les messages envoyés ou les minutes passées en vocal ne rapportent aucune expérience. ## :dart: Récompenses Pour encourager les membres à atteindre les niveaux supérieurs, vous pouvez définir des récompenses déblocables sous forme de rôles lorsqu'un membre atteint un niveau précis. ### Annonce de récompense débloquée Lorsqu'un nouveau niveau est atteint et qu'une récompense est débloquée, John-Bot permet d'envoyer instantanément une annonce personnalisée dans un salon défini. * **Activer l'annonce :** Pour activer l'annonce de récompense débloquée, cochez cette option. * **Activer l'image :** Avec chaque annonce, une image à l'effigie du membre est générée, indiquant également la récompense débloquée.

Image d'une aannonce de récompense débloquée

* **Choix du salon :** Vous pouvez choisir d'envoyer l'annonce de récompense débloquée dans le dernier salon où le membre a envoyé un message² en sélectionnant `Dans le salon actuel` via le menu déroulant, ou d'envoyer l'annonce dans un salon précis, toujours le même pour chaque annonce, en sélectionnant `Dans un salon personnalisé` via le menu déroulant, puis en définissant le salon à l'aide du second menu déroulant apparu plus bas ou sur la droite, selon votre appareil. * **Message de récompense débloquée :** En plus de l'image de récompense débloquée, vous pouvez ajouter un message personnalisé, compatible avec [les variables de niveau](/ressources/variables#variable-de-niveaux). ### Type de rôles récompenses :gem: Les rôles récompense sont attribués lorsqu'un membre atteint le niveau requis. Vous pouvez choisir qu'un membre ne puisse avoir qu'un seul rôle récompense à la fois sur son profil en séléctionnant `Rôles récompenses évolutifs`. Lorsqu'une nouvelle récompense est débloquée, le rôle actuel sera retiré du profil du membre et remplacé par le nouveau rôle débloqué. Si vous souhaitez que le membre accumule les rôles, sélectionnez `Rôles récompenses cumulables`. ### Configuration des récompenses Pour créer une récompense, cliquez sur le bouton situé en bas de la page et définissez les deux paramètres suivants : * **Niveau requis :** Définissez le niveau requis pour débloquer cette récompense en l'indiquant dans le champ prévu à cet effet. * **Rôles récompense :** Définissez le rôle qui sera attribué en guise de récompense lorsque le membre atteindra le niveau requis en le sélectionnant à l'aide du menu déroulant correspondant. ## :bar\_chart: Classement (leaderboard) Le classement de votre serveur répertorie les membres par ordre décroissant de leurs points d'expérience, permettant de connaître leur niveau et la quantité de points d'expérience accumulée.\ \ Il est accessible via la commande `leaderboard`, qui affiche les dix premiers du classement, une version complète est disponible en ligne.
Exemple de classement avec la commande /leaderboard Exemple de classement avec la commande /leaderboard
Exemple de classement complet en ligne Exemple de classement complet en ligne
### Accéder au classement du serveur Vous pouvez accéder au classement complet disponible en ligne de deux manières : * **URL complète :** L'adresse web (URL) du classement d'un serveur est composée ainsi : `https://www.johnbot.app/leaderboard/serverid`. Il suffit de remplacer la variable `serverid` par l'identifiant⁵ de votre serveur. * **Lien via une commande :** Vous pouvez obtenir ce lien facilement à l'aide de la commande `/leaderboard`. ![Mise en évidence du lien de la version complète en ligne sur la commande /leaderboard](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-633b4ca140f2cfc6553a327e1de719fbbab45ac5%2Flevels_leaderboard_link.png?alt=media) ## :wrench: Liste des commandes | Commande | Description | Exemple | | --------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /leaderboard | Affiche le classement des niveaux des membres du serveur. | ![Commande /leaderboard](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-52b3070eb58e3680f868dd89d0788da2d0e90b68%2Flevels_leaderboard_exemple.png?alt=media) | | /rank ou /level | Affiche votre niveau ou celui d'un membre. | ![Commande /rank ou /level](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-454cf047e9b7609fd7d5a96a079aaf08b4ddd029%2Flevels_commande_rank.png?alt=media) | | /xp add | Ajoute de l'expérience à un membre. | ![Commande /xp add](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-22f8b705d17c99335f4b1d7e00af0cd24ea6fbd4%2Flevels_commande_xp%20add.png?alt=media) | | /xp remove | Retire de l'expérience à un membre. | ![Commande /xp remove](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-2725d587892a60fe360cdae711cc76872eafadf8%2Flevels_commande_xp%20remove.png?alt=media) | | /xp import | Importe les données de niveaux d'autres robots. | | | /xp reset | Réinitialise les données de niveaux d'un membre ou de tous les membres du serveur. | ![Commande /xp reset](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-2af1e51a701d9039ab2bd0ce88266a3c01241914%2Flevels_commande_xp%20reset.png?alt=media) | | /xp user | Affiche le nombre total d'expérience d'un membre et son niveau. | ![Commande /ticket open](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-4348731232f4f6eaa9b6f8c793c8070cfb3def79%2Flevels_commande_xp%20user.png?alt=media) | | /rewards | Affiche la liste des récompenses pouvant être débloquées avec le système de niveaux. | ![Commande /ticket remove](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-f1eec617fabb1881915287036119d0abf58de94c%2Flevels_commande_rewards.png?alt=media) | *** 1 : sous réserve de disponibilité de l'application en question\ 2 : Le message sera envoyé dans la discussion du salon vocal si le membre passe au niveau supérieur dans un salon vocal\ 3 : les tickets doivent être gérés avec le [système de tickets](/configuration/tickets) de John-Bot\ 4 : seulement parmis les nombres suivants `1,5 ; 2 ; 2,5 ; 3`\ 5 : Trouver l'identifiant de votre serveur : [Où trouver l’ID de mon compte utilisateur / serveur / message ?](https://support.discord.com/hc/fr/articles/206346498-O%C3%B9-trouver-l-ID-de-mon-compte-utilisateur-serveur-message) # Experience Cette page explique comment est calculée l'expérience nécessaire pour atteindre chaque niveau. {% hint style="info" %} La plupart des informations de cette page sont extraites de la [documentation de MEE6 disponible sur GitHub](https://github.com/Mee6/Mee6-documentation), notamment de la [page docs/levels\_xp.md](https://github.com/Mee6/Mee6-documentation/blob/master/docs/levels_xp.md). {% endhint %} ### Calculer l'expérience nécessaire pour atteindre le niveau supérieur La formule suivante est utilisée : `5 * (lvl ^ 2) + (50 * lvl) + 100 - xp` Pour : * `lvl` : niveau actuel * `xp` : experience actuelle ### Experience nécessaire par niveau {% hint style="warning" %} Dans ce tableau ne sont réprésentés que les 100 premiers niveaux, John-Bot pouvant traiter les niveaux jusqu'au neuf mille neuf cent quatre-vingt-dix-neuvième. {% endhint %} | Niveau | Experience | | ------ | ---------- | | 0 | 0 | | 1 | 100 | | 2 | 255 | | 3 | 475 | | 4 | 770 | | 5 | 1 150 | | 6 | 1 625 | | 7 | 2 205 | | 8 | 2 900 | | 9 | 3 720 | | 10 | 4 675 | | 11 | 5 775 | | 12 | 7 030 | | 13 | 8 450 | | 14 | 10 045 | | 15 | 11 825 | | 16 | 13 800 | | 17 | 15 980 | | 18 | 18 375 | | 19 | 20 995 | | 20 | 23 850 | | 21 | 26 950 | | 22 | 30 305 | | 23 | 33 925 | | 24 | 37 820 | | 25 | 42 000 | | 26 | 46 475 | | 27 | 51 255 | | 28 | 56 350 | | 29 | 61 770 | | 30 | 67 525 | | 31 | 73 625 | | 32 | 80 080 | | 33 | 86 900 | | 34 | 94 095 | | 35 | 101 675 | | 36 | 109 650 | | 37 | 118 030 | | 38 | 126 825 | | 39 | 136 045 | | 40 | 145 700 | | 41 | 155 800 | | 42 | 166 355 | | 43 | 177 375 | | 44 | 188 870 | | 45 | 200 850 | | 46 | 213 325 | | 47 | 226 305 | | 48 | 239 800 | | 49 | 253 820 | | 50 | 268 375 | | 51 | 283 475 | | 52 | 299 130 | | 53 | 315 350 | | 54 | 332 145 | | 55 | 349 525 | | 56 | 367 500 | | 57 | 386 080 | | 58 | 405 275 | | 59 | 425 095 | | 60 | 445 550 | | 61 | 466 650 | | 62 | 488 405 | | 63 | 510 825 | | 64 | 533 920 | | 65 | 557 700 | | 66 | 582 175 | | 67 | 607 355 | | 68 | 633 250 | | 69 | 659 870 | | 70 | 687 225 | | 71 | 715 325 | | 72 | 744 180 | | 73 | 773 800 | | 74 | 804 195 | | 75 | 835 375 | | 76 | 867 350 | | 77 | 900 130 | | 78 | 933 725 | | 79 | 968 145 | | 80 | 1 003 400 | | 81 | 1 039 500 | | 82 | 1 076 455 | | 83 | 1 114 275 | | 84 | 1 152 970 | | 85 | 1 192 550 | | 86 | 1 233 025 | | 87 | 1 274 405 | | 88 | 1 316 700 | | 89 | 1 359 920 | | 90 | 1 404 075 | | 91 | 1 449 175 | | 92 | 1 495 230 | | 93 | 1 542 250 | | 94 | 1 590 245 | | 95 | 1 639 225 | | 96 | 1 689 200 | | 97 | 1 740 180 | | 98 | 1 792 175 | | 99 | 1 845 195 | | 100 | 1 899 250 | # Information Ici, vous trouverez la liste et la description de toutes les commandes d'information de John-Bot. ## :rocket: Introduction Si vous souhaitez obtenir des informations sur un serveur, un utilisateur... ou encore la photo ou bannière de n'importe quel utilisateur ou serveur et bien plus, les commandes d'information de John-Bot sont là pour vous ! Découvrez l'intégralité de ces commandes décrites précisement sur cette page. ## :clipboard: Liste des commandes | Commande | Description | Exemple | | --------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /bot-info | Affiche quelques informations sur John-Bot. | ![Commande /bot-info](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-46ee8fe5e6c1ef1d99a0f83e449f2cc04a4a0bd6%2Finformation_command_bot-info.png?alt=media) | | /user avatar | Affiche l'avatar d'un utilisateur. | ![Commande /user avatar](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-a553001f73a8f6da0f97be4999644be83858ea58%2Finformation_command_user%20avatar.png?alt=media) | | /user banner | Affiche la bannière d'un utilisateur. | ![Commande /user banner](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-5cdb64f3928250b172bc07dbcb29cb853e96203b%2Finformation_command_user%20banner.png?alt=media) | | /user info | Affiche quelques informations sur un utilisateur. | ![Commande /user info](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-9ea27f46d8012db06741d9be6693e76560b8a5ed%2Finformation_command_user%20info.png?alt=media) | | /server icon | Affiche l'icône du serveur. | ![Commande /server icon](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-c776bf3885d738b0738d952c69cfa79b416a7816%2Finformation_command_server%20icon.png?alt=media) | | /server banner | Affiche la bannière du serveur. | ![Commande /server banner](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-29c50c44f3bbe12256a6db8f98ae068fe8c27e6f%2Finformation_command_server%20banner.png?alt=media) | | /server info | Affiche quelques informations sur le serveur. | ![Commande /server info](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-83899accfd61a39498acef3cdf3362f6751a97d6%2Finformation_command_server%20info.png?alt=media) | | /server members | Affiche quelques informations sur les membres du serveur. | ![Commande /server members](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-f0dcf8eafefdf353edac3d0cbf79e851ae738abc%2Finformation_command_server%20members.png?alt=media) | | /role info | Affiche quelques informations sur un rôle. | ![Commande /role info](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-8a8b58fd79897093a33cb26b4495edc8a42f1e4e%2Finformation_command_role%20info.png?alt=media) | | /role color | Affiche la couleur d'un rôle. | ![Commande /role color](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-eb33ecd98827a9572c813245ef402ec62153cb21%2Finformation_command_role%20color.png?alt=media) | | /channel-info | Affiche quelques informations sur un salon. | ![Commande /channel-info](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-c6ef1b4d20b8817fba0ce6a6fbfac78f0c0846e6%2Finformation_command_channel-info.png?alt=media) | | /ping | Affiche le temps de latence de John-Bot. | ![Commande /ping](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-34bb582782d6351d8c08d1382957f87d88952960%2Finformation_command_ping.png?alt=media) | | /status | Affiche le status des shards de John-Bot. | ![Commande /status](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b904c85b54b7d3c813b32ce69242755874902dad%2Finformation_command_status.png?alt=media) | | /uptime | Affiche depuis combien de temps John-Bot est opérationnel. | ![Commande /uptime](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-9e2dfb7942021b2d612a00975837d7d9018f38ce%2Finformation_command_uptime.png?alt=media) | | /color | Affiche quelques informations sur une couleur. | ![Commande /color](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-4ad6b5d6cff5ceb5b57e6b67e6d1850606c2b71d%2Finformation_command_color.png?alt=media) | # Créateur de Messages Découvrez tout ce qu'il faut savoir sur le système de créateur de messages de John-Bot. Apprenez à le configurer et comprenez son fonctionnement. **Tutoriel vidéo lié à cette page :** [Créer et envoyer un embed modifiable sur Discord - Tutoriel #10](https://jnbt.xyz/fr/tutorials/embeds) ### :rocket: Introduction Le système de créateur de messages vous permet d'envoyer des messages au nom de John-Bot. Ces messages pourront être modifiés ultérieurement et enrichis avec diverses options qui ne sont pas disponibles directement dans l'application Discord pour un utilisateur classique. ### :tools: Accéder au Créateur de Messages Pour commencer, accédez au tableau de bord de John-Bot en utilisant la méthode de votre choix. Pour savoir comment faire, consultez ce guide : [Comment accéder au tableau de bord](https://help.johnbot.app/fonctionnalites/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord). Ensuite, cherchez l'option `Messages` dans la colonne de droite, située sous le logo et la bannière de votre serveur. Vous arriverez alors sur une page où vous pourrez accéder à tous les paramètres nécessaires pour la création de votre premier message. ### :pencil: Paramètres d'un messsage #### Créer un message Pour créer un nouveau message, utilisez le bouton situé au bas de la liste des messages déjà existants, ou en haut de la page si c'est votre premier. #### Dupliquer un embed Vous pouvez aussi créer un message à partir d'un message existant pour conserver les mêmes paramètres et le personnaliser en le dupliquant (aussi appelé le "copier-coller") . Cela vous évite de devoir reconfigurer tous les paramètres pour une différence minime entre les deux messages. Pour ce faire, il vous suffit de cliquer sur le bouton `Dupliquer` correspondant à l'embed souhaité et de valider votre choix via la fenêtre qui s'affiche. #### Modifier un message Pour ajuster les paramètres d'un message déjà existant, il vous suffit de cliquer sur le bouton `Modifier` associé au message de votre choix dans la liste. Vous accéderez ainsi directement aux paramètres du message sélectionné pour effectuer vos modifications. #### Supprimer un message Pour supprimer un messsage existant, cliquez simplement sur le bouton `Supprimer` correspondant au message souhaité et validez votre choix via la fenêtre qui apparaît. #### Modifier un message Une fois dans les paramètres d'un message, vous pouvez modifier de nombreuses options pour le personnaliser selon vos besoins. Une fois les configurations terminées, il vous suffit de cliquer sur le bouton vert `Enregistrer & modifier` situé en haut à droite de la fenêtre de configuration. Si vous ne souhaitez pas conserver vos modifications, cliquez simplement sur `Annuler`. #### Enregistrer et envoyer un embed Une fois vos modifications terminées, si votre message n'a jamais été envoyé, vous devez créer l'embed correspondant dans le salon défini au préalable. Pour ce fairen utilisez le bouton vert `Créer` situé en haut à droite. Vous devrez ensuite l'envoyer dans le salon défini au préalable avec le bouton `Envoyer`. #### Configuration d'un message **Nom du message** Le nom du message permet aux administrateurs du serveur de s'organiser dans le tableau de bord de John-Bot. Il ne sera pas visible par les membres. Pour le définir, écrivez-le dans le champ correspondant. **Salon d'envoi** Le salon d'envoi est le salon du serveur dans lequel sera envoyé le message. Pour le définir, choisissez le salon souhaité à l'aide du menu de sélection correspondant. **Type d'envoi** Vous avez le choix quant à la manière dont votre message sera envoyé. Sélectionnez simplement l'option qui correspond le mieux à vos besoins : * **Message à envoi unique** : Ce message ne sera envoyé qu'une seule fois et sera progressivement noyé parmi les autres messages du salon. * **Message persistant** : À chaque nouveau message posté dans le salon, John-Bot renverra votre message pour qu'il reste toujours visible et soit le dernier du salon. Si le message a déjà été envoyé auparavant, seule la version la plus récente sera conservée afin d'éviter de saturer le salon. **Message texte** Le message texte est le texte qui sera affiché hors de l'embed, comme un utilisateur Discord classique. Vous pouvez utiliser les emojis et le markdown¹ pour personnaliser votre texte. Pour désactiver le message texte, laissez le champ vide. ![Exemple de message avec le message texte mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-da6ce8c1b5ade60847fbf22a23d34da90aaaa1d6%2Fembed_message_partie%20texte.png?alt=media) **Embed** L'embed est la partie du message qui peut comporter plusieurs éléments personnalisables et qui sera affichée sous le message texte. Il est impossible à envoyer pour un utilisateur Discord classique. Vous pouvez utiliser les champs disponibles pour personnaliser votre embed. ![Exemple de message avec le message texte mis en évidence](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-bc3115b0b20b5cdb7e62261f44b621dd21ee250b%2Fembed_message_partie%20embed.png?alt=media) * **Icône de l'auteur de l'embed :** Vous pouvez illustrer votre embed en ajoutant une image (qui peut être animée) à votre auteur, uniquement visible lorsque l'auteur a un nom. * **Nom de l'auteur de l'embed :** Vous pouvez personnaliser votre embed en ajoutant un auteur, que vous pouvez nommer comme bon vous semble. * **Lien de l'auteur de l'embed :** Vous pouvez personnaliser votre embed en ajoutant un lien vers un site externe à l'auteur. * **Titre de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant un titre. * **Description de l'embed :** Vous pouvez personnaliser votre embed en y ajoutant une description. * **Couleur de l'embed :** Vous pouvez choisir une couleur pour personnaliser votre embed à l'aide du sélecteur. * **Lien de la vignette de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une vignette. * **Lien de l'image de l'embed :** Vous pouvez illustrer votre embed en y ajoutant une image. * **Icône du footer de l'embed :** Vous pouvez compléter votre embed à l'aide d'une image de footer. * **Texte du footer de l'embed :** Vous pouvez compléter votre embed à l'aide du footer. *** 1 : Découvrir ce qu'est le Markdown : [Markdown de Texte 101 (Formatage du chat : gras, italique, souligné)](https://support.discord.com/hc/fr/articles/210298617-Markdown-de-Texte-101-Formatage-du-chat-gras-italique-soulign%C3%A9) # Giveaway Ici, vous trouverez des informations sur la création et la configuration de giveaways ou concours. **Tutoriel vidéo lié à cette page :** [Organiser un giveaway sur son serveur avec John-Bot - Tutoriel #8](https://jnbt.xyz/fr/tutorials/giveaways) ## :rocket: Introduction Un giveaway est le moyen parfait pour récompenser vos membres en mettant en jeu un lot et en laissant le hasard décider. En effet, un giveaway est simplement un concours sous forme de loterie. Les participants peuvent s'inscrire via un simple bouton, et le tirage au sort est effectué au moment choisi. Il existe deux façons de créer un giveaway : l'une est rapide mais moins personnalisable, tandis que l'autre est plus personnalisable mais nécessite plus de temps et de précision. Choisissez celle qui vous convient le mieux en les comparant, et découvrez comment les mettre en place.\ Découvrez également comment interagir avec un giveaway pour y participer, ainsi que les commandes de gestion d'un giveaway. ## :zap: Méthode rapide et simple Si vous souhaitez créer un giveaway rapidement et efficacement, optez pour cette méthode. Tout d'abord, accédez au serveur dans lequel vous souhaitez lancer le giveaway. Assurez vous d'avoir la permission administrateur.\ Ensuite, entrez la commande /giveaway create. Vous aurez accès à plusieurs options : * Vous devez choisir la durée du giveaway, c'est-à-dire le laps de temps qui s'écoulera avant le tirage au sort automatique et l'annonce des résultats.\ Pour ce faire, entrez le nombre de seconde·s, de minute·s, d'heure·s ou de jour·s, suivis de l'unité (`s` pour seconde, `min` pour minute, `h` pour heure et `d` pour jour). * Vous devez choisir le nombre de gagnants qui seront sélectionnés pour recevoir la récompense mise en jeu. Entrez simplement un nombre entier supérieur à 0. * Vous devez choisir le prix que vous souhaitez mettre en jeu. Le champ est totalement libre ; entrez simplement le nom du prix, qu'il soit matériel, virtuel ou autre. * Enfin, vous pouvez choisir le salon dans lequel devra se dérouler le giveaway s'il diffère du salon dans lequel vous êtes en train d'entrer la commande pour paramétrer le giveaway. Cette option est donc facultative ; si vous la laissez vierge, le giveaway sera lancé directement dans le salon où la commande a été envoyée. ![Exemple d'une configuration avec la commande /giveaway create](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-66b7afbe001ff09edd9525f8348753035f8b5ad8%2Fgiveaway_command_create.png?alt=media) ## :tools: Méthode plus complète et personnalisable Si vous souhaitez créer un giveaway complexe et poussé en intégrant des éléments originaux, optez pour cette méthode. ### Accéder au tableau de bord Tout d'abord, rendez vous sur le tableau de bord de John-Bot par le moyen de votre choix. Découvrez comment faire : [Comment accéder au tableau de bord](https://help.johnbot.app/fonctionnalites/pages/blT5SObkUmBGxsiAFepy#pushpin-accéder-au-tableau-de-bord) ### Accéder aux paramètres Ensuite, cherchez `Giveaways` sur la colonne de droite, sous le logo et la bannière de votre serveur. Vous arrivez à présent sur une page où vous pouvez visualiser tous les giveaways de votre serveur, qu'ils soient terminés ou en cours. ### Créer et configurer Vous arrivez sur la page qui vous permettra de configurer votre giveaway. Voici comment configurer les différents paramètres : #### Nom Dans ce champ, choisissez le nom qui peut définir votre giveaway. Il sera affiché dans le titre du message envoyé ainsi que sur le tableau de bord pour pouvoir le repérer parmi les autres. #### Salon d'envoi Dans ce champ, choisissez où le giveaway sera envoyé et visible par les membres. Après l'envoi du giveaway, vous ne pourrez plus modifier le salon. #### Récompense Dans ce champ, choisissez le prix que vous souhaitez mettre en jeu. Le champ est totalement libre ; entrez simplement le nom du prix, qu'il soit matériel, virtuel ou autre. Il est impossible d'automatiser la distribution du gain, vous devrez vous en occuper manuellement. #### Date de fin Ce champ permet de définir la date et l'heure exacte du tirage au sort. À cette date, un message sera envoyé automatiquement en réponse au message originel du giveaway pour annoncer le ou les gagnant·s. #### Nombre de gagants Dans ce champ, définissez combien de membres pourront être déclarés vainqueurs de la récompense mise en jeu. #### Nombre maximum de participants :gem: Dans ce champ, vous pouvez choisir de limiter le nombre de membres qui peuvent s'inscrire au tirage au sort. #### Affichage de la liste des participants Vous pouvez désactiver l'affichage de la liste des participants en décochant la case associée. {% hint style="info" %} Découvrez comment fonctionne ce bouton dans la partie \[interaction directe avec le giveaway]\(giveaway.md#interaction-directe-avec-le-giveaway). {% endhint %} #### Rôles autorisés & ignorés Dans ces deux champs, vous pouvez restreindre le giveaway à certains rôles ou, au contraire, interdire certains rôles de participer au giveaway.\ Pour cela, sélectionnez les rôles souhaités dans le menu déroulant correspondant. #### Embed La partie `embed` permet de mettre en forme le message qui sera envoyé et visible par le membre dans le salon.\ Vous pouvez le personnaliser à votre guise à l'aide des nombreuses options proposées. #### Bouton :gem: La partie `bouton` permet de personnaliser le bouton qui sera joint au message du giveaway et qui permet aux membres de participer au giveaway.\ Vous pouvez le personnaliser à votre guise à l'aide des nombreuses options proposées tel que la couleur, le texte affiché ou encore l'emoji affiché. ### Finaliser et envoyer Une fois votre giveaway entièrement configuré, vérifiez que tout est correct et cliquez sur le bouton vert situé en haut à gauche, `Créer & Envoyer`. Votre giveaway sera envoyé et démarré dans le salon précisé avec toutes ses personnalisations. Il est conseillé de rédiger un message d'annonce pour mentionner à vos membres si le giveaway est organisé en l'honneur d'un événement important. ## :gear: Fonctionnement du giveaway ### Informations sur le giveaway Dans le message embed, vous retrouverez certaines informations relatives au giveaway. Voici des explications pour chaque information disponible sur le message. * **Nom ou titre** : Vous pouvez retrouver le nom du giveaway en titre de l'embed (partie supérieure en gras titré). * **Date et heure de fin** : Vous pouvez retrouver le temps restant ainsi que la date et l'heure auxquelles se terminera le giveaway. Le champ correspondant est `Se termine :`, situé sous le titre dans le corps de l'embed. Le champ se renomme `S'est terminé` dès lors que le giveaway est terminé. * **Auteur du giveaway** : Vous pouvez prendre connaissance de l'utilisateur à l'origine du giveaway. Son compte Discord est directement identifié dans le champ `Lancé par :`. * **Nombre de participants** : Vous pouvez connaître le nombre de membres qui sont inscrits au tirage au sort dans le champ `Participants :`. * **Nombre de gagnants ou gagnant·s** : Vous pouvez connaître le nombre de membres qui seront déclarés vainqueurs du lot après le tirage au sort dans le champ `Gagnants`. Ce champ affiche ensuite le·s gagnant·s en mention. ### Interaction directe avec le giveaway #### Bouton participer Vous pouvez vous inscrire au tirage au sort avec le bouton personnalisable par l'auteur du giveaway situé sous l'embed du giveaway, à gauche du bouton `Participants`. #### Bouton participants Vous pouvez consulter la liste des personnes inscrites au tirage au sort en cliquant sur le bouton `Participants` situé sous l'embed du giveaway, à droite du bouton de participation. {% hint style="info" %} Découvrez comment configurer ce bouton dans la partie [créer et configurer](#creer-et-configurer) de cette page. {% endhint %} ![Exemple d'un message classique de giveaway](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b9603178e3f4e6e02530377944429dc1a75cef70%2Fgiveaway_example.png?alt=media) ### Commandes | Commande | Description | | ---------------- | --------------------------------------------- | | /giveaway create | Lance un giveaway. | | /giveaway delete | Supprime un giveaway. | | /giveaway end | Termine un giveaway. | | /giveaway list | Affiche la liste des giveaways du serveur. | | /giveaway reroll | Choisi de nouveaux gagnants pour un giveaway. | # Rappels Ici, vous trouverez des informations sur le système de rappels par commandes de John-Bot. Découvrez son fonctionnement avec ses nombreuses commandes. **Tutoriel vidéo lié à cette page :** [Utiliser les rappels de John-Bot sur Discord - Tutoriel #11](https://jnbt.xyz/fr/tutorials/reminders) ## :rocket: Introduction Si vous avez une tâche que vous ne devez surtout pas oublier, vous pouvez utiliser le système de rappels de John-Bot. Il permet, en une simple commande exécutable sur n'importe quel serveur ou en messages privés, de programmer une alerte, qui sera envoyée sous forme de message privé à une heure précise. ## :alarm\_clock: Gérer les rappels ### Créer un rappel Pour programmer un message de rappel, entrez la commande `/reminder add`. Choisissez ensuite dans les champs proposés le motif (qui vous sera renvoyé au moment du rappel) et le temps qui devra s'écouler avant l'envoi. Un message de confirmation vous est ensuite envoyé. {% hint style="warning" %} Notez que la durée qui devra s'écouler avant l'envoi ne peut être ni inférieure à une minute ni supérieure à 365 jours. {% endhint %} ### Supprimer un rappel Si vous n'avez plus besoins d'un rappel précédement programmée, vous pouvez le supprimer facilement. Entrez la commande `/reminder remove` et séléctionnez le rappel à supprimer. Un message de confirmation vous sera ensuite envoyé. ### Lister les rappels en cours Pour visualiser tous vos rappels et les anticiper, entrez la commande `/reminder list`. ## :clipboard: Liste des commandes | Commande | Description | Exemple | | ---------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /reminder add | Définit un rappel. | ![Commande /reminder add](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-890afe9da6ebe9dceb691a60507a8ef9fa607734%2Frappels_command_add.png?alt=media) | | /reminder list | Affiche la liste de tous vos rappels. | ![Commande /reminder list](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-d3dca135c15128b0136250410b92ca0d76b91c7f%2Frappels_command_list.png?alt=media) | | /reminder remove | Supprime un rappel. | ![Commande /reminder remove](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-52585481c793cc35d105c2a32e294d91a6715f0f%2Frappels_command_remove.png?alt=media) | # Modération Découvrez comment fonctionne le système de modération par commandes de John-Bot et explorez ses fonctionnalités. **Tutoriel vidéo lié à cette page :** [Modérer efficacement son serveur avec John-Bot - Tutoriel #5](https://jnbt.xyz/fr/tutorials/moderation) #### :rocket: Introduction Le système de modération par commandes de John-Bot vous donne les outils pour modérer efficacement votre serveur Discord. Grâce à des commandes puissantes, vous pouvez simplifier et accélérer la modération pour maintenir un environnement sécurisé, le tout avec des fonctionnalités avancées via John-Bot inaccessibles aux utilisateurs classiques. #### :clipboard: Liste des commandes | Commande | Description | Exemple | | ----------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /ban | Banni un utilisateur du serveur. | ![Commande /ban](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-bd4dae014e29abfb5c3c3b66657eea782efd9b48%2Fmoderation_command_ban.png?alt=media) | | /clear | Supprime un nombre de messages dans un salon. | ![Commande /clear](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-48c932caf81e846a10344eeb7970c242e7cd8f74%2Fmoderation_command_clear.png?alt=media) | | /kick | Expulse un membre du serveur. | ![Commande /kick](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-5f5e30030bbe97bcb60ca351f9d10ac8fe2baf95%2Fmoderation_command_kick.png?alt=media) | | /lock | Verrouille un salon du serveur. | ![Commande /lock](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-e6ebcd7f28a14f721e60b0e632c9c686495f75f7%2Fmoderation_command_lock.png?alt=media) | | /mute | Réduit un membre au silence pendant un certain temps. | ![Commande /mute](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b267f98accebb5c6a284b3a50c8bdbfb7af50166%2Fmoderation_command_mute.png?alt=media) | | /nickname | Change le surnom d'un membre du serveur. | ![Commande /nickname](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-5b6d1ff616c6cc1d2d5dc3130fb01a64a88309f0%2Fmoderation_command_nickname.png?alt=media) | | /slowmode disable | Désactive le mode lent d'un salon. | ![Commande /slowmode disable](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-bc7db545dc4175548d63ad400b3f3e03c272d3f2%2Fmoderation_command_slowmode%20disable.png?alt=media) | | /slowmode set | Défini le mode lent d'un salon. | ![Commande /slowmode set](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-f9c5e74f225dbd021229776c1c2661a23426f379%2Fmoderation_command_slowmode%20set.png?alt=media) | | /unban | Révoque le bannissement d'un utilisateur. | ![Commande /unban](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-5c90e79ab220b3ab3d512887fd788072f1dbd4de%2Fmoderation_command_unban.png?alt=media) | | /unlock | Déverrouille un salon du serveur. | ![Commande /unlock](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-b5d211e538928bd013eaf18483359d61d78a998c%2Fmoderation_command_unlock.png?alt=media) | | /unmute | Rend la parole à un membre réduit au silence. | ![Commande /unmute](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-c6ae6ac05250a85ba95880a6f995407acb370306%2Fmoderation_command_unmute.png?alt=media) | | /warn | Averti un membre du serveur. | ![Commande /warn](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-7522a4d84811c8d4be14dbfa8aaf246f959d5deb%2Fmoderation_command_warn.png?alt=media) | | /warnings clear | Supprime les avertissements d'un membre ou de tous les membres du serveur. | ![Commande /warnings clear](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-d929a7d195ec171ce3e10ad45b5ce89fbedd1ea4%2Fmoderation_command_warnings%20clear.png?alt=media) | | /warnings list | Affiche la liste des avertissements d'un membre. | ![Commande /warnings list](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-ab86e38766008df636952a02cb250c702bee0a0c%2Fmoderation_command_warnings%20list.png?alt=media) | | /warnings remove | Supprime l'avertissement d'un membre. | ![Commande /warnings remove](https://2246715298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQGdhuqfnEA3v34QsX3k%2Fuploads%2Fgit-blob-2ab4f8f8d4c3a52f21bfb4f455d6a766482e7722%2Fmoderation_command_warnings%20remove.png?alt=media) | # Variables Liste des variables disponibles à utiliser à travers la configuration des différents systèmes de John-Bot ### Variables de Date | Variable | Description | Exemple | | ----------- | --------------------------------------------------- | ---------- | | {date} | Affiche la date actuelle sous forme : `JJ/MM/AAAA`. | 04/03/2024 | | {date.time} | Affiche le temps actuelle sous forme : `HH:MM`. | 09:22 | | {timestamp} | Affiche l'horodatage actuel. | 1741098205 | ### Variables de l'Utilisateur | Variable | Description | Exemple | | ------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | {user} | Affiche la mention de l'utilisateur. | @Utilisateur | | {user.id} | Affiche l'identifiant de l'utilisateur. | 982054684481167410 | | {user.username} | Affiche le nom unique (ou le nom et le tag) de l'utilisateur. | exempleutilisateur (ou Utilisateur#0001) | | {user.global\_name} | Affiche le nom d'affichage de l'utilisateur. | Utilisateur | | {user.nickname} | Affiche le surnom de l'utilisateur sur le serveur. | Modérateur - Utilisateur | | {user.avatar\_url} | Affiche le lien de l'avatar de l'utilisateur. | | | {user.banner\_url} | Affiche le lien de la bannière de l'utilisateur. | | ### Variables du Serveur | Variable | Description | Exemple | | ---------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------- | | {server.name} | Affiche le nom du serveur. | John-Bot | | {server.id} | Affiche l'identifiant du serveur. | 959269961572962314 | | {server.icon\_url} | Affiche l'icône du serveur. | | | {server.member\_count} | Affiche le nombre de membres que compte le serveur. | 100 | ### Variables du Panneau | Variable | Description | Example | | --------------------- | ------------------------------------------------------------- | --------------------- | | {panel.name} | Affiche le nom du panneau. | Support | | {panel.reopening\_at} | Affiche la date à laquelle le panneau sera de nouveau ouvert. | 20 janvier 2025 07:00 | ### Variables du Ticket | Variable | Description | Exemple | | --------------- | -------------------------------- | ------------------ | | {ticket} | Mentionne le ticket. | #ticket | | {ticket.id} | Affiche l'identifiant du ticket. | 959269961572962314 | | {ticket.name} | Affiche le nom du ticket. | Ticket | | {ticket.number} | Affiche le numéro du ticket. | 10 | ### Variables de Niveaux | Variable | Description | Exemple | | ------------- | ------------------------------------------------------------------------------- | -------------- | | {level} | Affiche le nouveau niveau du membre lors de son passe d'un niveau à l'autre. | 5 | | {reward.role} | Affiche le rôle débloqué par le membre lors de son passe d'un niveau à l'autre. | Super écrivain | ### Variables de la Chaîne (YouTube et Twitch) | Variable | Description | Exemple | | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | {channel.url} | Affiche le lien de la chaîne YouTube/Twitch. | **OU** | | {channel.name} | Affiche le nom de la chaîne YouTube/Twitch. | Les Cowboys Fringants | | {channel.icon\_url} | Affiche l'icône de la chaîne YouTube/Twitch. | **OU** | ### Variables YouTube | Variable | Description | Exemple | | ------------------- | ----------------------------------- | ---------------------------------------------------------- | | {video.title} | Affiche le titre de la vidéo. | Ma super vidéo YouTube | | {video.description} | Affiche la description de la vidéo. | Abonnez-vous à ma chaîne et suivez moi sur les réseaux ! | | {video.id} | Affiche l'identifiant de la vidéo. | q5mUj4KBOb0 | | {video.thumbnail} | Affiche la miniature de la vidéo. | | | {video.duration} | Affiche la durée de la vidéo. | 2:46 | | {video.url} | Affiche le lien de la vidéo. | | ### Variables Twitch | Variable | Description | Exemple | | ------------------------ | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | {stream.title} | Affiche le titre de la diffusion en direct. | Mon super live Twitch | | {stream.thumbnail} | Affiche la prévisualisation de la diffusion en direct. | | | {stream.game} | Affiche le nom du jeu de la diffusion en direct. | Minecraft | | {stream.game\_icon\_url} | Affiche la pochette du jeu de la diffusion en direct. | | | {stream.viewer\_count} | Affiche le nombre de spectateurs de diffusion en direct. | 1000 | | {stream.url} | Affiche le lien de la diffusion en direct. | | ### Variables Bluesky | Variable | Description | Exemple | | ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | {profile.url} | Affiche le lien du profil Bluesky. | | | {profile.name} | Affiche le nom d'affichage du profil Bluesky. | Bluesky | | {profile.icon\_url} | Affiche l'icône du profil Bluesky. | | | {profile.handle} | Affiche le nom d'utilisateur du profil Bluesky. | bsky.app | | {post.content} | Affiche le contenu de la publication. | Bienvenue sur mon compte Bluesky ! | | {post.url} | Affiche le lien de la publication. | | | {post.id} | Affiche l'identifiant de la publication. | 3l6oveex3ii2l | # Noms de Domaine Liste des noms de domaine officiels utilisés par John-Bot Certaines personnes créent des noms de domaine similaires à ceux utilisés par John-Bot à des fins malveillantes. Pour le moment, John-Bot utilise seulement trois noms de domaine, répertoriés dans la liste ci-dessous. | Nom de domaine | Utilisation | Exemple | | ----------------------------------------- | ---------------------------- | ----------------------------------------------------- | | [(www.)johnbot.app](http://johnbot.app) | Site internet | [johnbot.app/dashboard](http://johnbot.app/dashboard) | | [(www.)john-bot.app](http://john-bot.app) | Redirection vers johnbot.app | [john-bot.app/](http://john-bot.app/) | | [(www.)jnbt.xyz](http://jnbt.xyz) | Liens raccourcis | [jnbt.xyz/jNnLmd](http://jnbt.xyz/jNnLmd) | Tous les autres noms de domaine se faisant passer pour John-Bot n'appartiennent pas à John-Bot et sont probablement gérés par des personnes malveillantes.