Como usar o Azuriom no lugar de um site Tebex para FiveM

Você pode usar o Azuriom para montar o site da sua comunidade FiveM e fazer dele o destino que os jogadores visitam, no lugar de uma loja Tebex standalone. Use-o para a página inicial, as regras e as informações da comunidade; conecte o seu servidor de jogo pelo AzLink. Para os pacotes pagos do servidor, mantenha o Tebex no fluxo de pagamento: a documentação atual da Cfx.re identifica o Tebex como o provedor exclusivo de monetização e proíbe outras plataformas de pagamento para essa finalidade. Leia os requisitos de monetização da Cfx.re antes de configurar vendas.

Este tutorial cobre a instalação do site, o recurso oficial AzLink-FiveM e uma checklist prática de lançamento. Ele se baseia em uma revisão da documentação e do código-fonte em 9 de novembro de 2026; não afirma ter feito um teste completo com FXServer ou pagamentos. O Azuriom lista o FiveM como jogo suportado na sua documentação. O código da bridge revisado aqui é o commit d2c76cbdf4f7561bf7943aed8524bbce67a9ebc2 do repositório oficial; a última release publicada na data da revisão é a v0.1.1.

Escolha o que você quer que o Azuriom substitua

O site de uma comunidade e um serviço de pagamento resolvem problemas diferentes. O arranjo inicial mais útil é um site Azuriom hospedado por você, com um link visível de Loja na navegação apontando para a sua loja Tebex existente. Isso mantém a edição do site separada do checkout e da entrega dos pacotes. Você pode lançar o site antes de tentar qualquer integração de comércio mais profunda.

O AzLink é uma conexão separada entre o Azuriom e o FXServer. Ele troca informações do servidor e pode executar os comandos retornados pelo site. Instalá-lo não conecta automaticamente as suas compras do Tebex, não importa assinaturas e não transfere registros de clientes. O repositório oficial AzLink-FiveM documenta o recurso; nossa comparação entre Azuriom e Tebex cobre as diferenças mais amplas de software e de comércio.

Deixe o checkout direto por Stripe ou PayPal fora desta configuração de monetização de servidor FiveM. Um plugin de pagamento disponível não comprova que você tem permissão para usar essa via de pagamento no seu servidor.

1. Prepare a hospedagem e preserve a configuração que funciona

Você precisa de uma conta de hospedagem web ou de uma VPS para o Azuriom, um domínio com HTTPS, acesso ao banco de dados e permissão para gerenciar os recursos e o console do seu FXServer. O Azuriom é uma aplicação PHP; colocar os arquivos dele na pasta de recursos do FiveM não cria um site.

Na data da revisão, os requisitos oficiais de instalação especificam PHP 8.2 ou superior, as extensões PHP listadas e suporte a symlinks. MySQL/MariaDB ou PostgreSQL é recomendado. Peça à hospedagem que confira todos os requisitos, em vez de confiar em um plano descrito apenas como “hospedagem PHP”.

Antes de mudar qualquer coisa, salve uma cópia do server.cfg, de qualquer pasta AzLink existente e da configuração atual do site. Se for substituir um CMS existente, faça backup dos arquivos e do banco de dados dele. Comece em um hostname separado para que o site e a loja atuais continuem disponíveis durante a aceitação. Anote como restaurar o DNS e a configuração anterior do servidor web.

Ponto de verificação: o hostname escolhido carrega por HTTPS e você consegue acessar o painel de hospedagem, o banco de dados e o console do FXServer. Mantenha senhas de banco de dados e chaves da bridge fora de capturas de tela e de posts públicos de suporte.

2. Instale o site Azuriom

Baixe o pacote de instalação no site oficial do Azuriom. Envie e extraia o pacote no local do site configurado pela sua hospedagem, incluindo os arquivos ocultos. Siga as instruções do servidor web do projeto original; no Nginx, o document root documentado da aplicação termina em /public.

Abra o site no navegador, conclua o instalador, informe a conexão com o banco de dados e crie o primeiro administrador. Selecione a opção de identidade do FiveM adequada à sua comunidade. A bridge distingue identidades baseadas em Steam e em Cfx, então mantenha a escolha do site coerente com as contas dos seus jogadores. Não presuma que o nome de exibição do Discord é o identificador do jogo.

Use o guia de instalação para as tarefas agendadas quando os recursos ativados exigirem. Mantenha a saída de debug desativada em produção, restrinja o acesso aos arquivos conforme o modelo de implantação da sua hospedagem e verifique se os arquivos de configuração privados não podem ser baixados.

Ponto de verificação: entre como administrador, salve uma pequena alteração de conteúdo e depois veja-a sem estar logado. Confirme que uma conta comum não consegue abrir as páginas de administração. A página inicial carregar com sucesso é só a primeira dessas verificações.

3. Deixe o site útil antes de conectar o comércio

Crie as páginas de que os jogadores precisam: apresentação do servidor, instruções para entrar, regras e um contato de suporte claro. Coloque a loja na navegação principal e use a URL da sua loja Tebex existente como destino. Teste esse link em um navegador sem login e em um celular.

Use um tema que mantenha essas tarefas fáceis de encontrar. Instale extensões apenas para os recursos que você pretende operar e anote as versões delas, para que atualizações futuras possam ser testadas com a mesma configuração. Para uma checklist de planejamento mais ampla, veja nosso guia para criar um site para um servidor FiveM.

Ponto de verificação: um visitante novo encontra as instruções para entrar no servidor, as regras, o suporte e a loja sem usar uma sessão de administrador.

4. Instale o recurso oficial AzLink-FiveM

Baixe o recurso na página de Releases do repositório. Extraia-o de modo que a raiz do recurso se chame azlink, contendo diretamente o fxmanifest.lua e o diretório server. Evite uma pasta extra aninhada do arquivo compactado.

resources/
└── azlink/
    ├── fxmanifest.lua
    └── server/

Na primeira inicialização, o README do projeto original usa estas instruções para o console do servidor. Execute refresh antes se você adicionou a pasta com o FXServer já em execução:

refresh
start azlink

Para iniciar após uma reinicialização do servidor, adicione o recurso ao server.cfg:

ensure azlink

O manifest da bridge declara um recurso apenas de servidor; estas instruções não instalam uma integração de gameplay com ESX, QBCore ou Qbox. Comandos que afetam personagens ou inventários precisam da própria implementação e dos próprios testes para o seu framework. Esta revisão de código-fonte não comprova uma aceitação de runtime separada para GTAV Legacy e Enhanced.

Ponto de verificação: o FXServer informa que o recurso iniciou sem erro de manifest ausente nem erro de script. Isso comprova a inicialização, não uma conexão funcionando com o site.

5. Conecte o FXServer ao site

Na área de administração do Azuriom, adicione o seu servidor de jogo em Servers. Use os valores de configuração exibidos para esse servidor. A implementação do comando revisada aceita a URL base do site seguida da chave do site:

azlink setup https://community.example.com YOUR_SERVER_SITE_KEY
azlink status
azlink fetch

https://community.example.com e YOUR_SERVER_SITE_KEY são placeholders. Execute a configuração real no console do servidor, com os valores do seu próprio painel. O recurso acrescenta /api/azlink à URL base por conta própria; não o acrescente de novo. Mantenha a chave privada.

Quando a configuração dá certo, o recurso salva as configurações de conexão em config.json dentro do diretório do recurso. Preserve esse arquivo ao atualizar o recurso. Trate o backup dele como sensível, pois contém a credencial da bridge. Confira o resultado de novo depois de reiniciar o recurso, para que uma conexão temporária em memória não esconda uma falha ao salvar a configuração.

Ponto de verificação: o status confirma a conectividade, o fetch termina e o site reflete o servidor conectado. Entre com uma conta de teste e compare as informações do jogador com as do FXServer. Verifique o modo de identidade selecionado antes de tentar ações específicas de jogadores.

6. Mantenha os pacotes pagos no caminho do Tebex

Para o lançamento mais simples, mantenha o link de navegação para a sua loja Tebex. Configure a entrega dos pacotes pagos pela conexão Tebex existente e não duplique essas ações no AzLink. Se você ainda precisa dessa conexão, nosso tutorial de configuração de loja Tebex para FiveM explica o lado da loja.

Se mais tarde você quiser navegar pelos pacotes dentro do Azuriom, o marketplace lista uma extensão Tebex Integration de terceiros, de Bricec6. A listagem dela descreve uma integração com a Tebex Headless API. Revise a compatibilidade, as dependências e a manutenção atuais antes de adotá-la. Este artigo não testou essa extensão, então a configuração básica acima não depende dela.

Antes de colocar um novo fluxo de compra no ar, verifique a identificação da conta, o destino real do checkout, a entrega dos pacotes e o canal de suporte. Mantenha o histórico de compras e as assinaturas ativas no sistema que funciona até existir uma migração testada à parte. Um redesign do site não é prova de que esses registros ou os acordos de renovação foram transferidos.

Solução de problemas do AzLink

O recurso não é encontrado

Confira o nome e o aninhamento da pasta. O manifest fica em resources/azlink/fxmanifest.lua. Atualize a lista de recursos depois de adicionar os arquivos e então inspecione o primeiro erro do console do servidor.

O recurso inicia, mas o site aparece desconectado

Confira a URL base HTTPS configurada e a chave de servidor correspondente. O cliente HTTP chama o endpoint /api/azlink do site. Revise os logs de acesso e de erro do site para esse caminho. Falhas de DNS, problemas de TLS, redirecionamentos para outro hostname, barreiras de autenticação ou desafios de navegador podem impedir que o FXServer receba a resposta esperada da API.

Corrija o acesso à rota de API pretendida sem desativar a proteção em todo o site. Ao pedir ajuda, informe o status HTTP, o horário e a versão do recurso; oculte credenciais e identificadores de jogadores.

O status funciona, mas o jogador ou a ação está errado

Confira a correspondência de identidade Steam versus Cfx, a conexão atual do jogador e os requisitos do comando de destino. A bridge substitui informações do jogador nos comandos e os executa pelo console do servidor. Uma requisição HTTP bem-sucedida não prova que o comando fez a mudança de gameplay pretendida.

Use primeiro uma ação inofensiva com uma conta de teste. Teste o comportamento com jogador desconectado separadamente antes de confiar em uma ação que espera um ID de servidor online. A administração do site e as credenciais da bridge merecem, portanto, o mesmo cuidado que outros caminhos capazes de disparar comandos no servidor.

Verificações de lançamento e de rollback

Lance depois de conferir o site sem login, as permissões de usuários comuns, a navegação no celular, a conexão persistente da bridge e o caminho de compra pretendido no Tebex. Mantenha um registro das versões do CMS, das extensões e do recurso, da data e do que você realmente testou.

Se a conexão com o site causar problemas, devolva os visitantes ao site anterior, restaure a configuração e o banco de dados dele quando necessário e pare o AzLink durante a investigação. Restaure a configuração salva do recurso apenas se ela ainda corresponder ao site e ao registro de servidor pretendidos. Mantenha o sistema de comércio existente disponível durante toda a mudança.

O Azuriom dá a você o controle do site que os jogadores usam. Para um servidor FiveM, este guia mantém o Tebex responsável pelo fluxo de monetização, enquanto o AzLink cuida da conexão entre o site e o servidor.