Bots personnalisés | Documentation Noxyr

Qu'est-ce qu'un bot personnalisé

Un bot personnalisé est Noxyr fonctionnant avec un token de bot que vous possédez. Les membres voient votre nom et votre avatar, mais le code, les réglages et la base de données sont ceux de Noxyr : une modification faite sur le tableau de bord s'applique aux deux bots, et rien n'est dupliqué.

Noxyr l'héberge pour vous sur l'un de ses nœuds. Chaque serveur n'a qu'un seul bot : là où votre bot personnalisé est présent, Noxyr s'efface et ne répond plus ; là où il ne l'est pas, Noxyr continue comme avant. Un compte Discord n'a droit qu'à un seul bot personnalisé, que vous pouvez utiliser dans autant de serveurs que vous administrez.

De quoi vous avez besoin

Un vote sur Top.gg: Voter pour Noxyr déverrouille le formulaire de configuration pendant 12 heures. C'est tout le prix : il n'existe aucune offre payante.
Votre propre application: Créez-en une dans le Portail des développeurs Discord. Le token de Noxyr est refusé, tout comme un token d'utilisateur.
Deux intents privilégiés: Server Members Intent et Message Content Intent doivent être activés sous Bot → Privileged Gateway Intents. Le tableau de bord vérifie cela avant d'accepter le token.
Noxyr dans le serveur: Votre bot personnalisé fonctionne avec les réglages et la base de données de Noxyr, donc Noxyr doit rester dans chaque serveur qu'il dessert.
Administrateur: Seules les personnes qui peuvent ouvrir le serveur sur le tableau de bord peuvent configurer un bot personnalisé pour celui-ci.

Mise en place

Votez pour Noxyr sur Top.gg, puis ouvrez Bot personnalisé sur le tableau de bord du serveur.
Dans le Portail des développeurs, cliquez sur Nouvelle application et donnez-lui le nom que le bot doit porter. Dans l'onglet Bot, définissez l'avatar et activez les deux intents privilégiés.
Cliquez sur Reset Token, copiez-le une seule fois et collez-le sur la page Bot personnalisé. Il est stocké chiffré ; seuls le site et le nœud qui fait tourner votre bot peuvent le lire.
Choisissez un hébergeur (Automatique sélectionne le nœud le plus rapide disposant de place) et cliquez sur Start my bot.
Utilisez le lien d'invitation fourni par la page. Le bot est en ligne en une vingtaine de secondes et enregistre les commandes de Noxyr sous son propre nom.

Seule la personne qui a collé le token peut le remplacer plus tard. Les autres administrateurs du serveur peuvent voir le bot, mais ils ne peuvent pas le remplacer par un autre token sous votre nom.

Fenêtre de vote, période de grâce et rappels

Un vote maintient le bot personnalisé déverrouillé pendant 12 heures, ce qui correspond aussi à la fréquence à laquelle Top.gg vous laisse voter. Quand cette fenêtre se ferme, une période de grâce de 74 heures commence : le bot continue de tourner, mais la page Bot personnalisé reste verrouillée jusqu'à votre prochain vote.

Un MP de rappel arrive 24 heures après votre dernier vote, soit 12 heures dans la période de grâce, avec un compte à rebours jusqu'à la coupure. Si la période de grâce expire aussi, le bot passe hors ligne et ses commandes sont retirées du serveur. Rien n'est supprimé : le token, les réglages et chaque ticket, produit et facture restent exactement en place, et un seul vote remet tout en marche.

Fenêtre de vote: 12 heures à partir du vote. Les deux compteurs défilent en direct sur la page Bot personnalisé.
Période de grâce: 74 heures après la fermeture de la fenêtre. Bot allumé, tableau de bord verrouillé.
MP de rappel: Envoyé une fois par fenêtre, 24 heures après le vote.
Désactivé: Après la période de grâce. Votez à nouveau et le bot redémarre tout seul.

Plus de temps sans voter

Les votes ne sont pas le seul moyen de garder un bot personnalisé en marche. Chacune des options ci-dessous ajoute des heures à ce qu'il vous reste, rien n'est perdu, et la page Obtenir plus de temps (Bot personnalisé → Obtenir plus de temps) affiche votre compte à rebours, votre situation pour chaque option et chaque heure qui vous a été créditée.

Noxyr Rush: Un mini-jeu dans le navigateur, sur le site. Obtenez 3,000 points en une partie et gagnez 12 heures. Vous pouvez détenir 12 heures de jeu à la fois ; une fois ces heures utilisées, vous pouvez en regagner. Seuls les comptes qui font tourner un bot personnalisé gagnent du temps, et le serveur vérifie chaque partie.
Inviter un ami: Partagez votre lien de parrainage depuis la page Obtenir plus de temps. Quand votre ami configure son premier bot personnalisé, vous gagnez tous les deux 12 heures. Cela ne compte qu'une fois par ami, son compte Discord doit avoir au moins 30 jours, et vous pouvez gagner du temps grâce à jusqu'à 10 amis tous les 30 jours.
Rapports de bugs et suggestions: Envoyez-en un via le Centre d'assistance. Lorsque l'équipe Noxyr l'approuve, vous obtenez 12 heures, une fois par rapport.
De la part de l'équipe: L'équipe Noxyr peut ajouter du temps directement, par exemple après une panne.

Si Noxyr est expulsé du serveur

Comme le bot personnalisé dépend de la présence de Noxyr, expulser Noxyr arrête le bot personnalisé dans ce serveur en une minute environ. Le bot envoie un MP à la personne qui a expulsé Noxyr et, si c'est une autre personne, au propriétaire du bot également, avec un lien d'invitation.

Réinvitez Noxyr et le bot personnalisé redémarre tout seul. Pendant qu'il est arrêté pour cette raison, votre fenêtre de vote est mise en pause plutôt que consommée, tant qu'aucun autre de vos bots n'est encore en marche.

Transférer votre fenêtre de vote à quelqu'un d'autre

La personne qui vote et celle à qui appartient le bot ne doivent pas forcément être le même compte. Depuis la page Bot personnalisé, vous pouvez céder votre fenêtre restante à un autre utilisateur Discord via son identifiant utilisateur, en totalité ou sur un nombre d'heures donné.

Le temps s'ajoute à ce qu'il possède déjà, un transfert ne le désavantage donc jamais. Vous conservez votre période de grâce, ainsi votre propre bot ne s'arrête pas en pleine action. Vous recevez tous les deux un MP indiquant ce qui a été transféré.

Seule une fenêtre active peut être transférée : une fois en période de grâce, il ne reste rien à céder. Les transferts de moins de cinq minutes sont refusés.

Dépannage

« Discord a rejeté ce token » (code de passerelle 4004): Le token a été réinitialisé dans le Portail des développeurs, l'ancien est donc invalide. Le bot reste désactivé jusqu'à ce que vous cliquiez de nouveau sur Reset Token et que vous colliez le nouveau sur la page Bot personnalisé.
« Discord a refusé la connexion » (code de passerelle 4013 / 4014): Un intent privilégié a été désactivé après la configuration. Réactivez Server Members Intent et Message Content Intent, puis rallumez le bot depuis le tableau de bord.
« Votez d'abord sur Top.gg »: Votre fenêtre de vote est terminée. Votez, puis réessayez : la page se déverrouille immédiatement.
« Ce bot est déjà le bot personnalisé du serveur de quelqu'un d'autre »: Une application ne peut appartenir qu'à un seul propriétaire. Créez une nouvelle application pour vous.
« Vous gérez déjà … »: Un compte, un bot personnalisé. Utilisez le bot existant sur ce serveur aussi (la page le propose), ou supprimez-le d'abord.
Changer de nœud est grisé: Chaque déplacement nécessite une nouvelle connexion Discord, il y a donc un délai de cinq minutes entre deux déplacements.
Le statut affiche « suspendu »: Soit le vote et la période de grâce sont tous deux écoulés, soit Noxyr a été expulsé du serveur. Le message de statut de la page indique laquelle.