Aller au contenu principal

Configuration de ResurrectionChest

Premier démarrage​

Tant que la configuration n'est pas terminée, ResurrectionChest affiche un rappel de premier démarrage dix secondes après chaque connexion d'un administrateur possédant resurrectionchest.*. Ce message confirme que le plugin est prêt, indique /resurrectionchest setup et rappelle comment enregistrer un coffre : poser un coffre et y placer un panneau portant [DeathChest], ou le texte défini dans Input name for death chest.

ResurrectionChest fonctionne immédiatement avec les coffres vanilla. Aucune configuration n'est donc obligatoire. Le rappel disparaît dès que setupDone vaut true dans config.yml. L'ouverture de /resurrectionchest setup attribue automatiquement cette valeur et désactive définitivement le message.

/resurrectionchest initialize ouvre la configuration guidée. Les choix Recommended Setup, Manual Setup et Use Current Content marquent chacun la configuration comme terminée. Les coffres de mort vanilla fonctionnent sans téléchargement de pack.

Menu de configuration​

/resurrectionchest setup

Cette commande ouvre le menu Nightbreak. Les administrateurs peuvent y :

  • consulter tous les packs ResurrectionChest, Wooden Chest et Angelic Chest
  • installer ou désinstaller les packs, ce qui déplace les modèles entre les dossiers models et models_disabled de FreeMinecraftModels
  • filtrer les packs gratuits ou premium
  • rechercher et télécharger une mise à jour du plugin depuis Mise à jour du plugin
  • télécharger ou mettre à jour tous les packs à la fois avec l'entrée de téléchargement global, qui exécute /resurrectionchest downloadall pour vous
  • ouvrir la liste Plugins recommandés, identique à celle de /resurrectionchest recommendedplugins
  • activer ou désactiver les mises à jour automatiques avec nightbreak.autoDownloadPluginUpdates, voir Configuration et permissions
  • lire les instructions d'installation et ouvrir les liens Nightbreak correspondants avec le bouton d'information

Lors de l'installation ou de la désinstallation d'un pack, ResurrectionChest recharge automatiquement FreeMinecraftModels pour actualiser les modèles des coffres.

/resurrectionchest downloadall télécharge en une fois la mise à jour du plugin, si disponible, et tous les packs ResurrectionChest disponibles sur Nightbreak. Un compte Nightbreak lié est nécessaire. /resurrectionchest downloadallcontent télécharge uniquement les packs de contenu. /resurrectionchest updatecontent, alias updateallcontent, retélécharge uniquement les packs qui ne sont plus à jour.

Si les fichiers d'un pack sont endommagés ou supprimés alors que sa version est toujours indiquée comme actuelle, /resurrectionchest forcereinstallcontent <package|all> force leur téléchargement. L'autocomplétion de l'argument propose all, wooden-chest et angelic-chest. Utilisez all pour réinstaller tous les packs déjà téléchargés, ou indiquez directement l'identifiant d'un pack dont les fichiers ont entièrement disparu.

Importations manuelles​

Les téléchargements arrivent dans ce dossier, où vous pouvez aussi déposer manuellement des packages :

plugins/ResurrectionChest/imports

Laissez les archives intactes. Au démarrage, ResurrectionChest décompresse le contenu du dossier, envoie les modèles vers FreeMinecraftModels et recharge automatiquement ce dernier si des modèles ont été installés. Consultez le guide commun : Importations manuelles ou gestion en jeu.

Enregistrer un coffre​

  1. Posez un coffre.
  2. Fixez un panneau mural à ce coffre.
  3. Écrivez le texte déclencheur configuré sur la première ou la deuxième ligne du panneau. Les majuscules et minuscules n'ont pas d'importance.

Le texte par défaut est :

[DeathChest]

Lorsque le panneau est accepté, ResurrectionChest :

  • réécrit le panneau : première ligne vide, texte déclencheur en violet sur la deuxième, nom d'affichage du joueur sur la troisième et quatrième ligne vide
  • enregistre ce coffre pour le joueur
  • supprime son précédent enregistrement s'il en avait un, ainsi que le panneau de configuration de l'ancien coffre ; l'ancien coffre et son contenu restent intacts
  • marque les blocs du coffre et du panneau avec l'identité du propriétaire au tick suivant, pour les distinguer ensuite de blocs semblables

Si un autre plugin annule la pose du panneau, aucun enregistrement n'est validé et l'ancien coffre reste enregistré. Casser un coffre ou son panneau ne supprime l'enregistrement que lorsque le bloc est effectivement cassé. Une destruction annulée ne désenregistre rien.

Il n'existe aucune commande pour enregistrer un coffre.

Règles d'enregistrement​

  • Le joueur doit posséder resurrectionchest.use.
  • L'enregistrement est interdit dans les mondes de la liste noire.
  • Le panneau doit être un panneau mural fixé à un coffre.
  • Tous les matériaux de panneau mural fonctionnent. Le code vérifie le type de bloc, sans imposer un matériau précis.
  • Le bloc derrière le panneau doit être un coffre ordinaire. Les coffres piégés, tonneaux et autres conteneurs sont refusés.
  • Le coffre ne doit pas déjà appartenir à un autre joueur. Cette vérification couvre les deux moitiés d'un coffre double. Sinon, le panneau reste ordinaire et le joueur reçoit un message indiquant que le coffre appartient à quelqu'un d'autre.
  • Le joueur doit avoir le droit de construire à l'emplacement du coffre. ResurrectionChest utilise les vérifications communes WorldGuard et GriefPrevention de MagmaCore et les signalements de protection des fournisseurs de propriété des emplacements. Un refus empêche l'enregistrement et affiche le texte Chest protected region message. Sans fournisseur de protection ou de propriété, aucune restriction supplémentaire ne s'applique. Voir Configuration et permissions.

Coffres simples et doubles​

  • Un coffre simple ordinaire fonctionne immédiatement.
  • Si un coffre enregistré devient ensuite un coffre double, ResurrectionChest détecte le changement un tick après la pose du bloc, marque la nouvelle moitié et ses panneaux, puis utilise le modèle de coffre double.
  • Si cette nouvelle moitié appartient déjà à l'enregistrement d'un autre joueur, l'enregistrement entier est supprimé au lieu d'absorber le coffre de cet autre joueur.
  • Les objets de mort peuvent remplir les deux moitiés de l'inventaire du coffre double, soit les 54 emplacements.
  • Un coffre double peut être à cheval sur une limite de chunk. Le serveur n'associe les deux moitiés que lorsque les deux chunks sont chargés : lorsque le propriétaire meurt loin du coffre, ResurrectionChest charge donc le chunk qui contient l'autre moitié avant de vérifier la propriété et de déplacer les objets. Il le charge normalement et ne le garde pas chargé de force. Si les moitiés ne s'associent toujours pas, la console consigne un avertissement qui nomme le joueur et l'emplacement du coffre, et seule la moitié enregistrée reçoit des objets.
  • Avec les réglages de sécurité par défaut, chaque moitié doit encore porter la marque de propriété du joueur au moment de sa mort. Si une moitié a été remplacée à l'insu du plugin, le coffre est considéré comme manquant.

Suppression d'un enregistrement​

Casser l'un de ces éléments supprime l'enregistrement :

  • le coffre enregistré
  • un panneau fixé au coffre et appartenant à cet enregistrement

Lorsqu'un enregistrement est supprimé, que ce soit en cassant le coffre, son panneau ou le modèle FreeMinecraftModels, le plugin supprime aussi les panneaux muraux fixés qui passent sa vérification de propriété. Ces panneaux disparaissent sans laisser d'objet au sol.

L'enregistrement est également supprimé lorsque le plugin ne peut plus confirmer la propriété des blocs. Si une moitié du coffre à un emplacement enregistré a perdu sa marque ou porte celle d'un autre joueur, le plugin supprime l'enregistrement au prochain démarrage, chargement du chunk ou rafraîchissement du modèle. Il écrit dans la console un avertissement avec l'UUID du propriétaire et les coordonnées du coffre. Le coffre lui-même reste en place. Les marques des panneaux ne sont revérifiées que lorsque le plugin marque à nouveau ses blocs, lors de l'ajout d'une moitié de coffre double ou de la migration d'un ancien enregistrement vers les marques actuelles. Activez Enable high compatibility / low security mode for plugin conflicts si un autre plugin supprime ces données de bloc. Voir Configuration et permissions.

Le plugin annule aussi les tentatives de modification du panneau enregistré.

Si un modèle personnalisé de coffre est actif, un clic gauche sur ce modèle supprime également l'enregistrement. Seul le propriétaire peut le faire. Voir Configuration et permissions.

Les administrateurs peuvent effacer tous les coffres enregistrés avec /resurrectionchest clear. Pour chacun d'eux, la commande dépose son inventaire au sol, supprime le coffre et ses panneaux de configuration, puis efface l'enregistrement.

Ce nettoyage respecte les vérifications de propriété configurées. Les blocs qui ne les passent pas restent en place. Si le monde d'un coffre est déchargé, seul son enregistrement est effacé ; les blocs de ce monde restent intacts.

Avertissement concernant la protection​

ResurrectionChest n'est pas un plugin de protection.

  • Il n'empêche pas les autres joueurs d'ouvrir le coffre physique.
  • Il ne les empêche pas de casser le coffre ou son panneau si les protections de votre serveur l'autorisent.

Utilisez une protection de région ou une autre solution de protection des coffres si vous devez contrôler l'accès.

Dépannage​

  • Les objets ne vont pas dans le coffre. Vérifiez que le joueur possède resurrectionchest.use, que le panneau utilisait le texte de déclenchement configuré, et que le coffre existe toujours et est enregistré pour ce joueur (le casser supprime l'enregistrement). Les morts dans un monde listé dans blacklistedWorlds, ou avec keepInventory activé, sont laissées de côté.
  • Le modèle de coffre personnalisé ne s'affiche pas. Le modèle est choisi à l'enregistrement du coffre. Si FreeMinecraftModels ou le pack de modèles a été installé plus tard, ou si la permission de modèle du joueur a changé, cassez le coffre et enregistrez-le de nouveau. Voir Intégration FreeMinecraftModels.
  • Avant d'exécuter /resurrectionchest clear, sauvegardez playerData.yml et tout contenu de coffre que vous voulez conserver. La commande vide chaque coffre enregistré sur le sol et supprime les coffres et leurs panneaux.

Lorsque vous demandez de l'aide, indiquez les versions de ResurrectionChest et du serveur, votre config.yml, les étapes qui reproduisent le problème et le journal complet du serveur. /logify téléverse le journal et renvoie un lien.