Configuration d'Extractioncraft

Extractioncraft utilise plusieurs fichiers de configuration. Les principaux réglages se trouvent dans config.yml et messaging.yml. Les packs de contenu, les tables de butin et les pools de butin possèdent chacun leur propre dossier.

config.yml

Clé	Type	Valeur par défaut	Description
deleteItemsOnFailToExtract	Boolean	true	Détermine si les joueurs perdent tous leurs objets lorsqu'ils ne quittent pas une partie par un point d'extraction. Le contenu fourni est équilibré autour de ce risque lorsque l'option est activée. La désactiver facilite le farming et réduit l'intérêt des mécaniques d'extraction.
nightbreak.autoDownloadPluginUpdates	Boolean	false	Réglage partagé de MagmaCore, ajouté au fichier après le démarrage d'Extractioncraft. Avec true, les mises à jour disponibles du plugin Extractioncraft sont téléchargées quelques minutes après le démarrage et utilisées après le prochain redémarrage, sauf si nightbreak.applyPluginUpdatesWithoutRestart les applique plus tôt. Voir Mises à jour automatiques.
nightbreak.applyPluginUpdatesWithoutRestart	String	never	Réglage partagé de MagmaCore. never attend le prochain redémarrage, when-empty applique une mise à jour du plugin téléchargée dès qu'aucun joueur n'est connecté, et immediately l'applique dès la fin du téléchargement. Appliquer une mise à jour recharge Extractioncraft, ce qui termine les parties en cours. Voir Appliquer les mises à jour sans redémarrage.

La suppression ne s'applique qu'une fois la partie lancée. Partir pendant l'attente ou le compte à rebours laisse l'inventaire intact. Une extraction, un arrêt du serveur ou un rechargement du plugin conserve les objets et lie à l'âme du joueur ceux qui ne sont pas liés, lorsque l'enchantement Soulbind d'EliteMobs est activé. Avec cette option à false, toute autre sortie d'une partie active lie les objets à l'âme au lieu de les supprimer. Voir Déroulement des parties pour chaque façon de quitter une partie.

messaging.yml

Tous les messages acceptent les codes couleur &. Les variables sont indiquées dans chaque ligne.

Clé	Valeur par défaut	Description
failedToJoinOngoingMatchAsPlayerMessage	Can't join this match - it has already started!	Affiché lorsqu'un joueur tente de rejoindre une partie déjà commencée
failedToJoinOngoingMatchAsPlayerInstanceIsFull	Can't join this match - the instance is already full!	Affiché lorsque la partie a atteint son nombre maximal de joueurs
failedToJoinOngoingMatchAsPlayerNoPermission	Can't join this match - you don't have the permission!	Message configurable en l'absence de permission. Actuellement jamais envoyé : les parties Extractioncraft ne définissent aucune permission d'entrée.
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessage	Can't join this match - spectators are not allowed!	Message configurable lorsque les spectateurs sont interdits par le pack. Le moteur de partie MagmaCore ne l'émet pas actuellement : la tentative est rejetée sans message.
failedToJoinMatchAsSpectatorNoPermission	Can't spectate this match - you don't have the permission!	Message configurable en l'absence de permission de spectateur. Actuellement jamais envoyé : regarder une partie en spectateur ne demande aucune permission.
matchJoinAsPlayerMessage	[Extractioncraft] You are now in the match, $player!	Message du chat à l'entrée d'un joueur dans une partie. $player est remplacé par le nom du joueur et $count par le nombre minimal de joueurs.
matchJoinAsPlayerTitle	Extract!	Titre affiché à l'entrée dans une partie
matchJoinAsPlayerSubtitle	Grab the loot and head to an extraction point!	Sous-titre affiché à l'entrée dans une partie
matchJoinAsSpectatorTitle	(vide)	Titre affiché à l'entrée comme spectateur. Extractioncraft n'a aucune commande pour regarder une partie en spectateur : seuls les spectateurs admis par un autre plugin via l'API le voient.
matchJoinAsSpectatorSubtitle	Now spectating!	Sous-titre affiché à l'entrée comme spectateur. Envoyé uniquement aux spectateurs admis via l'API.
matchJoinAsSpectatorMessage	[Extractioncraft] You are now spectating a match! Do &a/extractioncraft quit &fto stop spectating!	Message du chat à l'entrée comme spectateur. Envoyé uniquement aux spectateurs admis via l'API. $player est remplacé par le nom du joueur.
matchLeaveAsPlayerMessage	[Extractioncraft] You have left the match, $player!	Message de départ configurable, actuellement non émis par le moteur MagmaCore. $player n'est pas remplacé.
matchLeaveAsSpectatorMessage	[Extractioncraft] You have left the match, $player!	Message configurable de départ d'un spectateur, actuellement non émis par le moteur MagmaCore. $player n'est pas remplacé.
matchFailedToStartNotEnoughPlayersMessage	This match requires $count players before starting - can't start yet!	Affiché à tous les joueurs de la partie si /exc start est utilisé sans assez de joueurs. Seule la variable $amount est remplacée par le nombre minimal de joueurs : le texte par défaut affiche donc $count littéralement. Utilisez $amount si vous voulez que le nombre soit affiché.
matchStartingMessage	[Extractioncraft] Match starting!	Message configurable du chat au démarrage, actuellement non émis par le moteur MagmaCore. Le compte à rebours utilise le titre et le sous-titre.
matchStartingTitle	Match starting!	Titre du compte à rebours. $count affiche 2, 1, puis 0 à une seconde d'intervalle.
matchStartingSubtitle	in $count...	Sous-titre du compte à rebours. $count affiche 2, 1, puis 0 à une seconde d'intervalle.
preventTeleportInMessage	[Extractioncraft] You have attempted to teleport into an ongoing match - you can't do that!	Message configurable pour les téléportations bloquées vers un monde de partie. La téléportation est bien annulée par le moteur, mais ce message n'est pas envoyé au joueur actuellement.
preventTeleportOutMessage	[Extractioncraft] You have attempted to teleport from an ongoing match - you can't do that!	Message configurable pour les téléportations bloquées hors d'une partie. La téléportation est bien annulée par le moteur, mais ce message n'est pas envoyé au joueur actuellement.

Configuration des packs de contenu

Les packs de contenu sont des fichiers YAML dans content_packages/. Chacun définit la configuration d'une carte jouable.

Clé	Type	Valeur par défaut	Description
isEnabled	Boolean	true	Détermine si le pack est considéré comme installé et la couleur de son entrée dans /exc setup : true pour installé/vert, false pour téléchargé mais non installé/jaune. Le menu modifie cette valeur pour vous. /exc createMatch propose toujours un pack désactivé en complétion, mais refuse de le générer.
name	String	(obligatoire)	Nom d'affichage du pack, avec prise en charge des codes couleur &
description	Liste de chaînes	(obligatoire)	Lignes de description affichées dans le menu de configuration
downloadLink	String	(facultatif)	URL affichée dans le chat au clic sur un pack non téléchargé. Les packs fournis utilisent https://nightbreak.io/plugin/extractioncraft/.
version	Integer	0	Numéro de version du contenu. Extractioncraft ne distingue actuellement que les états non téléchargé, installé et non installé ; cette valeur n'est comparée à aucune autre.
folderName	String	(facultatif)	Présent dans les fichiers fournis, mais non lu par le code actuel. Le fait qu'un pack soit considéré comme téléchargé dépend de betterStructuresModulesContainerName.
usesEliteMobs	Boolean	false	Indicateur déclaratif d'utilisation de contenu EliteMobs, non contrôlé à l'exécution.
usesBetterStructures	Boolean	false	Indicateur déclaratif d'utilisation de contenu BetterStructures, non contrôlé à l'exécution.
usesFreeMinecraftModules	Boolean	false	Indicateur déclaratif d'utilisation de contenu FreeMinecraftModels, non contrôlé à l'exécution. La clé YAML s'écrit bien usesFreeMinecraftModules, avec « Modules », dans les sources.
betterStructuresModulesContainerName	String	(facultatif)	Fichier de configuration du générateur de modules BetterStructures transmis au générateur de monde par /exc createMatch, par exemple kobold_mines_module_generator_10.yml. C'est cette clé qui détermine réellement la carte générée. Le générateur doit être activé, avoir isWorldGeneration: true et lister au moins un module de départ installé. Le menu de configuration considère le pack comme téléchargé dès que BetterStructures a chargé ce générateur.
spectatable	Boolean	false	Indique si la partie accepte des spectateurs. Extractioncraft n'a aucune commande pour regarder une partie en spectateur : ce réglage ne concerne que les spectateurs admis par un autre plugin via l'API.
pvpEnabled	Boolean	true	Active le PvP pendant les parties. Avec false, les joueurs et leurs projectiles ne peuvent infliger de dégâts aux autres joueurs nulle part dans le monde de la partie.
minPlayers	Integer	1	Nombre minimal de joueurs pour démarrer. /exc start refuse en dessous de ce seuil. Si le nombre baisse sous ce seuil pendant le compte à rebours, celui-ci est annulé et la partie se termine. Une valeur supérieure à maxPlayers est ramenée à maxPlayers.
maxPlayers	Integer	100	Nombre maximal de joueurs d'une partie (au moins 1). Les cinq packs Kobold Mines fournis utilisent 8. Extractioncraft n'enregistre aucune commande pour rejoindre une partie : seul son créateur y entre, sauf si un autre plugin admet des joueurs via l'API.
contentLevel	Integer	10	Niveau transmis à EliteMobs pour générer le butin des coffres et tonneaux. Une valeur inférieure à 1 devient 1. Les packs fournis utilisent 10, 20, 30, 40 et 50.
chestLootTables	Liste de chaînes	[]	Tables de butin des coffres, au format filename.yml:weight
barrelLootTables	Liste de chaînes	[]	Tables de butin des tonneaux, au format filename.yml:weight

Format des poids des tables de butin

Les entrées des tables de butin pour coffres et tonneaux utilisent <loot_table_filename.yml>:<weight>. À l'ouverture d'un conteneur, une table est sélectionnée selon ces probabilités pondérées.

Exemple :

chestLootTables:
  - my_chest_high_loot_table.yml:.2
  - my_chest_low_loot_table.yml:.2
barrelLootTables:
  - kobold_mines_supplies_loot_table.yml:1

La partie :weight est obligatoire et doit être un nombre positif. Une entrée qui ne contient pas exactement un deux-points, dont le nom de fichier est vide ou dont le poids n'est pas un nombre positif est ignorée avec un avertissement. Les poids sont relatifs : dans cet exemple, les deux tables de coffres ont chacune 50 % de chances d'être choisies. Un nom sans fichier correspondant dans loot_tables/ produit un avertissement au démarrage et est ignoré, tout comme une table définie avec isEnabled: false. S'il ne reste aucune table utilisable, un clic droit sur ce type de conteneur n'a aucun effet.