Vertex Studio

2. config.yml

Réglages globaux, appliqués à tous les jobs sauf override spécifique.

yaml

config-version: 1

Ne touche pas à cette ligne. Elle sert à faire évoluer le fichier automatiquement lors des mises à jour du plugin (voir section 19 pour ce que ça implique concrètement).

yaml

language: fr

Choisit le fichier utilisé dans languages/ (sans l'extension .yml). Si le fichier n'existe pas, le plugin retombe sur messages.yml à la racine. Change en language: en pour passer tout le plugin en anglais (le fichier languages/en.yml est fourni).

css

main-menu: main

Le menu ouvert quand un joueur tape /jobs sans argument. C'est l'identifiant du fichier dans gui/ (sans .yml, sans le dossier gui/). Par défaut, main correspond à gui/main.yml.

python

max-active-jobs: 3

Nombre de jobs qu'un joueur peut avoir en même temps. Dépassable par permission : advancedjobs.jobs.<nombre> (ex. advancedjobs.jobs.5) ou advancedjobs.jobs.unlimited pour aucune limite.

yaml

points-mode: PER_JOB

PER_JOB : chaque job a sa propre réserve de points, totalement séparée.
GLOBAL : une seule réserve de points, partagée entre tous les jobs du joueur.

yaml

global-multipliers:
  xp: 1.0
  money: 1.0
  points: 1.0
  coins: 1.0

Multiplicateurs appliqués à tous les jobs, en plus des bonus de rank et des boosters actifs. Les quatre valeurs sont indépendantes : tu peux booster l'XP serveur entier sans toucher à l'argent. Combiné avec les bonus de rank et les boosters selon la formule : gain final = gain de base × global-multipliers × rank-bonus × boosters actifs

yaml

job-coins:
  enabled: true

Coupe-circuit global des coins-job (la 4ᵉ ressource, voir section 6). Si false, aucune action ne rapporte de coins, sur aucun job, même si jobs/miner.yml en déclare — sans avoir à modifier chaque fichier de job. Les autres gains (xp/money/points) continuent normalement.

yaml

anti-abuse:
  ignore-placed-blocks: true
  tracked-blocks: 20000

ignore-placed-blocks : si true, un bloc posé par un joueur ne rapporte rien quand il le recasse ensuite (empêche le farm artificiel pierre ↔ poser/casser en boucle).
tracked-blocks : nombre maximum de positions de blocs mémorisées simultanément en mémoire (protection contre une fuite mémoire sur un serveur avec beaucoup de joueurs qui posent énormément de blocs).

yaml

leaderboard:
  size: 10
  refresh-seconds: 300

size : nombre de joueurs conservés dans le classement de chaque job.
refresh-seconds : fréquence de recalcul du classement (en secondes), en tâche asynchrone — les menus ne consultent jamais la base de données en direct, seulement ce cache.

yaml

auto-save-seconds: 300

Fréquence de sauvegarde automatique des profils joueurs modifiés (XP, argent gagné, coins, réclamations...), en secondes.

yaml

backups:
  on-startup: true
  keep: 10

on-startup : si true, une archive zip de la configuration (et de la base de données SQLite si utilisée) est créée à chaque démarrage du plugin, dans backups/.
keep : nombre d'archives conservées — les plus anciennes au-delà de ce nombre sont supprimées automatiquement.

yaml

exploration:
  enabled: true
  travel-step: 100

enabled : active/désactive l'écoute des actions d'exploration (TRAVEL, WORLD, EXPLORE_BIOME, EAT).
travel-step : distance en blocs à parcourir entre deux déclenchements de l'action TRAVEL.

yaml

debug:
  enabled: false
  modules: [jobs, levels, rewards, gui, database, placeholder, integration, booster, multiplier]

enabled : active le mode debug (rien ne s'affiche si false, même si des modules sont listés).
modules : liste des sous-systèmes à tracer dans la console. Retire ceux qui ne t'intéressent pas pour réduire le bruit. placeholder est particulièrement verbeux (une ligne par résolution de placeholder).