Configuration d'Extractioncraft

Extractioncraft utilise plusieurs fichiers de configuration. Les paramètres principaux se trouvent dans config.yml et messaging.yml. Les paquets de contenu, les tables de butin et les pools de butin ont chacun leurs propres dossiers de configuration.

config.yml

Clé	Type	Défaut	Description
deleteItemsOnFailToExtract	Boolean	true	Indique si les joueurs perdent tous leurs objets lorsqu'ils échouent à s'extraire d'un match via l'un des points d'extraction. Lorsque cette option est activée, le contenu premade est équilibré autour de ce risque. La désactiver rend le contenu plus facile à farmer avec moins de raisons d'utiliser les mécaniques d'extraction.

La suppression ne s'applique qu'une fois le match réellement lancé : un joueur qui part alors que l'instance est encore en attente ou en compte à rebours conserve son inventaire. Une fois le match en cours, toute sortie qui n'est pas une extraction réussie (départ, déconnexion, mort ou retrait par le plugin) vide l'intégralité de l'inventaire.

messaging.yml

Tous les messages prennent en charge les codes couleur &. Les espaces réservés sont indiqués par ligne.

Clé	Défaut	Description
failedToJoinOngoingMatchAsPlayerMessage	Can't join this match - it has already started!	Affiché lorsqu'un joueur tente de rejoindre un match en cours
failedToJoinOngoingMatchAsPlayerInstanceIsFull	Can't join this match - the instance is already full!	Affiché lorsque le match a atteint son nombre maximum de joueurs
failedToJoinOngoingMatchAsPlayerNoPermission	Can't join this match - you don't have the permission!	Affiché lorsqu'un joueur n'a pas la permission de rejoindre
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessage	Can't join this match - spectators are not allowed!	Message configurable lorsque le mode spectateur est désactivé pour le paquet de contenu. Actuellement non émis par le runtime de match MagmaCore : la tentative de spectateur est silencieusement rejetée sans envoyer aucun message.
failedToJoinMatchAsSpectatorNoPermission	Can't spectate this match - you don't have the permission!	Message configurable lorsqu'un joueur n'a pas la permission de regarder. Actuellement non émis par le runtime de match MagmaCore : un spectateur sans permission se voit afficher failedToJoinOngoingMatchAsPlayerNoPermission à la place.
matchJoinAsPlayerMessage	[Extractioncraft] You are now in the match, $player!	Message de chat en rejoignant un match comme joueur. Le runtime MagmaCore ne substitue que l'espace réservé $count (par le nombre minimum de joueurs) dans cette chaîne ; $player n'est pas substitué, donc le texte par défaut affiche littéralement $player.
matchJoinAsPlayerTitle	Extract!	Titre affiché en rejoignant un match
matchJoinAsPlayerSubtitle	Grab the loot and head to an extraction point!	Sous-titre de connexion configurable. Actuellement non utilisé par le runtime de match MagmaCore : le sous-titre réellement affiché à la connexion est matchStartingSubtitle.
matchJoinAsSpectatorTitle	(vide)	Titre de connexion spectateur configurable. Actuellement non émis par le runtime de match MagmaCore.
matchJoinAsSpectatorSubtitle	Now spectating!	Sous-titre de connexion spectateur configurable. Actuellement non émis par le runtime de match MagmaCore.
matchJoinAsSpectatorMessage	[Extractioncraft] You are now spectating a match! Do &a/extractioncraft quit &fto stop spectating!	Message de chat de connexion spectateur configurable. Actuellement non émis par le runtime de match MagmaCore.
matchLeaveAsPlayerMessage	[Extractioncraft] You have left the match, $player!	Message de départ configurable. Actuellement non émis par le runtime de match MagmaCore, et $player n'est pas substitué.
matchLeaveAsSpectatorMessage	[Extractioncraft] You have left the match, $player!	Message de départ spectateur configurable. Actuellement non émis par le runtime de match MagmaCore, et $player n'est pas substitué.
matchFailedToStartNotEnoughPlayersMessage	This match requires $count players before starting - can't start yet!	Affiché lorsque /exc start est utilisé sans assez de joueurs. Le runtime de MagmaCore remplace l'espace réservé $amount par le nombre minimum de joueurs, donc personnalisez ce message en utilisant $amount plutôt que $count si vous voulez que le nombre soit substitué.
matchStartingMessage	[Extractioncraft] Match starting!	Message de chat de début de match configurable. Actuellement non émis par le runtime de match MagmaCore (le compte à rebours est affiché via le titre/sous-titre à la place).
matchStartingTitle	Match starting!	Titre affiché pendant le compte à rebours de 3 secondes. $count est remplacé par les secondes restantes.
matchStartingSubtitle	in $count...	Sous-titre pendant le compte à rebours de 3 secondes. $count est remplacé par les secondes restantes.
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 match. La téléportation elle-même est annulée par le runtime, mais ce message n'est actuellement pas envoyé au joueur.
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'un match. La téléportation elle-même est annulée par le runtime, mais ce message n'est actuellement pas envoyé au joueur.

Configuration des paquets de contenu

Les paquets de contenu sont des fichiers YAML dans le dossier content_packages/. Chacun définit une configuration de carte jouable.

Clé	Type	Défaut	Description
isEnabled	Boolean	true	Indique si le paquet compte comme installé. Cela détermine la couleur de son entrée dans /exc setup (true = installé/vert, false = téléchargé mais non installé/jaune), et le menu de configuration le bascule pour vous. Cela ne retire pas le paquet de /exc createMatch.
name	String	(requis)	Nom d'affichage du paquet (prend en charge les codes couleur &)
description	Liste de String	(requis)	Lignes de description affichées dans le menu de configuration
downloadLink	String	(optionnel)	URL affichée dans le chat lorsque vous cliquez sur un paquet non téléchargé dans le menu de configuration
version	Integer	0	Numéro de version du contenu. La vérification d'état de contenu d'Extractioncraft ne distingue que non téléchargé / installé / non installé, donc cette valeur n'est actuellement comparée à rien.
folderName	String	(requis)	Nom du sous-dossier de schematics pour ce paquet
usesEliteMobs	Boolean	false	Indicateur déclaratif signalant que le paquet utilise du contenu EliteMobs. Non appliqué au runtime.
usesBetterStructures	Boolean	false	Indicateur déclaratif signalant que le paquet utilise du contenu BetterStructures. Non appliqué au runtime.
usesFreeMinecraftModules	Boolean	false	Indicateur déclaratif signalant que le paquet utilise du contenu FreeMinecraftModels. Non appliqué au runtime. Notez que la clé YAML s'écrit usesFreeMinecraftModules (avec « Modules ») dans le code source.
betterStructuresModulesContainerName	String	(optionnel)	Le nom de fichier de configuration du générateur de modules BetterStructures transmis au générateur de monde lorsque /exc createMatch est exécutée, par exemple kobold_mines_module_generator_10.yml. C'est cette clé qui décide réellement quelle carte est générée.
spectatable	Boolean	false	Bascule de spectateur configurable. Extractioncraft ne transmet pas cette valeur à l'instance de match qu'il construit : le runtime traite donc toujours les matchs comme non observables et les connexions de spectateurs sont rejetées quelle que soit la valeur définie ici.
pvpEnabled	Boolean	true	Indique si le PvP est activé pendant les matchs. Lorsque la valeur est false, les tirs alliés sont bloqués dans tout le monde du match.
minPlayers	Integer	1	Nombre minimum de joueurs requis pour démarrer un match. /exc start refuse en dessous de ce seuil, et le compte à rebours est interrompu (mettant fin au match) si le nombre passe en dessous en cours de décompte.
maxPlayers	Integer	100	Nombre maximum de joueurs autorisés dans un match. Les cinq paquets premade Kobold Mines remplacent cette valeur par 8. La build actuelle n'enregistre aucune commande pour rejoindre, donc seul le créateur entre dans un match et ce plafond n'est jamais atteint.
chestLootTables	Liste de String	[]	Tables de butin utilisées pour les coffres, au format nom_fichier.yml:poids
barrelLootTables	Liste de String	[]	Tables de butin utilisées pour les tonneaux, au format nom_fichier.yml:poids

Format de poids des tables de butin

Les entrées de table de butin des coffres et tonneaux utilisent le format <nom_fichier_table_butin.yml>:<poids>. Lorsqu'un joueur ouvre un conteneur, une table de butin est sélectionnée en fonction de la probabilité pondérée.

Exemple :

chestLootTables:
  - kobold_mines_chest_high_loot_table_10.yml:.2
  - kobold_mines_chest_low_loot_table_10.yml:.2
barrelLootTables:
  - kobold_mines_barrel_loot_table_10.yml:1

La moitié :poids est obligatoire — une entrée sans deux-points suivi d'un nombre ne peut pas être analysée et empêche le chargement du paquet de contenu. Les poids sont relatifs les uns aux autres : l'exemple ci-dessus donne donc à chacune des deux tables de coffres une part égale de 50 %. Un nom de fichier qui ne correspond à aucun fichier de loot_tables/ génère un avertissement au démarrage et casse le pillage des conteneurs pour ce paquet.