Créer un plugin

Les plugins sont des processus Python isolés. Écrivez un gestionnaire, déclarez vos capacités, envoyez un zip — nous l'exécutons dans un conteneur Docker verrouillé et lui transmettons les événements Discord via JSON-RPC.

Qu'est-ce qu'un plugin ?

Un plugin est un petit programme qui écoute les événements dans un serveur Discord et y réagit.

• Quelqu'un rejoint votre serveur → votre plugin envoie un message de bienvenue.
• Quelqu'un tape /leaderboard → votre plugin répond avec les 10 premiers utilisateurs.
• Quelqu'un réagit à un message → votre extension compte le vote et met à jour le décompte.

Vous écrivez du Python. Vous importez le SDK. Vous décorez une fonction avec @plugin.on_event("member_join") et écrivez ce qui doit se passer. La plateforme s'occupe du reste.

Ce que la plateforme fait pour vous

• Se connecte à Discord. Vous n'avez jamais à gérer les passerelles WebSocket, le sharding, les intents ou les limites de débit. La plateforme livre les événements à vos gestionnaires, et un seul appel ctx.discord.send_message(…) suffit pour répondre.
• Héberge votre code. Pas de serveurs à louer, pas de Docker à gérer, pas de déploiements à 2 h du matin. Poussez votre code — la plateforme l'exécute dans un sandbox isolé.
• Parle au monde extérieur. Appelez les API externes avec ctx.http, maintenez les connexions en direct ouvertes avec ctx.ws et laissez la plateforme injecter les clés API à partir des secrets chiffrés pour que votre code n'y touche jamais. Consultez HTTP sortant.
• Gère les paiements. Fixez un prix ou livrez-le gratuitement. Les clients paient via Stripe et vous conservez 70–85 % des revenus (le niveau dépend du volume de vos 30 derniers jours), versé à votre banque automatiquement après une période de rétention. Consultez Vendre votre extension.
• Donne à chaque installation une page de paramètres. Déclarez quelques widgets en JSON et les administrateurs obtiennent une page de tableau de bord thématisée pour votre Module — cartes de statistiques, graphiques, formulaires de paramètres — sans que vous écriviez une seule ligne de code frontal. Voir Tableaux de bord.
• Expédie vos mises à jour. Publiez une nouvelle version et les installations la récupèrent automatiquement (les propriétaires peuvent épingler une version pour refuser). Aucun email de migration, aucun « veuillez réinviter le bot ». Voir mises à jour et annulation.
• Évolue pour vous. Une installation ou un million — la plateforme gère la concurrence, les nouvelles tentatives et les quotas.

Ce que vous faites

Écrire la logique qui transforme les événements Discord en actions. C'est tout. Le flux ressemble à ceci :

En quoi un plugin diffère d'un « framework de bot Discord »

Aspect	Plugin (cette plateforme)	Bot auto-hébergé (discord.py, etc.)
Se connecter à Discord	La plateforme le fait	Vous le faites
Serveur pour héberger le code	La plateforme le fournit	Vous louez / gérez
Paiements / Stripe	La plateforme gère	Vous le construisez vous-même
Installation par client	En un clic pour le client	Vous guidez chaque client à travers OAuth
Mise à l'échelle / quotas / nouvelles tentatives	La plateforme gère	Vous vous en chargez
Avis / découvrabilité	Marketplace intégré	Vous faites vous-même la promotion de votre bot
Surface de l'API Discord	Délimitée par capacités (déclarez ce dont vous avez besoin)	Accès complet (sous votre responsabilité)

Où vous passerez votre temps

1. Relier les événements aux gestionnaires. Des décorateurs comme @plugin.on_event("message_create") ou @plugin.on_slash_command("hello").
2. Stocker l'état. Les paramètres par serveur, les compteurs et les classements vivent dans ctx.kv (clé-valeur, chaque extension l'a) ou ctx.sql (SQL complet, une capacité que vous demandez qui est accordée après examen du personnel). De toute façon, il n'y a pas de base de données à gérer.
3. (Facultatif) Une page de paramètres. Intégrez un manifeste JSON et les clients obtiennent une page de tableau de bord depuis laquelle ils peuvent configurer votre plugin. Aucun code frontend requis.

Vous pouvez créer et soumettre votre premier Module en un après-midi. Les premières versions des nouveaux développeurs passent par un court examen du personnel avant d'apparaître sur la Place de marché ; les développeurs établis publiant à partir de dépôts publics contournent généralement la file d'attente. Cliquez sur « Commencer » ci-dessus quand vous êtes prêt à écrire du code. Préférez ne pas commencer par un fichier vide ? Le Générateur de Module rédige un premier brouillon fonctionnel à partir d'une description, et le CLI yourbot l'exécute localement avant de charger quoi que ce soit.

Le voyage complet en un coup d'œil

Chaque Module passe par les mêmes cinq arrêts, et ces docs sont disposées dans le même ordre — la barre d'onglets ci-dessus les groupe en Comprendre → Construire → Expédier → Référence. Chaque arrêt mène à la section qui le couvre :

Bon à savoir avant de construire

FAQ existante

Allez directement à la section qui répond à votre question. La boîte de filtre ci-dessus ne recherche que dans l'onglet sur lequel vous êtes.

Je veux…	Allez sur le
Réagir quand quelqu'un rejoint, poste ou clique	Tous les événements
commande slash	Commandes slash
Nouveaux messages	events:message_content
Stocker les paramètres ou compteurs par serveur	Magasin clé-valeur
Garder une clé API sans la coder en dur	Utilisateurs autorisés
Exécuter de véritables requêtes SQL	Stockage et E/S : SQL en bac à sable
Appeler une API externe	Simuler les requêtes HTTP sortantes
Maintenir une connexion active à un serveur de jeu	Stockage et E/S : WebSockets
Faire quelque chose selon un calendrier	Planifications cron
Ouvrir un formulaire contextuel (modal)	Construire : Dialogues modaux
Mettez à jour un message quand un bouton est cliqué	Construire : Boutons & menus
Ajouter un délai d'attente ou une limite de débit à une commande	Stockage & E/S : État éphémère
Voir les paramètres	Manifeste du tableau de bord (JSON)
Construire une interface de tableau de bord entièrement personnalisée	Tableaux de bord : Mode Iframe
Tester mon module avant de le télécharger	Premiers pas
Écrivez des tests unitaires pour mes gestionnaires	Production : Tests
Gérez les erreurs du SDK sans planter	Production : Gestion des erreurs
Comprendre pourquoi les variables globales du module se réinitialisent	Production : Mode Pool
Voir ce que mon module est autorisé à toucher	Référence : Catalogue des capacités
Vérifier chaque limite de taille et de débit	Référence : Limites et quotas
Supprimer le plugin	Nommez votre plugin
Publier & réviser	Publier & réviser
Voir ce qui a changé dans chaque version du SDK	Référence : journal des modifications du SDK