Bukkit

Rewards pour v2.0.0+

Les [...] sont là pour vous indiquer que d'autres conditions peuvent se trouver à sa place, ne les mettez pas dans vos yml...

La section rewards doit se trouver dans vos fichiers reward.

Par exemple je crée un fichier reward quand le joueur atteint le level 250 en MINING donc je crée SKILLS/MINING/ONE/250.yml.
Dans ce fichier reward si il n'y en a pas je crée un scenario avec un nom parlant pour moi:

all:
  My First scenario:

La section rewards doit faire partie d'un scenario :

all:
  My First scenario:
    rewards:

Aprés le noeud 'rewards:' vous pouvez utiliser les rewards disponibles listés dans cette doc.

Message

rewards:
  [...]
  message:
    mp:
    - '&3One private message'
    broadcast:
    - '&3One message on public chat'
    log:
    - 'Log this message in console'

• mp -> une liste de messages privés à envoyer au joueur
• broadcast -> une liste de messages pour broadcast
• log -> une liste de messages de log en console

Vous pouvez utiliser des variables de remplacement dans les messages, elles sont listées en fin de page.

Money

rewards:
  [...]
  money:
    sender: boozaa
    amount: 200

• sender -> qui doit payer (optionnel)
  
• amount -> combien
  

lotteryMoney

rewards:
  lotteryMoney:
    probability: 1
    amount: 100
    sender: 'johnny' (optional)
    message:
      broadcast:
      - 'We have a lucky player, %player% win %amount%'
      mp:
      - 'Luck, you win %amount%'

• probability -> nombre de chances par rapport au 'diceFaces' fixé dans votre 'config.yml'
  
• amount -> combien
  
• sender -> qui doit payer (optionnel)
  

La partie message fonctionne normalement mise à part que vous pouvez ici utiliser la variable %amount% si vous voulez faire afficher le montant dans les messages.

Permission

rewards:
  [...]
  perm:
  - +[Base]boo.perms.perm1
  - +[Liberty]boo.perms.perm2

Vous devez indiquer '-' pour lui retirer une permission ou '+' pour lui ajouter.

• -[Base]boo.perms.perm1 -> lui retirer la permission boo.perms.perm1 pour le Monde nommé Base
• +[Liberty]boo.perms.perm2 -> lui ajouter la permission boo.perms.perm2 pour le Monde nommé Liberty
• +boo.perms.perm3 -> lui ajouter la permission boo.perms.perm3
• -boo.perms.perm4 -> lui retirer la permission boo.perms.perm4

Group

rewards:
  [...]
  group:
  - +jumper
  - -default

Vous devez indiquer '-' pour le retirer d'un groupe ou '+' pour l'ajouter.

• -default -> pour le retirer du groupe default
  
• +jumper -> pour l'ajouter au groupe jumper
  

Item

rewards:
  [...]
  item:
  - '363'
  - '260:5'
  - '278:1:35:3'
  - '35/14'

Chaque item a donné a cette structure :

Donc dans l'exemple

'363' -> donne Raw Beef

'260:5' -> donne 5x Apple

'278:1:35:3' -> donne une pioche diamant enchantée

'35/14' -> donne 1 x Red Wool

Pour la partie enchantement vous devez vous référer à ceci :

lotteryItem

rewards:
  [...]  
  lotteryItem:    
    probability: 5
    item:
    - '268'
    - '269'
    - '270'
    message:
      mp:
      - '&7&3LotteryItem, are you lucky ?'

Le lotteryItem est un lancer de dés pour chaque item listé.
Le nombre de faces du dé est fixé dans votre 'config.yml' : diceFaces.
probability c'est le nombre de chances qu'il a en rapport au nombre de faces totale du dé.
Le dé est lancé pour chaque item ajouté dans la liste 'item:' avec la probabilité fixée par 'probability:'.
La partie item fonctionne normalement comme indiqué avec la quantité et enchantements.
La partie message fonctionne normalement comme indiqué mais elle est traité qu'après la lottery.

luckyItem

rewards:
  [...]
  luckyItem:
    item:
    - '260'
    - '297'
    - '366'
    - '278:1:35:3'
    message:
      mp:
      - '&3Tirage au sort, que le hasard decide'
      broadcast:
      - '&5Tirage au sort ... %player% tente sa chance'
      log:
      - 'Lottery for %player%'

Le luckyItem est une chance d'avoir un item bonus parmi une liste d'item.
Le joueur gagne à tous les coups un item mais choisis au hasard dans la liste d'item que vous lui donnez
La partie item fonctionne normalement comme indiqué avec la quantité et enchantements.
La partie message fonctionne normalement comme indiqué mais elle est traité qu'après le luckyItem.

luckyKit

rewards:
  [...]
  luckyKit:
    item:
    - '298:1:1:4|299:1:1:4|300:1:1:4|301:1:1:4'
    - '306:1:1:4|307:1:1:4|308:1:1:4|309:1:1:4'
    - '310:1:1:4|311:1:1:4|312:1:1:4|313:1:1:4'
    message:
      mp:
      - '&bBravo tu as gagné le kit %item%'

Le luckyKit est une chance d'obtenir un des kits d'item listés.
Le joueur gagne à tous les coups un des kits mais choisis au hasard dans la liste d'item que vous lui donnez
Vous devez séparer chaque item par un '|'
La partie item fonctionne normalement comme indiqué avec la quantité et enchantements.
La partie message fonctionne normalement

Command

rewards:
  [...]
  command:
  - 'broadcast hello %player% on level %power%. You reach the %skillName% level %skillLevel%, on World %worldName% at location %XLoc%, %YLoc%, %ZLoc%'

Vous indiquez une liste de commande sans le '/' du début et ces commandes seront éxecutées en tant que Console Sender.
Vous pouvez utiliser dans vos 'message:' et 'command' les variables de remplacement suivantes:
%player%
%power%
%skillName%
%skillLevel%
%XLoc%
%YLoc%
%ZLoc%
%worldName%

Exemple complet avec tous les rewards possibles

all:
  My First scenario:
    rewards:
      message:
        mp:
        - '&3One private message'
        broadcast:
        - '&3One message on public chat'
        log:
        - 'Log this message in console'
      money:
        sender: boozaa
        amount: 200
      lotteryMoney:
        probability: 1
        amount: 100
        sender: 'johnny' (optional)
        message:
          broadcast:
          - 'We have a lucky player, %player% win %amount%'
          mp:
          - 'Luck, you win %amount%'
      perm:
      - +[Base]boo.perms.perm1
      - +[Liberty]boo.perms.perm2
      group:
      - +jumper
      - -default
      item:
      - '363'
      - '260:5'
      - '278:1:35:3'
      - '35/14'
      lotteryItem:    
        probability: 5
        item:
        - '268'
        - '269'
        - '270'
        message:
          mp:
          - '&7&3LotteryItem, are you lucky ?'
      luckyItem:
        item:
        - '260'
        - '297'
        - '366'
        - '278:1:35:3'
        message:
          mp:
          - '&3Tirage au sort, que le hasard decide'
          broadcast:
          - '&5Tirage au sort ... %player% tente sa chance'
          log:
          - 'Lottery for %player%'
      luckyKit:
        item:
        - '298:1:1:4|299:1:1:4|300:1:1:4|301:1:1:4'
        - '306:1:1:4|307:1:1:4|308:1:1:4|309:1:1:4'
        - '310:1:1:4|311:1:1:4|312:1:1:4|313:1:1:4'
        message:
          mp:
          - '&bBravo tu as gagné le kit %item%'
      command:
      - 'broadcast hello %player% on level %power%. You reach the %skillName% level %skillLevel%'