FiveM Marriage Mod - Weddings & Romance Script

Sposarsi (FiveM\/ESX\/QBCore) — Matrimoni con Limousine, Fuochi d'artificio e Cognomi Condivisi

Porta matrimoni indimenticabili nella tua città. Marry consente ai giocatori di proporre, accettare e festeggiare con un'intera pipeline di cerimonia: giro in limousine, telecamera cinematografica, fuochi d'artificio sincronizzati, outfit opzionali e un cognome condiviso automatico per entrambi i partner.

Scaricamento

Perché “Marry”?

Roleplay è tutto incentrato su momenti significativi. Con Marry, fidanzamenti e matrimoni diventano eventi a livello di server anziché semplici emoticon di chat. Tutto è orchestrato lato server per equità e immersione, con un NUI pulito sia per il richiedente che per il ricevente.

Cerimonia Immersiva: spawn limo + pilota AI, percorso verso la location, animazioni temporizzate, fuochi d'artificio e riprese della telecamera.
Identità reale: aggiornamento opzionale del cognome (rileva automaticamente gli schemi di identità ESX) o modalità soft tramite esportazioni.
Flusso senza intoppi: proposta → accetta\/rifiuta → cerimonia → pulizia. Il server mantiene la verità (soldi, DB, log).
Multi‑Framework: ESX 1.1\/1.2\/oldlegacy\/legacy e QBCore tramite un adattatore condiviso.
Sicuro per impostazione predefinita: token di sessione, limiti di frequenza, controlli di prossimità e raffreddamento, filtri per parolacce.
Localizzato: localizzazioni EN\/DE pronte all'uso.

Nuovo nei framework? Il nostro rapido Guida ai Framework (ESX vs QBCore vs QBOX) può aiutarti a scegliere la base giusta per la tua città. Leggi la guida »

Caratteristiche principali

Sistema di proposta — Selettore giocatore vicino, inserimento cognome, selettore location, messaggio opzionale; il ricevente vede un prompt modale per accettare o rifiutare.
Pipeline della cerimonia — Bucket di routing opzionali per isolamento, limousine guidata dall'IA dall'inizio dell'animazione pre‑definita fino a destinazione, fuochi d'artificio sincronizzati, animazioni maschili\/femminili e telecamera cinematografica.
Aggiornamento Cognome — Rileva automaticamente users/characters tabelle (varianti ESX); ricade all'esportazione in modalità soft se non è presente alcun sistema di identità.
Basato sulla Configurazione — Stazioni, luoghi, animazioni, fuochi d'artificio, hook per abbigliamento e prezzi sono tutti nella configurazione.
Strumenti di amministrazione — /marry:divorce E /marry:status con permesso ACE FiveMX_marry.admin.
Superficie per Sviluppatori — Esportazioni per stato civile e ricerca partner, oltre a eventi stabili per integrazioni (HUDs, classifiche, ecc.).

Come Funziona (Percorso del Giocatore)

Proponi vicino a una Stazione Matrimoniale configurata o tramite /marry (alla stazione).
Accetta\/Rifiuta — Il ricevente riceve un messaggio localizzato con i dettagli.
Celebra — All'accettazione, la tariffa viene elaborata, vengono create le voci nel database, viene eseguita la logica del cognome e la sequenza limousine + fuochi d'artificio + telecamera si avvia. Il server pulisce tutto alla fine.

Compatibilità e requisiti

Quadri: ESX (1.1, 1.2, oldlegacy, legacy) E QBCore (parità tramite adattatore).
Banca dati: oxmysql (migrazioni incluse).
Opzionale: skinchanger / esx_skin O qb-clothing per abiti da sposa.

Nuovo su QBCore? Vedi il nostro avvio rapido su Configurazione di QBCore Scripts.
Segui i passaggi »

Compatibile con questo abito da sposa:

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

Installazione (5–10 minuti)

Trascina la cartella FiveMX_marry nel tuo server resources/.
Assicurati delle dipendenze (es_extended O qb-core, E @oxmysql).
Avvia una volta; le migrazioni creano automaticamente le tabelle marriages E marriage_audit.
Configurare config.lua (vedi sotto) e imposta la versione ESX desiderata.
Aggiungi al tuo server.cfg nell'ordine corretto: ensure oxmysql ensure es_extended # or: ensure qb-core ensure FiveMX_marry
Riavvia il server o la risorsa tramite txAdmin.

Suggerimento: dopo il go-live, usa Resmon per tenere d'occhio le prestazioni mentre i giocatori testano la cerimonia. Come usare Resmon »

Snapshot della configurazione

Di seguito un piccolo estratto per illustrare lo stile (inviamo una configurazione completa e documentata):

FiveMXCore = FiveMXCore or {}
FiveMXLocales = FiveMXLocales or {}

-- Framework & version
FiveMXCore.ESXVersion = 'legacy' -- 1.1 | 1.2 | oldlegacy | legacy

-- Internal event prefix (do not change at runtime)
FiveMXCore.InternalPrefix = 'FiveMX_marry:'

-- Price & 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 }
}

-- Venues
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 validatore integrato controlla luoghi, stazioni, fuochi d'artificio e impostazioni del framework all'avvio, registrando avvisi chiari se qualcosa è configurato in modo errato.

Comandi e permessi amministratore

/marry — apri l'interfaccia di proposta (presso una Stazione Matrimoniale).
/marry:status [id] — stampa lo stato del matrimonio per te o per un bersaglio.
/marry:divorce <id|identifier> — chiudi un matrimonio attivo; ripristino facoltativo del cognome.

Permesso ACE: FiveMX_marry.admin

Sviluppatore API (Esportazioni)

Usali per integrarti con HUDs, tabelloni segnapunti o trame personalizzate:

exports['FiveMX_marry']:IsMarried(identifier_or_source) -- boolean
exports['FiveMX_marry']:GetPartner(identifier)          -- {identifier, surname, married_at} | nil
exports['FiveMX_marry']:GetMarriageRecord(identifier)   -- table | nil

Eventi segui il modello FiveMX_marry:<side>:<name> e sono protetti da token di sessione e controlli di prossimità. Consulta il README per un elenco completo.

Sicurezza e Fair Play

Denaro lato server gestione e scritture DB
Token di sessione (ruotati), cooldown e limiti di frequenza
Controlli di prossimità (stazioni e partner), sanificazione input
Bucket di routing opzionali durante le cerimonie

Domande frequenti

Funziona sia su ESX che su QBCore?
Sì—piena parità tramite una condivisione adattatore framework.

Cambierà i cognomi dei giocatori?
Se lo schema di identità ESX espone un lastname colonna, possiamo sincronizzarlo. Altrimenti, il cognome è memorizzato nella nostra tabella ed esposto tramite export (per HUD/scoreboards).

E le prestazioni?
La cerimonia utilizza entità di breve durata e si pulisce rigorosamente. Usa Resmon durante i tuoi primi eventi per confermare il budget sulla tua macchina.

Possiamo aggiungere i nostri luoghi e fuochi d'artificio?
Assolutamente—tutto è configurabile. Aggiungi nuovo MarryLocations con blocchi pre-anim e main-anim.

Come localizziamo?
Impostato FiveMXCore.Locales e modifica locales/en.lua O locales/de.lua.

Registro delle modifiche

v1.0.0 — Rilascio pubblico iniziale: proposte, pipeline cerimonia completa, integrazione cognome, localizzazioni EN/DE, export, strumenti admin, validatore configurazione.

Scaricamento

Hai bisogno di aiuto per configurarlo o desideri un pacchetto cerimonia personalizzato? Contattaci tramite Supporto dal piè di pagina del sito.