0R - Marriage V2#
0r-marriagev2 is a FiveM marriage system. Players can propose with rings, book a wedding venue, run a synced ceremony, sign certificates, toss a bouquet, track their partner, claim marriage rewards, and divorce.
What This Resource Does#
0r-marriagev2 is ceremony-first.
That means:
- the couple starts with a ring proposal and engagement
- wedding halls, jewelry shops, and planner NPCs are placed from config
- the ceremony runs as a synced multiplayer flow for both spouses
- finished marriage state is stored in MySQL through
oxmysql
Current Runtime Model#
Important behavior in the current build:
- frameworks:
Qbox,QB-Core, andESX - inventory adapters:
ox_inventoryandqb-inventory - target adapters:
ox_targetandqb-target(or ox_lib drawtext) - streamed props live in a separate dependency:
0r-marriagev2-streams - ceremony music uses
xsound - editable runtime settings live in
config/config.lua
Read This In Order#
If you are installing the resource for the first time, read these pages in this order:
Start Here#
- Setup and Database
- Configuration
- Items and Inventory
- Framework Integrations
- Features and Flow
- Troubleshooting
What Is Included?#
- ring proposal and engagement
- jewelry shop with configurable ring catalog
- wedding planner booking / invitation system
- priest ceremony with dialog, certificate signing, and kiss emote
- ceremony control panel (music, confetti, fireworks, bouquet)
- wedding bouquet hold + throw + pickup
- partner tracker (blip / marker / NUI)
- marriage XP and level rewards
- divorce decree flow
- optional wife surname change
- certificate and ring replacement at the priest
Platform Notes#
Current docs support:
- Windows FiveM hosts
- Linux FiveM hosts
No PowerShell or Node host tooling is required for this resource. The shipped UI is already built under web/dist.
Quick Summary#
If you only want the shortest install path:
- copy
0r-marriagev2and0r-marriagev2-streamsintoresources - install
ox_lib,oxmysql, and your framework - install inventory + target resources you plan to use
- install
xsoundfor ceremony music - add inventory items from
INSTALL/items.md - copy item images from
INSTALL/ITEM-IMAGES - import SQL from
INSTALL/insert-me.sqlifAutoRunSQL = false - apply surname integration from
INSTALL/integrations.mdif needed - review
config/config.lua ensure 0r-marriagev2-streamsthenensure 0r-marriagev2- validate jewelry shop, proposal, booking, and ceremony in game