diff --git a/docs/en/1.installation.md b/docs/en/1.installation.md index 7056e7e01..7e3706390 100644 --- a/docs/en/1.installation.md +++ b/docs/en/1.installation.md @@ -1,12 +1,12 @@ --- slug: /installation -title: Installation and settings +title: Installation description: Here is the process for inviting and installing DraftBot. -navigation.icon: 'twemoji:gear' -contributors: ['ls62', 'sagipierre', 'imroxxor', 'rababio4579'] +navigation.icon: 'twemoji:wrench' +contributors: ['ls62', 'sagipierre', 'imroxxor', 'rababio4579', 'lyvendev', 'draftproducts'] updatedAt: '2025-07-31' -sourceHash: 41c9766341a9a03820fd056da4a936d7680e5d75c7aac234815422d7cec87437 -sourceCommit: 51972c2686adbcf5e90fce49c0fb3a6d854c3b34 +sourceHash: 7250b34230c76744cc7bb3f6bd3915fa59be4b0030b87dbbab6c1bbd03a9ccee +sourceCommit: 464b867748ef029b1262a90764b2872599b1b018 --- ## Inviting DraftBot diff --git a/docs/en/10.utilities/0.info-commands.md b/docs/en/10.utilities/0.info-commands.md index 9042f2345..bbce1debb 100644 --- a/docs/en/10.utilities/0.info-commands.md +++ b/docs/en/10.utilities/0.info-commands.md @@ -5,8 +5,8 @@ description: Discover every command available for getting detailed information a navigation.icon: 'twemoji:card-index' contributors: ['theorik', 'rababio4579', 'iibey', 'imroxxor'] updatedAt: '2023-07-04' -sourceHash: 8cc6640b8639ca92a86009790794850662ea652606dc0248d34be3b6ad48d748 -sourceCommit: d9e726b99435a84e0f0cda920a025db6e761e5e4 +sourceHash: 84b9ed753073e4f6f288343a526edf62555f18ca7ec5d782ac6f35557d46a120 +sourceCommit: 464b867748ef029b1262a90764b2872599b1b018 --- ## /info user @@ -38,6 +38,7 @@ The \ command gives you detailed information about your Discord se - The shard and cluster it sits on in the "[Status](/status)" page. - The owner's username. - The number of members, channels, threads, roles, emojis, bots and boosts. +- The server's various perks: Server tag, Enhanced role colors, Role icons, Animated icon, Animated banner, Invite background, Custom invite link - The security level: verification and age restriction. - The date the server was created. - The date DraftBot joined the server. diff --git a/docs/en/11.misc/3.premium.md b/docs/en/11.misc/3.premium.md index 68d278000..febd7e336 100644 --- a/docs/en/11.misc/3.premium.md +++ b/docs/en/11.misc/3.premium.md @@ -4,9 +4,9 @@ title: Premium subscription description: Here you will find everything you need to know about how DraftBot's premium works, and how to manage and activate it. navigation.icon: 'material-symbols:diamond-outline' contributors: ['ls62', 'imroxxor', 'rababio4579', 'lyvendev'] -updatedAt: '2025-08-18' -sourceHash: 78170fffee6d99b5e64fb481d8f8f62705b0bfe9e19b3a53d3301edd2d4ec2fc -sourceCommit: 3776da3855c1e37b0dd4e1e94ee9dc61ae4bde08 +updatedAt: '2026-09-11' +sourceHash: d9b67c9498d56802d8d2cf173f2005edea8a0c260725235ace74de22307f1c9c +sourceCommit: 464b867748ef029b1262a90764b2872599b1b018 --- ## Your subscription @@ -43,7 +43,7 @@ When premium is purchased, it is associated with your Discord account straight a :: ::tab{ label="Through a command" } - To activate premium on your server, simply run the \ command. + To activate premium on your server, run the \ command. ![Message of the /premium enable command](./assets/premium/premium_enable_command.png) :: @@ -69,6 +69,10 @@ Go to the **[panel](/dashboard/user/premium)**, open the **"inventory"** section From the \ command, a **"Redeem a code"** button also adds a premium code directly to your inventory, without going through the panel. You can then activate it whenever you want. :: +::hint{ type="info" } + From the [web panel](/dashboard/user/premium), the **"Enable renewal"** button turns your code into a subscription. You pick a [plan](/premium) (monthly, 6 months or yearly): nothing is charged today, your code runs until it expires, and the subscription takes over on that date. You can cancel it at any time. If the plan you pick covers fewer servers than your current code, the panel warns you before you confirm. +:: + ## Available commands By taking out a premium subscription, you get several essential commands for managing it. @@ -104,6 +108,6 @@ You can deactivate the premium benefits on a server where you have activated the :: ::tab{ label="Through a command" } - To deactivate premium on a server, simply run the \ command, giving the name or the ID of the server concerned. + To deactivate premium on a server, run the \ command, giving the name or the ID of the server concerned. :: :: diff --git a/docs/en/11.misc/6.variables.md b/docs/en/11.misc/6.variables.md index 4ec0261ca..158c097b1 100644 --- a/docs/en/11.misc/6.variables.md +++ b/docs/en/11.misc/6.variables.md @@ -5,9 +5,9 @@ description: The variable system inserts contextual information into your messag navigation.icon: 'material-symbols:data-object' redactors: ['elbaguetto', 'imroxxor'] contributors: ['draftproducts', 'rababio4579', 'erwangit'] -updatedAt: '2025-10-23' -sourceHash: 18a9c84355be7c85f073dc897b97e69c6a4eb7510538ad66236b6eedeeaffca0 -sourceCommit: 3776da3855c1e37b0dd4e1e94ee9dc61ae4bde08 +updatedAt: '2026-09-03' +sourceHash: 59027a3899a3cbbbf9d1bf15bf18413af3bc99389399413a3f7dcd229838065f +sourceCommit: 464b867748ef029b1262a90764b2872599b1b018 --- ## General syntax @@ -29,7 +29,7 @@ Variables are always used between curly braces `{}` and follow one of the follow Parameters fine-tune a variable's behavior by passing it additional information. They are added after the variable's name, each of them preceded by a colon `:`. -Each parameter follows the `name=value` structure. When you want to use several parameters at once, simply add a new `:` followed by the next parameter. +Each parameter follows the `name=value` structure. When you want to use several parameters at once, add a new `:` followed by the next parameter. **Example:** @@ -363,7 +363,7 @@ color: '#FAEF90' | Variable | Description | Example | |----------|-------------|---------| -| `{user}` | Member(s) celebrating their birthday | @John, @Jane | +| `{user}` or `{users}` | Member(s) celebrating their birthday | @John, @Jane | | `{role}` | Temporary birthday role | @Birthday | | `{gifts}` | Rewards granted | 500 💰, VIP role | @@ -399,6 +399,13 @@ color: '#FAEF90' | `{number}` | The indicated number | 4956 | | `{reward}` | Reward won when passing a tier | 5,000 💰 | +### Counter reset + +| Variable | Description | Example | +|----------|-------------|---------| +| `{infiniteroad.number}` | Next number expected after the reset | 1 | +| `{infiniteroad.error_type}` | Type of error that caused the reset | an **incorrect number** | + ### Advent calendar | Variable | Description | Example | @@ -444,7 +451,7 @@ color: '#FAEF90' | `{stream.title}` | Stream title | Development stream | | `{stream.game}` | Game being streamed | Just Chatting | | `{stream.url}` | Stream link | https://twitch.tv/... | -| `{stream.start_at}` | Start time | 2 hours ago | +| `{stream.start_at}` or `{stream.started_at}` | Start time | 2 hours ago | | `{stream.tags}` | Stream tags | english, development | **Parameters:** diff --git a/docs/en/2.settings.md b/docs/en/2.settings.md index f0d5b42f5..92ff1f497 100644 --- a/docs/en/2.settings.md +++ b/docs/en/2.settings.md @@ -1,45 +1,40 @@ --- slug: /settings title: Settings -description: Configure your server's basic settings, language, timezone and emergency managers. +description: Configure your server's basic settings, language, timezone and emergency contacts. navigation.icon: 'twemoji:gear' redactors: ['draftproducts'] updatedAt: '2026-09-02' -sourceHash: fcb3ab1af720667fee01cbfbeedd8233084c868e3761888152568bf4cee39abd +sourceHash: 318c13f24580f5411127c188d767b1f3c9c66f4c6c18536dede9ca5145a97706 +sourceCommit: 464b867748ef029b1262a90764b2872599b1b018 --- -The **Settings** page of the panel gathers your server's basic settings. They apply to every **DraftBot** system. - You can access it by [**`clicking here`**](/dashboard/first/settings). -## Language and timezone - -### Language - -The language determines the one **DraftBot** uses in its messages and commands on your server. Two languages are available: +### Language and timezone -- **Français** -- **English** +This section lets you set the **bot language** as well as the **timezone** used on your server. These settings affect, among other things, how dates and times are displayed in the messages DraftBot sends. -Changing the language also updates the default messages of the various systems that have not been customized yet. +![Language and timezone settings in the panel](./assets/installation/panel_language_timezone.png) -### Timezone - -The timezone is used to correctly display dates and times wherever **DraftBot** handles them: [recurring messages](/docs/communication/recurring-messages), [birthdays](/docs/community/birthdays), logs, etc. +- **Language**: choose the language DraftBot speaks in on your server. +- **Timezone**: select the timezone matching your server so that timestamps stay consistent. ::hint{ type="info" } - If your members are spread across several timezones, pick the one most of them live in: it is the one used for the times announced on the server. + This setting changes the bot's global language for the whole server. It is not a per-member preference. :: -## Emergency managers +### Emergency contacts + +When a serious issue is detected on your server (disabled system, missing permission, etc.), DraftBot sends an **urgent message** in the logs channel and mentions the designated contacts so that the issue actually gets taken care of. -When a serious issue is detected (disabled system, missing permission…), an urgent log is sent and the managers are mentioned so that the issue actually gets taken care of. +![Emergency contacts setting in the panel](./assets/installation/panel_emergency_managers.png) -Two targets are available: +You have two options to choose from: -- **All administrators**: every member with the `Administrator` permission is mentioned. -- **Custom list**: you select the members to mention, up to 10. +- **All administrators**: every member holding the Administrator permission on the server is mentioned. +- **Custom list**: you pick the members to be mentioned yourself. ::hint{ type="warning" } - Pick managers who are actually active on the server: an ignored urgent log can leave an essential system out of order. + Take care to configure the emergency contacts: if nobody is designated, critical issues may go unnoticed and disrupt how DraftBot works on your server. :: diff --git a/docs/en/assets/installation/panel_emergency_managers.png b/docs/en/assets/installation/panel_emergency_managers.png new file mode 100644 index 000000000..7a665d688 Binary files /dev/null and b/docs/en/assets/installation/panel_emergency_managers.png differ diff --git a/docs/en/assets/installation/panel_language_timezone.png b/docs/en/assets/installation/panel_language_timezone.png new file mode 100644 index 000000000..c4243a7fa Binary files /dev/null and b/docs/en/assets/installation/panel_language_timezone.png differ