Configuration de ResurrectionChest

Premier Démarrage

La première fois qu'un administrateur avec resurrectionchest.* se connecte, ResurrectionChest publie un message unique de premier démarrage dix secondes après la connexion. Le message confirme que le plugin est prêt à l'emploi, pointe vers /resurrectionchest setup et rappelle comment enregistrer un coffre (placer un coffre et y poser un panneau indiquant [DeathChest] — ou la valeur que vous avez donnée à Input name for death chest).

ResurrectionChest fonctionne immédiatement avec les coffres vanilla, donc il n'y a rien que vous devez faire ici. Le rappel cesse d'apparaître une fois que setupDone est true dans config.yml. Ouvrir /resurrectionchest setup bascule automatiquement setupDone à true, ce qui écarte définitivement le message.

Menu de Configuration

/resurrectionchest setup

Ouvre le menu de configuration Nightbreak. À partir de là, les administrateurs peuvent :

• voir tous les packs de contenu ResurrectionChest (Wooden Chest, Angelic Chest)
• installer ou désinstaller des packs (ce qui déplace les fichiers de modèle entre les dossiers models et models_disabled de FreeMinecraftModels)
• filtrer les packs par Free ou Premium
• vérifier et télécharger une mise à jour du plugin via l'entrée Plugin Update
• ouvrir la liste Recommended Plugins (la même vue que /resurrectionchest recommendedplugins)
• activer ou désactiver les Automatic Updates (le paramètre nightbreak.autoDownloadPluginUpdates — voir Config et Permissions)
• lire les instructions d'installation et ouvrir les liens Nightbreak pertinents via le bouton d'info

Quand un pack est installé ou désinstallé, ResurrectionChest recharge automatiquement FreeMinecraftModels afin que les accessoires de coffre soient rafraîchis.

/resurrectionchest downloadall télécharge la mise à jour du plugin (le cas échéant) et tous les packs de contenu ResurrectionChest disponibles depuis Nightbreak en une seule fois (nécessite un compte Nightbreak lié). /resurrectionchest downloadallcontent télécharge uniquement les packs de contenu, et /resurrectionchest updatecontent (alias updateallcontent) re-télécharge uniquement les packs de contenu obsolètes.

Si les fichiers d'un pack ont été endommagés ou supprimés alors que le numéro de version indique toujours qu'il est à jour, /resurrectionchest forcereinstallcontent <package|all> le re-télécharge quand même. L'argument de package se complète au tab avec all, wooden-chest et angelic-chest ; utilisez all pour refaire tous les packs déjà téléchargés, ou nommez directement le slug si les fichiers d'un pack ont entièrement disparu.

Imports Manuels

Les téléchargements arrivent dans ce dossier, et les packages placés à la main peuvent y être déposés :

plugins/ResurrectionChest/imports

Laissez les archives de package intactes. ResurrectionChest décompresse le dossier au démarrage, achemine les fichiers de modèle vers FreeMinecraftModels et rafraîchit automatiquement FreeMinecraftModels lorsque des modèles ont été installés. Voir le guide partagé : Imports manuels vs gestion en jeu.

Enregistrer un Coffre

1. Placez un coffre.
2. Placez un panneau mural attaché à ce coffre.
3. Écrivez le texte déclencheur configuré sur la ligne 1 ou la ligne 2 du panneau.

Le texte déclencheur par défaut est :

[DeathChest]

Quand le panneau est accepté, ResurrectionChest :

• réécrit le panneau (la ligne 1 est effacée, la ligne 2 affiche le texte déclencheur en violet, la ligne 3 affiche le nom d'affichage du joueur, la ligne 4 est effacée)
• enregistre ce coffre pour le joueur
• supprime l'entrée de coffre enregistrée précédente du joueur s'il en avait déjà une, y compris en supprimant le panneau de configuration de cet ancien coffre (le bloc de l'ancien coffre et son contenu sont laissés intacts)
• marque les blocs de coffre et de panneau avec un marqueur de propriété au tick suivant, afin que le plugin puisse plus tard distinguer ses propres blocs des sosies

Il n'y a pas de flux d'enregistrement de coffre basé sur les commandes.

Règles de Configuration

• Le joueur a besoin de resurrectionchest.use.
• La configuration est bloquée dans les mondes de la liste noire.
• Le panneau accepté doit être un panneau mural attaché à un coffre.
• N'importe quel matériau de panneau mural fonctionne car le code vérifie les types de bloc de panneau mural, pas un matériau de panneau spécifique.
• Le bloc derrière le panneau doit être un coffre ordinaire. Les coffres piégés, les tonneaux et les autres conteneurs sont rejetés.
• Le coffre ne doit pas être déjà enregistré au nom d'un autre joueur. S'il l'est (l'une ou l'autre moitié d'un coffre double compte), le panneau reste du texte ordinaire et il est indiqué au joueur que le coffre appartient à quelqu'un d'autre.
• Le joueur doit être autorisé à construire sur le bloc du coffre. ResurrectionChest passe par la recherche WorldGuard / GriefPrevention partagée de MagmaCore : enregistrer un coffre à l'intérieur d'une région où le joueur ne peut pas construire est donc refusé avec le texte Chest protected region message. Sans plugin de protection installé, il n'y a aucune restriction supplémentaire — voir Config et Permissions.

Coffres Simples et Doubles

• Un coffre simple normal fonctionne immédiatement.
• Si un coffre enregistré devient plus tard partie d'un coffre double, ResurrectionChest détecte le changement un tick après la pose du bloc, marque la moitié nouvellement rattachée (et les panneaux qui s'y trouvent) et remplace l'accessoire par le modèle de coffre double.
• Si cette moitié nouvellement rattachée appartient déjà à l'enregistrement d'un autre joueur, l'enregistrement entier est abandonné plutôt que d'absorber le coffre de l'autre joueur.
• Les objets de mort peuvent remplir les deux côtés d'un inventaire de coffre double.
• À la mort, chaque moitié du coffre doit encore porter la balise de propriété de ce joueur. Si une moitié a été remplacée à l'insu du plugin, le coffre est considéré comme manquant.

Comportement de Suppression

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

• le coffre enregistré
• un panneau attaché appartenant à ce coffre enregistré

Quand un enregistrement est supprimé (par n'importe quel déclencheur — casser le coffre, casser le panneau, ou le détruire via l'accessoire FreeMinecraftModels), le plugin supprime également tous les panneaux muraux encore attachés à ce bloc de coffre. Ces panneaux sont supprimés, pas lâchés sous forme d'objets.

Un enregistrement est aussi abandonné automatiquement quand le plugin ne peut plus prouver que les blocs lui appartiennent : si une moitié de coffre à un emplacement stocké a perdu sa balise de propriété, ou porte désormais celle de quelqu'un d'autre, l'enregistrement est abandonné au prochain démarrage, chargement de chunk ou rafraîchissement de modèle, et un avertissement mentionnant l'UUID du propriétaire et les coordonnées du coffre est écrit dans la console. Le bloc de coffre lui-même est laissé en place. Les balises de panneau ne sont revérifiées que lorsque le plugin re-marque ses blocs — quand une moitié de coffre double est rattachée, et quand un ancien enregistrement est migré vers les balises de propriété actuelles. Mettez Enable high compatibility / low security mode for plugin conflicts à true si un autre plugin de votre serveur supprime ces données de bloc — voir Config et Permissions.

Le plugin annule également les tentatives de modifier le panneau de configuration enregistré sur place.

Si un accessoire de coffre personnalisé est actif, un clic gauche sur l'accessoire supprime également l'enregistrement (seul le propriétaire du coffre peut faire cela — voir Config et Permissions).

Les administrateurs peuvent effacer tous les coffres enregistrés d'un coup avec /resurrectionchest clear. Pour chaque coffre suivi, il lâche l'inventaire du coffre au sol, puis supprime le coffre et tous les panneaux de configuration attachés et efface l'enregistrement stocké.

Avertissement de Protection

ResurrectionChest n'est pas un plugin de protection.

• Il n'empêche pas les autres joueurs d'ouvrir le coffre physique.
• Il n'empêche pas les autres joueurs de casser le coffre physique ou le panneau si la configuration de protection de votre serveur le permet.

Utilisez la protection de région ou une autre solution de protection de coffre si vous avez besoin de contrôle d'accès.