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.

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.
  • 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).
  • ox:plateFormat
  • ox:deathSystem
    • Padrão: true
    • Ativa o sistema de morte e respawn integrado.
  • ox:characterSelect
    • Padrão: true
    • Ativa o registro de personagem integrado e utiliza esse personagem ao entrar.
  • ox:spawnLocation
    • Padrão: [-258.211, -293.077, 21.6132, 206.0]
    • Define o local de spawn padrão para personagens recém-criados.