- Um recurso, o fluxo inteiroTela de carregamento, menu principal, seleção de personagem, spawn e veículo inicial em um único recurso.
- Spawn onde faz sentidoÚltima localização, pontos de spawn padrão, apartamentos ou casas, escolhidos em um seletor de spawn.
- Painel de administraçãoLibere slots, desative ou reative personagens e aplique CK com backups automáticos.
- Configuração autodetectadaO framework e o sistema de aparência são detectados na inicialização, sem nenhuma opção de framework para alterar.
Um script multipersonagem FiveM com tela de carregamento e menu principal
O Rarx Multicharacter (nome do recurso: rarx_multicharacter) cobre tudo desde o momento em que o jogador se conecta até estar no mundo: uma tela de carregamento personalizada, um menu principal com a identidade visual do seu servidor, o seletor de personagens, um seletor de spawn e um veículo inicial para personagens novos.
O framework é detectado na inicialização na ordem qbx_core, qb-core, es_extended. O sistema de aparência é detectado da mesma forma, então o seletor mostra cada personagem com o recurso de roupas que o seu servidor já usa.
Criação e seleção de personagens com slots configuráveis
- Crie, selecione e, se você permitir, exclua personagens.
- Tanto o total de slots exibidos quanto os slots desbloqueados por padrão são configuráveis, e a staff pode liberar mais para cada jogador.
- Filtro de palavras proibidas nos nomes, limites de ano de nascimento e lista de nacionalidades configurável.
- Os cartões de personagem mostram os campos que você escolher: nome, emprego, dinheiro, banco, celular, nacionalidade ou data de nascimento.
- Cores primária e secundária personalizadas e o seu próprio logo.
Seletor de spawn e veículo inicial para personagens novos
Depois de escolher o personagem, os jogadores escolhem onde aparecer: na última localização, em um dos seus pontos de spawn padrão, ou em um apartamento ou casa pelos recursos de moradia compatíveis. Um routing bucket aleatório evita que os jogadores se sobreponham enquanto escolhem.
Personagens novos podem receber um veículo inicial em uma tela de seleção com a sua lista de modelos, ou um aleatório dessa lista sem interface. O veículo é enviado para a garagem que você configurar.
Painel de administração para slots, status de personagens e CK
A staff abre o painel de administração com /multicharadmin para liberar ou remover slots, desativar ou reativar personagens informando um motivo obrigatório e aplicar CK que criam antes um backup automático. Cada ação de administração pode ser enviada para logs de webhook separados.
O acesso é concedido por permissões ACE ou por uma lista de identificadores de administrador, e as duas formas funcionam em paralelo. No ESX, use a lista de identificadores ou um ACE que você realmente conceda, já que o ACE padrão é do QBCore.
Tudo incluído
Funções
Jogadores
- Criação, seleção e exclusão opcional de personagens
- Limites de slots configuráveis
- Filtro de nomes, limites de ano de nascimento e lista de nacionalidades
- Cartões de informação do personagem personalizáveis
- Seletor de spawn com última localização e spawns padrão
- Seletor de veículo inicial ou modo aleatório
Tela de carregamento e menu
- Fundos de vídeo, imagem ou link de vídeo
- Música de fundo e dicas rotativas
- Logo, nome, slogan e cores do servidor
- Seções de regras, controles e conteúdo próprio
- Barra de estatísticas ao vivo: jogadores, tempo online, staff
- Transmissão incorporada no menu principal
Staff
- Painel de administração com gestão de slots
- Desativar e reativar personagens com motivo
- CK com backup automático no banco de dados
- Logs de webhook por tipo de ação
- Permissões por ACE e por identificador
- Traduções em inglês e espanhol, com arquivos de idioma abertos
Comandos
| Comando | O que faz | Acesso |
|---|---|---|
/logout | Volta para a seleção de personagem (se Config.logoutCmd estiver ativado) | — |
/relog | Volta para a seleção de personagem (somente Qbox) | — |
/multicharadmin | Abre o painel de administração | Permissão ACE ou identificadores de administrador |
/setslots [identifier] [amount] | Define os slots de personagem desbloqueados de um jogador | Admin |
/removeslots [identifier] | Restaura os slots de um jogador para o valor padrão | Admin |
/disablecharacter | Desativa um personagem ([citizenid] no QBCore/Qbox, [identifier] [slot] no ESX) | Admin |
/enablecharacter | Reativa um personagem ([citizenid] no QBCore/Qbox, [identifier] [slot] no ESX) | Admin |
Antes de instalar
Compatibilidade
Frameworks
- Qbox
qbx_core- QBCore
qb-core- ESX
es_extended
Detectado automaticamente na inicialização na ordem qbx_core, qb-core, es_extended.
Recursos e banco de dados
Obrigatórios: ox_lib, oxmysql, rarx_lib (included), An appearance resource
Opcionais: rarx_clothing (recomendado), illenium-appearance, fivem-appearance, bl_appearance, origen_clothing ou qb-clothing, rarx_apartments, qb-apartments, 0r_motels ou origen_housing para o seletor de spawn
Banco de dados: Importe install/general.sql e o arquivo do seu framework (esx.sql, qb.sql ou qbox.sql). Todas as tabelas usam IF NOT EXISTS.
Integrações e idiomas
- Qbox: defina useExternalCharacters = true em qbx_core/config/client.lua.
- ESX Legacy: são necessários dois pequenos patches no es_extended, e é preciso remover esx_multicharacter, esx_skin e skinchanger.
- QBCore com qb-apartments: adicione o export GetApartmentsConfig. qb-apartments e rarx_apartments não podem ser usados juntos.
- Os logs de webhook de administração usam URLs de webhook compatíveis com o Discord.
- O idioma é definido pela convar rarx-lang.
- Inglês
- Espanhol
Primeiros passos
Instalação
- 01
Baixe e extraia
Baixe o recurso no seu Cfx.re Portal e extraia rarx_multicharacter e rarx_lib na sua pasta de recursos.
- 02
Importe o banco de dados
Execute install/general.sql e depois o arquivo do seu framework: esx.sql, qb.sql ou qbox.sql.
- 03
Inicie na ordem certa
Primeiro oxmysql, ox_lib e rarx_lib, depois o seu framework e o seu recurso de aparência, e por último o multipersonagem.
ensure oxmysql ensure ox_lib ensure rarx_lib ensure es_extended # or qb-core / qbx_core ensure illenium-appearance # or your appearance resource ensure rarx_multicharacter - 04
Aplique o passo do seu framework
Qbox: ative useExternalCharacters. ESX: aplique os patches do es_extended da documentação e remova os recursos que ele substitui.
- 05
Configure e reinicie
Edite config.lua (e ui/loadingConfig.js para a tela de carregamento) e depois reinicie o servidor por completo.
Este é um resumo. A configuração, os exports, os events e a solução de problemas estão na documentação completa (em inglês).
Bom saber
Perguntas sobre Rarx Multicharacter
Não encontrou o que procura? Abra um ticket no nosso Discord com seu framework e o erro que aparece.
Pedir suporteMais sobre scripts de multipersonagem para FiveM →Quais frameworks o Rarx Multicharacter suporta?
Qbox, QBCore e ESX. O framework é detectado automaticamente na inicialização na ordem qbx_core, qb-core, es_extended.
O que preciso ter instalado?
ox_lib, oxmysql, rarx_lib (incluído) e um recurso de aparência como rarx_clothing, illenium-appearance, fivem-appearance ou bl_appearance.
No ESX a tela de carregamento termina, mas o seletor nunca aparece. Por quê?
O es_extended ainda está no modo de um só personagem. Aplique os dois patches do es_extended da documentação (Config.Multichar = true e desativar sempre o spawn manager) e reinicie o servidor por completo.
Os personagens não funcionam no Qbox. O que devo verificar?
Defina useExternalCharacters = true em qbx_core/config/client.lua para que o Rarx Multicharacter assuma a seleção de personagem.
Por que a tela de carregamento mostra o logo errado?
A tela de carregamento roda antes de os scripts Lua serem carregados, então ela lê ui/loadingConfig.js em vez de config.lua. Coloque os mesmos valores nos dois arquivos e reinicie o servidor.
Posso usar a minha própria tela de carregamento?
Sim. Defina Config.Loading.enabled = false e comente as linhas de loadscreen no fxmanifest.lua.
Quem pode abrir o painel de administração?
Qualquer pessoa que tenha a permissão ACE ou esteja em Config.AdminSystem.adminIdentifiers. No ESX, use a lista de identificadores ou um ACE que você conceda, como group.admin.
Continue explorando
