Marry (FiveM/ESX/QBCore) — Mariages avec limousine, feux d'artifice et noms de famille partagés

Apportez des mariages inoubliables dans votre ville. Marier permet aux joueurs de proposer, d'accepter et de célébrer avec un pipeline de cérémonie complet : trajet en limousine, caméra cinématique, feux d'artifice synchronisés, tenues optionnelles et un nom de famille partagé automatique pour les deux partenaires.

Télécharger

Pourquoi « se marier » ?

Le jeu de rôle est avant tout une question de moments significatifs. Avec MarierLes fiançailles et les mariages deviennent des événements à l'échelle du serveur plutôt que de simples émoticônes. Tout est orchestré côté serveur pour plus d'équité et d'immersion, avec une interface utilisateur intuitive pour le demandeur et le destinataire.

Cérémonie immersive: spawn limousine + chauffeur IA, itinéraire vers le lieu, animations chronométrées, feux d'artifice et prises de vue de caméra.
Identité réelle: mise à jour facultative du nom de famille (détecte automatiquement les schémas d'identité ESX) ou mode logiciel via les exportations.
Écoulement sans frottement: proposer → accepter/refuser → cérémonie → nettoyage. Le serveur conserve la vérité (argent, base de données, journaux).
Multi-Framework: ESX 1.1/1.2/oldlegacy/legacy et QBCore via un adaptateur partagé.
Sécurisé par défaut: jetons de session, limites de débit, vérifications de proximité et de temps de recharge, filtres de blasphème.
Localisé: Paramètres régionaux EN/DE prêts à l'emploi.
Entièrement Open Source

Vous débutez avec les frameworks ? Notre rapide Guide du framework (ESX vs QBCore vs QBOX) peut vous aider à choisir la bonne base pour votre ville. Lire le guide »

Points forts des fonctionnalités

Système de proposition — Sélecteur de joueur à proximité, saisie du nom de famille, sélecteur de lieu, message facultatif ; le destinataire voit une invite modale pour accepter ou refuser.
Pipeline de cérémonie — Des buckets de routage optionnels pour l'isolement, une limousine pilotée par l'IA du début de l'animation à la destination, des feux d'artifice synchronisés, des animations homme/femme et une caméra cinématographique.
Mise à jour du nom de famille — Détection automatique utilisateurs/personnages tables (variantes ESX) ; revient à l'exportation en mode logiciel si aucun système d'identité n'est présent.
Piloté par la configuration — Les stations, les lieux, les animations, les feux d'artifice, les crochets à vêtements et les prix sont tous en configuration.
Outils d'administration — /marier:divorce et /marier:statut avec la permission de l'ACE FiveMX_marry.admin.
Surface du développeur — Exportations pour l'état matrimonial et la recherche de partenaires, ainsi que des événements stables pour les intégrations (HUD, tableaux de bord, etc.).

Comment ça marche (parcours du joueur)

Proposer à proximité d'une station Marry configurée ou via /marier (à la gare).
Accepter/Refuser — Le récepteur reçoit une invite localisée avec des détails.
Célébrer — Une fois les frais acceptés, ils sont traités, les entrées de la base de données sont créées, la logique du nom de famille s'exécute et la séquence limousine + feu d'artifice + caméra démarre. Le serveur nettoie tout à la fin.

Compatibilité et exigences

Cadres: ESX (1.1, 1.2, ancien héritage, héritage) et QBCore (parité via adaptateur).
Base de données: oxmysql (migrations incluses).
Facultatif: changeur de peau / peau_esx ou vêtements qb pour les tenues de mariage.

Nouveau sur QBCore ? Découvrez notre guide de démarrage rapide sur Configuration des scripts QBCore.
Suivez les étapes »

Compatible avec cette robe de mariée :

https://fivemx.com/fivem-wedding-dress

Installation (5 à 10 minutes)

Déposer le dossier FiveMX_marier dans votre serveur ressources/.
Assurer les dépendances (es_extended ou QB-Noyau, et @oxmysql).
Démarrer une fois ; les migrations créent automatiquement des tables mariages et audit_de_mariage.
Configure config.lua (voir ci-dessous) et définissez la chaîne de version ESX souhaitée.
Ajoutez à votre serveur.cfg dans le bon ordre : assurer oxmysql assurer es_extended # ou : assurer qb-core assurer FiveMX_marry
Redémarrez le serveur ou la ressource via txAdmin.

Conseil : après la mise en service, utilisez Résmon pour garder un œil sur les performances pendant que les joueurs testent la cérémonie. Comment utiliser Resmon »

Instantané de configuration

Vous trouverez ci-dessous un petit extrait pour illustrer le style (nous livrons une configuration complète et documentée) :

FiveMXCore = FiveMXCore ou {} FiveMXLocales = FiveMXLocales ou {} -- Framework et version FiveMXCore.ESXVersion = 'legacy' -- 1.1 | 1.2 | oldlegacy | legacy -- Préfixe d'événement interne (ne pas modifier à l'exécution) FiveMXCore.InternalPrefix = 'FiveMX_marry:' -- Prix et stations FiveMXCore.MarryPrice = 5000 FiveMXCore.MarryStations = { { pos = vec3(-1378.4, -1409.8, 4.3), ped = 's_m_m_highsec_01', blip = {sprite=280, color=3}, radius = 3.0 } } -- Lieux FiveMXCore.MarryLocations = { beach = { preanim = { car = 'stretch', start = vec3(-1395.1,-1370.2,4.5), destination = vec3(-1495.2,-1045.5,6.3), speed = 14.0 }, mainanim = { durée = 30, caméra = { fov = 60 } , feu d'artifice = { boucle = 3 } } } }

Un validateur intégré vérifie les lieux, les stations, les feux d'artifice et les paramètres du cadre au démarrage, en enregistrant des avertissements clairs si quelque chose est mal configuré.

Commandes et autorisations d'administration

/marier — ouvrez l'interface utilisateur de proposition (à une station Marry).
/marier:statut [id] — imprimer l'état matrimonial pour vous ou une cible.
/marier:divorce — fermer un acte de mariage actif ; rétablissement facultatif du nom de famille.

Autorisation ACE: FiveMX_marry.admin

API développeur (exportations)

Utilisez-les pour intégrer des HUD, des tableaux de bord ou des scénarios personnalisés :

exports['FiveMX_marry']:IsMarried(identifiant_ou_source) -- booléen exports['FiveMX_marry']:GetPartner(identifiant) -- {identifiant, nom, marié_à} | nil exports['FiveMX_marry']:GetMarriageRecord(identifiant) -- table | nil

Événements suivre le modèle FiveMX_marier : : et sont protégés par des jetons de session et des contrôles de proximité. Consultez le fichier README pour la liste complète.

Sécurité et fair-play

Server‑side money manutention & DB writes
Jetons de session (rotation), temps de recharge et limites de taux
Contrôles de proximité (stations et partenaires), désinfection des entrées
Seaux de routage facultatifs pendant les cérémonies

FAQ

Cela fonctionne-t-il à la fois sur ESX et QBCore ?
Oui, parité totale via un partage adaptateur de cadre.

Cela changera-t-il les noms de famille des joueurs ?
Si votre schéma d’identité ESX expose un nom de famille colonne, nous pouvons la synchroniser. Sinon, le nom de famille est stocké dans notre propre table et exposé via les exportations (par exemple, Affichage tête haute (HUD)(tableaux d'affichage).

Qu'en est-il des performances ?
La cérémonie utilise des entités éphémères et nettoie rigoureusement. Résmon lors de vos premiers événements pour confirmer le budget sur votre machine.

Pouvons-nous ajouter nos propres lieux et feux d’artifice ?
Absolument, tout est piloté par la configuration. Ajouter de nouveaux Emplacements de mariage avec des blocs pré-animés et animés principaux.

Comment localisons-nous ?
Ensemble FiveMXCore.Paramètres régionaux et éditer locales/en.lua ou locales/de.lua.

Journal des modifications

v1.0.0 — Version publique initiale : propositions, pipeline de cérémonie complet, intégration de noms de famille, paramètres régionaux EN/DE, exportations, outils d'administration, validateur de configuration.

Télécharger

Besoin d'aide pour l'installation ou souhaitez un forfait cérémonie personnalisé ? Contactez-nous via Soutien depuis le pied de page du site.