Bukkit

Installation :

1. Téléchargez le plugin (Fichier Insurance.jar)
   
2. Placez le dans votre dossier plugins
   
3. Démarrez le serveur
   
4. Modifiez plugins/Insurance/config.yml
   
5. Lancez la commande insurance-reload (ou redémarrez le serveur)
   (Vous pouvez répéter les étapes 3 et 4 jusqu'à ce que vous ayez trouver le parfait équilibre avec les prix de vente de vos boutiques)

Commandes :

insurance-calculate: (ou icalc)
Calcule la prime pour le joueur donné (celui qui la lance si non spécifié)

Utilisation : /insurance-calculate
Description : Calcule combien vous gagnerez avec l'inventaire actuel.
Permission requise : Insurance.calculateMyPrime

Utilisation : /insurance-calculate [playername]
Description : Calcule combien gagnera le joueur donné avec son inventaire actuel.
Permission requise : Insurance.calculatePrime

insurance-reload: (ou ireload)
Recharge la configuration depuis le fichier config.yml.

Utilisation : /insurance-reload
Permission requise : Insurance.reload

Permissions :

• Insurance.* : Donne accès à toutes les commandes du plugin.
  
• Insurance.receivePrime : Recevoir la prime d'assurance quand le joueur meurt.
  
• Insurance.calculatePrime : Afficher le montant de la prime d'un joueur avec son inventaire actuel.
  
• Insurance.calculateMyPrime : Afficher le montant de sa propre prime avec l'inventaire actuel.
  
• Insurance.reload : Mettre à jour la configuration en rechargeant le fichier.
  

Configuration :

Le fichier plugins/Insurance/config.yml est très simple à comprendre. Attention: Vous devez conserver la structure Yaml (l'indentation et les symboles ":" comme dans le fichier par défaut).

Pour simplifier l'écriture de cette page de documentation, j'utiliserai par exemple "Insurance.log_prime" pour désigner l'option "log_prime" contenue dans la section "Insurance".

Insurance.log_prime :
Accepte true ou false comme valeur, si c'est à true, chaque paiement sera enregistré dans le fichier plugins/Insurance/primesLog.txt. Vous pouvez effacer ce fichier sans risques quand vous le voulez.

Insurance.log_filesize :
Nombre de bytes maximum que peut occuper le fichier de log (si Insurance.log_prime est à true).

Insurance.calc_message:
Phrase affichée à l'utilisateur quand il lance la commande /insurance-calculate.
"<player>" sera remplacé par le nom du joueur, "<amount>" par la somme représentant la valeur de son équipement.

Insurance.pay_message :
Le texte du message affiché à l'utilisateur avant qu'il reçoive son argent.
"<player>" sera remplacé par le nom du joueur, "<amount>" par la somme représentant la valeur de son équipement.

Insurance.pay_command :
La commande exécutée pour payer le joueur (sans le "/" de début).
Notez que cette commande est lancée en tant qu'utilisateur console (qui ne tient pas compte des permissions).
"<player>" sera remplacé par le nom du joueur, "<amount>" par la somme représentant la valeur de son équipement.

Exemple pour le plugin iConomy :

Insurance:
  log_prime: true
  pay_message: <player>, tu recevras sous peu <amount> euros en compensation de tes items perdus.
  pay_command: money give <player> <amount>
  primes:
    AIR: 0.0
    ...

Insurance.primes :
Ce sont des paires de valeurs comme suit : NOM-ITEM: VALEUR où NOM-ITEM est le nom de l'item interne à Minecraft et VALEUR la somme reçue pour un seul objet de ce type. Donc, si vous paramétrez DIRT:5.0 et COBBLESTONE:10.0, un joueur qui meurt avec 10 dirts et 2 cobbles recevra 70.

Subtilité : Certains items dans Minecraft comportent des sous-items (la laine, le bois, …), ils seront donc eux-même une section contenant la liste des sous-items avec la même notation.

Insurance.consider_condition :
Accepte true ou false comme valeur, si c'est à true, l'état de l'item rentre en compte dans le calcul de son prix. Par exemple, une épée usée à moitié ne sera remboursée qu'à 50% de la valeur définie dans le fichier de config.

Advanced / Fun :

Comme le plugin Insurance ne dépend d'aucun plugin et qu'il se contente d'appeler la commande que vous voulez, vous pouvez décider de détourner son usage avec un plugin tiers ou une commande spécifique… Par exemple, avoir un plugin qui fournit une commande prenant le montant pour lui appliquer une valeur aléatoire. Une autre idée pourrait être de ne pas envoyer d'argent mais de donner de la nourriture ou autre chose. Je vous laisse réfléchir à ces possibilités.

Example à la con :

Insurance:
  log_prime: true
  pay_message: HAHA! Tu viens de perdre pour <amount> euros de matos… C'est con hein ?
  pay_command: give <player> dirt <amount>
  primes:
    ...