Documentation NovaMobCoins

📚 Documentation NovaMobcoins

📖 Table des matières

Installation
Configuration
Commandes
Permissions
Système de Licence
Gains de Mobcoins
Shop avec Rotation
Récapitulatif Périodique
Base de Données
PlaceholderAPI
Dépannage

🚀 Installation

Prérequis

Serveur Minecraft Spigot/Paper 1.16+
Java 17+
PlaceholderAPI (optionnel mais recommandé)

Étapes d'installation

Télécharger le plugin
- Récupérez le fichier NovaMobcoins.jar
Placer le fichier
```
/plugins/NovaMobcoins.jar
```
Premier démarrage
- Démarrez le serveur
- Le dossier /plugins/NovaMobcoins/ sera créé
- Le fichier config.yml sera généré

Accepter l'EULA

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

Configurer la licence

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

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 ?

Contacter le support
- Discord: https://discord.gg/HtjPAfqUXu
- Indiquer votre serveur et vos besoins
Recevoir votre clé
- Format: XXXX-XXXX-XXXX-XXXX
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 ?

Vérifier la clé dans config.yml
Vérifier la connexion internet du serveur
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

SQLite (par défaut)
MySQL (recommandé pour multi-serveurs)
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 :

Créer la base de données MySQL
Créer un utilisateur dédié
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

Installer PlaceholderAPI
Redémarrer le serveur
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 :

✅ Le plugin est-il démarré ?
✅ L'EULA est-elle acceptée ?
✅ La licence est-elle valide ?
✅ Le mob est-il configuré dans config.yml ?
✅ Avez-vous la permission novamobcoins.use ?
✅ 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 :

Vérifier la clé dans config.yml
Vérifier la connexion internet du serveur
Vérifier que le port 444 n'est pas bloqué
Contacter le support avec les logs

Problème : Shop ne s'ouvre pas

Solutions :

Vérifier la permission novamobcoins.shop
Vérifier qu'il y a des items configurés
Regarder les erreurs dans la console

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

Checklist :

✅ recap.enabled: true dans config.yml ?
✅ Avez-vous tué au moins 1 mob ?
✅ show-when-zero: false et 0 mobcoins gagnés ?
✅ Attendez l'intervalle configuré

Obtenir de l'aide

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

Informations à fournir :

Version du plugin
Version de Spigot/Paper
Logs complets (console)
Fichier config.yml
Description détaillée du problème

📝 Changelog

Version 1.0.0 #24

✅ Système de gains de mobcoins
✅ Shop avec rotation d'items
✅ Récapitulatif périodique personnalisable
✅ Système de licence
✅ Support SQLite et MySQL
✅ PlaceholderAPI
✅ Cache optimisé
✅ Commandes complètes
✅ Messages personnalisables

📄 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

Mis à jour il y a 0 minute

Bonsoir