Aller au contenu

character — Personnage

API personnage MoonBot Lua : niveau, vie, PA, PM, kamas, caractéristiques, position du personnage.

29 fonctions dans ce namespace.

Index

Référence

Identite

character.name() / level() / classId() / id() / sex() / breed() / breedName() / nickname() / accountId()

returns string | number | boolean

name()→string, level()→number, classId()→number (1=Feca, 2=Osa, 3=Enu, 4=Sram, 5=Xelor, 6=Eca, 7=Eni, 8=Iop, 9=Cra, 10=Sadi, 11=Sacri, 12=Panda), id()→number, sex()→boolean (false=male, true=female), breed()=classId(), breedName()→string ('Feca', 'Iop'...), nickname()→string, accountId()→string.

Points de vie

character.hp() / hpMax() / hpPercent() / lifePoints() / maxLifePoints() / lifePointsP()

returns number

PV actuels, max, et pourcentage.

Ressources

character.kamas() / xp() / xpPercent() / energy() / energyMax()

returns number

Kamas, XP, energie.

Pods

character.pods() / podsPercent()

returns number, number / number

pods() retourne (current, max). podsPercent() retourne le %.

Position

character.position() / mapId() / cellId() / x() / y()

returns number, number | number

position()→(x: number, y: number) deux valeurs. mapId()→number (ex: 7412). cellId()→number (0-479). x()→number, y()→number.

Combat

character.ap() / mp() / initiative() / range() / prospecting()

returns number

PA, PM, initiative, portee, prospection.

Serveur

character.server() / serverId()

returns string / number

Nom et ID du serveur.

Stats de base

character.vitality() / wisdom() / strength() / intelligence() / chance() / agility()

returns number

Statistiques actuelles.

Stats de base (base)

character.getVitalityBase() / getWisdomBase() / getStrengthBase() / getIntelligenceBase() / getChanceBase() / getAgilityBase()

returns number

Valeurs de base (sans bonus equipement).

Cout du prochain boost

character.getCostVitality() / getCostWisdom() / getCostStrength() / getCostIntelligence() / getCostChance() / getCostAgility()

returns number

Points necessaires pour le prochain boost de stat.

Boost stats (+1)

character.UpgradeStrength(pts?) / UpgradeVitality(pts?) / UpgradeWisdom(pts?) / UpgradeChance(pts?) / UpgradeAgility(pts?) / UpgradeIntelligence(pts?)

Depense des points de stats. Sans parametre = 1 point.

Monter une stat au niveau X

character.statUpgrade(statName: string, targetBase: number)

returns boolean

Monte une stat de base jusqu'a la valeur cible. statName: 'strength', 'vitality', 'wisdom', 'chance', 'agility', 'intelligence' (ou FR: 'force', 'vitalite', 'sagesse', 'agilite'). Gere le cout automatiquement. Retourne true si atteint, false si plus de points.

Points dispo

character.statsPoints() / spellPoints()

returns number

Points de stats et sorts disponibles.

Monter un sort

character.upgradeSpell(spellId: number)

returns boolean

Monte un sort d'un niveau (coute 1 point de sort). Retourne false si aucun point dispo.

Monter un sort au niveau X

character.spellUpgrade(spellId: number, targetLevel: number)

returns boolean

Monte un sort jusqu'au niveau cible. Envoie autant de SB que necessaire (500ms entre chaque). Retourne true si atteint, false si plus de points.

Niveau d'un sort

character.spellLevel(spellId: number)

returns number

Niveau actuel du sort (0 si pas appris).

Etat

character.isInFight()

returns boolean

True si en combat.

Alignement

character.alignment()

returns number, string | nil

Camp du personnage suivi de son nom : 0 neutre, 1 bontarien, 2 brakmarien, 3 mercenaire (ex: 1, "bontarien"). nil tant que le serveur ne l'a pas envoye (As).

Ailes (etat)

character.hasWings()

returns boolean | nil

true si les ailes (mode Joueur contre joueur) sont activees, false sinon, nil si inconnu. Ailes activees, les joueurs du camp adverse peuvent agresser le personnage.

Activer / desactiver les ailes

character.setWings(enabled: boolean, maxHonourLoss?: number)

blocking · returns boolean, string?

Comme le panneau d'alignement officiel. Activer envoie GP+ ; le serveur garde alors les ailes au moins 10 minutes. Desactiver envoie GP*, lit la perte d'honneur annoncee par le serveur (GIP), laisse 1,5 a 4 s comme pour lire la confirmation, puis envoie GP-. Avec maxHonourLoss, les ailes sont gardees si la perte le depasse. Retourne true quand le serveur a confirme (10 s max), ou tout de suite si c'est deja le cas ; sinon false et la raison (personnage neutre, combat, refus du serveur). Les ailes sont exigees pour voler d'un prisme a un autre.

Abonnement Dofus

character.isSubscribed()

returns boolean

True si le compte Dofus est encore abonne.

Jours d'abo restants

character.subscriptionDaysLeft()

returns number

Jours restants (float, ex: 12.5). Retourne -1 si inconnu.

Fin d'abo (epoch)

character.subscriptionEndEpoch()

returns number

Timestamp epoch ms de fin d'abonnement. 0 si inconnu.

Fin d'abo (texte)

character.subscriptionEnd()

returns string

Temps restant en texte (ex: '12 jours'). Persiste en base de donnees.

Equiper un preset

character.equipPreset(id: number)

returns boolean

Equipe un ensemble d'equipement rapide sauvegarde. L'id correspond au slot (0, 1, 2...). Attend 1s apres l'envoi.

Sauvegarder un preset

character.savePreset(id: number)

returns boolean

Sauvegarde l'equipement actuellement porte dans le preset donne. Ecrase le contenu precedent.

Creer un preset

character.createPreset(id: number, iconId: number, name: string)

returns boolean

Cree un nouveau preset d'equipement rapide. iconId: 0-15 (etoile, epee, bouclier, diamant, etc). Le preset sauvegarde l'equipement actuel.

Supprimer un preset

character.deletePreset(id: number)

returns boolean

Supprime un preset d'equipement rapide.

Aliases et compatibilite

character.energyPoints() / maxEnergyPoints() / statsPoint() / freeMode() / certified() / trusted()

returns number / boolean

energyPoints et maxEnergyPoints sont les aliases d'energie; statsPoint retourne les points de caracteristiques. freeMode retourne false; certified et trusted retournent true pour compatibilite.