✉️ Système de Lettres / Missives médiéval - Avec Oiseaux, délais automatique, logs... 1.1

Bonjour ! Merci d'avoir cliqué sur mon script !
____________________________________________________________________________________________________________________

Description :
Ce script permet aux joueurs d’envoyer des lettres (missives) aux autres joueurs.
Il existe 3 types d’envoi :

• Simple: envoyer à un ou plusieurs joueurs de votre choix votre lettre.
  • Ces lettres simples peuvent être rendues anonymes, ce qui cachera votre nom à la vue du destinataire.
• Par catégorie de job : envoyer directement aux joueurs de toute une catégorie votre lettre.
• Général : envoyer à tout le serveur votre lettre.

Les destinataires reçoivent la lettre sur l’écran.

Uniquement compatible Darkrp et dérivé !

Le content : Steam Workshop::Content - Missives Louison

____________________________________________________________________________________________________________________

Fonctionnalités :

1. Archivage des lettres:
   • Vous pouvez conserver les lettres reçues et les retrouver via l’onglet « Mes Missives », ainsi que les supprimer.
2. Délai de réception configurable:
   • Délai simple : la lettre mettra 60 secondes (configurable) à arriver à son destinataire.
   • Délai automatique (« réaliste ») : le système calcule la distance entre l’expéditeur et le destinataire. La lettre mettra 20 secondes (configurable) à parcourir 100 mètres, 40 secondes pour 200 mètres, etc.
3. Oiseau messager:
   • Vous pouvez activer/désactiver l’apparition d’un oiseau lors de l’envoi.
   • Le modèle de l’oiseau (corbeau par défaut) peut être changé dans la configuration (ex. : une chouette pour un serveur Poudlard RP).
   • À l’envoi, l’oiseau s’envole puis disparaît, et réapparaît près du destinataire après le délai configuré.
   • L’oiseau suit le destinataire même s’il se déplace, et la missive est reçue à son arrivée.
4. Système de logs pour admins:
   • Affiche toutes les lettres envoyées, leurs messages, le type d’envoi, l’anonymat, le SteamID de l’expéditeur, etc.

____________________________________________________________________________________________________________________

Sécurité et optimisation :

• Limites anti-spam:
  • Nombre de caractères limité à 1500 par lettre.
  • Un cooldown empêche l’envoi massif de lettres.
• Gestion des logs:
  • Les logs admins sont sauvegardés de manière compacte sur le serveur.
  • Les missives enregistrées dans « Mes Missives » sont stockées localement (client), évitant toute surcharge serveur.
• Performances:
  • Les fonctionnalités (oiseau, délais, etc.) sont optimisées et ne réduisent pas les performances et peuvent de toute manière être désactivées dans la configuration.

____________________________________________________________________________________________________________________

Prix, support et crédits :

Le script est vendu 9 euros et toute les mises à jour sont gratuites (logique). Aucun remboursement n'est possible après l'achat, sauf en cas de défaut technique majeur de mon fait non résolu sous 15 jours. Le support technique est garanti pour ce qui est des corrections de mon fait (et non si cela vient de vous).

Crédits :

• Kera pour la beta test et l'idée de choix multiple
• Sabino et Ware pour l'idée de missive
• Vaelyn et Cyrille pour divers avis
• Les créateurs des quelques UI qui sont libre de droit sur internet
• Le model de corbeau provient du Workshop et ne m'appartient pas
• Le model de l'entité de missive provient du Workshop et ne m'appartient pas

____________________________________________________________________________________________________________________

Pour aller plus loin :

• Les délais sont exprimés en secondes.
• La liste de droite correspond aux catégories Darkrp
• Les catégories exclues doivent correspondre exactement aux noms définis dans darkrp_customthings/categories.lua.

Ce qui est modifiable dans le fichier config :

1. Modèle de l'Entité des Missives

• LouisonMissiveConfig.MissiveEntityModel : Définit le modèle 3D de l'entité utilisée pour envoyer/recevoir les lettres.
• LouisonMissiveConfig.MissiveIsPaid : Si l'envoi de missive doit être payant
• LouisonMissiveConfig.MissivePrice : Si l'envoi de missive est payant, le prix que le joueur paye
  

2. Système de l'Oiseau Messager

• LouisonMissiveConfig.EnableCrow : Active/désactive l’apparition d’un oiseau lors de l’envoi et la réception.
• LouisonMissiveConfig.CrowModel : Modèle 3D de l’oiseau (doit être riggé avec une animation de vol).
  LouisonMissiveConfig.CrowAnimation : Animation de vol utilisée par l’oiseau.
  Exemple : "fly01" (liste visible via "Modifier l’icône" dans le menu des props).

3. Délais de Livraison

• LouisonMissiveConfig.EnableDelay : Active/désactive les délais avant réception.
• LouisonMissiveConfig.UseAutoDelay : Si true, le délai dépend de la distance entre l’expéditeur et le destinataire.
• LouisonMissiveConfig.DelayPer1000Units : Nombre de secondes pour parcourir 100 mètres (si UseAutoDelay = true).
• LouisonMissiveConfig.FixedDelay : Délai fixe (en secondes) si UseAutoDelay = false.

4. Accès aux Logs Administrateurs

• ADMIN_LOGS_ACCESSMISSIVE : Liste des rangs DarkRP autorisés à consulter les logs des missives.
  Exemple : {"superadmin", "admin", "moderateur"}

5. Catégories Exclues de la Liste "Région"

• CATEGORIES_TO_EXCLUDEMISSIVE : Catégories de jobs non affichées dans le menu d’envoi par région.
  Exemple : {"VIP", "STAFF"}
• LouisonMissiveConfig.BlockedJobs : Jobs Darkrp qui n'ont pas accès au système de missive.
  Exemple : {"Citoyen", "En connexion"}

6. Personnalisation des Textes

• LouisonMissiveConfig.MissiveHeaderText : Titre principal de l’interface.
• LouisonMissiveConfig.MissiveCategoryHeaderText : Titre de la section "Région".
• LouisonMissiveConfig.MyMissivesButtonText : Texte du bouton "Mes Missives".
• LouisonMissiveConfig.GeneralMessageButtonText : Texte du bouton "Missive Générale".
• LouisonMissiveConfig.World3DText : Texte affiché au-dessus de l’entité dans le monde.