Passer au contenu principal
Un Guild est un serveur (« guild » est le nom que Discord donne aux serveurs dans son API). Vous en obtenez un comme guild d’une commande utilisée sur un serveur, avec les événements qui s’y produisent, et comme member.guild, role.guild ou channel.guild.
Comment vos fonctions reçoivent un serveur est dans Commandes et Événements. Ce dont un serveur se souvient de ses membres, et pourquoi pas de tous, est dans Mémoire.

Propriétés

Snowflake
L’identifiant unique que Discord lui a donné.
Date
Quand il a été créé : un identifiant Discord contient sa date de création.
string
Le nom du serveur.
string | null
La description du serveur, quand il en a une.
Snowflake
L’identifiant de l’utilisateur à qui appartient le serveur.
boolean
false pendant une panne de Discord : les données peuvent ne pas être à jour.
number | null
Combien de membres a le serveur. Exact quand le bot reçoit les événements des membres, approximatif sinon ; null quand Discord ne l’a jamais dit.
readonly GuildFeature[]
Ce que le serveur a activé ou débloqué (COMMUNITY, VANITY_URL…). Voir GuildFeature.
VerificationLevel
Ce que Discord demande aux nouveaux membres avant qu’ils puissent écrire. Voir VerificationLevel.
PremiumTier
Le niveau de boost du serveur. Voir PremiumTier.
number
Combien de boosts a le serveur.
Locale
La langue du serveur, utilisée pour ce que Discord lui envoie. Voir Locale.
string | null
Le code du lien d’invitation personnalisé du serveur, quand il en a un.
Snowflake | null
L’identifiant du salon où Discord publie les messages de bienvenue.
Snowflake | null
L’identifiant du salon qui affiche le règlement, sur un serveur Communauté.
Snowflake | null
L’identifiant du salon vocal où sont déplacés les membres inactifs.
Date | null
Quand le bot a rejoint le serveur, quand Discord l’a dit.
ReadonlyMap<Snowflake, Role>
Les rôles du serveur, @everyone compris.
ReadonlyMap<Snowflake, GuildMember>
Les membres du serveur que connaît le bot : ceux vus le plus récemment, pas tous.
ReadonlyMap<Snowflake, GuildChannel | ThreadChannel>
Les salons et les fils actifs du serveur.
ReadonlyMap<Snowflake, GuildEmoji>
Les emojis personnalisés du serveur.
VoiceConnection | null
Le bot en vocal dans ce serveur, pour jouer ou partir ; null quand il n’est dans aucun salon vocal ici. Voir VoiceConnection.
Role
Le rôle @everyone, que chaque membre a.
GuildMember
Le bot en tant que membre de ce serveur.
members ne contient que les membres que le bot a vus récemment (voir Mémoire). Utilisez fetchMember() pour en obtenir un à coup sûr. me est toujours là, quoi que garde le bot en mémoire.

Helpers

Ils lisent ce dont le bot se souvient : ils n’envoient jamais de requête.

iconURL()

L’URL de l’icône du serveur, quand il en a une. Voir ImageOptions.

bannerURL()

L’URL de la bannière du serveur, quand il en a une. Voir ImageOptions.

splashURL()

L’URL de l’arrière-plan d’invitation du serveur, quand il en a un. Voir ImageOptions.

toString()

Le nom du serveur.

toJSON()

Les données de Discord sous forme d’objet simple, avec des noms en camelCase.

Lire depuis Discord

fetch()

Demande à Discord les dernières données du serveur. Documentation de Discord

fetchMember()

Un membre du serveur : depuis la mémoire du bot, sinon depuis Discord. Documentation de Discord

fetchMembers()

Des membres du serveur, par pages de 1000 au plus, triés par identifiant. Demande que le Server Members Intent soit activé pour le bot. limit est un nombre entier entre 1 et 1000 (par défaut) ; after est l’identifiant du dernier membre de la page précédente. Documentation de Discord

searchMembers()

Les membres dont le nom d’utilisateur ou le surnom commence par le texte donné. limit vaut 1 par défaut. Documentation de Discord

fetchOwner()

Le membre à qui appartient le serveur.

fetchBan()

Le bannissement d’un utilisateur ; null quand il n’est pas banni. Voir Ban. Documentation de Discord

fetchBans()

Les bannissements du serveur, par pages de 1000 au plus. Voir Ban. Documentation de Discord

fetchRoles()

Demande à Discord les rôles du serveur. Documentation de Discord

fetchChannels()

Les salons du serveur (les fils ne sont pas inclus). Documentation de Discord

fetchActiveThreads()

Les fils du serveur qui ne sont pas archivés. Documentation de Discord

fetchEmojis()

Demande à Discord les emojis personnalisés du serveur. Documentation de Discord

fetchInvites()

Les invitations du serveur, avec combien de fois chacune a été utilisée. Documentation de Discord

fetchWebhooks()

Les webhooks de chaque salon du serveur. Documentation de Discord

fetchAuditLog()

Ce que les modérateurs et les bots ont fait sur le serveur. Les options sont les filtres du journal d’audit ; le résultat est un AuditLog. Documentation de Discord

fetchScheduledEvents()

Les événements programmés du serveur. Voir ScheduledEvent. Documentation de Discord

fetchAutoModerationRules()

Les règles de modération automatique du serveur. Voir AutoModerationRule. Documentation de Discord

fetchStickers()

Les stickers personnalisés du serveur. Voir Sticker. Documentation de Discord

Actions

edit()

Change les réglages du serveur. Voir GuildEditOptions. Documentation de Discord

leave()

Fait quitter le serveur au bot. Documentation de Discord

kick()

Retire un membre du serveur ; il peut revenir avec une invitation. Documentation de Discord

ban()

Bannit un utilisateur du serveur, membre ou non. Voir BanOptions. Documentation de Discord

bulkBan()

Bannit jusqu’à 200 utilisateurs d’un coup. Renvoie les identifiants des utilisateurs bannis, et de ceux qui n’ont pas pu l’être. Voir BanOptions. Documentation de Discord

unban()

Lève le bannissement d’un utilisateur. Documentation de Discord

createRole()

Crée un rôle. Voir RoleCreateOptions. Documentation de Discord

createChannel()

Crée un salon. Voir ChannelCreateOptions. Documentation de Discord

createEmoji()

Ajoute un emoji personnalisé au serveur. options.image est l’image sous forme de data URI (data:image/png;base64,...). Documentation de Discord

createScheduledEvent()

Programme un événement sur le serveur. Les options sont les options d’un événement programmé ; le résultat est un ScheduledEvent. Documentation de Discord

Types

GuildFeature

Ce qu’un serveur a activé ou débloqué, tel que Discord le nomme : l’un de 'ANIMATED_BANNER', 'ANIMATED_ICON', 'APPLICATION_COMMAND_PERMISSIONS_V2', 'AUTO_MODERATION', 'BANNER', 'COMMUNITY', 'CREATOR_MONETIZABLE_PROVISIONAL', 'CREATOR_STORE_PAGE', 'DEVELOPER_SUPPORT_SERVER', 'DISCOVERABLE', 'ENHANCED_ROLE_COLORS', 'FEATURABLE', 'GUILD_TAGS', 'GUESTS_ENABLED', 'INVITES_DISABLED', 'INVITE_SPLASH', 'MEMBER_VERIFICATION_GATE_ENABLED', 'MORE_SOUNDBOARD', 'MORE_STICKERS', 'NEWS', 'PARTNERED', 'PREVIEW_ENABLED', 'PRUNE_REQUIRES_ADMIN', 'RAID_ALERTS_DISABLED', 'ROLE_ICONS', 'ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE', 'ROLE_SUBSCRIPTIONS_ENABLED', 'SOUNDBOARD', 'TICKETED_EVENTS_ENABLED', 'VANITY_URL', 'VERIFIED', 'VIP_REGIONS', 'WELCOME_SCREEN_ENABLED'. Discord ajoute des fonctionnalités avec le temps, donc tout autre texte est accepté aussi : guild.features.includes('COMMUNITY') est typé, et une fonctionnalité inconnue ne casse rien. Documentation de Discord

Filtres du journal d’audit

Ce que prend fetchAuditLog(). Chaque champ peut être laissé de côté.
Snowflake
Seulement les entrées de cet utilisateur.
AuditLogEvent
Seulement les entrées de cette sorte d’action. Voir AuditLogEvent.
Snowflake
Seulement les entrées dont l’identifiant est inférieur à cet identifiant d’entrée du journal d’audit.
Snowflake
Seulement les entrées dont l’identifiant est supérieur à cet identifiant d’entrée du journal d’audit.
number
Combien d’entrées au plus, entre 1 et 100 ; 50 par défaut.
Documentation de Discord

Options d’un événement programmé

Ce que prend createScheduledEvent(). Les dates sont des textes ISO 8601 (date.toISOString()) ; l’image est une data URI (data:image/png;base64,...).
string
requis
Le nom de l’événement programmé.
number
requis
Le niveau de confidentialité de l’événement programmé : 2 (seulement les membres du serveur).
string
requis
L’heure à laquelle programmer l’événement.
number
requis
Où a lieu l’événement : 1 dans un salon de conférence, 2 dans un salon vocal, 3 ailleurs (entityMetadata.location dit alors où).
Snowflake
L’identifiant du salon de l’événement programmé.
{ location?: string }
Les métadonnées de l’événement programmé : location est l’endroit où il a lieu (1 à 100 caractères).
string
L’heure à laquelle l’événement programmé doit se terminer.
string
La description de l’événement programmé.
string
L’image de couverture de l’événement programmé.
object
La définition de la fréquence à laquelle cet événement se répète, telle que la décrit Discord.
Documentation de Discord

Autres types