KaellyBOT est destinée à fournir des commandes utiles à la communauté de DOFUS ! L'intégralité de son code est libre d'accès. Si vous avez des questions, des suggestions ou que vous souhaitez juste passer un coucou, rejoignez le serveur discord du support :
Cette commande est destiné à expliciter les commandes de Kaelly avec des exemples d'utilisation.
!help
explique de manière succinte chaque commande.
!help command
explique de façon détaillée la commande spécifiée.
Donne des informations relatives à l'Almanax.
!almanax
: Donne le bonus et l'offrande du jour actuel.
!almanax jj/mm/aaaa
: Donne le bonus et l'offrande du jour spécifié.
!almanax +days
: donne la liste des bonus et offrandes des jours à venir (jusqu'à 9 jours).
Informations relatives à Kaelly.
!about
: Donne des informations sur KaellyBOT et un moyen d'obtenir de l'aide.
Autorise ou non l'utilisation d'une commande de Kaelly.
!cmd command true
: Autorise l'utilisation de la commande. Fonctionne aussi avec on
et 0
.
!cmd command false
: Interdit l'utilisation de la commande. Fonctionne aussi avec off
et 1
.
Renvoie les statistiques d'un item du jeu Dofus.
!item item
: Renvoie les statistiques de l'item spécifié : son nom peut être approximatif s'il est suffisemment précis.
Gère un annuaire d'artisans.
!job
: Renvoie la liste des métiers du jeu Dofus.
!job métier
: Renvoie l'annuaire des artisans pour ce métier.
!job métier niveau
: Vous ajoute à l'annuaire du métier correspondant. Si vous indiquez 0, vous êtes supprimé de l'annuaire pour ce métier.
!job -all niveau
: Vous ajoute à l'annuaire pour tous les métiers correspondants. Si vous indiquez 0, vous êtes supprimé de chaque annuaire.
Tire au hasard une carte du Goultarminator.
!map
: Tire au hasard une carte du Goultarminator ou bien parmi celles spécifiées en paramètre.
!map map1 map2 ...
: Tire une carte parmi celles spécifiées en paramètre. Nombres romains ou numériques uniquement.
Gère les positions de portails de dimension.
!pos dimension
: Donne la position du portail de la dimension désirée.
!pos dimension [POS, POS]
: Met à jour la position du portail de la dimension spécifiée.
!pos dimension [POS, POS] nombre d'utilisations
: Met à jour la position et le nombre d'utilisation de la dimension spécifiée.
!pos -reset dimension
: Supprime les informations de la dimension spécifiée.
Change le préfixe utilisé pour invoquer une commande. Niveau modérateur minimum requis.
!prefix prefix
: Change le préfixe par celui passé en paramètre. 3 maximum.
Commande tirant des valeurs aléatoires.
!rdm
: Tire une valeur entre Vrai et Faux.
!rdm nombre
: Tire une valeur entre 0 et nombre.
!rdm valeur1 valeur2 ...
: Tire une valeur parmi celles spécifiées en paramètre.
Gère les droits d'administration de Kaelly.
!right
: Donne le niveau d'administration de l'auteur de la requête.
!right @pseudo
: Donne le niveau d'administration de l'utilisateur ou d'un groupe spécifié.
!right @pseudo niveau
: Change le niveau d'administration d'un utilisateur ou d'un groupe spécifié.
Autorise ou non Kaelly à poster du contenu RSS dans un salon.
!rss true
: Poste les news à partir du flux RSS de Dofus.com. Fonctionne aussi avec on
et 0
.
!rss false
: Ne poste plus les flux RSS dans le salon. Fonctionne aussi avec off
et 1
.
Poste des images sexuellement explicite.
!rule34 tag1 tag2 ...
: Poste du contenu sexuellement explicite (NSFW) avec les tag précisés.
Joue des sons dans un salon vocal.
!sound
: Joue un son au hasard, parmi une liste prédéfinie.
!sound sound
: Joue le son spécifié.
Permet de déterminer à quel serveur Dofus correspond ce serveur Discord.
!server
: Affiche le serveur Dofus rattachée au serveur Discord.
!server server
: Permet de déterminer à quel serveur Dofus correspond ce serveur Discord.
!server -reset
: Permet de se détacher d'un quelconque serveur Dofus.
Renvoie le tutoriel correspondant à la recherche effectuée..
!tuto search
: renvoie le tutoriel correspondant à la recherche effectuée : quête, donjon... Son nom peut être approximatif s'il est suffisemment précis.
Autorise ou non Kaelly à poster des tweets dans un salon.
!twitter true
: Poste les tweets de Dofusfr. Fonctionne aussi avec on
et 0
.
!twitter false
: Ne poste plus les tweets dans le salon. Fonctionne aussi avec off
et 1
.
Affiche la page personelle d'un joueur.
!whois *pseudo*
: Donne la page personnelle associée au pseudo. Celui-ci doit être exact.
!whois *pseudo serveur*
: Est à utiliser lorsque le pseudo ne suffit pas pour déterminer la fiche d'un personnage.
Tout le monde peut aider au développement de KaellyBOT ! Proposez des suggestions, remontez des bugs sur le support ou bien développez des évolutions en proposant vos pulls request : https://github.com/Kaysoro/KaellyBot/pulls.
- Connectez vous sur le site developers discord.
- Dans Application > MyApp : Cliquez sur New App.
- Renseignez le nom du Bot, une brève description et une icône.
- Une fois créé, Cliquez sur "Create a bot user".
- Cochez la case "Public bot" si vous souhaitez qu'il soit accessible par n'importe qui.
- Récupérez le client ID et le token, ils vous serviront à ajouter votre bot sur un serveur et à le mettre en route.
Ne diffusez pas votre token, il permettrait à n'importe qui de modifier votre bot.
Vous avez créé votre bot sur le site de Discord et vous souhaitez l'inviter sur un serveur. Récupérez le client ID de votre bot et placez le à la place de CLIENT_ID dans l'url suivante : https://discordapp.com/oauth2/authorize?&client_id=CLIENT_ID&scope=bot
Maintenant que vous avez déclaré votre application sur la plateforme Discord, il suffit d'ajouter le token précèdemment copié dans le fichier config.properties, de telle sorte que : discord.token=TOKEN.
Avant de continuer il faut ajouter la base de données bdd.sqlite à la racine du dossier; celle-ci est en libre téléchargement sur le serveur de support KaellyBOT, dans le salon #trucs_utiles.
Installer Maven sur votre machine puis exécutez les commandes suivantes :
cd VotreProjet
mvn clean compile
mvn assembly:single
- En double cliquant dessus (Ne prémunit pas d'éventuelles erreurs).
- En l'exécutant depuis la console :
java -jar jarfile
(Permet aussi d'avoir les logs du bot).
Kaelly peut être lancé depuis n'importe quelle distribution : elle est compatible Windows/Linux/MacOS. Un serveur VPS est nécessaire pour son autonomie (sans quoi il devra tourner sur votre machine personnelle); il pourra fonctionner indépendemment en utilisant des commandes tels que screen
ou encore tmux
sur Linux, par exemple.
Ce projet est sous licence GPL(v3).