Créer des coffres au trésor
Les coffres au trésor permettent de distribuer du butin ou de faire apparaître un boss mimique hostile. Placez leurs fichiers de configuration dans plugins/EliteMobs/customtreasurechests.
Valeurs
isEnabled
Définit si un coffre au trésor est activé.
| Clé | Valeurs | Défaut |
|---|---|---|
isEnabled | Booléen | true |
Un fichier sans cette clé se charge comme activé. Les coffres désactivés sont entièrement ignorés : ils ne sont pas placés dans le monde et ne sont pas proposés à (ni acceptés par) /em place treasureChest.
Exemple
isEnabled: true
chestType
Définit le matériau du bloc. Utilisez un conteneur directionnel comme CHEST ou BARREL. Ce réglage ne remplit pas un inventaire normal : le butin provient de lootList lors de l'interaction.
| Clé | Valeurs | Défaut |
|---|---|---|
chestType | Matériau | CHEST |
Exemple
chestType: CHEST
Cela doit être un matériau de coffre valide comme CHEST ou BARREL.
facing
Définit la direction vers laquelle le coffre est orienté.
| Clé | Valeurs | Défaut |
|---|---|---|
facing | Spécial [1] | NORTH |
Exemple
facing: NORTH
Cela définit la direction vers laquelle le coffre est orienté. Les valeurs valides sont NORTH, SOUTH, EAST ou WEST.
Spécial [1]
Déplier le Tableau
| Orientation |
|---|
NORTH |
SOUTH |
WEST |
EAST |
dropStyle
Définit si le coffre est destiné à un seul joueur ou à plusieurs joueurs.
Le premier joueur qui interagit consomme un coffre SINGLE : le bloc devient de l'air et une échéance de réapprovisionnement est enregistrée. Il réapparaît après restockTimer minutes lorsque son chunk est chargé. Il n'y a pas de suivi par joueur. Les clics gauche et droit peuvent tous deux déclencher le coffre.
Les coffres GROUP restent dans le monde et chaque joueur reçoit son propre délai. Hors instance, tous les emplacements du même fichier partagent le délai de ce joueur via restockTimers. Utilisez des fichiers distincts pour des coffres indépendants. Dans une instance, chaque coffre actif garde sa propre liste de joueurs ayant déjà reçu leur butin.
Les deux modes attribuent un butin personnel au joueur qui interagit. GROUP ne lance pas de vote de groupe et ne récompense pas tous les joueurs proches. Les interactions déjà annulées par un autre plugin sont ignorées et la casse normale du bloc est bloquée. Aucun rang de guilde n'est requis.
| Clé | Valeurs | Défaut |
|---|---|---|
dropStyle | SINGLE / GROUP | SINGLE |
Exemple
dropStyle: SINGLE
lootList
Liste le butin que le coffre au trésor doit lâcher lorsqu'il est ouvert.
Chaque entrée admissible effectue son propre tirage : une ouverture peut donc attribuer plusieurs récompenses. Les permissions, quantités et filtres de difficulté applicables restent actifs. putLootDirectlyIntoPlayerInventory dans ItemSettings.yml choisit entre remise en inventaire et dépôt au coffre. Les objets élite qui ne tiennent pas dans l'inventaire tombent près du joueur avec son attribution de propriété.
| Clé | Valeurs | Défaut |
|---|---|---|
lootList | Table de butin EM | aucun |
Exemple
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=1.0
Si aucune entrée ne remet de récompense, le joueur reçoit treasureChestNoDropMessage de config.yml. Cela couvre les tirages ratés et les entrées qui ne peuvent produire de récompense. Le délai est tout de même consommé.
mimicChance
Définit la probabilité de faire apparaître un boss hostile au lieu de lâcher du butin.
| Clé | Valeurs | Défaut |
|---|---|---|
mimicChance | Double | 0 |
Chaque interaction admissible effectue le tirage du mimique avant la génération du butin. Un succès tente de faire apparaître le mimique à la place du butin, jamais les deux. Utilisez une valeur entre 0 et 1 ; 0.5 signifie 50 %. Le délai est consommé même si le boss choisi est introuvable ou ne peut pas apparaître.
Exemple
mimicChance: 0.5
mimicCustomBossesList
Indique la liste des boss hostiles pouvant apparaître. Un seul boss sera choisi aléatoirement dans cette liste pour apparaître.
La liste prend également en charge un système de poids que vous pouvez utiliser pour vous assurer que certains boss sont choisis plus souvent que d'autres.
| Clé | Valeurs | Défaut |
|---|---|---|
mimicCustomBossesList | Liste de chaînes | aucun |
Exemple
mimicCustomBossesList:
- my_cool_mimic_boss.yml
- weak_mimic_boss.yml
Si vous souhaitez attribuer des poids aux boss, la liste doit être formatée ainsi :
mimicCustomBossesList:
- my_cool_mimic_boss.yml:60
- weak_mimic_boss.yml:40
Dans cette configuration, my_cool_mimic_boss.yml a plus de chances d'être choisi pour apparaître que weak_mimic_boss.yml.
Une entrée sans suffixe de poids, ainsi qu'une entrée dont le poids ne peut pas être lu comme un nombre, se rabattent toutes deux sur un poids de 1.
Utilisez des noms de fichiers distincts et des poids positifs et finis. Répéter un nom remplace son poids précédent au lieu d'ajouter une entrée. Le sélecteur ne valide pas les poids négatifs ou non finis. Vérifiez que les boss sont activés et peuvent apparaître.
À quel niveau le mimique apparaît-il ?
Le fichier du boss détermine le calcul ; les niveaux numériques fixes sont remplacés par le calcul du palier du coffre :
level du boss mimique | Niveau d'apparition |
|---|---|
| Un nombre fixe | chestTier × 10, plus un bonus aléatoire de 0-10 |
dynamic (-1) dans un donjon dynamique | Le niveau sélectionné du donjon, ±1 |
dynamic (-1) partout ailleurs | Le niveau d'apparition naturel du joueur qui ouvre, ±1 |
Si le fichier de boss nommé dans la liste est introuvable, aucun mimique n'apparaît et un avertissement est consigné — le joueur n'obtient rien, pas même le butin.
Les calculs de ±1 donnent au minimum le niveau 1. Si les données d'inventaire du joueur manquent hors d'un donjon dynamique, le mimique dynamique utilise le mécanisme normal d'apparition du boss. Les mimiques créés dans un donjon appartiennent à cette rencontre.
restockTimer
Définit le délai, en minutes, avant que le coffre ne se remplisse à nouveau de butin.
| Clé | Valeurs | Défaut |
|---|---|---|
restockTimer | Entier | 0 |
Hors instance, SINGLE attend ce délai avant de restaurer le bloc dans un chunk chargé, tandis que GROUP l'applique à chaque joueur. Les échéances survivent aux redémarrages. Voir instanced pour les règles propres aux instances.
Laisser cette valeur à sa valeur par défaut de 0 signifie qu'il n'y a en pratique aucun temps de recharge, et que le coffre peut donc être farmé en boucle. Définissez une vraie valeur sur tout coffre lâchant quelque chose qui en vaut la peine.
Exemple
restockTimer: 30
effects
Remarque : ce réglage n'a aucun effet. Le chargeur lit la clé, mais les coffres n'utilisent pas sa valeur. Elle ne génère aucune particule.
Si vous voulez des particules autour d'un coffre, générez-les depuis une autre source pour le moment.
| Clé | Valeurs | Défaut |
|---|---|---|
effects | Liste de chaînes | aucun |
locations
Définit les emplacements où le coffre au trésor apparaîtra.
Ajoutez un emplacement avec /em place treasureChest <treasurechestfilename.yml> depuis le bloc souhaité. Il faut un joueur possédant elitemobs.place.admin et une configuration de coffre chargée et activée. La commande enregistre les coordonnées du bloc dans le fichier et place le coffre immédiatement. L'exécuter sur un bloc déjà listé réinitialise l'échéance de réapprovisionnement de cet emplacement au lieu d'ajouter une seconde entrée.
| Clé | Valeurs | Défaut |
|---|---|---|
locations | Liste de chaînes | aucun |
Chaque entrée utilise le format worldName,x,y,z,yaw,pitch. La forme abrégée worldName,x,y,z est également acceptée, auquel cas le yaw et le pitch sont considérés comme valant 0.
Le suffixe :unixTimestamp stocke l'échéance de cet emplacement en secondes Unix. EliteMobs l'écrit lorsqu'un coffre SINGLE est pillé. Arrêtez le serveur avant de le supprimer manuellement. Le changement prend effet au chargement de la configuration, sans réinitialiser un coffre déjà actif.
Un fichier peut contenir plusieurs emplacements. Ceux de SINGLE ont des échéances indépendantes ; ceux de GROUP hors instance partagent la liste des délais par joueur.
Les coordonnées fractionnaires sont arrondies vers le bas au bloc qui les contient. Ne combinez pas l'ancienne clé location avec locations. Le chargeur privilégie location, mais la sauvegarde des échéances utilise locations si cette liste n'est pas vide. Supprimer un coffre avec /em remove retire du fichier uniquement l'emplacement cliqué et laisse les autres en place.
Exemple
locations:
- my_world,10,50,10,0,0
- my_nether_world,12,58,12,0,0
- my_world,80,64,-30,0,0:1707394380
chestTier
Définit le palier du coffre, qui sert de référence pour le niveau du butin qu'il lâche. Le niveau de référence est chestTier * 10.
| Clé | Valeurs | Défaut |
|---|---|---|
chestTier | Entier | 0 |
L'importance réelle de chestTier dépend de l'endroit où se trouve le coffre et du type d'objet présent dans la table de butin :
| Situation | Niveau auquel le butin est lâché |
|---|---|
| Coffre ouvert en dehors de toute instance | Les objets élite scalable suivent le niveau d'apparition naturel du joueur qui ouvre, ±1. Tout le reste utilise chestTier * 10. |
| Coffre dans un donjon dynamique | Le niveau sélectionné du donjon est utilisé pour tout, les elite items scalable recevant ±1. chestTier est ignoré. |
| Coffre dans toute autre instance | chestTier * 10 pour tout. |
Ces niveaux sont transmis à la génération des objets. Les objets fixed conservent leurs statistiques définies et les limited respectent leur plafond configuré ; le coffre ne remplace pas ces règles. En survie normale, les objets scalable suivent le joueur qui ouvre. Les mimiques utilisent une autre formule, voir mimicCustomBossesList.
Les calculs de ±1 donnent au minimum le niveau 1. Si les données d'inventaire du joueur manquent hors instance, le butin utilise chestTier * 10.
Laisser cette valeur à sa valeur par défaut de 0 donne un niveau de butin de référence de 0.
Exemple
chestTier: 3
instanced
Indique si le coffre appartient à une instance. Après son pillage, le réapprovisionnement normal n'est pas programmé : SINGLE retire le bloc et GROUP autorise une ouverture par joueur pour ce coffre. Les instances simultanées ont des états indépendants.
SINGLE présente une limite : décharger puis recharger son chunk programme de nouveau le réapprovisionnement selon l'échéance du coffre actif. Il peut donc réapparaître dans la même instance après ce délai. Utilisez GROUP pour conserver la restriction d'une ouverture par joueur pendant toute l'instance.
NE DÉFINISSEZ PAS CETTE VALEUR MANUELLEMENT.
| Clé | Valeurs | Défaut |
|---|---|---|
instanced | Booléen | false |
Exemple
instanced: true
restockTime
Une fois qu'un coffre a été pillé, le plugin écrit cette clé pour suivre l'heure de réapprovisionnement.
Elle n'est utilisée que par l'ancien format à coffre unique, où la position du coffre est stockée dans une clé location plutôt que dans la liste locations. Dès qu'un fichier possède la moindre entrée locations, l'heure de réapprovisionnement est écrite sous forme de suffixe :unixTimestamp sur l'entrée locations correspondante et cette clé n'est plus touchée.
NE DÉFINISSEZ PAS CETTE VALEUR MANUELLEMENT.
| Clé | Valeurs | Défaut |
|---|---|---|
restockTime | Horodatage Unix en secondes | 0 |
Exemple
restockTime: 1707394380
restockTimers
Stocke les données de temps de recharge par joueur pour les coffres en mode GROUP. Le plugin écrit cette valeur automatiquement lorsqu'un joueur pille le coffre, et supprime les entrées expirées à chaque écriture. Le temps de recharge est enregistré avant toute remise de butin ; si cet enregistrement échoue, le joueur est invité à réessayer plus tard et ne reçoit rien.
Les coffres instanciés n'utilisent pas cette liste — au sein d'une instance, le temps de recharge par joueur est conservé en mémoire uniquement pour la durée de vie de cette instance.
NE DÉFINISSEZ PAS CETTE VALEUR MANUELLEMENT.
| Clé | Valeurs | Défaut |
|---|---|---|
restockTimers | Liste de chaînes | aucun |
Exemple
restockTimers:
- '12345678-abcd-4ef0-8123-123456789012:1707394380'
- '09876543-abcd-4ef0-8123-098765432109:1707395000'
Chaque entrée contient un UUID de joueur et un horodatage Unix en secondes, séparés par deux-points.
Exemple de configuration de coffre au trésor
isEnabled: true
chestType: CHEST
facing: NORTH
chestTier: 3
dropStyle: GROUP
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=0.95
mimicChance: 0.50
mimicCustomBossesList:
- balrog.yml
- killer_rabbit_of_caerbannog.yml
restockTimer: 1
locations:
- world,0.0,-60.0,-14.0,0.0,0.0
Notez que chaque entrée de butin ci-dessus utilise le préfixe filename=. Écrire magmaguys_toothpick.yml:chance=0.95 à la place serait interprété comme l'ancien format filename.yml:chance, et chance=0.95 n'étant pas un nombre, l'entrée consignerait un avertissement d'analyse à chaque démarrage.
