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

Notifications ActionBar et titres

Barre d'action

Chaque fois qu'un joueur gagne de l'XP, un message apparaît au-dessus de la barre d'outils. C'est ce qu'on appelle la barre d'action. Elle affiche :

Combien d'XP vient d'être gagnée (<xp>)
Combien d'argent a été gagné (<money>)
De quel métier provient l'XP (<job>)
Niveau actuel (<level>)
Progression XP (<current_xp> / <xp_required>)
Une barre de progression visuelle (<progress_bar>)

Vous pouvez personnaliser ce format dans lang/FR.yml sous xp-gain-actionbar.

Pour éviter le spam, la barre d'action n'est envoyée qu'une fois toutes les notification-cooldown millisecondes (configurable dans config.yml).

Pour désactiver complètement la barre d'action, définissez actionbar-enabled: false dans config.yml.

Titre de montée de niveau

Lorsqu'un joueur monte de niveau, un grand titre apparaît à l'écran. Configurez-le dans config.yml :

title-enabled — active ou désactive le titre
title-fade-in, title-stay, title-fade-out — contrôlent le timing (en ticks, 20 ticks = 1 seconde)

Le texte du titre se trouve dans lang/FR.yml sous level-up-title et level-up-subtitle.

Annonce globale serveur

Définissez broadcast-levelup: true dans config.yml pour annoncer les montées de niveau dans le chat. Utilisez broadcast-levelup-interval: 5 pour n'annoncer qu'un niveau sur 5 afin d'éviter le spam.

Classement

Le classement suit quels joueurs possèdent le plus d'XP dans chaque métier. Les données sont mises en cache et rafraîchies périodiquement.

Classement global — classe les joueurs par XP totale sur tous les métiers.
Classement par métier — classe les joueurs par XP dans un métier précis.
Intervalle de rafraîchissement : définissez leaderboard.refresh-interval dans config.yml (en secondes).
Forcer le rafraîchissement : utilisez l'interface Admin ou /jobs admin → Rafraîchir le classement.
Nombre d'entrées par page : définissez leaderboard.size dans config.yml.

Support PlaceholderAPI

! Note importante : le vrai préfixe PlaceholderAPI est %jobs_...%. N'utilisez pas %modernjobs_...%.

Si PlaceholderAPI est installé, ModernJobs enregistre l'expansion jobs. Ces placeholders fonctionnent dans les scoreboards, hologrammes, tablists et tous les autres plugins compatibles PlaceholderAPI.

ℹ Remplacez <job> par l'identifiant du métier (nom du fichier sans .yml, par exemple miner, farmer, hunter).

Placeholder	Retour
`%modernjobs_level_<job>%`	Niveau actuel du joueur dans ce métier
`%modernjobs_xp_<job>%`	XP actuelle du joueur dans ce métier
`%modernjobs_xp_required_<job>%`	XP nécessaire pour le prochain niveau
`%modernjobs_prestige_<job>%`	Niveau de prestige du joueur dans ce métier
`%modernjobs_total_xp_<job>%`	Total d'XP gagnée dans ce métier

Support Folia

ℹ ModernJobs supporte Folia nativement. Aucune configuration supplémentaire n'est nécessaire : utilisez le même jar.

Liste complète des placeholders

ModernJobs expose actuellement ces placeholders via l'identifiant jobs :

Placeholder	Retour
`%jobs_level_<job>%`	Niveau actuel du joueur dans ce métier
`%jobs_xp_<job>%`	XP actuelle du joueur dans ce métier
`%jobs_xp_needed_<job>%`	XP restante avant le prochain niveau
`%jobs_progress_<job>%`	Pourcentage de progression pour ce métier
`%jobs_progress_bar_<job>%`	Barre de progression configurée pour ce métier
`%jobs_max_level_<job>%`	Niveau maximum configuré pour ce métier
`%jobs_prestige_<job>%`	Niveau de prestige du joueur dans ce métier
`%jobs_total_xp_<job>%`	Total d'XP gagnée dans ce métier
`%jobs_job_<job>%`	Nom affiché de ce métier
`%jobs_count%`	Nombre de métiers rejoints par le joueur
`%jobs_total_level%`	Total des niveaux sur tous les métiers rejoints
`%jobs_job%`	Nom affiché du premier métier rejoint
`%jobs_level%`	Niveau du premier métier rejoint
`%jobs_xp%`	XP actuelle du premier métier rejoint
`%jobs_xp_needed%`	XP nécessaire du premier métier rejoint
`%jobs_progress%`	Pourcentage de progression du premier métier rejoint
`%jobs_progress_bar%`	Barre de progression du premier métier rejoint
`%jobs_max_level%`	Niveau maximum du premier métier rejoint
`%jobs_prestige%`	Prestige du premier métier rejoint

Exemples

%jobs_level_miner%
%jobs_prestige_hunter%
%jobs_progress_bar_farmer%
%jobs_total_level%

Si un placeholder ne retourne rien, vérifiez que PlaceholderAPI est installé, que le joueur a bien des données dans ce métier et que l'identifiant du métier correspond exactement au nom du fichier.

ModernJobs supporte complètement Folia, la variante multithread des serveurs Minecraft. Le plugin détecte automatiquement s'il tourne sur Folia ou sur Paper/Spigot classique et utilise le planificateur approprié.

Aucune configuration supplémentaire n'est nécessaire : utilisez simplement le même jar sur un serveur Folia.

Intégrations

Plugin	Type	Ce que cela active
Vault	Dépendance souple	Récompenses en argent pour les actions et les récompenses de niveaux. Sans Vault, les valeurs d'argent sont ignorées.
PlaceholderAPI	Dépendance souple	Expose les statistiques des métiers sous forme de placeholders pour scoreboards, tab et hologrammes.
LuckPerms	Dépendance souple	Quand les récompenses de niveau accordent des permissions, LuckPerms les applique de façon persistante. Fonctionne aussi avec d'autres plugins de permissions.
ItemsAdder	Dépendance souple	Les blocs et meubles personnalisés d'ItemsAdder peuvent être utilisés comme cibles d'actions dans les fichiers métier (`ia-block-break`, `ia-furniture`).
Nexo	Dépendance souple	Même principe qu'ItemsAdder, mais pour les blocs et meubles personnalisés de Nexo (`nexo-block-break`, `nexo-furniture`).

Conseils admin et questions fréquentes

Exemple de récompense de prestige spécifique à un métier

rewards:
  0:
    10:
      money: 1000
  1:
    10:
      money: 2500
      perks:
        - "miner-vein"
  2:
    10:
      money: 5000
      items:
        - "DIAMOND 4"

Cela signifie que la récompense du niveau 10 pour ce métier devient plus forte quand le joueur atteint des paliers de prestige plus élevés.

Comment ajouter un nouveau métier ?

Créez un nouveau fichier dans plugins/ModernJobs/jobs/ — ex. : monmetier.yml
Copiez la structure d'un fichier métier existant
Modifiez display-name, icon, color, gui-slot et la section actions
Exécutez /jobs reload

Comment désactiver un métier sans supprimer son fichier ?

Ajoutez son identifiant dans disabled-jobs dans config.yml :

jobs:
  disabled-jobs:
    - enchanter

Comment positionner les métiers dans l'interface ?

Chaque fichier métier possède un numéro gui-slot. L'emplacement 0 = haut gauche, l'emplacement 53 = bas droite. Planifiez votre disposition sur une grille 9×6 :

 0  1  2  3  4  5  6  7  8
 9 10 11 12 13 14 15 16 17
18 19 20 21 22 23 24 25 26
27 28 29 30 31 32 33 34 35
36 37 38 39 40 41 42 43 44
45 46 47 48 49 50 51 52 53

Comment rendre la progression plus rapide ou plus lente ?

Dans le fichier métier, ajustez xp-formula.multiplier. Plus bas = progression plus rapide, plus haut = progression plus lente. Vous pouvez aussi ajuster les valeurs d'XP de chaque action individuellement.

Comment donner de l'XP à un joueur manuellement ?

/jobs giveexp NomDuJoueur miner 1000

Comment réinitialiser les données de métier d'un joueur ?

/jobs reset NomDuJoueur miner       # Réinitialise un métier
/jobs reset NomDuJoueur             # Réinitialise TOUS les métiers

Couleurs MiniMessage

Tous les textes dans config.yml, gui.yml, les fichiers métier et les fichiers de langue supportent le formatage MiniMessage :

Balise	Résultat
`<green>`	Texte vert
`<gold>`	Texte or
`<aqua>`	Texte aqua
`<red>`	Texte rouge
`<light_purple>`	Violet clair
`<yellow>`	Jaune
`<white>`	Blanc
`<gray>`	Gris
`<dark_gray>`	Gris foncé
`<bold>`	Gras
`<italic>`	Italique
`<underlined>`	Souligné
`<strikethrough>`	~~Barré~~
`<color:#FF0000>`	Couleur hexadécimale personnalisée

💡 Après chaque modification de la configuration, exécutez /jobs reload pour appliquer les changements sans redémarrer. Les données des joueurs sont automatiquement sauvegardées avant le rechargement.

ModernJobs — Plugin Minecraft Métiers Premium

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