Faire un bot Discord avec DiSky

[SkyCraft78]

Bien le bonjour, jeunes gens!

Comme certains d'entre vous le savent, les bots Discord étaient faisable autrefois avec Vixio, un bon addon mais qui est maintenant remplie de bugs et abandonné par son développeur.

Depuis, DiSky est sorti et offrent plus de fonctionnalités tout en fixant les bugs présents de Vixio.

Sommaire

• Créez le bot et l'invitez

• Le connecter avec Skript

• Gérer son status

• Faire une commande simple

• Faire une commande complexe

• Liens utiles

1) Créez le bot et l'invitez sur votre serveur

Avant toute chose, vous devez vous rendre sur le Panel de développeur officiel Discord, d'où vous pourrez créer, modifiez puis invitez votre bot.

Connectez-vous, puis cliquez sur le bouton NEW APPLICATION en haut à droite:

 

 

 

 

 

 

 

 

 

 

Ensuite, entrez le nom (1) que vous voulez, il ne dépendra de rien pour la suite du tutoriel, puis cliquez sur CREATE (2):

 

 

 

 

 

 

 

 

 

 

 

 

Rendez-vous dans la partie BOT à droite, cliquez sur ADD A BOT puis validez avec YES, DO IT! :

 

 

 

 

 

 

 

 

 

 

 

Vous pouvez ensuite changez le nom ainsi que l'icone de votre bot. Ces deux informations seront affichés sur Discord.

Pour nous facilitez la tache dans la prochaine partie, copier le token en cliquant sur COPY !

 

 

 

 

 

 

 

 

 

 

 

 

 VOUS DEVEZ ACTIVEZ LES INTENTS! SANS, LE BOT NE SE CONNECTERA PAS:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Bien, maintenant que le bot en lui-même est créé et modifié, nous pouvons l'inviter :D

Pour cela, rendez-vous sur la partie OAUTH2 puis cochez toutes les cases montrées dans l'image. Copier le lien et invitez votre bot sur votre serveur parmi la liste qui s'affiche:

 

 

 

 

 

 

 

 

 

 

 

 

2) Le connecter avec Skript

Enfin, nous pouvons attaquer le concret; la partie du développement en Skript!

Vous n'avez qu'une seule ligne de code pour charger le bot. Utilisez:

# N'importe quel event, bien que je conseil le 'one load' ou 'on skript load'
on load:
	# Remplacez le token par le votre. Le nom importe peu, c'est juste pour reconnaitre le bot dans le reste du code.
	login to "TOKEN" with name "NAME"

Si jamais le bot n'est pas en ligne, vérifier si vous avez bien activé les intents comme indiqués précédemment!

Plus rapide que la précédente partie n'est-ce pas ?

3) Changer son status

Nous allons changez le online status du bot, puis le faire jouer quelque chose.

Le code est ici encore très simple à manier, mais voici un petit exemple:

# N'importe quel event, bien que je conseil le 'one load' ou 'on skript load'
on load:
	
	# Remplacez le token par le votre. Le nom importe peu, c'est juste pour reconnaitre le bot dans le reste du code.
	login to "TOKEN" with name "NAME"
	
	# On change son status, en utilisant le même nom utilisé précédemment.
	# Valeurs possibles: online, offline, idle, do not disturb
	set online status of bot "NAME" to do not disturb
    
    # Sur discord, il sera afficher comme "En train de jouer ..."
    # Valeurs possibles: playing, watching, competing, streaming, listening
    mark bot "NAME" as playing "Evoland 2, meilleur jeux ever <3"

4) Faire une commande basique (sans arguments)

On avance, notre bot est déjà beau visuellement, mais bon il sert à rien actuellement.

Nous allons faire une petite commande basique, qui renvoie, dans un embed, le ping actuel du bot:

# On définit une nouvelle commande nommée "ping", sans aucun argument:
discord command ping:
	# /!\ On marque une tabulation, c'est comme une section / event / condition !
	# On change aussi son préfix. Il peut en avoir plusieurs, il faut les séparer avec ,
	prefixes: !
	trigger:
		# Là on va créer un nouvel embed,
		make embed:
			# Et changez quelques de ses paramètres ...
			# Ici, on set simplement le ping avant, pour éviter de doubler les " après dans l'author.
			set {_ping} to ping of bot "NAME"
			set author of embed to "Pong ... %{_ping}%MS"
			set author icon of embed to avatar of event-user
			set color of embed to lime
		# Puis on renvoie l'embed précédemment créé:
		reply with last embed

Résultat:

5) Faire une commande complexe (avec arguments)

Nous allons cette fois si utiliser une condition, ainsi que deux arguments dans notre commande.

Elle nous servira pour tester si un membre spécifique à un rôle spécifique ou non, en renvoyant un message de validation.

# Le nom des commandes n'est pas case sensitive, donc 'hasRole' = 'hasrole'

# Les arguments Discord marchent exactement comme les arguments Skript:
# - Utilisez '<type>' pour un argument obligatoire
# - Utilisez '[<type>]' pour un argument optionnel
discord command hasRole [<member>] [<role>]:
	trigger:
    	# Une simple condition que propose DiSky, dispo sur la documentation:
        # https://skripthub.net/docs/?id=5209
        if arg-1 has role arg-2:
        	# Ici, le membre spécifié à bien le role, donc on vas renvoiyer oui
           	reply with "**:white_check_mark: %discord name of arg-1% à bien le role %discord name of arg-2%!**"
        else:
        	# Ici non, donc:
            reply with "**:x: %discord name of arg-1% n'a pas le role %discord name of arg-2%!**"

6) Liens utiles

• Téléchargement
• Documentation
• Discord
• Source Code
• Rapport d'Issue

Et voilà ! Vous savez maintenant comment utilisez DiSky et faire des commandes avec quelques arguments!

N'hésitez pas à faire des retours, sachant que c'est mon premier tutoriel il n'a rien de parfait

Merci encore de votre lecture et bonne journée / soirée !

 

[HakrayIII]

on load:
	
	# Remplacez le token par le votre. Le nom importe peu, c'est juste pour reconnaitre le bot dans le reste du code.
	login to "TOKEN" with name "NAME"
	
	# On change son status, en utilisant le même nom utilisé précédemment.
	# Valeurs possibles: online, offline, idle, do not disturb
	set online status of bot "NAME" to do not disturb
    
    # Sur discord, il sera afficher comme "En train de jouer ..."
    # Valeurs possibles: playing, watching, competing, streaming, listening
    mark bot "NAME" as playing "Evoland 2, meilleur jeux ever <3"

ça ne fonctionne pas rien que le (login to "TOKEN" with name "NAME") n'est pas reconnu 

[Hecate]

Pour les gens qui passe ici, le tuto n'est plus à jour cela ne sert à rien d'écrire que ça ne marche pas
Les dernières version de Disky ne supporte que la 2.6.X et certaines syntaxes ont changées

Modifié le 6 janvier 2023 par Hecate
Quand on fait un tuto on indique les version d'addons/Skript