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

config.yml — Paramètres principaux

C'est le cœur de ModernJobs. Chaque option est expliquée ci-dessous.

settings :

Clé	Défaut	Effet
`language`	`EN`	Quel fichier de langue charger depuis `lang/`. Disponible : `EN`, `FR`, `ES`, `DE`
`max-jobs`	`3`	Nombre de métiers qu'un joueur peut exercer simultanément. Les joueurs avec la permission `ojobs.bypass.maxjobs` ignorent cette limite.
`auto-join-all-jobs`	`true`	Si `true`, chaque joueur est automatiquement inscrit dans tous les métiers chargés. Ignore les limites d'inscription et les permissions. Mettre à `false` si les joueurs doivent rejoindre les métiers manuellement.
`count-player-placed-blocks`	`false`	Si `false` (recommandé), les blocs posés par les joueurs ne donnent PAS d'XP quand ils sont cassés — évite les fermes et les abus.
`actionbar-enabled`	`true`	Affiche l'XP et l'argent gagnés dans la barre d'action (le texte au-dessus de la barre de raccourcis) à chaque fois qu'un joueur gagne de l'XP.
`notification-cooldown`	`2000`	Délai minimum en millisecondes entre les messages XP de la barre d'action par joueur. Évite le spam. `2000` = 2 secondes.
`title-enabled`	`true`	Affiche un grand titre à l'écran lorsqu'un joueur monte de niveau ou prestige.
`title-fade-in`	`10`	Nombre de ticks pour l'apparition du titre de montée de niveau. (20 ticks = 1 seconde)
`title-stay`	`60`	Nombre de ticks pendant lesquels le titre de montée de niveau reste affiché.
`title-fade-out`	`20`	Nombre de ticks pour la disparition du titre de montée de niveau.
`broadcast-levelup`	`false`	Annonce les montées de niveau dans le chat de tout le serveur.
`broadcast-levelup-interval`	`5`	N'annonce que tous les N niveaux (ex. : `5` = annonce au niveau 5, 10, 15…). S'applique uniquement si `broadcast-levelup: true`.

settings.sounds :

Clé	Défaut	Quand il se joue
`job-join`	`ENTITY_PLAYER_LEVELUP`	Le joueur rejoint un métier
`job-leave`	`BLOCK_NOTE_BLOCK_BASS`	Le joueur quitte un métier
`level-up`	`UI_TOAST_CHALLENGE_COMPLETE`	Le joueur monte de niveau
`prestige`	`UI_TOAST_CHALLENGE_COMPLETE`	Le joueur prestige

💡 Les noms de sons proviennent de l'énumération Sound de Bukkit. Vous pouvez trouver la liste complète en recherchant « Bukkit Sound 1.21 ».

jobs :

Clé	Effet
`disabled-jobs: []`	Liste des identifiants de métiers à ne pas charger. Le fichier yml du métier reste dans le dossier sans modification — ajoutez simplement son nom ici pour le masquer. Exemple : `- enchanter`

jobs:
  disabled-jobs:
    - enchanter   # enchanter.yml existe mais ne sera pas chargé
    - explorer    # explorer.yml existe mais ne sera pas chargé

xp :

Clé	Défaut	Effet
`global-multiplier`	`1.0`	Multiplie TOUS les gains d'XP par ce nombre. `1.5` = 50% d'XP bonus pour tout le monde.
`permission-multipliers`	—	Association permission → multiplicateur. La permission correspondante la plus élevée l'emporte. Ces valeurs remplacent (sans s'empiler) le multiplicateur global pour ce joueur.
`boosters.max-global`	`3`	Nombre maximum de boosters globaux actifs simultanément.
`boosters.max-per-job`	`5`	Nombre maximum de boosters actifs sur un seul métier.
`boosters.max-per-player`	`3`	Nombre maximum de boosters qu'un seul joueur peut avoir actifs.

prestige :

Clé	Défaut	Effet
`enabled`	`true`	Active ou désactive l'ensemble du système de prestige.
`max-prestige`	`10`	Le niveau de prestige maximum qu'un joueur peut atteindre par métier.
`reset-level`	`true`	Lors du prestige, remet le niveau à 1.
`reset-xp`	`true`	Lors du prestige, remet l'XP à 0.
`xp-bonus-per-prestige`	`0.10`	Chaque niveau de prestige ajoute ce montant au multiplicateur d'XP. `0.10` = +10% par prestige. Prestige 3 = +30% de gain d'XP total.

prestige.rewards :

Vous pouvez donner de l'argent aux joueurs et exécuter des commandes à des paliers de prestige spécifiques :

prestige:
  rewards:
    1:                                  # au niveau de prestige 1
      money: 5000
      commands:
        - "say %player% a prestigé !"
    5:
      money: 50000
      commands:
        - "say %player% a atteint le Prestige 5 !"

leaderboard :

Clé	Défaut	Effet
`size`	`10`	Nombre d'entrées affichées par page de classement.
`refresh-interval`	`300`	Fréquence (en secondes) de rafraîchissement des données du classement en cache. `300` = toutes les 5 minutes.

storage.yml — Base de données

ModernJobs prend en charge 4 façons de stocker les données des joueurs. Choisissez celle qui correspond à la taille de votre serveur.

Backend	Recommandé pour	Configuration requise
`YAML`	Petits serveurs, configuration simple	Aucune — un fichier par joueur dans `plugins/ModernJobs/data/`
`SQLITE`	Serveurs moyens	Aucune — un seul fichier `data.db`
`MYSQL`	Grands serveurs, réseaux multi-serveurs	Un serveur MySQL/MariaDB
`MONGODB`	Grande échelle, schéma flexible	Une instance MongoDB

Changer de backend

type: YAML    # Changer en SQLITE, MYSQL ou MONGODB
auto-save-interval: 300   # Sauvegarde les données modifiées toutes les 300 secondes

Exemple MySQL

type: MYSQL
mysql:
  host: "localhost"
  port: 3306
  database: "ojobs"
  username: "root"
  password: "votremotdepasse"
  use-ssl: false
  table-prefix: "ojobs_"

lang/ — Messages

Tous les messages du chat se trouvent dans lang/FR.yml (ou la langue que vous avez définie). Vous pouvez modifier chaque message. Supporte les couleurs MiniMessage comme <green>, <gold>, <bold>, etc.

Format de la barre d'action

Le message le plus important est la barre d'action affichée lorsque de l'XP est gagnée :

xp-gain-actionbar: "<gray>+<green><xp> XP</green> <gray>|</gray> <gold>+$<money></gold> <dark_gray>(<yellow><job></yellow>)</dark_gray> <gray>Nv.<white><level></white> [<current_xp>/<xp_required>] <progress_bar>"

Variables disponibles dans la barre d'action : <xp>, <money>, <job>, <level>, <current_xp>, <xp_required>, <progress_bar>

ModernJobs — Plugin Minecraft Métiers Premium

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