MyEconomy

Documentation · v1.2

Installation et démarrage

Prérequis

Serveur Paper 1.21+ (ou dérivé). Vault est recommandé pour l'intégration avec les autres plugins (shops, jobs, etc.). Optionnel : PlaceholderAPI, DecentHolograms, MyCore.

Installation pas à pas

  1. Téléchargez MyEconomy.jar depuis la page Téléchargements du site.
  2. Placez le fichier dans le dossier plugins/ à la racine de votre serveur Minecraft.
  3. Redémarrez le serveur (ou exécutez /reload si votre hébergeur le permet).
  4. Au premier démarrage, le fichier plugins/MyEconomy/config.yml est créé automatiquement.

Vérification

En jeu, tapez /balance (ou /bal). Si le plugin est chargé, votre solde s'affiche. Les nouveaux joueurs reçoivent un solde de départ défini dans la config.

Premiers pas

Commandes essentielles : /balance ou /bal pour voir son solde, /pay <joueur> <montant> pour envoyer de l'argent, /ecomenu pour ouvrir le menu graphique. Personnalisez la monnaie et les classements dans config.yml.

Exemple de configuration

Extrait du fichier config.yml pour la monnaie et le solde de départ :

currency:
  name: "coins"
  symbol: ""
  decimals: 2
starting-balance:
  amount: 100.0
  welcome-message: "&aYou received &e{amount} {currency} &a!"

Commandes

Commandes joueur

CommandeDescriptionAlias
/balance [joueur]Affiche le soldebal, money
/pay <joueur> <montant>Envoyer de l'argentsend
/baltop [weekly|monthly]Classement des plus richestopbalance, topbal
/ecomenuOuvre le menu économiemoneymenu, economy, market, prices
/transactions [joueur] [page]Historique des transactionshistory, tx

Commandes admin

/eco <give|take|set|reset> <joueur> [montant] — Donner, retirer, définir ou réinitialiser le solde d'un joueur.

Permissions

  • myeconomy.player — Commandes joueur (balance, pay, baltop, menu, transactions)
  • myeconomy.balance.others — Voir le solde des autres
  • myeconomy.admin — Commandes /eco
  • myeconomy.admin.hologram — Gestion des hologrammes

Configuration (config.yml)

Général

general.language — Langue (en, fr, es, de, etc.). general.prefix — Préfixe des messages. general.debug — Messages de debug.

Monnaie

currency.name, currency.singular, currency.plural, currency.symbol, currency.decimals, currency.display-format (name ou symbol), currency.short-format (1.5K, 1.2M).

Solde de départ

starting-balance.amount — Montant pour les nouveaux joueurs. starting-balance.welcome-message — Message de bienvenue (placeholders: {amount}, {currency}).

Paiements (/pay)

pay.enabled, pay.min-amount, pay.max-amount, pay.tax-percentage, pay.require-confirmation-above, pay.allow-self-pay, pay.quick-amounts (montants rapides dans le GUI).

Classements

rankings.top-size. Classement hebdomadaire : rankings.weekly.enabled, reset-day, rewards.positions. Classement mensuel : rankings.monthly (même structure).

Sécurité

security.max-transactions-per-minute, transaction-cooldown, max-balance, min-balance, allow-negative-balance.

Base de données

database.type — yaml, mysql ou sqlite. Puis database.mysql ou database.sqlite selon le type.

Hologrammes (DecentHolograms)

holograms.enabled, update-interval, format.title-global, format.line-format (placeholders: {rank}, {player}, {balance}, {currency}).

Fonctionnalités

Économie complète

Monnaie personnalisable (nom, symbole, décimales), solde de départ, historique des transactions.

Classements

Classement global, hebdomadaire et mensuel avec récompenses automatiques (top 1, 2, 3). Réinitialisation configurable (jour de la semaine ou jour du mois).

Menu GUI

/ecomenu — Interface pour consulter le solde, envoyer de l'argent (montants rapides), voir les classements.

Intégrations

  • Vault — API économie pour les autres plugins
  • PlaceholderAPI — Placeholders (solde, rang, etc.)
  • DecentHolograms — Hologrammes des classements
  • MyCore — Événements et API
  • Maison de vente aux enchères (taxes, suivi des transactions)

Sécurité

Limite de transactions par minute, cooldown, plafond de solde, confirmation pour les gros montants.