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

Récompenses de niveaux

Lorsqu'un joueur atteint un niveau précis, il peut recevoir une récompense. Les récompenses supportent deux formats.

Format 1 — Avec gestion du prestige (recommandé)

La section rewards: utilise une clé externe pour le niveau de prestige, puis des clés internes pour le niveau du métier :

rewards:
  0:                               # Prestige 0 (jeu normal)
    5:                             # Au niveau 5 du métier
      money: 500                   # Argent à donner
      commands:
        - "say %player% a atteint le niveau 5 !"
      items:
        - "DIAMOND 8"              # Donne 8 diamants
        - "GOLDEN_APPLE 4"
      permissions:
        - "ojobs.miner.fortune"   # Accorde cette permission
      perks:
        - "miner-vein"            # Accorde cette perk (raccourci pour sa permission)
      firework: false              # Lancer un feu d'artifice ?
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      sound-volume: 1.0
      sound-pitch: 1.0
  1:                               # Récompenses du prestige 1
    10:
      money: 5000
      commands: []
      items:
        - "NETHERITE_INGOT 1"
      permissions: []
      firework: true
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      sound-volume: 1.0
      sound-pitch: 1.0

Explication des champs de récompense

Champ	Effet
`money`	Montant d'argent à donner (nécessite Vault)
`commands`	Liste de commandes console à exécuter. `%player%` est remplacé par le nom du joueur.
`items`	Liste d'objets au format `MATÉRIAU QUANTITÉ`. Donnés directement à l'inventaire du joueur.
`permissions`	Liste de permissions à accorder définitivement au joueur (via LuckPerms ou similaire).
`perks`	Liste de clés de perks à accorder. Raccourci pour donner la permission configurée de la perk — le plugin la résout automatiquement depuis `config.yml`. Exemple : `- "builder-lineplace"`
`firework`	`true` = lance un feu d'artifice coloré à la position du joueur.
`sound`	Nom d'un son Bukkit joué au joueur lors de la montée de niveau.
`sound-volume`	Volume du son (1.0 = normal).
`sound-pitch`	Hauteur du son (1.0 = normal, 2.0 = plus aigu).

Multiplicateurs XP

Il existe trois couches de multiplicateurs XP qui se cumulent :

Multiplicateur global (xp.global-multiplier) — s'applique à tout le monde
Multiplicateur de permission — s'applique aux joueurs ayant une permission spécifique. La permission correspondante la plus élevée l'emporte (elles ne se cumulent pas entre elles)
Booster actif — multiplicateur temporaire ajouté par-dessus

xp:
  global-multiplier: 1.0
  permission-multipliers:
    ojobs.multiplier.vip:   1.25   # Rang VIP : +25% XP
    ojobs.multiplier.mvp:   1.5    # Rang MVP : +50% XP
    ojobs.multiplier.elite: 2.0    # Rang Elite : double XP

Boosters XP

Les boosters sont des multiplicateurs XP temporaires s'appliquant à un métier spécifique (ou à tous). Activez-les via le GUI admin ou la commande :

/jobs booster add <métier> <multiplicateur> <durée-secondes>

Exemple : /jobs booster add miner 2.0 3600 — double l'XP du Mineur pendant 1 heure.

Les limites des boosters sont configurables dans config.yml sous xp.boosters.

Lorsqu'un booster s'active, tous les joueurs connectés reçoivent une notification dans le chat. Lorsqu'il expire, ils sont à nouveau notifiés.

Système de prestige

Le prestige permet aux joueurs de réinitialiser un métier après avoir atteint le niveau maximum, en échange d'un bonus XP permanent et de récompenses exclusives.

ℹ Le prestige est géré par métier. Un joueur peut être Prestige 3 en Mineur et Prestige 0 en Fermier.

Comment prestigier

Atteignez le niveau maximum dans un métier (ex. niveau 20)
Ouvrez /jobs → cliquez sur le métier → le bouton ⭐ Prestige devient disponible
Cliquez sur Prestige — le niveau revient à 1, l'XP à 0
Toute l'XP future dans ce métier est multipliée par 1 + (prestige × xp-bonus-per-prestige)

Ce qui est réinitialisé et ce qui reste

prestige.reset-level: true renvoie ce métier au niveau 1.
prestige.reset-xp: true efface la progression XP actuelle dans ce métier.
Le compteur de prestige augmente de façon permanente pour ce métier précis.
Le bonus XP affecte uniquement le métier qui a été prestigié.

prestige:
  enabled: true
  max-prestige: 10
  reset-level: true
  reset-xp: true
  xp-bonus-per-prestige: 0.10

Exemples de bonus XP

Prestige	Bonus total	Multiplicateur XP effectif
0	+0%	`1.00x`
1	+10%	`1.10x`
3	+30%	`1.30x`
5	+50%	`1.50x`
10	+100%	`2.00x`

Couches de récompenses de prestige

Récompenses globales de prestige dans config.yml sous prestige.rewards.
Récompenses de prestige spécifiques au métier dans les fichiers de métier sous rewards.<prestige>.<niveau>.

Récompenses de prestige

Définissez les récompenses de palier dans config.yml. Elles se déclenchent lorsqu'un joueur atteint ce niveau de prestige :

prestige:
  rewards:
    1:
      money: 5000
      commands:
        - "say %player% a prestigé pour la première fois !"
    3:
      money: 15000
      commands: []
    5:
      money: 50000
      commands:
        - "broadcast %player% a atteint le Prestige 5 !"
    10:
      money: 200000
      commands:
        - "say %player% a atteint le PRESTIGE MAXIMUM !"

Les métiers peuvent aussi avoir des récompenses de niveau spécifiques au prestige dans leurs fichiers yml sous rewards.1:, rewards.2:, etc.

ModernJobs — Plugin Minecraft Métiers Premium

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