ModernJobs

Un plugin métiers premium pour serveurs Minecraft avec interface complète, prestige, boosters, perks, classements et support PlaceholderAPI.

API-Version 1.21+ Compatible Folia PlaceholderAPI Économie Vault 11 Métiers inclus

Guide Prestige PlaceholderAPI Documentation Anglaise

Fonctionnement des métiers

Chaque métier est défini par un fichier YAML dans plugins/ModernJobs/jobs/. Quand un joueur est dans un métier et effectue une action correspondante, il reçoit de l'XP et éventuellement de l'argent.

1. Le joueur ouvre /jobs et clique sur un métier pour voir ses détails.
2. Le joueur clique sur Rejoindre (ou est inscrit automatiquement si auto-join-all-jobs: true).
3. Le joueur effectue des actions — mine des blocs, tue des mobs, pêche, craft, etc.
4. Chaque action correspondante donne de l'XP et de l'argent. La barre d'action affiche le gain.
5. L'XP s'accumule. Quand le seuil du niveau suivant est atteint, le joueur monte de niveau (titre affiché, son joué, récompense donnée si configurée).
6. Au niveau maximum, le joueur peut Prestigier pour se réinitialiser et obtenir un bonus d'XP permanent.

Les 11 métiers inclus

Référence des fichiers métier

Chaque métier est contenu dans un unique fichier .yml dans le dossier jobs/. Toutes les options possibles sont expliquées ci-dessous.

Informations de base

display-name: "⛏ Mineur"         # Nom affiché dans les menus (supporte les codes couleur)
description:                       # Lignes affichées dans l'info-bulle du métier
  - "<gray>Mine des minerais et de la pierre."
  - ""
  - "<yellow>Actions : <white>Casser des blocs"

icon: DIAMOND_PICKAXE              # Nom du matériau Minecraft pour l'item dans l'interface
custom-model-data: -1             # Données de modèle personnalisé pour les resource packs (-1 = aucun)
color: "<aqua>"                     # Couleur MiniMessage utilisée pour le nom du métier
gui-slot: 11                       # Case fixe dans le menu principal (0-53). Retirez ou mettez -1 pour automatique.

Limites

max-level: 20                      # Niveau maximum que les joueurs peuvent atteindre dans ce métier
max-players: -1                    # Nombre maximum de joueurs simultanés dans ce métier. -1 = illimité
required-permission: ""           # Permission requise pour rejoindre. Vide = aucune restriction

Formule XP

xp-formula:
  type: EXPONENTIAL               # Seul EXPONENTIAL est supporté actuellement
  base: 100.0                      # XP nécessaire pour passer du niveau 1 au niveau 2
  multiplier: 1.5                  # Chaque niveau nécessite base × multiplicateur^(niveau-1)

Avec base: 100 et multiplier: 1.5 :

Restrictions de mondes

worlds:
  whitelist: []                    # Seuls ces mondes donnent de l'XP. Vide = tous les mondes autorisés.
  blacklist:                       # Ces mondes ne donnent jamais d'XP.
    - "world_the_end"

Temps de recharge

cooldowns:
  block-break: 0                   # Secondes entre deux récompenses de blocs cassés. 0 = pas de délai

Chaque type d'action peut avoir son propre temps de recharge. Par exemple, un métier Chasseur pourrait avoir :

cooldowns:
  mob-kill: 2                      # Le joueur ne peut gagner de l'XP pour les kills que toutes les 2 secondes

Types d'actions

Les actions définissent ce qu'un joueur doit FAIRE en jeu pour gagner de l'XP/argent dans un métier. Différents métiers utilisent différents types d'actions.

Format d'entrée des actions

Chaque élément dans une section d'action suit cette structure :

actions:
  block-break:
    DIAMOND_ORE:                   # Nom du matériau Minecraft (doit être en majuscules)
      xp: 25.0                      # XP donnée par action
      money: 0.50                   # Argent donné par action (nécessite Vault)
      chance: 1.0                   # 1.0 = 100% de chance. 0.5 = 50% de chance de récompense
      level-requirement: 5         # Le joueur doit être au moins à ce niveau pour gagner de l'XP
      max-level-requirement: 15   # Le joueur cesse de gagner de l'XP au-dessus de ce niveau (-1 = jamais)

Actions d'enchantement — nommage spécial

Pour le métier Enchanteur, la clé d'item est le nom de l'enchantement suivi du numéro de niveau :

actions:
  enchanting:
    SHARPNESS_1:
      xp: 6.0
      money: 1.0
    FORTUNE_3:
      xp: 35.0
      money: 12.0
    MENDING:
      xp: 50.0
      money: 20.0

Formule XP expliquée

La formule de l'XP nécessaire pour atteindre le niveau suivant est :

xp_needed = base × multiplicateur ^ (niveau - 1)

Avec base: 100 et multiplier: 1.5, le niveau 1 nécessite 100 XP, le niveau 2 en nécessite 150, le niveau 3 en nécessite 225, etc. Pour ralentir la progression, augmentez le multiplier. Pour l'accélérer, diminuez-le (minimum 1.0).

Restrictions de mondes

Chaque métier peut être limité à certains mondes ou bloqué dans certains mondes.

worlds:
  whitelist:                       # SEULS ces mondes donnent de l'XP
    - "survival"
    - "survival_nether"
  blacklist:                       # Ces mondes ne donnent JAMAIS d'XP
    - "world_the_end"
    - "creative_world"

Temps de recharge

Les temps de recharge empêchent les joueurs de spammer une action pour gagner de l'XP trop rapidement. Mettez 0 pour aucun délai.

cooldowns:
  block-break: 0     # 0 seconde = pas de délai
  mob-kill: 2         # 2 secondes de délai entre les récompenses de kills

ModernJobs — Plugin Minecraft Métiers Premium

Documentation générée pour les administrateurs et les joueurs.