Ox Core
Um framework moderno para FiveM, projetado para oferecer suporte adequado a recursos como OneSync, statebags e entidades no lado do servidor.
Receita txAdmin
Se você está procurando instalar e configurar rapidamente o ox_core, tente usar nossa receita (opens in a new tab).
Instalação
Recomendamos fortemente consultar os Guias para configurar as ferramentas de desenvolvimento necessárias.
Instale todas as dependências do recurso.
Baixe a última versão (opens in a new tab) ou compile o código-fonte.
- Configure Git, Node.js, e pnpm.
- Baixe e configure MariaDB 11.4+ (opens in a new tab).
- Execute os seguintes comandos no seu CLI (ex.: Terminal, Prompt de Comando).
git clone https://github.com/overextended/ox_core.git
cd ox_core
pnpm i
pnpm build
Instale dependências opcionais.
Esses recursos não são estritamente necessários, mas são fortemente recomendados.
Usando ox_core nos seus recursos
Lua
Você pode importar as definições do ox_core carregando @ox_core/lib/init.lua
no seu recurso.
Isto pode ser um client_script
ou server_script
, se preferir.
shared_script '@ox_core/lib/init.lua'
JavaScript
Para usar o ox_core com seus recursos JavaScript, você precisará do nosso pacote npm, que fornece suporte completo para TypeScript e Intellisense.
Para começar, experimente nosso fivem-typescript-boilerplate (opens in a new tab) e instale o pacote ox_core.
pnpm i @overextended/ox_core
Configuração
A configuração do recurso é gerenciada usando convars (opens in a new tab).
Replicados
Esses convars devem usar o comando setr
para serem lidos pelos clientes.
ox:debug
- Padrão:
false
- Ativa mensagens e comandos de depuração. Habilitado por padrão ao usar
pnpm watch
.
- Padrão:
ox:characterSlots
- Padrão:
1
- Define o número de slots de personagem disponíveis para recursos de seleção de personagens (ex.: ox_charselect).
- Padrão:
ox:plateFormat
- Padrão:
"........"
- Consulte SET_DEFAULT_VEHICLE_NUMBER_PLATE_TEXT_PATTERN (opens in a new tab).
- Padrão:
ox:deathSystem
- Padrão:
true
- Ativa o sistema de morte e respawn integrado.
- Padrão:
ox:characterSelect
- Padrão:
true
- Ativa o registro de personagem integrado e utiliza esse personagem ao entrar.
- Padrão:
ox:spawnLocation
- Padrão:
[-258.211, -293.077, 21.6132, 206.0]
- Define o local de spawn padrão para personagens recém-criados.
- Padrão: