Skip to content

0R - Marriage V2

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, and ESX
  • inventory adapters: ox_inventory and qb-inventory
  • target adapters: ox_target and qb-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:

  1. copy 0r-marriagev2 and 0r-marriagev2-streams into resources
  2. install ox_lib, oxmysql, and your framework
  3. install inventory + target resources you plan to use
  4. install xsound for ceremony music
  5. add inventory items from INSTALL/items.md
  6. copy item images from INSTALL/ITEM-IMAGES
  7. import SQL from INSTALL/insert-me.sql if AutoRunSQL = false
  8. apply surname integration from INSTALL/integrations.md if needed
  9. review config/config.lua
  10. ensure 0r-marriagev2-streams then ensure 0r-marriagev2
  11. validate jewelry shop, proposal, booking, and ceremony in game