FiveM Marriage Mod - Weddings & Romance Script

Marry (FiveM\/ESX\/QBCore) — Śluby z limuzyną, fajerwerkami & wspólnymi nazwiskami

Przynieś niezapomniane wesela do swojego miasta. Marry pozwala graczom składać oświadczyny, akceptować i świętować z pełnym procesem ceremonii: przejażdżka limuzyną, kinowa kamera, zsynchronizowane fajerwerki, opcjonalne stroje – oraz automatyczne wspólne nazwisko dla obojga partnerów.

Pobierz

Dlaczego “Marry”?

Roleplay skupia się na znaczących momentach. Z Marry, zaręczyny i wesela stają się wydarzeniami ogólnoserwerowymi, a nie prostymi emotkami na czacie. Wszystko jest koordynowane po stronie serwera dla uczciwości i immersji, z czystym NUI dla osoby składającej oświadczyny i odbierającej.

Immersyjna ceremonia: spawn limuzyny + AI kierowca, trasa do miejsca, animacje czasowe, fajerwerki i ujęcia kamery.
Prawdziwa Tożsamość: opcjonalna aktualizacja nazwiska (automatycznie wykrywa schematy tożsamości ESX) lub tryb miękki przez eksporty.
Bezproblemowy Przepływ: oświadczyny → akceptacja/odrzucenie → ceremonia → sprzątanie. Serwer przechowuje prawdę (pieniądze, DB, logi).
Multi‑Framework: ESX 1.1/1.2/oldlegacy/legacy oraz QBCore przez wspólny adapter.
Bezpieczne domyślnie: tokeny sesji, limity szybkości, sprawdzanie bliskości i czasu odnowienia, filtry wulgaryzmów.
Zlokalizowane: lokalizacje EN/DE od razu dostępne.

Nowy w frameworkach? Nasz szybki Przewodnik po Frameworkach (ESX vs QBCore vs QBOX) może pomóc Ci wybrać odpowiednią bazę dla Twojego miasta. Przeczytaj przewodnik »

Najważniejsze funkcje

System Oświadczyn — Wybór pobliskiego gracza, wpis nazwiska, wybór miejsca, opcjonalna wiadomość; odbiorca widzi monit modalny do akceptacji lub odrzucenia.
Proces Ceremonii — Opcjonalne kubły routingu dla izolacji, limuzyna sterowana przez AI od startu przed animacją do celu, zsynchronizowane fajerwerki, animacje męskie/żeńskie i kinowa kamera.
Aktualizacja nazwiska — Automatycznie wykrywa users/characters tabele (warianty ESX); wraca do eksportu w trybie miękkim, jeśli nie ma systemu tożsamości.
Sterowany konfiguracją — Stacje, miejsca, animacje, fajerwerki, zaczepy ubrań i ceny są w konfiguracji.
Admin Tools — /marry:divorce I /marry:status z uprawnieniem ACE FiveMX_marry.admin.
Powierzchnia deweloperska — Eksport dla statusu małżeńskiego i wyszukiwania partnera, plus stabilne zdarzenia dla integracji (HUDs, tablice wyników itp.).

Jak to działa (ścieżka gracza)

Złóż oświadczyny w pobliżu skonfigurowanej stacji ślubnej lub przez /marry (na stacji).
Akceptuj/Odrzuć — Odbiorca otrzymuje zlokalizowany monit ze szczegółami.
Świętuj — Po akceptacji opłata jest przetwarzana, tworzone są wpisy w bazie danych, uruchamiana jest logika nazwisk, a sekwencja limuzyny + fajerwerków + kamery jest uruchamiana. Serwer czyści wszystko na końcu.

Zgodność i wymagania

Frameworki: ESX (1.1, 1.2, oldlegacy, legacy) I QBCore (parzystość przez adapter).
Baza danych: oxmysql (migracje w cenie).
Opcjonalne: skinchanger / esx_skin Lub qb-clothing na stroje ślubne.

Nowość w QBCore? Zobacz nasz szybki przewodnik po Konfigurowanie QBCore Scripts.
Postępuj zgodnie z krokami »

Kompatybilna z tą suknią ślubną:

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

Instalacja (5–10 minut)

Upuść folder FiveMX_marry na serwer resources/.
Zapewnij zależności (es_extended Lub qb-core, oraz @oxmysql).
Uruchom raz; migracje automatycznie tworzą tabele marriages I marriage_audit.
Skonfiguruj config.lua (patrz poniżej) i ustaw pożądaną wersję ESX.
Dodaj do swojego server.cfg w odpowiedniej kolejności: ensure oxmysql ensure es_extended # or: ensure qb-core ensure FiveMX_marry
Uruchom ponownie serwer lub zasób za pomocą txAdmin.

Wskazówka: Po uruchomieniu, użyj Resmon aby monitorować wydajność podczas testowania ceremonii przez graczy. Jak używać Resmon »

Zrzut konfiguracji

Poniżej znajduje się niewielki fragment ilustrujący styl (wysyłamy pełną, udokumentowaną konfigurację):

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

Wbudowany walidator sprawdza obiekty, stacje, fajerwerki i ustawienia frameworka podczas uruchamiania, rejestrując jasne ostrzeżenia, jeśli coś jest nieprawidłowo skonfigurowane.

Polecenia administratora i uprawnienia

/marry — otwórz propozycję UI (na Stacji Ślubnej).
/marry:status [id] — wyświetla status małżeństwa dla ciebie lub celu.
/marry:divorce <id|identifier> — zamknij aktywny wpis o małżeństwie; opcjonalny powrót nazwiska.

Uprawnienie ACE: FiveMX_marry.admin

Deweloper API (Eksporty)

Użyj ich do integracji z HUDs, tablicami wyników lub niestandardowymi fabułami:

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

Wydarzenia postępuj zgodnie ze wzorem FiveMX_marry:<side>:<name> i są chronione przez tokeny sesji i kontrole bliskości. Pełną listę znajdziesz w pliku README.

Bezpieczeństwo i Fair Play

Pieniądze po stronie serwera obsługa i zapisy do bazy danych
Tokeny sesji (rotowane), czasy odnowienia i limity żądań
Sprawdzanie bliskości (stacje i partnerzy), czyszczenie danych wejściowych
Opcjonalne wiadra routingu podczas ceremonii

FAQ

Czy działa na ESX i QBCore?
Tak — pełna zgodność dzięki współdzielonej adapter frameworka.

Czy zmieni to nazwiska graczy?
Jeśli Twój schemat tożsamości ESX udostępnia lastname kolumnie, możemy ją zsynchronizować. W przeciwnym razie nazwisko jest przechowywane w naszej własnej tabeli i udostępniane poprzez eksporty (dla HUDs/scoreboards).

A co z wydajnością?
Ceremonia wykorzystuje krótkotrwałe encje i rygorystycznie sprząta. Użyj Resmon podczas Twoich pierwszych wydarzeń, aby potwierdzić budżet na Twojej maszynie.

Czy możemy dodać własne obiekty i fajerwerki?
Absolutnie – wszystko jest sterowane konfiguracją. Dodaj nowe MarryLocations z blokami pre‑anim i main‑anim.

Jak lokalizujemy?
Ustaw FiveMXCore.Locales i edytuj locales/en.lua Lub locales/de.lua.

Dziennik zmian

v1.0.0 — Początkowe publiczne wydanie: propozycje, pełny potok ceremonii, integracja nazwisk, lokalizacje EN/DE, eksporty, narzędzia administracyjne, walidator konfiguracji.

Pobierz

Potrzebujesz pomocy w konfiguracji lub chcesz niestandardowy pakiet ceremonii? Skontaktuj się przez Wsparcie z stopki strony.