Trouwen (FiveM\/ESX\/QBCore) — Bruiloften met Limo, Vuurwerk & Gedeelde Achternamen
Breng onvergetelijke bruiloften naar jouw stad. Trouwen laat spelers een aanzoek doen, accepteren en vieren met een volledige ceremonie-pijplijn: limousinerit, filmische camera, gesynchroniseerd vuurwerk, optionele outfits—en een automatische gedeelde achternaam voor beide partners.
Waarom “Trouwen”?
Roleplay draait om betekenisvolle momenten. Met Trouwen, worden verlovingen en bruiloften serverbrede gebeurtenissen in plaats van eenvoudige chat-emotes. Alles wordt server-side georkestreerd voor eerlijkheid en immersie, met een schone NUI voor zowel aanzoeker als ontvanger.
- Immersieve Ceremonie: limousine spawnen + AI-chauffeur, route naar locatie, getimede animaties, vuurwerk en camerashots.
- Echte Identiteit: optionele achternaamupdate (detecteert automatisch ESX-identiteitsschema's) of zachte modus via exports.
- Naadloze Stroom: aanzoek → accepteren/weigeren → ceremonie → opruiming. Server houdt de waarheid (geld, DB, logs).
- Multi‑Framework: ESX 1.1/1.2/oldlegacy/legacy en QBCore via een gedeelde adapter.
- Standaard Beveiligd: sessietokens, snelheidslimieten, nabijheids- en cooldowncontroles, filter voor grof taalgebruik.
- Gelokaliseerd: EN/DE-locales uit de doos.
Nieuw met frameworks? Onze snelle Framework Handleiding (ESX vs QBCore vs QBOX) kan je helpen de juiste basis voor jouw stad te kiezen. Lees de gids »
Functiehoogtepunten
- Aanzoeksysteem — Nabijgelegen spelerskiezer, achternaaminvoer, locatiekiezer, optioneel bericht; ontvanger ziet een modale prompt om te accepteren of te weigeren.
- Ceremoniepijplijn — Optionele routeringsbuckets voor isolatie, AI‑gestuurde limo van pre‑anim start naar bestemming, gesynchroniseerd vuurwerk, mannelijke/vrouwelijke animaties en filmische camera.
- Achternaamupdate — Detecteert automatisch
users/characterstabellen (ESX varianten); valt terug op soft‑mode export als er geen identity-systeem aanwezig is. - Configuratiegestuurd — Stations, locaties, animaties, vuurwerk, kledinghaken en prijzen staan allemaal in de config.
- Admin Tools —
/marry:divorceEn/marry:statusmet ACE-toestemmingFiveMX_marry.admin. - Ontwikkelaarsoppervlak — Exports voor huwelijkse staat & partner opzoeken, plus stabiele events voor integraties (HUDs, scoreboards, etc.).
Hoe het werkt (spelersreis)
- Aanzoek bij een geconfigureerd Huwelijksstation of via
/marry(bij station). - Accepteren/Afwijzen — Ontvanger krijgt een gelokaliseerde prompt met details.
- Vieren — Bij acceptatie wordt de vergoeding verwerkt, DB-items worden aangemaakt, achternaamlogica wordt uitgevoerd, en de limo + vuurwerk + camera-sequentie begint. De server ruimt alles aan het einde op.
Compatibiliteit & Vereisten
- Frameworks: ESX (
1.1,1.2,oldlegacy,legacy) En QBCore (pariteit via adapter). - Database:
oxmysql(migraties inbegrepen). - Optioneel:
skinchanger/esx_skinofqb-clothingvoor trouwoutfits.
New to QBCore? See our quick starter on Instellen van QBCore Scripts.
Volg de stappen »
Compatibel met deze trouwjurk:
https://fivemx.com/fivem-wedding-dress
Installatie (5–10 minuten)
- Plaats de map
FiveMX_marryin de server’sresources/. - Ensure dependencies (
es_extendedofqb-core, en@oxmysql). - Start eenmalig; migraties maken automatisch tabellen aan
marriagesEnmarriage_audit. - Configureren
config.lua(zie hieronder) en stel de gewenste ESX-versietekenreeks in. - Toevoegen aan uw
server.cfgin de juiste volgorde:ensure oxmysql ensure es_extended # or: ensure qb-core ensure FiveMX_marry - Restart the server or the resource via txAdmin.
Tip: Gebruik na de livegang Resmon om de prestaties in de gaten te houden terwijl spelers de ceremonie testen. Hoe Resmon te gebruiken »
Configuratie Snapshot
Hieronder een klein fragment om de stijl te illustreren (we leveren een volledige, gedocumenteerde configuratie):
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 } }
}
}
Een ingebouwde validatie controleert locaties, stations, vuurwerk en framework-instellingen bij het opstarten, en logt duidelijke waarschuwingen als er iets verkeerd is geconfigureerd.
Admin Commands & Permissions
/marry— open de voorstel-UI (bij een Huwelijksstation)./marry:status [id]— toon huwelijksstatus voor jou of een doelwit./marry:divorce <id|identifier>— sluit een actief huwelijksrecord; optionele achternaam terugdraaien.
ACE Permissie: FiveMX_marry.admin
Ontwikkelaar API (Exports)
Use these to integrate with HUDs, scoreboards, or custom storylines:
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
Evenementen volg het patroon FiveMX_marry:<side>:<name> en worden beschermd door sessietokens en nabijheidscontroles. Zie de README voor een volledige lijst.
Beveiliging & Fair Play
- Server-zijdig geld in-game financiën beheert, & DB writes
- Sessietokens (geroteerd), cooldowns & snelheidslimieten
- Nabijheidscontroles (stations & partners), invoeropschoning
- Optionele routing buckets tijdens ceremonies
Veelgestelde vragen
Werkt het op zowel ESX als QBCore?
Ja—volledige pariteit via een gedeelde framework adapter.
Zal het de achternamen van spelers wijzigen?
Als uw ESX identiteitsschema een blootlegt lastname kolom, kunnen we deze synchroniseren. Anders wordt de achternaam opgeslagen in onze eigen tabel en beschikbaar gesteld via exports (voor HUDs/scoreboards).
Hoe zit het met de prestaties?
De ceremonie gebruikt kortlevende entiteiten en ruimt grondig op. Gebruik Resmon tijdens je eerste evenementen om het budget op je machine te bevestigen.
Kunnen we eigen locaties & vuurwerk toevoegen?
Absoluut - alles is configuratiegestuurd. Voeg nieuwe toe MarryLocations met pre‑anim en main‑anim blokken.
Hoe kunnen we lokaliseren?
Instellen FiveMXCore.Locales en bewerk locales/en.lua of locales/de.lua.
Changelog
v1.0.0 — Initiële publieke release: voorstellen, volledige ceremonie-pijplijn, achternaamintegratie, EN/DE-locales, exports, admin-tools, configuratievalidator.
Hulp nodig bij het instellen of wil je een aangepast ceremoniepakket? Neem contact op via Steun vanuit de websitevoettekst.
