Module Boîte aux Lettres

Fichier : modules/mailbox/config.yml

Le module Boîte aux Lettres propose deux fonctionnalités complémentaires :

• Boîte aux lettres d'objets : les administrateurs envoient des objets dans la boîte aux lettres virtuelle d'un joueur, même lorsqu'il est hors ligne. Le joueur ouvre l'interface de sa boîte aux lettres pour récupérer ses objets, qui expirent après une durée configurable.
• Courriers texte : les joueurs envoient de courts messages texte à un autre joueur, connecté ou non. Le destinataire les lit avec /mail read et est prévenu à sa connexion lorsque des courriers non lus l'attendent.

Configuration SourceCopier le lien vers ce titre

enable: true

# The expiration time of items when added to the mailbox
# If the player does not recover his items with expiration they will be deleted permanently.
expiration: 86400

# Settings of the text mails, sent with /mail send <player> <message>
# A mail can be sent to an offline player, it will be readable with /mail read on his next connection.

# Notify the player when he connects and has unread mails
message-notify-on-join: true

# Delay in seconds before sending the notification, to avoid it being lost in the join messages
message-notify-delay: 3

# Maximum amount of mails a player can store, a new mail is refused when the limit is reached
message-max-amount: 50

# Maximum amount of characters of a mail
message-max-length: 256

# Delay in seconds between two mails sent by the same player
# Players with the permission essentials.bypass.cooldown are not affected
message-cooldown: 5

# Date format used to display the date of a mail
message-date-format: "yyyy-MM-dd HH:mm"

OptionsCopier le lien vers ce titre

Boîte aux lettres d'objetsCopier le lien vers ce titre

Courriers texteCopier le lien vers ce titre

Boîte aux lettres d'objetsCopier le lien vers ce titre

1. Un administrateur envoie un objet dans la boîte aux lettres d'un joueur avec /mail give, /mail give-hand, /mail giveall ou /mail giveall-hand.
2. L'objet est stocké dans la boîte aux lettres virtuelle du destinataire, qu'il soit connecté ou non. Un destinataire connecté reçoit un message dans la barre d'action.
3. Le joueur ouvre sa boîte aux lettres avec /mail et clique sur les objets pour les récupérer (un emplacement libre dans l'inventaire est nécessaire).
4. Si un objet n'est pas récupéré avant sa date d'expiration, il est supprimé.
5. Les administrateurs peuvent consulter la boîte aux lettres d'un autre joueur avec /mail open <joueur> et la vider avec /mail clear <joueur>.

Courriers texteCopier le lien vers ce titre

Les courriers texte permettent de laisser un message à un joueur qui n'est pas connecté.

• /mail send <joueur> <message> envoie un courrier à un joueur connecté ou hors ligne. Un destinataire connecté est prévenu immédiatement par un message l'invitant à utiliser /mail read.
• /mail read affiche tous vos courriers, avec l'expéditeur et la date, puis les marque comme lus.
• /mail clearmessages supprime vos propres courriers ; /mail clearmessages <joueur> supprime ceux d'un autre joueur.
• /mail sendall <message> envoie un courrier à tous les joueurs connectés (l'expéditeur est ignoré, ainsi que les joueurs dont la boîte est pleine).
• Lorsqu'un joueur se connecte avec des courriers non lus, il reçoit une notification cliquable après message-notify-delay secondes (si message-notify-on-join est activé).

RestrictionsCopier le lien vers ce titre

• Un courrier ne peut pas dépasser message-max-length caractères.
• Un joueur ne peut pas s'envoyer un courrier à lui-même.
• Un joueur muet (mute) ne peut pas envoyer de courrier.
• Un joueur qui a utilisé /ignore sur l'expéditeur ne reçoit pas ses courriers (l'expéditeur est informé que le destinataire ne souhaite pas les recevoir). La liste d'ignorés est vérifiée lorsque le destinataire est connecté.
• Un courrier est refusé lorsque le destinataire stocke déjà message-max-amount courriers.
• Les joueurs doivent attendre message-cooldown secondes entre deux courriers, sauf s'ils ont essentials.bypass.cooldown.
• Les courriers envoyés depuis la console sont signés du nom de la console et ne sont pas soumis aux vérifications de mute et de délai.

StockageCopier le lien vers ce titre

Les courriers texte fonctionnent avec tous les types de stockage :

Commandes AssociéesCopier le lien vers ce titre

Sous-commandesCopier le lien vers ce titre

Pour la liste complète des commandes, consultez Commandes & Permissions.

Placeholders AssociésCopier le lien vers ce titre

Pour la liste complète des placeholders, consultez Placeholders.

ExemplesCopier le lien vers ce titre

Expiration des objets après 7 joursCopier le lien vers ce titre

expiration: 604800

Les objets expirent après 7 jours, ce qui laisse plus de temps aux joueurs pour se connecter et récupérer leurs livraisons.

Courriers texte plus strictsCopier le lien vers ce titre

message-max-amount: 20
message-max-length: 128
message-cooldown: 30
message-date-format: "dd/MM/yyyy HH:mm"

Les joueurs peuvent stocker au maximum 20 courriers de 128 caractères et doivent attendre 30 secondes entre deux courriers.

Désactiver la notification de connexionCopier le lien vers ce titre

message-notify-on-join: false

Les joueurs ne sont plus prévenus à la connexion ; ils doivent exécuter /mail read eux-mêmes.