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

Vue d'ensemble du système de perks

Les perks sont des bonus de gameplay spéciaux que les joueurs débloquent en atteignant certains niveaux dans un métier. Il en existe deux types :

• Perks actives — déclenchées par des actions spécifiques (définies dans config.yml sous perks.features). Elles sont accordées via le champ permissions ou perks dans une récompense de niveau.
• Effets passifs — effets de potion permanents appliqués tant que le joueur possède la permission requise (définis dans config.yml sous perks.passive-effects).

Les joueurs peuvent aussi voir leurs perks en jeu en ouvrant le menu détail d'un métier et en cliquant sur le bouton ✨ Perks.

Référence des perks actives

Ces perks sont configurées dans config.yml sous perks.features. Chaque perk est accordée en donnant au joueur la permission associée via une récompense de niveau.

Perks du Mineur

Perks du Bûcheron

Perks du Fermier

Perks du Artisan

Perks du Pêcheur

Perks du Chasseur

Perks du Forgeron

Perks du Constructeur

Perks du Fondeur

Perks de l'Explorateur

Configuration des perks

Chaque perk définie dans config.yml sous perks.features supporte ces options universelles :

perks:
  features:
    miner-vein:
      enabled: true              # false = perk désactivée pour tout le monde
      toggleable: true           # true = les joueurs peuvent la désactiver avec /jobs perk <clé>
      permission: "ojobs.miner.vein"
      display-name: "Vein Miner"
      description:
        - "<gray>Casse les filons de minerai connectés."
      require-sneaking: false    # true = ne se déclenche que si le joueur est accroupi
      require-item: ""           # Nom du matériau — ne se déclenche que si cet objet est en main

Paramètres configurables par perk

Certaines perks ont des paramètres numériques supplémentaires réglables :

Effets passifs (effets de potion permanents)

Les effets passifs appliquent un effet de potion à un joueur tant qu'il possède la permission requise. Le système se rafraîchit chaque seconde pour éviter tout scintillement.

perks:
  passive-effects:
    enabled: true
    effects:
      miner-nightvision:           # Clé unique de votre choix
        enabled: true
        permanent: true            # true = tâche de rafraîchissement (sans scintillement)
        permission: "ojobs.miner.nightvision"
        type: "NIGHT_VISION"       # Nom PotionEffectType de Bukkit
        amplifier: 0              # 0 = niveau I, 1 = niveau II, etc.
        refresh-threshold: 100   # Réapplique quand les ticks restants passent sous ce seuil
        apply-duration: 500       # Ticks à appliquer à chaque rafraîchissement (doit être > refresh-threshold)
        ambient: true             # true = particules subtiles (ou aucune si particles: false)
        particles: false          # Afficher les particules de potion ?
        icon: true               # Afficher l'icône dans le HUD ?

Ajouter votre propre effet permanent

Ajoutez une nouvelle entrée sous effects: et donnez la permission au joueur via une récompense de niveau :

# Dans config.yml :
hunter-speed:
  enabled: true
  permanent: true
  permission: "ojobs.hunter.speed"
  type: "SPEED"
  amplifier: 0
  refresh-threshold: 100
  apply-duration: 500
  ambient: true
  particles: false
  icon: true

# Puis dans les récompenses de hunter.yml, accorder la permission :
10:
  permissions:
    - "ojobs.hunter.speed"

Définir les perks dans les fichiers métier (pour l'affichage GUI)

Chaque fichier yml de métier peut avoir une section perks:. Elle est purement informative pour la GUI — elle permet aux joueurs de voir quelles perks ils débloquent et à quel niveau. Elle n'accorde pas les perks elle-même ; les permissions sont accordées via level-rewards.

perks:
  5:                               # Niveau auquel cette perk se débloque
    name: "Vein Miner"
    feature-key: miner-vein      # Lie à la perk fonctionnelle dans config.yml
    icon: DIAMOND_PICKAXE         # Matériau affiché dans la GUI quand déverrouillée
    description:
      - "Mine un filon entier d'un coup."
  10:
    name: "Fortune des Minerais"
    feature-key: miner-fortune
    icon: EMERALD
    description:
      - "Chance d'obtenir un minerai supplémentaire."

Dans la GUI, les perks déverrouillées brillent et affichent leur icône. Les perks verrouillées apparaissent comme un objet gris avec le niveau requis.

Créer des perks personnalisées

ModernJobs supporte quatre niveaux de perks personnalisées, du zéro code à une mécanique Java complète :

Type 1 — Perk déclencheur de commandes (config complète, aucun code)

L'option la plus puissante sans code. Définissez une perk dans config.yml sous perks.features avec un bloc trigger. Quand l'événement se produit et que le joueur a la permission, ModernJobs exécute vos commandes, affiche un message dans la barre d'action et joue un son — avec support de chance et de temps de recharge.

# config.yml
perks:
  features:
    lucky-miner:
      enabled: true
      toggleable: true
      permission: "ojobs.miner.lucky"
      trigger:
        event: "block-break"        # block-break · block-place · mob-kill · fish
                                       # craft · smelt · interact · damage
        chance: 0.20                 # 20% de chance par déclenchement
        cooldown: 10                 # secondes entre deux déclenchements par joueur
        commands:
          - "give %player% diamond 1"
        player-commands: []         # commandes exécutées EN TANT QUE le joueur
        action-bar: "<gold>Lucky Miner<gray>: <white>diamant bonus !"
        sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
        sound-volume: 1.0
        sound-pitch: 1.2

Liez-la ensuite à la GUI dans le yml du métier et accordez-la via une récompense de niveau :

# jobs/miner.yml
perks:
  10:
    name: "<gold>🍀 Lucky Miner"
    icon: DIAMOND
    feature-key: "lucky-miner"
    description:
      - "<gray>20% de chance d'obtenir un diamant bonus"
      - "<gray>en cassant un bloc."

rewards:
  0:
    10:
      perks:
        - "lucky-miner"

Placeholders disponibles

Type 2 — Effet de potion passif (config, aucun code)

Tout effet de potion permanent ou temporaire conditionné par une permission. Configuré dans config.yml sous perks.passive-effects.effects.

Type 3 — Lier une perk à une mécanique intégrée

Ajoutez un feature-key correspondant à l'un des identifiants intégrés ci-dessous. La mécanique se déclenche pour tout joueur ayant la permission requise.

perks:
  15:
    name: "<aqua>⛏ Vein Miner"
    icon: DIAMOND_PICKAXE
    feature-key: "miner-vein"
    description:
      - "<gray>Sneak + casser pour miner tout le filon."

rewards:
  0:
    15:
      perks:
        - "miner-vein"

Type 4 — Mécanique entièrement personnalisée via l'API Java

Pour des mécaniques de jeu totalement nouvelles, implémentez CustomPerkHandler dans votre propre plugin et enregistrez-le auprès de ModernJobs au démarrage. Votre handler est appelé automatiquement par ModernJobs pour les événements que vous surchargez, uniquement quand le joueur possède la permission de la perk — les vérifications enabled/toggleable/require-sneaking de config.yml s'appliquent toujours.

// Dans le onEnable() de votre plugin :
OJobsProvider.get().ifPresent(api -> api.registerPerkHandler(new MaPerkPersonnalisee()));

// Désenregistrer au disable :
OJobsProvider.get().ifPresent(api -> api.unregisterPerkHandler("monplugin-maperk"));

public class MaPerkPersonnalisee implements CustomPerkHandler {

    @Override
    public String getKey() {
        return "monplugin-maperk";   // Doit correspondre au feature-key dans le yml du métier
    }

    @Override
    public void onBlockBreak(Player player, BlockBreakEvent event) {
        // Votre mécanique ici — ne se déclenche que si le joueur a la permission
        player.sendMessage("Perk personnalisée déclenchée !");
    }

    // Surchargez uniquement les événements dont vous avez besoin :
    // onBlockPlace, onInteract, onMobKill, onFish, onCraft, onFurnaceExtract, onDamage
}

Définissez ensuite la perk dans le yml du métier pour qu'elle s'affiche dans la GUI :

# Dans jobs/monmetier.yml
perks:
  20:
    name: "<red>🔥 Ma Perk Personnalisée"
    icon: BLAZE_ROD
    feature-key: "monplugin-maperk"
    description:
      - "<gray>Fait quelque chose d'incroyable."

rewards:
  0:
    20:
      perks:
        - "monplugin-maperk"

Optionnellement, ajoutez une section de configuration pour bénéficier gratuitement du support enabled/toggleable/require-sneaking :

# Dans config.yml
perks:
  features:
    monplugin-maperk:
      enabled: true
      permission: "monmetier.maperk"
      toggleable: true
      require-sneaking: false

Tous les feature-key intégrés

ModernJobs — Plugin Minecraft Métiers Premium

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