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ée à expliciter les commandes de Kaelly avec des exemples d'utilisation.
!help explique de manière succincte 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).
!almanax true : poste quotidiennement l'almanax du jour. Fonctionne aussi avec on et 0.
!almanax false : ne poste plus l'almanax dans le salon. Fonctionne aussi avec off et 1.

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 suffisamment précis.
!item -more item : renvoie les statistiques détaillés de l'item spécifiée.

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.

Renvoie les statistiques d'un monstre du jeu Dofus.
!monster monstre : renvoie les statistiques du monstre spécifié : son nom peut être approximatif s'il est suffisamment précis.
!monster -more monstre : renvoie les statistiques détaillés du monstre spécifié.

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'utilisations 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 tags 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é 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 sur dofuspourlesnoobs : quête, donjon... Son nom peut être approximatif s'il est suffisamment 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 personnelle 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.

Attention, cette section est avant tout réservée à un public averti : si vous ne maîtrisez pas un minimum l'informatique, veuillez utiliser le bot officiel dont le lien est disponible plus haut. Dans le cas contraire, un support moindre sera apporté, mais il faudra savoir se débrouiller un minimum soi-même !

1. Connectez-vous sur le site developers discord.
2. Dans Application > MyApp : Cliquez sur New App.
3. Renseignez le nom du Bot, une brève description et une icône.
4. Une fois créé, Cliquez sur "Create a bot user".
5. Cochez la case "Public bot" si vous souhaitez qu'il soit accessible par n'importe qui.
6. 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ée 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épendamment en utilisant des commandes telles que screen ou encore tmux sur Linux, par exemple.

Ce projet est sous licence GPL(v3).