Documentation
Économie et progressionGratuit

Économie

Devises, soldes des joueurs, paiements entre joueurs et classements de richesse, partagés par tout votre réseau.

Le module Économie donne à votre serveur sa propre monnaie. Vous pouvez utiliser une seule devise ou plusieurs (par exemple des pièces et des gemmes), laisser les joueurs se payer entre eux et suivre chaque opération depuis l'éditeur web. D'autres modules d'InglisCore, comme la boutique, les kits, les récompenses quotidiennes et l'hôtel des ventes, s'en servent pour débiter et payer les joueurs.

Fonctionnalités

  • Plusieurs devises, chacune avec son nom, son symbole, son nombre de décimales et son solde de départ.
  • Paiements entre joueurs avec /pay, avec un montant minimum et un délai entre deux paiements. Vous choisissez quelles devises peuvent être envoyées.
  • Classement avec /baltop, page par page, pour n'importe quelle devise.
  • Compatible Vault : si Vault est installé, la devise cochée « Vault » devient la monnaie du serveur pour tous les autres plugins qui utilisent Vault (boutiques, métiers, plugins de chat, etc.).
  • À l'échelle du réseau : les soldes sont partagés par tous les serveurs de votre réseau. Un joueur payé sur un serveur est prévenu sur celui où il joue.
  • Historique complet : chaque changement de solde est enregistré avec sa raison (paiement, achat, kit, récompense, modification par le staff, etc.).
  • Montants faciles à saisir : joueurs et staff peuvent taper 1500, 1 500, 12,5, 2k, 1.5m ou 1b.

Mise en place

Ouvrez le module Économie dans l'éditeur web.

Onglet Économie

Cet onglet donne une vue d'ensemble de votre économie :

  • Une tuile par devise, avec le total de monnaie en circulation et le nombre de comptes.
  • Classement : les 10 joueurs les plus riches dans la devise choisie.
  • Historique : toutes les opérations sur tous les soldes, avec une recherche par pseudo et un filtre par devise.

Pour modifier le solde d'un joueur, ouvrez son profil dans Joueurs, puis l'onglet Économie. Vous y voyez ses soldes et ses dernières opérations, et Modifier le solde vous permet d'Ajouter, de Retirer ou de Fixer un montant, avec une raison facultative.

Onglet Réglages

Devises est un tableau avec une ligne par devise :

Colonne Rôle Par défaut
Identifiant Nom court utilisé dans les commandes, par exemple /pay Steve 10 gems. Lettres minuscules, chiffres et _. coins, gems
Nom Nom affiché aux joueurs. Pièces, Gemmes
Symbole Affiché après les montants. ⛃, ✦
Décimales 0, 1 ou 2 chiffres après la virgule. 2 pour les pièces, 0 pour les gemmes
Solde de départ Ce que chaque joueur reçoit à sa première connexion. 100 pièces, 0 gemme
Vault La devise que les autres plugins voient via Vault. C'est aussi la devise principale d'InglisCore : quand un module n'a pas de devise définie, il utilise celle-ci. Cochée pour les pièces
Envoyable Indique si les joueurs peuvent envoyer cette devise avec /pay. Cochée pour les pièces, décochée pour les gemmes

Si aucune devise n'est cochée Vault, la première du tableau sert de devise principale.

Paiements

Réglage Rôle Par défaut
Montant minimum Plus petit montant qu'un joueur peut envoyer avec /pay. 1
Délai entre deux paiements Temps qu'un joueur doit attendre entre deux paiements. 2s

Classement

Réglage Rôle Par défaut
Joueurs par page Nombre de joueurs sur chaque page de /baltop (de 3 à 50). 10

Commandes

Commande Rôle Permission
/balance [currency] Affiche votre solde dans chaque devise, ou seulement dans celle indiquée. Alias : /bal, /money. inglis.economy.balance (tout le monde)
/balance <player> [currency] Affiche le solde d'un autre joueur, connecté ou non. inglis.economy.balance.others
/pay <player> <amount> [currency] Envoie de l'argent à un autre joueur, connecté ou non. Sans devise précisée, c'est la devise principale qui est utilisée. inglis.economy.pay (tout le monde)
/baltop [currency] [page] Joueurs les plus riches. Alias : /moneytop, /topmoney. inglis.economy.baltop (tout le monde)
/eco give <player> <amount> [currency] Ajoute de l'argent à un joueur. Alias : /economy. inglis.economy.admin (opérateurs)
/eco take <player> <amount> [currency] Retire de l'argent à un joueur. Refusé s'il n'en a pas assez. inglis.economy.admin (opérateurs)
/eco set <player> <amount> [currency] Fixe le solde exact d'un joueur. inglis.economy.admin (opérateurs)
/eco reset <player> [currency] Remet un joueur à son solde de départ. inglis.economy.admin (opérateurs)

Par défaut, seuls les opérateurs ont inglis.economy.balance.others : donnez-la à vos grades de staff.

Placeholders

Ils fonctionnent avec PlaceholderAPI et partout où InglisCore accepte des placeholders. Remplacez <id> par l'identifiant d'une devise, par exemple %ingliscore_balance_gems%.

Placeholder Affiche
%ingliscore_balance% Le solde dans la devise principale, en nombre brut (1234.5).
%ingliscore_balance_formatted% Le solde dans la devise principale, avec séparateurs et symbole (1,234.50 ⛃).
%ingliscore_balance_number% Le solde dans la devise principale, avec séparateurs, sans symbole.
%ingliscore_balance_<id>% Le solde dans cette devise, en nombre brut.
%ingliscore_balance_<id>_formatted% Le solde dans cette devise, avec séparateurs et symbole.
%ingliscore_balance_<id>_number% Le solde dans cette devise, avec séparateurs, sans symbole.

Les montants formatés suivent la langue du joueur.

Conseils

  • Choisissez l'identifiant d'une devise une bonne fois pour toutes : les soldes sont rattachés à l'identifiant, donc le renommer fait repartir cette devise de zéro. Le nom et le symbole, eux, se changent quand vous voulez.
  • Utilisez une devise non envoyable (comme les gemmes par défaut) pour les récompenses que vous ne voulez pas voir s'échanger entre joueurs.
  • Vous venez d'un autre plugin d'économie ? Vous pouvez récupérer les soldes grâce à une migration.