Déroulement des parties Extractioncraft

Cette page décrit le fonctionnement réel d'une partie, de sa création à la suppression du monde instancié, avec les minuteries, les règles d'extraction et les conditions de perte d'équipement.

Création de la partie

/exc createMatch <contentPackage.yml> transmet le betterStructuresModulesContainerName du pack à BetterStructures, qui génère un nouveau monde instancié. La commande vérifie d'abord que BetterStructures, EliteMobs et FreeMinecraftModels sont chargés, que le joueur n'est pas déjà dans une partie ou en attente d'une partie, et que le pack ainsi que son générateur de modules sont activés.

Pendant la génération du monde, le joueur est réservé pour cette partie et ne peut ni en rejoindre ni en créer une autre. La génération est annulée, et le monde à moitié construit supprimé, si elle dure plus de 15 minutes, si le joueur se déconnecte ou exécute /exc leave, ou si l'un des plugins compagnons cesse d'être disponible. À la fin de la génération :

• un ExtractionMatch est créé pour ce monde, dans l'état en attente
• le joueur ayant exécuté la commande est ajouté à la partie et, au tick suivant, téléporté à un point d'apparition choisi au hasard dans le nouveau monde. Une carte sans point d'apparition annule la partie à la place.

Chaque entrant passe en mode Aventure. Sa position et son mode de jeu précédents sont enregistrés avant ce changement et restaurés à son départ. Les joueurs conservent leur propre inventaire dans la partie ; rien n'est mis de côté.

Il n'y a ni file d'attente ni matchmaking. Une partie existe parce qu'un joueur l'a créée.

Attente des joueurs

Aucune commande pour rejoindre

/exc createMatch est le seul moyen intégré d'entrer dans une partie. Extractioncraft n'enregistre aucune sous-commande join ni de commande pour devenir spectateur : une partie contient donc normalement exactement un joueur, son créateur. D'autres plugins peuvent admettre des joueurs ou des spectateurs via l'API développeur ; les règles ci-dessous s'appliquent alors à eux.

Pendant l'attente :

• l'admission accepte des joueurs jusqu'à maxPlayers, fixé à 8 dans tous les packs Kobold Mines fournis, et refuse une instance pleine avec failedToJoinOngoingMatchAsPlayerInstanceIsFull
• une fois le compte à rebours commencé ou la partie lancée, plus personne ne peut la rejoindre en tant que joueur ; les arrivants tardifs reçoivent failedToJoinOngoingMatchAsPlayerMessage
• les spectateurs ne sont acceptés que si le pack de contenu définit spectatable: true. Tous les packs fournis le laissent à false.
• partir ne coûte rien à ce stade : la règle de suppression des objets ne s'applique qu'une fois la partie lancée

Démarrage

Tout joueur présent dans la partie peut exécuter /exc start.

• Si le nombre de participants est inférieur à minPlayers, le démarrage est refusé et tous les joueurs en sont informés via matchFailedToStartNotEnoughPlayersMessage. $amount est remplacé par le nombre requis.
• Sinon, le compte à rebours affiche 2, 1, puis 0 à une seconde d'intervalle. Il se termine à la troisième mise à jour, environ deux secondes après la première.
• Si le nombre de joueurs passe sous minPlayers pendant ce compte à rebours, la partie est annulée et se termine immédiatement.
• Exécuter de nouveau /exc start une fois le compte à rebours commencé n'a aucun effet.

À la fin du compte à rebours, la partie est lancée. Les interactions physiques avec la redstone sont déverrouillées, les boss instanciés de la carte apparaissent, les coffres et tonneaux sont placés, et la minuterie de 15 minutes, la bordure rétrécissante et la boussole en barre de boss démarrent. Les points d'extraction décoratifs, encore inutilisables, sont placés au même moment.

Minuteries

Minuterie	Durée	Effet
Minuterie de partie	15 minutes	Affichée sous la forme Timer MM:SS dans le tableau latéral Extractioncraft, actualisée chaque seconde. À 00:00, la partie se termine.
Activation des points d'extraction	1 minute après le départ	Place la version utilisable de chaque point d'extraction, avec son levier.
Fenêtre d'extraction	20 secondes	Démarre à l'actionnement du levier d'un point d'extraction.
Ouverture d'un conteneur	3 secondes	Durée pendant laquelle il faut rester immobile pour piller un coffre ou un tonneau.

Lorsque la minuterie de partie atteint 00:00, la partie se termine et chaque joueur encore présent est retiré comme ayant échoué son extraction. Voir Mort et perte d'objets.

Bordure du monde

La bordure est centrée sur le milieu de la carte générée et commence aussi large que la carte. BetterStructures calcule cette largeur à partir du générateur de modules, sous la forme (2 × radius − 1) × moduleSizeXZ, soit 384 blocs pour les cartes Kobold Mines fournies. Chaque seconde, la bordure prend la largeur de départ multipliée par la proportion de temps restant : elle rétrécit donc régulièrement et atteint 1 bloc à la fin de la minuterie de 15 minutes.

Sa distance d'avertissement correspond à la largeur actuelle moins 50, sans jamais descendre sous 0. Minecraft interprète cette distance comme le nombre de blocs depuis la bordure à partir duquel l'écran se teinte : l'avertissement rouge couvre donc toute la carte tant que la bordure mesure plus de 100 blocs de large, puis n'apparaît plus qu'à proximité du bord.

Les zones les plus difficiles se trouvant au milieu de la carte (voir Butin des mobs tués), le resserrement pousse progressivement les joueurs vers la partie la plus difficile et la plus lucrative de la carte. Les dégâts de la bordure s'appliquent toujours, et des dégâts de bordure mortels retirent le joueur par le mécanisme normal de mort en partie.

Extraction

1. Trouvez un point d'extraction. La barre de boss en haut de l'écran sert de boussole : elle affiche un marqueur ⦿ pour chaque point situé à moins de 90° de votre direction de regard, à raison d'environ 3° par caractère. La barre apparaît dès le début de la partie, mais reste vide la première minute. Les marqueurs concernent uniquement les points utilisables, placés à l'expiration de la minuterie d'activation.
2. Faites un clic droit sur le levier du point d'extraction. Le levier est retiré, tous les joueurs dans un rayon de 10 blocs reçoivent « You have triggered an exit! » et une seule fenêtre d'extraction de 20 secondes s'ouvre pour ce point.
3. Restez dans la zone d'extraction : le cube de 7 × 7 × 7 blocs centré sur le bloc du point d'extraction. À l'intérieur, le message Extracting! in N seconds! s'affiche.
4. Sortir de la zone affiche Extraction cancelled!, mais la fenêtre continue. Revenir avant sa fermeture permet toujours de s'extraire.
5. À la fermeture, tous les joueurs présents dans la zone sont extraits ensemble et voient Victory / Extraction successful!. Ils quittent la partie en conservant tout ce qu'ils portent.

Une fenêtre par point d'extraction

Chaque point d'extraction ouvre une seule fenêtre par partie. Le gestionnaire accepte un levier situé à moins de 10 blocs d'un point d'extraction pas encore utilisé. Un levier proche d'un point déjà utilisé n'a aucun effet particulier et s'actionne comme un levier normal.

Mort et perte d'objets

Chaque joueur dispose d'une seule vie par partie Extractioncraft. Il n'existe ni réapparition ni coffre de mort.

• Les dégâts qui tueraient le joueur sont annulés. Le joueur est retiré de la partie à la place. Pendant une partie active, ses effets de potion, son embrasement, son gel et sa distance de chute sont d'abord effacés.
• Lors de ce retrait, il retrouve son mode de jeu enregistré et est téléporté à sa position d'avant l'entrée. Sa santé n'est pas rétablie, sauf pour les joueurs encore présents à la fin de la partie.
• Tomber sous le bas du monde ramène le joueur sur le dernier bloc où il se tenait, jusqu'à trois fois de suite. Au-delà, le vide peut le tuer comme n'importe quels autres dégâts.

La façon dont un joueur quitte une partie active détermine le sort de ses objets :

Mode de départ	Butin conservé ?
Extraction à un point prévu	Oui, lié à l'âme
Arrêt du serveur ou /exc reload	Oui, lié à l'âme
Mort, /exc leave, /exc quit ou déconnexion pendant une partie active	Non, avec la configuration par défaut
Encore présent à la fin de la minuterie de 15 minutes	Non, avec la configuration par défaut
Départ pendant l'attente ou le compte à rebours	Oui, sans modification

« Non » vide l'inventaire entier, l'objet tenu au curseur et la grille de fabrication lorsque deleteItemsOnFailToExtract vaut true (valeur par défaut). Avec false, ces sorties lient plutôt les objets à l'âme. La liaison lie chaque objet non lié au joueur qui part tant que l'enchantement Soulbind d'EliteMobs est activé ; les objets déjà liés conservent leur propriétaire.

Les joueurs encore présents lorsqu'un compte à rebours est annulé faute de minPlayers sont retirés à la fin de la partie et gardent leurs objets intacts, car la partie n'est jamais devenue active. La perte d'objets ne concerne que les joueurs présents dans la partie au moment où elle est devenue active.

Protections du monde

Le monde instancié est protégé pendant toute sa durée de vie :

• les joueurs ne peuvent ni casser ni poser des blocs, utiliser de la poudre d'os, vider des seaux, modifier des panneaux ou endommager le terrain. Les explosions, le feu, l'écoulement des liquides, la disparition des feuilles et l'apparition vanilla des mobs sont bloqués, et le vol en élytres est désactivé.
• les coffres, tonneaux et autres conteneurs ne peuvent pas être ouverts ; les conteneurs de la partie se pillent comme décrit dans Butin des conteneurs. Les portes, trappes et portillons ne peuvent pas être utilisés. Les cadres, porte-armures et pots de fleurs sont protégés.
• les interactions physiques avec la redstone, comme les plaques de pression, sont bloquées jusqu'au lancement de la partie. Ce réglage ne bloque pas toutes les formes d'interaction redstone.
• le PvP est bloqué si le pack définit pvpEnabled: false
• les joueurs de la partie ne peuvent se téléporter par aucun moyen que la partie n'a pas elle-même déclenché, y compris les commandes, les perles de l'Ender et les fruits du chorus. Les autres joueurs ne peuvent pas se téléporter dans le monde de la partie, sauf s'ils possèdent extractioncraft.match.bypass (par défaut : op).
• pendant le compte à rebours ou la partie active, toute autre personne trouvée dans le monde de la partie sans extractioncraft.match.bypass est renvoyée au point d'apparition du monde principal.

Les administrateurs peuvent utiliser /exc protection bypass pour les vérifications de blocs et d'interactions qui consultent ce statut du joueur. Il ne contourne ni les restrictions de téléportation de la partie, ni l'interdiction du PvP, ni l'ensemble des règles du monde.

Fin de la partie

La partie se termine au retrait de son dernier joueur actif (qu'il se soit extrait, soit mort, soit parti ou se soit déconnecté), à la fin de la minuterie de 15 minutes, ou lorsqu'un compte à rebours perd son nombre minimal de joueurs. Tous les joueurs encore présents sont soignés et retirés, Extractioncraft arrête les tâches de bordure, de boussole, de tableau et de particules de la partie, et toute autre personne restée dans le monde, comme un membre de l'équipe disposant de la permission de contournement, est renvoyée au point d'apparition du monde principal.

La fin de la partie demande ensuite la suppression définitive du monde temporaire. La suppression est abandonnée si le monde ne peut pas être déchargé. Tant que le plugin est activé, la suppression du dossier attend cinq secondes et vérifie aussi que le monde n'a pas été rechargé.

Les parties sont également supprimées à la désactivation du plugin, notamment lors d'/exc reload ou de l'arrêt du serveur. Les parties encore en cours de génération sont annulées, et les joueurs des parties actives conservent leurs objets comme décrit ci-dessus.