Informations

Donnez des nouveaux objectifs à vos joueurs !

Présentation

Fonctionnalités

• Fonctionnel en 1.19 - 1.21

• Configuration simple et rapide

• Créez autant de métiers que vous voulez

• Menu de progression

• Système de classement

• Système avancé de boost d'XP

• Option de leveling et récompenses infini (configurable)

• Supporte les "custom model data"

• Support des blocs custom avec ItemsAdder
• Support des codes couleurs Hex

Commandes

Commande	Description	Permission
/jobs	Accès au menu principal	//
/jobs help	Voir la liste des commandes	//
/jobs reload	Recharger le plugin	jobs.admin
/jobs open <métier>	Ouvre le menu de récompense d'un métier précis	jobs.open.<métier>
/jobs join <métier>	Rejoins un métier précis	//
/jobs leave <métier>	Quitte un métier déjà rejoint	//
/jobs setlevel <joueur> <jobId> <level>	Définis le niveau d'un métier pour un joueur	jobs.admin
/jobs addlevel <joueur> <jobId> <level>	Ajoute des niveaux au métier d'un joueur	jobs.admin
/jobs removelevel <joueur> <jobId> <level>	Retire des niveaux au métier d'un joueur	jobs.admin
/jobs reset <all/joueur>	Réinitilialise les niveaux au métier d'un joueur	jobs.admin
/jobs addrankingpoints <joueur> <jobID> <quantité>	Ajoute des points de classement à un joueur	jobs.admin
/jobs removerankingpoints <joueur> <jobID> <quantité>	Retire des points de classement à un joueur	jobs.admin
/jobs setrankingpoints <joueur> <quantité>	Définis les points de classement d'un joueur	jobs.admin
/jobsboost <durée> <multiplicateur> <métier/all> <joueur/global>	Commencer un event de boost d'xp	jobs.admin
/jobsboost cancel <joueur/global>	Annulez un event de boost d'xp	jobs.admin
//	Limite la quantité de métier rejoignable en même temps	jobs.quantity.1
//	Donne un boost d'expérience en pourcentage sur un métier précis	jobs.<métier>.exp.<pourcentage>

Placeholders

• %jobs_job_<job>_level% - Affiche le niveau du joueur dans un métier précis

• %jobs_job_<job>_experience% - Affiche l'expérience possédée dans un métier précis

• %jobs_job_<job>_needed-experience% - Affiche l'expérience manquante d'un métier précis

• %jobs_job_<job>_ranking-points% - Affiche les points de classement du joueur dans un métier

• %jobs_job_<job>_ranking-position% - Affiche la position du joueur dans le métier indiqué

• %jobs_job_<job>_ranking_<position>_name% - Affiche le pseudo du joueur à la position du classement indiquée

• %jobs_job_<job>_ranking_<position>_points% - Affiche le nombre de points du joueur dans le métier et la position du classement indiquée

Information complémentaires

1. Vous pouvez créer tous types de métiers grâce aux différents objectifs disponible :

Objectifs	Description
block-place	Placer un bloc
block-break	Casser un bloc
mob-kill	Tuer un monstre
crop-harvest	Casser une culture
fishing	Pêcher un poisson
enchanting	Enchanter un objet
crafting	Créer un objet
brewing	Concocter une potion
player-kill	Tuer un joueur
repairing	Réparer un objet

1. Les objectifs acceptent les indications de blocs spécifiques, comme par exemple: crafting-GOLD_BLOCK, mob-kill-SKELETON, enchanting-DIAMOND_BOOTS, etc..

2. Pour attribuer une valeur spécifique à un poisson pêché (rawcod, rawpufferfish, rawsalmon, rawtadpole, rawtropicalfish) ne mettez pas de tiret. Par exemple : fishing-rawsalmon;5 vous permettra de donner 5 points d'expérience quand un joueur obtient un saumon cru. Si vous utilisez le plugin FoxFishing, le format est le même, mais veillé à garder le nom exact de votre poisson custom défini dans la configuration.

3. Pour les blocs custom avec <ItemsAdder>, on utilisera ce format : block-break-NOMDUBLOC;1

Configurations

builder.yml

settings:
  friendly-name: 'Builder'
  # objective;experience-per
  # objectives can be: block-place, block-break, mob-kill, crop-harvest, fishing, enchanting, crafting, brewing
  # all objectives accepts specific block/material name, for example: crafting-GOLD_BLOCK, mob-kill-SKELETON, enchanting-DIAMOND_BOOTS etc.
  objectives:
    - 'block-place;1'
    - 'block-place-COAL_BLOCK;2'
    - 'block-place-REDSTONE_BLOCK;3'
    - 'block-place-IRON_BLOCK;7'
    - 'block-place-EMERALD_BLOCK;10'
    - 'block-place-DIAMOND_BLOCK;15'

1. Vous pouvez également définir des actions pour tous les boutons des menus du plugin tel que:

inventories.yml

    other:
      end-tree:
        material: 'NETHER_STAR'
        display-name: '&#EB4D4D&lEnd of Job Tree'
        lore:
          - '&7This is as far as you can advance!'
        slots:
          - 53
        actions:
          CLOSE_INVENTORY: true
          SEND_MESSAGE: '&cYou have reached the end of the job tree!'
          RUN_COMMAND: 'say {player} has reached the end of the job tree!'
          PLAY_SOUND: BLOCK_CHEST_CLOSE;1.0;1.

1. Les custom models data sont supportées par FoxJobs, il vous suffit d'ajouter "custom-model-data: valeur" sous la configuration d'un objet:

inventories.yml

      gray-glass:
        material: 'GRAY_STAINED_GLASS_PANE'
        display-name: '&c'
        custom-model-data: 5
        slots:
          - 1

Fichiers de Configuration

config.yml

database:
  type: 'sqlite' # sqlite, mysql
  address: 'localhost:3306'
  database: 'database'
  username: 'username'
  password: 'password'

reset-at-max-level: true
disable-main-menu: false

debug-mode: false

inventories.yml

main-menu:
  title: '&lAvailable Jobs'
  size: 27
  items:
    content:
      builder: # job id (file name without .yml)
        slot: 13
    other:
      gray-glass:
        material: 'GRAY_STAINED_GLASS_PANE'
        display-name: '&c'
        slots: []

job-menu:
  title: '&o&l{job-name} Job'
  size: 54
  page-item:
    previous:
      slot: 48
      material: 'ARROW'
      display-name: '&aPrevious Page'
      lore:
        - '&7Click to go to the previous page.'
    next:
      slot: 50
      material: 'ARROW'
      display-name: '&aNext Page'
      lore:
        - '&7Click to go to the next page.'
  items:
    content:
      job-tree-slots:
        slots: [0, 9, 18, 27, 28, 29, 20, 11, 2, 3, 4, 13, 22, 31, 32, 33, 24, 15, 6, 7, 8, 17, 26, 35, 44, 53]
    other:
      end-tree:
        material: 'NETHER_STAR'
        display-name: '&#EB4D4D&lEnd of Job Tree'
        lore:
          - '&7This is as far as you can advance!'
        slots: [53]
        actions:
          CLOSE_INVENTORY: true
          PLAY_SOUND: BLOCK_CHEST_CLOSE;1.0;1.0
      gray-glass:
        material: 'GRAY_STAINED_GLASS_PANE'
        display-name: '&c'
        slots: []

messages.yml

messages-prefix: '&6&l[Jobs]'

general:
  command-usage:
    - '{prefix} &cUsage: /{usage}'
  no-permission:
    - "{prefix} &cYou don't have enough permissions."
  target-not-found:
    - '{prefix} &cTarget not found.'
  help-command:
    - ''
    - '&6&l Jobs Commands'
    - ''
    - '&f /jobs &8▶ &7&oOpen jobs GUI.'
    - '&f /jobs setlevel <target> <job> <level> &8▶ &7&oSet player level in a job.'
    - '&f /jobs addlevel <target> <job> <level> &8▶ &7&oAdd player level in a job.'
    - '&f /jobs removelevel <target> <job> <level> &8▶ &7&oRemove player level in a job.'
    - '&f /jobs reset <target> <job> &8▶ &7&oReset a player job.'
    - '&f /jobs reload &8▶ &7&oReload all configurations.'
    - ''
  reload-command:
    - '{prefix} &aConfigurations successfully reloaded!'
  add-level-command:
    - '{prefix} &aSuccessfully added {level} level(s) to {target} job {job}.'
  remove-level-command:
    - '{prefix} &aSuccessfully removed {level} level(s) from {target} job {job}.'
  set-level-command:
    - '{prefix} &aSuccessfully set {target} job {job} level to {level}.'
  add-exp-command:
    - '{prefix} &aSuccessfully added {exp} EXP to {target} job {job}.'
  add-ranking-points-command:
    - '{prefix} &aSuccessfully added {points} point(s) to {target} job {job}.'
  remove-ranking-points-command:
    - '{prefix} &aSuccessfully removed {points} points(s) from {target} job {job}.'
  set-ranking-points-command:
    - '{prefix} &aSuccessfully set {target} job {job} ranking points to {points}.'
  reset-command:
    - '{prefix} &aSuccessfully reset {target} jobs.'
  job-not-found:
    - '{prefix} &cJob not found.'
  invalid-boost-duration:
    - '{prefix} &cInvalid boost duration! Example: 1h.'
  boost-already-active:
    - '{prefix} &cThere is already an active Boost Event.'
  no-boost-active:
    - '{prefix} &cThere is no active Boost Event.'
  cancel-boost:
    - '{prefix} &aSuccessfully cancelled Boost Event.'
  start-boost:
    - '{prefix} &aSuccessfully started Boost Event for {duration}.'
  start-boost-broadcast:
    - ''
    - '&#FFBB22&l JOB BOOST EVENT'
    - '&f &8▶ &7&o{job} job experience has been boosted by {amplifier}x for {duration}.'
    - ''
  start-all-boost-broadcast:
    - ''
    - '&#FFBB22&l JOB BOOST EVENT'
    - '&f &8▶ &7&oALL jobs has been boosted by {amplifier}x for {duration}.'
    - ''
  reached-max-jobs:
    - '{prefix} &cYou cannot join any more jobs!'
  already-in-job:
    - '{prefix} &cYou are already part of that job!'
  not-in-job:
    - '{prefix} &cYou are not in that job!'
  no-permission-to-join:
    - '{prefix} &cYou do not have access to join in this job!'
  job-join:
    - '{prefix} &aYou are now part of the %job% job!'
  job-leave:
    - '{prefix} &aYou are no longer part of the %job% job!'

jobs:
  reached-max-experience:
    - '{prefix} &aYou have reached the max experience for {job} Job and can level up.'
  level-up:
    - '{prefix} &aYour &f{job} Job &ahas reached &fLevel {level}&a!'
  max-level-up:
    - '{prefix} &aYour &f{job} Job &ahas reached &fMax Level&a and you received 1 ranking point.'
  insufficient-exp:
    - '{prefix} &cYou need {needed-experience} experience to level up.'