Marry (FiveM/ESX/QBCore) — Bodas con Limusina, Fuegos Artificiales y Apellidos Compartidos
Trae bodas inolvidables a tu ciudad. Marry permite a los jugadores proponer, aceptar y celebrar con un proceso completo de ceremonia: paseo en limusina, cámara cinematográfica, fuegos artificiales sincronizados, atuendos opcionales y un apellido compartido automático para ambos socios.
¿Por qué “Marry”?
Roleplay se trata de momentos significativos. Con Marry, los compromisos y las bodas se convierten en eventos de todo el servidor, no simples emotes de chat. Todo está orquestado del lado del servidor para garantizar equidad e inmersión, con una interfaz limpia NUI tanto para el proponente como para el receptor.
- Ceremonia detallada: generar limusina + conductor IA, ruta al lugar, animaciones temporizadas, fuegos artificiales y tomas de cámara.
- Identidad Real: actualización opcional del apellido (detecta automáticamente esquemas de identidad ESX) o modo suave mediante exports.
- Flujo Fluido: proponer → aceptar/rechazar → ceremonia → limpieza. El servidor mantiene la verdad (dinero, base de datos, registros).
- Multi‑Framework: ESX 1.1/1.2/oldlegacy/legacy y QBCore a través de un adaptador compartido.
- Seguro por defecto: tokens de sesión, límites de velocidad, comprobaciones de proximidad y tiempo de reutilización, filtros de groserías.
- Localizado: locales EN/DE listos para usar.
- Código totalmente abierto
¿Nuevo en frameworks? Nuestra guía rápida Guía de Frameworks (ESX vs QBCore vs QBOX) puede ayudarte a elegir la base adecuada para tu ciudad. Leer la guía »
Aspectos Destacados
- Sistema de Propuesta — Selector de jugadores cercanos, entrada de apellido, selector de lugar, mensaje opcional; el receptor ve un modal para aceptar o rechazar.
- Proceso de Ceremonia — Cubos de enrutamiento opcionales para aislamiento, limusina con IA desde el inicio de la animación previa hasta el destino, fuegos artificiales sincronizados, animaciones masculinas/femeninas y cámara cinematográfica.
- Actualización de Apellido — Detecta automáticamente las tablas
usuarios/personajes(variantes ESX); recurre a export de modo suave si no hay sistema de identidad presente. - Configurable — Estaciones, lugares, animaciones, fuegos artificiales, enganches de ropa y precios están todos en la configuración.
- Herramientas de administración —
/marry:divorcey/marry:statuscon permiso ACEFiveMX_marry.admin. - Superficie del desarrollador — Exportaciones para el estado civil y búsqueda de pareja, además de eventos estables para integraciones (HUDs, marcadores, etc.).
Cómo funciona (Recorrido del jugador)
- Proponer cerca de una Estación de Matrimonio configurada o mediante
/marry(en la estación). - Aceptar/Rechazar — El receptor recibe un aviso localizado con detalles.
- Celebrar — Al aceptar, se procesa la tarifa, se crean entradas en la BD, se ejecuta la lógica del apellido y comienza la secuencia de la limusina + fuegos artificiales + cámara. El servidor limpia todo al final.
Compatibilidad y requisitos
- Marcos: ESX (
1.1,1.2,oldlegacy,legado) y QBCore (paridad mediante adaptador). - Base de datos:
oxmysql(migraciones incluidas). - Opcional:
cambiapieles/esx_skinoropa qbpara atuendos de boda.
¿Nuevo en QBCore? Consulta nuestro inicio rápido en Configuración de QBCore y Scripts.
Sigue los pasos »
Compatible con este vestido de novia:
https://fivemx.com/fivem-wedding-dress/
Instalación (5–10 minutos)
- Suelta la carpeta
FiveMX_marryen su servidorrecursos/. - Asegúrate de las dependencias (
es_extendidoonúcleo qb, y@oxmysql). - Inicia una vez; las migraciones crean tablas automáticamente
marriagesymarriage_audit. - Configurar
config.lua(ver abajo) y establece la cadena de versión ESX deseada. - Añadir a tu
servidor.cfgen el orden correcto:asegúrate de que oxmysql asegure es_extended # o: asegura qb-core asegura FiveMX_marry - Reinicia el servidor o el recurso a través de txAdmin.
Consejo: Después del lanzamiento, usa Resmon para vigilar el rendimiento mientras los jugadores prueban la ceremonia. Cómo usar Resmon »
Instantánea de configuración
A continuación se muestra un pequeño extracto para ilustrar el estilo (enviamos una configuración completa y documentada):
FiveMXCore = FiveMXCore or {}
FiveMXLocales = FiveMXLocales or {}
-- Marco y versión
FiveMXCore.ESXVersion = 'legacy' -- 1.1 | 1.2 | oldlegacy | legacy
-- Prefijo de evento interno (no cambiar en tiempo de ejecución)
FiveMXCore.InternalPrefix = 'FiveMX_marry:'
-- Precio y estaciones
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 }
}
-- Lugares
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 = { duration = 30, camera = { fov = 60 } , firework = { loop = 3 } }
}
}
Un validador incorporado verifica lugares, estaciones, fuegos artificiales y configuraciones del framework al inicio, registrando advertencias claras si algo está mal configurado.
Comandos de administrador y permisos
/marry— abre la propuesta UI (en una estación de matrimonio)./marry:status [id]— muestra el estado de matrimonio para ti o un objetivo./marry:divorce— cierra un registro de matrimonio activo; reversión opcional del apellido.
Permiso ACE: FiveMX_marry.admin
API de desarrollador (Exports)
Úsalos para integrar con HUDs, marcadores o historias personalizadas:
exports['FiveMX_marry']:IsMarried(identifier_or_source) -- booleano
exports['FiveMX_marry']:GetPartner(identifier) -- {identificador, apellido, casado_en} | nil
exports['FiveMX_marry']:GetMarriageRecord(identifier) -- tabla | nil
Eventos sigue el patrón FiveMX_marry:: y están protegidos por tokens de sesión y verificaciones de proximidad. Consulta el README para una lista completa.
Seguridad y juego limpio
- Dinero del lado del servidor manejo & escrituras en DB
- Tokens de sesión (rotados), tiempos de espera y límites de tasa
- Verificaciones de proximidad (estaciones y socios), sanitización de entrada
- Cubos de enrutamiento opcionales durante ceremonias
Preguntas frecuentes
¿Funciona tanto en ESX como en QBCore?
Sí: paridad total a través de un adaptador de framework compartido.
¿Cambiará los apellidos de los jugadores?
Si tu esquema de identidad ESX expone un apellido columna, podemos sincronizarla. De lo contrario, el apellido se almacena en nuestra propia tabla y se expone a través de exports (para HUD/scoreboards).
¿Qué pasa con el rendimiento?
La ceremonia utiliza entidades de corta duración y se limpia rigurosamente. Usa Resmon durante tus primeros eventos para confirmar el presupuesto en tu máquina.
¿Podemos agregar nuestros propios lugares y fuegos artificiales?
Absolutamente: todo está basado en configuración. Agrega nuevos MarryLocations con bloques de pre-anim y main-anim.
¿Cómo localizamos?
Colocar FiveMXCore.Locales y edita locales/en.lua o locales/de.lua.
Registro de cambios
v1.0.0 — Lanzamiento público inicial: propuestas, pipeline completo de ceremonia, integración de apellidos, locales EN/DE, exports, herramientas de administración, validador de configuración.
¿Necesitas ayuda para configurarlo o quieres un paquete de ceremonia personalizado? Contacta a través de Apoyo desde el pie de página del sitio.