Casar (FiveM/ESX/QBCore) — Casamentos com limusine, fogos de artifício e sobrenomes compartilhados

Traga casamentos inesquecíveis para sua cidade. Casar permite que os jogadores proponham, aceitem e comemorem com uma cerimônia completa: passeio de limusine, câmera cinematográfica, fogos de artifício sincronizados, trajes opcionais e um sobrenome compartilhado automático para ambos os parceiros.

Download

Por que “Casar”?

A dramatização é feita de momentos significativos. Com Casar, noivados e casamentos se tornam eventos em todo o servidor, em vez de simples emotes de bate-papo. Tudo é orquestrado no servidor para garantir imparcialidade e imersão, com uma NUI limpa tanto para quem propõe quanto para quem recebe.

Cerimônia Imersiva: gerar limusine + motorista de IA, rota para o local, animações cronometradas, fogos de artifício e tomadas de câmera.
Identidade Real: atualização opcional de sobrenome (detecta automaticamente esquemas de identidade ESX) ou modo suave por meio de exportações.
Fluxo sem atrito: propor → aceitar/recusar → cerimônia → limpeza. O servidor mantém a verdade (dinheiro, banco de dados, logs).
Multi-estrutura: ESX 1.1/1.2/oldlegacy/legacy e QBCore por meio de um adaptador compartilhado.
Seguro por padrão: tokens de sessão, limites de taxa, verificações de proximidade e tempo de espera, filtros de profanidade.
Localizado: Localidades EN/DE prontas para uso.
Totalmente Open Source

Novo em frameworks? Nossa rápida Guia de Estrutura (ESX vs QBCore vs QBOX) pode ajudar você a escolher a base certa para sua cidade. Leia o guia »

Destaques do recurso

Sistema de Propostas — Selecionador de jogador próximo, entrada de sobrenome, seletor de local, mensagem opcional; o receptor vê um prompt modal para aceitar ou recusar.
Pipeline de cerimônia — Baldes de roteamento opcionais para isolamento, limusine controlada por IA do início pré-animação até o destino, fogos de artifício sincronizados, animações masculinas/femininas e câmera cinematográfica.
Atualização de sobrenome — Detecta automaticamente Usuários/personagens tabelas (variantes do ESX); retorna para exportação em modo suave se nenhum sistema de identidade estiver presente.
Orientado por configuração — Estações, locais, animações, fogos de artifício, ganchos para roupas e preços estão todos configurados.
Ferramentas de administração — /casar:divórcio e /casar:status com permissão da ACE FiveMX_marry.admin.
Superfície do desenvolvedor — Exportações para estado civil e pesquisa de parceiros, além de eventos estáveis para integrações (HUDs, placares, etc.).

Como funciona (Jornada do jogador)

Propor perto de uma Estação Marry configurada ou via /casar (na estação).
Aceitar/Recusar — O destinatário recebe um prompt localizado com detalhes.
Comemorar — Após a aceitação, a taxa é processada, as entradas no banco de dados são criadas, a lógica do sobrenome é executada e a sequência limusine + fogos de artifício + câmera começa. O servidor limpa tudo no final.

Compatibilidade e Requisitos

Estruturas: ESX (1.1, 1.2, legado antigo, legado) e QBCore (paridade via adaptador).
Banco de dados: oxmysql (migrações incluídas).
Opcional: trocador de pele / pele_esx ou qb-roupas para roupas de casamento.

Novo no QBCore? Veja nosso guia rápido sobre Configurando scripts QBCore.
Siga os passos »

Compatível com este vestido de noiva:

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

Instalação (5–10 minutos)

Solte a pasta FiveMX_casar no seu servidor recursos/.
Garantir dependências (es_extendido ou qb-núcleo, e @oxmysql).
Comece uma vez; as migrações criam tabelas automaticamente casamentos e auditoria_de_casamento.
Configurar configuração.lua (veja abaixo) e defina a string da versão ESX desejada.
Adicionar ao seu servidor.cfg na ordem correta: garantir oxmysql garantir es_extended # ou: garantir qb-core garantir FiveMX_marry
Reinicie o servidor ou o recurso via txAdmin.

Dica: Após a ativação, use Resmon para ficar de olho no desempenho enquanto os jogadores testam a cerimônia. Como usar o Resmon »

Instantâneo de configuração

Abaixo está um pequeno trecho para ilustrar o estilo (enviamos uma configuração completa e documentada):

FiveMXCore = FiveMXCore ou {} FiveMXLocales = FiveMXLocales ou {} -- Framework e versão FiveMXCore.ESXVersion = 'legacy' -- 1.1 | 1.2 | oldlegacy | legado -- Prefixo de evento interno (não alterar em tempo de execução) FiveMXCore.InternalPrefix = 'FiveMX_marry:' -- Preço e estações 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 } } -- Locais 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 = { duração = 30, câmera = { fov = 60 } , fogo de artifício = { loop = 3 } } } }

Um validador integrado verifica locais, estações, fogos de artifício e configurações de estrutura na inicialização, registrando avisos claros se algo estiver mal configurado.

Comandos e permissões de administrador

/casar — abra a interface de proposta (em uma Estação Marry).
/casar:status [id] — imprima o estado civil de você ou de um alvo.
/casar:divórcio — fechar um registro de casamento ativo; reversão de sobrenome opcional.

Permissão ACE: FiveMX_marry.admin

API do desenvolvedor (exportações)

Use-os para integrar com HUDs, placares ou histórias personalizadas:

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

Eventos siga o padrão FiveMX_casar: : e são protegidos por tokens de sessão e verificações de proximidade. Consulte o README para obter uma lista completa.

Segurança e Jogo Limpo

dinheiro do lado do servidor manuseio E DB escreve
Tokens de sessão (rotacionados), tempos de espera e limites de taxa
Verificações de proximidade (estações e parceiros), higienização de entradas
Baldes de roteamento opcionais durante cerimônias

Perguntas frequentes

Funciona tanto no ESX quanto no QBCore?
Sim, paridade total através de uma rede compartilhada adaptador de estrutura.

Isso mudará os sobrenomes dos jogadores?
Se o seu esquema de identidade ESX expõe um sobrenome coluna, podemos sincronizá-la. Caso contrário, o sobrenome é armazenado em nossa própria tabela e exposto por meio de exportações (por HUDs/placares).

E quanto ao desempenho?
A cerimônia utiliza entidades de curta duração e realiza uma limpeza rigorosa. Resmon durante seus primeiros eventos para confirmar o orçamento da sua máquina.

Podemos adicionar nossos próprios locais e fogos de artifício?
Com certeza, tudo é controlado pela configuração. Adicione novos CasarLocais com blocos pré-anim e principal-anim.

Como localizamos?
Definir FiveMXCore.Localidades e editar locais/en.lua ou locais/de.lua.

Registro de alterações

v1.0.0 — Lançamento público inicial: propostas, pipeline de cerimônia completo, integração de sobrenomes, localidades EN/DE, exportações, ferramentas de administração, validador de configuração.

Download

Precisa de ajuda para montar ou quer um pacote de cerimônia personalizado? Entre em contato pelo Apoiar do rodapé do site.