Documentation NovaMobCoins

📚 Documentation NovaMobcoins

📖 Table des matières

1. Installation

2. Configuration

3. Commandes

4. Permissions

5. Système de Licence

6. Gains de Mobcoins

7. Shop avec Rotation

8. Récapitulatif Périodique

9. Base de Données

10. PlaceholderAPI

11. Dépannage

---

🚀 Installation

Prérequis

• Serveur Minecraft Spigot/Paper 1.16+

• Java 17+

• PlaceholderAPI (optionnel mais recommandé)

Étapes d'installation

1. Télécharger le plugin

   • Récupérez le fichier NovaMobcoins.jar

2. Placer le fichier

   /plugins/NovaMobcoins.jar

3. Premier démarrage

   • Démarrez le serveur

   • Le dossier /plugins/NovaMobcoins/ sera créé

   • Le fichier config.yml sera généré

4. Accepter l'EULA

   # Dans config.yml
   eula:
     accept-eula: true  # Changez de false à true

5. Configurer la licence

   # Dans config.yml
   license:
     key: "VOTRE-CLE-LICENCE-ICI"

6. Redémarrer le serveur

   • Le plugin démarrera normalement

---

⚙️ Configuration

Structure du config.yml

config.yml
├── eula             # Acceptation EULA
├── license          # Clé de licence
├── database         # Configuration BDD
├── cache            # Système de cache
├── performance      # Paramètres de performance
├── mobs             # Gains et récapitulatif
├── shop             # Configuration shop
├── top              # Classement
├── logging          # Logs
├── security         # Sécurité
├── messages         # Messages personnalisables
└── integrations     # PlaceholderAPI, Discord, etc.

Configuration des gains de mobs

mobs:
  gains:
    ZOMBIE: 5           # Zombie donne 5 mobcoins
    SKELETON: 7
    CREEPER: 10
    ENDERMAN: 15
    WITHER: 500
    ENDER_DRAGON: 1000

Multiplicateurs de monde

mobs:
  world-multipliers:
    "world_nether": 1.5   # x1.5 dans le Nether
    "world_the_end": 2.0  # x2.0 dans l'End

Exemple : Tuer un Zombie dans le Nether = 5 × 1.5 = 7.5 mobcoins

---

💬 Commandes

Commandes joueurs

Commande	Description	Permission
/mc help	Afficher l'aide	novamobcoins.use
/mc about	Infos sur le plugin	novamobcoins.use
/mc balance	Voir son solde	novamobcoins.balance
/mc balance <joueur>	Voir le solde d'un joueur	novamobcoins.balance.other
/mc shop	Ouvrir le shop	novamobcoins.shop
/mc top	Voir le classement	novamobcoins.top
/mc pay <joueur> <montant>	Envoyer des mobcoins	novamobcoins.pay

Commandes administrateur

Commande	Description	Permission
/mc reload	Recharger la config	novamobcoins.admin
/mc give <joueur> <montant>	Donner des mobcoins	novamobcoins.admin
/mc set <joueur> <montant>	Définir le solde	novamobcoins.admin
/mc take <joueur> <montant>	Retirer des mobcoins	novamobcoins.admin

Exemples

/mc balance
→ Affiche : "Votre solde: 1,250 mobcoins"

/mc give Notch 1000
→ Donne 1000 mobcoins à Notch

/mc pay Steve 500
→ Envoie 500 mobcoins à Steve

/mc shop
→ Ouvre l'interface du shop

---

🔑 Permissions

Permissions de base

permissions:
  novamobcoins.use:
    description: Utiliser le plugin
    default: true
    
  novamobcoins.balance:
    description: Voir son solde
    default: true
    
  novamobcoins.balance.other:
    description: Voir le solde des autres
    default: op
    
  novamobcoins.shop:
    description: Accéder au shop
    default: true
    
  novamobcoins.top:
    description: Voir le classement
    default: true
    
  novamobcoins.pay:
    description: Envoyer des mobcoins
    default: true

Permissions administrateur

permissions:
  novamobcoins.admin:
    description: Commandes admin
    default: op
    children:
      - novamobcoins.give
      - novamobcoins.set
      - novamobcoins.take
      - novamobcoins.reload

Configuration avec LuckPerms

# Donner accès au plugin
/lp group default permission set novamobcoins.use true

# Donner accès admin
/lp user Admin permission set novamobcoins.admin true

# Permission spécifique pour le shop
/lp group vip permission set novamobcoins.shop true

---

🔐 Système de Licence

Comment obtenir une licence ?

1. Contacter le support

   • Discord: https://discord.gg/HtjPAfqUXu

   • Indiquer votre serveur et vos besoins

2. Recevoir votre clé

   • Format: XXXX-XXXX-XXXX-XXXX

3. Configurer dans config.yml

   license:
     key: "VOTRE-CLE-LICENCE-ICI"

Vérification de licence

Le plugin vérifie la licence :

• ✅ Au démarrage (bloquant)

• ✅ Toutes les 30 minutes (vérification périodique)

• ✅ **Lors d'un /mc reload

Messages de licence

✓ LICENCE VALIDÉE AVEC SUCCÈS !
  Titulaire: Votre Nom
  Type: Premium

🛑 DÉMARRAGE IMPOSSIBLE: LICENCE INVALIDE
  Le serveur de validation a rejeté votre licence.
  Contactez le support: https://discord.gg/HtjPAfqUXu

Que faire en cas de problème ?

1. Vérifier la clé dans config.yml

2. Vérifier la connexion internet du serveur

3. Contacter le support avec les logs

---

💰 Gains de Mobcoins

Comment gagner des mobcoins ?

Tuez des mobs ! Chaque mob configuré donne des mobcoins :

ZOMBIE: 5        # Facile
SKELETON: 7
CREEPER: 10
ENDERMAN: 15     # Moyen
BLAZE: 20
WITHER_SKELETON: 25
ELDER_GUARDIAN: 100  # Rare
WITHER: 500      # Boss
ENDER_DRAGON: 1000

Multiplicateurs de monde

Gagnez plus de mobcoins dans certains mondes :

world-multipliers:
  "world_nether": 1.5   # +50% dans le Nether
  "world_the_end": 2.0  # +100% dans l'End

Messages de gain

Silencieux : Pas de spam dans le chat

gain-message:
  enabled: false  # Pas de message à chaque kill

Avec message :

gain-message:
  enabled: true
  format: "&a+{amount} mobcoins &7(Mob: &e{mob}&7)"

Anti-spam

Le plugin évite le spam avec :

• Délai minimum entre gains : 50ms

• Cache optimiste pour réactivité instantanée

• Traitement asynchrone

---

🛒 Shop avec Rotation

Concept

Le shop affiche un nombre limité d'items qui changent régulièrement !

Configuration

shop:
  rotation:
    enabled: true              # Activer la rotation
    items-displayed: 6         # 6 items affichés simultanément
    rotation-interval: 3600    # Rotation toutes les heures
    shuffle-on-restart: true   # Mélanger au redémarrage
    announce-rotation: true    # Annoncer les rotations

Types d'items

1. Items physiques

Donnent un item au joueur :

diamond:
  slot: auto                 # Slot automatique (rotation)
  material: DIAMOND
  amount: 1
  price: 100
  name: "&b&lDiamant"
  give-item: true            # ✅ Donne l'item
  commands: []

2. Items par commandes

Exécutent des commandes :

vip_rank:
  slot: auto
  material: DIAMOND
  price: 5000
  name: "&6&lGrade VIP"
  give-item: false           # ❌ Ne donne pas l'item
  commands:
    - "lp user {player_name} parent add vip"
    - "tell {player_name} &aVous êtes VIP !"
    - "broadcast &e{player_name} &aest devenu VIP !"

Placeholders dans les commandes

• {player} : Nom du joueur

• {player_name} : Nom du joueur (alias)

• {uuid} : UUID du joueur

• {price} : Prix de l'item

Slots

slot: auto      # Rotation automatique
slot: 10        # Slot fixe (toujours affiché)

---

📊 Récapitulatif Périodique

Fonctionnement

Toutes les X minutes, le joueur reçoit un récapitulatif détaillé :

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
📊 Récapitulatif - 10 minutes

⚔ Zombie x45 → +225 mobcoins
⚔ Skeleton x32 → +224 mobcoins
⚔ Creeper x18 → +180 mobcoins
⚔ Spider x52 → +156 mobcoins

📊 TOTAL
💰 Mobcoins gagnés: +785
⚔ Mobs tués: 147
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Configuration

mobs:
  recap:
    # Activer/Désactiver
    enabled: true
    
    # Intervalle en secondes
    interval: 600  # 10 minutes
    # Exemples: 60=1min, 300=5min, 1800=30min
    
    # Afficher même si 0 mobcoins
    show-when-zero: false

Personnalisation des messages

recap:
  header: "&8▬▬▬▬▬▬▬▬▬▬..."
  title: "&6&l📊 Récapitulatif - {time}"
  mob-line: "&e⚔ {mob} &7x{kills} &8→ &a+{mobcoins} mobcoins"
  total-title: "&6&l📊 TOTAL"
  total-mobcoins: "&e💰 Mobcoins gagnés: &a+{total}"
  total-kills: "&e⚔ Mobs tués: &a{kills}"
  footer: "&8▬▬▬▬▬▬▬▬▬▬..."

Placeholders disponibles

• {time} : Durée formatée (ex: "10 minutes", "1 heure")

• {mob} : Nom du mob

• {kills} : Nombre de kills

• {mobcoins} : Mobcoins gagnés pour ce mob

• {total} : Total mobcoins

• {kills} (dans total-kills) : Total de mobs tués

Exemples d'intervalles

interval: 60     # 1 minute (test)
interval: 300    # 5 minutes
interval: 600    # 10 minutes (par défaut)
interval: 1800   # 30 minutes
interval: 3600   # 1 heure

---

🗄️ Base de Données

Types supportés

1. SQLite (par défaut)

2. MySQL (recommandé pour multi-serveurs)

3. MongoDB (expérimental)

Configuration SQLite

database:
  type: "sqlite"
  sqlite:
    file: "mobcoins.db"
    wal_mode: true           # Performance
    synchronous: "NORMAL"
    cache_size: 10000

Avantages :

• ✅ Aucune configuration requise

• ✅ Pas de serveur externe

• ✅ Parfait pour 1 serveur

Limites :

• ❌ 1 serveur uniquement

• ❌ Performance limitée sur gros serveur

Configuration MySQL

database:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    database: "novamobcoins"
    username: "root"
    password: "votre_mot_de_passe"
    ssl: false
    pool-size: 8             # Connexions simultanées

Avantages :

• ✅ Multi-serveurs (BungeeCord/Velocity)

• ✅ Meilleure performance

• ✅ Sauvegardes faciles

Configuration requise :

1. Créer la base de données MySQL

2. Créer un utilisateur dédié

3. Configurer le plugin

Commandes MySQL

-- Créer la base de données
CREATE DATABASE novamobcoins;

-- Créer l'utilisateur
CREATE USER 'mobcoins'@'localhost' IDENTIFIED BY 'mot_de_passe_fort';

-- Donner les permissions
GRANT ALL PRIVILEGES ON novamobcoins.* TO 'mobcoins'@'localhost';
FLUSH PRIVILEGES;

Cache

Le plugin utilise un système de cache intelligent :

cache:
  enabled: true
  player-data-expire: 30     # Expiration en secondes
  balance-cache-ttl: 30
  top-refresh-interval: 60

Avantages :

• ⚡ Réactivité instantanée

• 📉 Réduction des requêtes DB

• 🚀 Performance optimale

---

📊 PlaceholderAPI

Installation

1. Installer PlaceholderAPI

2. Redémarrer le serveur

3. NovaMobcoins se connecte automatiquement

Placeholders disponibles

Placeholder	Description	Exemple
%novamobcoins_balance%	Solde du joueur	1,250
%novamobcoins_balance_formatted%	Solde formaté	1.25k
%novamobcoins_rank%	Rang dans le top	#5
%novamobcoins_top_1_name%	Nom du 1er	Notch
%novamobcoins_top_1_balance%	Solde du 1er	50,000
%novamobcoins_top_2_name%	Nom du 2ème	Steve
%novamobcoins_top_2_balance%	Solde du 2ème	45,000
%novamobcoins_top_3_name%	Nom du 3ème	Alex
%novamobcoins_top_3_balance%	Solde du 3ème	40,000

Exemples d'utilisation

ScoreBoard (FeatherBoard)

scoreboard:
  lines:
    - "&6Mobcoins"
    - "&e%novamobcoins_balance%"
    - ""
    - "&6Votre rang"
    - "&e%novamobcoins_rank%"

Chat (EssentialsChat)

format: '{DISPLAYNAME} &7[&e{novamobcoins_balance}&7]&r: {MESSAGE}'

Tab (TAB)

tabprefix: "&7[&e%novamobcoins_balance%&7] "

---

🔧 Dépannage

Problème : Base de données en lecture seule

[ERROR] Attempt to write a readonly database

Solution :

# Arrêter le serveur
stop

# Corriger les permissions
chmod 666 plugins/NovaMobcoins/mobcoins.db
chmod 777 plugins/NovaMobcoins/

# Ou supprimer et recréer
rm plugins/NovaMobcoins/mobcoins.db

# Redémarrer

Problème : Pas de mobcoins en tuant des mobs

Checklist :

1. ✅ Le plugin est-il démarré ?

2. ✅ L'EULA est-elle acceptée ?

3. ✅ La licence est-elle valide ?

4. ✅ Le mob est-il configuré dans config.yml ?

5. ✅ Avez-vous la permission novamobcoins.use ?

6. ✅ Y a-t-il des erreurs dans la console ?

Commandes de test :

/mc balance         # Vérifier votre solde
/mc give [vous] 100 # Tester l'ajout manuel

Problème : Licence invalide

🛑 DÉMARRAGE IMPOSSIBLE: LICENCE INVALIDE

Solutions :

1. Vérifier la clé dans config.yml

2. Vérifier la connexion internet du serveur

3. Contacter le support avec les logs

Problème : Shop ne s'ouvre pas

Solutions :

1. Vérifier la permission novamobcoins.shop

2. Vérifier qu'il y a des items configurés

3. Regarder les erreurs dans la console

Problème : Récapitulatif ne s'affiche pas

Checklist :

1. ✅ recap.enabled: true dans config.yml ?

2. ✅ Avez-vous tué au moins 1 mob ?

3. ✅ show-when-zero: false et 0 mobcoins gagnés ?

4. ✅ Attendez l'intervalle configuré

Obtenir de l'aide

Support Discord :

https://discord.gg/HtjPAfqUXu Informations à fournir :

• Version du plugin

• Version de Spigot/Paper

• Logs complets (console)

• Fichier config.yml

• Description détaillée du problème

---

📋 NovaMobcoins v1.0.1 #1 - Changelog

🎯 Fonctionnalités Principales

💰 Système de Mobcoins Décimaux

• ✅ Support des gains décimaux : Configurez des mobs avec 0.5, 0.3, 1.5 mobcoins

• ✅ Affichage précis : Les mobcoins s'affichent avec leurs décimales (0.5, 1.5, etc.)

• ✅ Stockage optimisé : Système de centièmes en interne pour performance

• ✅ Commandes décimales : /mc give joueur 0.5, /mc set joueur 1.5

⚡ Gains Instantanés

• ✅ Cache optimiste : Les mobcoins apparaissent instantanément

• ✅ Zero latence : Plus d'attente entre le kill et l'ajout des mobcoins

• ✅ DB asynchrone : Sauvegarde en arrière-plan sans ralentir

📊 Récapitulatif Périodique Configurable

• ✅ Intervalle personnalisable : De 1 minute à plusieurs heures

• ✅ Messages personnalisables : Tous les textes modifiables dans config.yml

• ✅ Détails par mob : Voit combien chaque type de mob a rapporté

• ✅ Option affichage à 0 : Masquer si aucun mobcoin gagné

• ✅ Statistiques détaillées : Total mobcoins, total kills, tri par rentabilité

🛒 Shop avec Rotation d'Items

• ✅ Rotation automatique : Items changent toutes les X secondes

• ✅ Nombre d'items limité : Affiche 6 items parmi tous ceux configurés

• ✅ Items par commande : Achats qui exécutent des commandes (grades, permissions, etc.)

• ✅ Items physiques : Achats qui donnent des items Minecraft

• ✅ Support ItemsAdder : Compatible avec items customs

• ✅ Annonces de rotation : Message broadcast quand le shop se rafraîchit

🔐 Système de Licence

• ✅ Vérification au démarrage : Bloque le plugin si licence invalide

• ✅ Vérification périodique : Toutes les 30 minutes

• ✅ Serveur de validation : Connexion sécurisée au serveur de licences

• ✅ Protection anti-piratage : UUID serveur unique

🗄️ Base de Données Multi-Support

• ✅ SQLite : Par défaut, aucune config requise

• ✅ MySQL : Pour multi-serveurs avec HikariCP

• ✅ MongoDB : Support expérimental

• ✅ Cache intelligent : Réduction massive des requêtes DB

• ✅ Optimisations WAL : Mode SQLite ultra-rapide

⚙️ Commandes Complètes

Joueurs :

• /mc help - Aide

• /mc about - Infos plugin

• /mc balance [joueur] - Voir le solde

• /mc shop - Ouvrir le shop

• /mc top - Classement

• /mc pay <joueur> <montant> - Envoyer des mobcoins

Admin :

• /mc reload - Recharger config

• /mc give <joueur> <montant> - Donner des mobcoins

• /mc set <joueur> <montant> - Définir le solde (accepte 0)

• /mc take <joueur> <montant> - Retirer des mobcoins

🎨 Personnalisation Complète

• ✅ Tous les messages : Configurables dans config.yml

• ✅ Codes couleur : Support complet des codes Minecraft

• ✅ Placeholders : {player}, {amount}, {mob}, etc.

• ✅ Format des nombres : Avec séparateurs (1,250 ou 1.5k)

🌍 Multiplicateurs de Monde

• ✅ Bonus par monde : Nether x1.5, End x2.0

• ✅ Illimité : Configurez autant de mondes que voulu

• ✅ Calcul automatique : Gain de base × multiplicateur

📈 Système de Top/Classement

• ✅ Pagination : Navigation entre les pages

• ✅ Cache optimisé : Rafraîchissement toutes les 60 secondes

• ✅ GUI cliquable : Boutons précédent/suivant

• ✅ Têtes de joueurs : Affichage visuel des tops

🔌 Intégrations

• ✅ PlaceholderAPI : Tous les placeholders disponibles

• ✅ Vault : Support optionnel

• ✅ ItemsAdder : Items customs dans le shop

• ✅ Discord Webhook : Logs optionnels

📊 Performances

• ✅ Multi-threading : DB, commandes, et events asynchrones

• ✅ Rate limiting : Protection contre le spam

• ✅ Memory monitoring : Alertes si utilisation élevée

• ✅ Batch processing : Optimisation des opérations groupées

🛡️ Sécurité

• ✅ Validation stricte : Montants, UUIDs, commandes

• ✅ Anti-overflow : Vérification débordement balance

• ✅ Limites configurables : Max transaction, max balance

• ✅ Logs détaillés : Toutes les actions admin loggées

📝 Logging Avancé

• ✅ Transactions : Toutes les opérations mobcoins

• ✅ Actions admin : Give, set, take

• ✅ Erreurs : Stack traces complètes

• ✅ Rotation : Fichiers limités en taille et nombre

• ✅ Asynchrone : Pas de lag causé par les logs

---

🆕 Nouveautés v1.0.1 #2

🎯 Correctifs Majeurs

1. ✅ Mobcoins décimaux : Support complet de 0.5, 0.3, 1.5 mobcoins

2. ✅ /mc set joueur 0 : Fonctionne maintenant (reset de solde)

3. ✅ Gains instantanés : Cache optimiste, zero latence

4. ✅ Erreurs VACUUM supprimées : Plus de conflits SQLite

5. ✅ Utils.java fusionné : Toutes fonctionnalités préservées

---

📊 Statistiques Techniques

• Bases de données : SQLite, MySQL, MongoDB

• Thread pools : 3 (DB, Commands, Events)

• Système de cache : 5 types différents

• Commandes : 10+ avec autocomplétion

• Permissions : 15+

---

🎮 Exemples de Configuration

Mobs avec décimaux :

mobs:
  gains:
    CHICKEN: 0.5    # Poulet = 0.5 mobcoin
    PIG: 0.3        # Cochon = 0.3 mobcoin
    COW: 0.8        # Vache = 0.8 mobcoin
    ZOMBIE: 5       # Zombie = 5 mobcoins
    SKELETON: 7     # Squelette = 7 mobcoins
    ENDER_DRAGON: 1000  # Dragon = 1000 mobcoins

Récapitulatif personnalisé :

mobs:
  recap:
    enabled: true
    interval: 300        # 5 minutes
    show-when-zero: false
    title: "&6&l📊 Vos gains - {time}"
    mob-line: "&e⚔ {mob} &7x{kills} &8→ &a+{mobcoins} mobcoins"

Shop avec rotation :

shop:
  rotation:
    enabled: true
    items-displayed: 6
    rotation-interval: 3600  # 1 heure
    announce-rotation: true

---

🔮 Prochaines Versions

• Support Redis pour cache distribué

• WebPanel pour gestion en ligne

• Achievements système

• Quêtes quotidiennes

• Events spéciaux (double mobcoins)

• Boosts personnels

---

💡 Support

Discord : https://discord.gg/HtjPAfqUXu PayPal : https://paypal.me/YoannFM Auteur : YoannFM (NovaDev)

---

Merci d'utiliser NovaMobcoins ! 💰

---

📄 Licence

NovaMobcoins est un plugin premium sous licence propriétaire.

• ❌ Interdiction de redistribution

• ❌ Interdiction de décompilation

• ✅ Utilisation sur vos serveurs Minecraft

Support : https://discord.gg/HtjPAfqUXu Auteur : YoannFM PayPal : https://paypal.me/YoannFM

---

🎯 Crédits

Développé par : YoannFM (NovaDev) Discord : https://discord.gg/HtjPAfqUXu

Merci d'utiliser NovaMobcoins ! 💰

---

Documentation mise à jour le 22/12/2024