Skip to main content
O Five Skins é um sistema completo de cosméticos de armas para servidores FiveM. O jogador abre caixas, recebe skins por sorteio ponderado, organiza o inventário por arma, compra e vende com a moeda interna, troca skins com outros jogadores, aprimora itens em busca de skins mais valiosas, acompanha o ranking e ainda testa qualquer skin em uma área isolada antes de decidir. Toda a lógica é validada no servidor, enquanto o cliente apenas exibe e pede ações. A interface é uma aplicação React (NUI) totalmente configurável pelo Lua.

​
Funcionalidades

Caixas e sorteio

Abertura de caixas pagas com a moeda interna ou de uma caixa diária grátis, com a skin definida por sorteio ponderado.

Inventário por categoria

Organização das skins por arma, com equipar, desequipar, vender e comprar direto no painel.

Loja integrada

Compra de skins pelo inventário, com opção de preço por período de validade.

Trocas entre jogadores

Propostas de troca com outro jogador, com taxa cobrada em vouchers e validade configurável.

Aprimoramento

Consome skins e saldo para tentar uma skin de maior valor, com chance proporcional ao investimento.

Ranking

Ranking de skins ganhas por período, alimentado pelo histórico de aberturas.

Teste de armas

Testa a skin em uma área isolada por routing bucket, sem afetar os outros jogadores.

Skins temporárias

Skins com prazo de validade, compradas por período ou ganhas em caixas, removidas de forma automática ao expirar.

​
Como funciona

1

O jogador abre o painel

Pelo comando /skins, por evento ou por outro recurso que dispare a abertura.
2

Abre caixas e recebe skins

Cada caixa entrega uma skin por sorteio ponderado. A caixa diária é gratuita e entra em cooldown, as demais custam a moeda interna.
3

Gerencia o inventário

O jogador equipa, vende ou compra skins por categoria. A skin equipada é aplicada na arma pela integração com o inventário.
4

Troca, aprimora e testa

Troca skins com outros jogadores, aprimora itens em busca de algo melhor e testa qualquer skin em uma área isolada antes de decidir.

​
Caixas

Cada caixa pode ser gratuita ou paga, e pode ter acesso restrito a um grupo. A skin entregue é definida pelo campo chance de cada skin do catálogo. Toda abertura entra no histórico que alimenta o ranking e a lista de vitórias recentes.

​
Skins temporárias

Uma skin temporária funciona igual a uma permanente enquanto está válida. A diferença é que ela tem uma data de expiração. O jogador pode obter uma skin temporária de duas formas.

Na compra pela loja

Ao comprar uma skin, o jogador escolhe um dos períodos definidos na configuração. A opção permanente também aparece na mesma lista.

Ao abrir uma caixa

Se a skin sorteada tiver uma duração definida na caixa, ela entra no inventário já com o prazo.
Quando o prazo termina, a skin é removida do inventário de forma automática e o jogador recebe um aviso. No painel, as skins temporárias mostram quantos dias restam, e as que estão perto de expirar ganham destaque.
Se o jogador já tem a skin de forma permanente, abrir uma caixa ou comprar uma versão temporária não tira a permanência. A skin continua sem prazo.

​
Economia

O sistema trabalha com uma moeda interna própria (SkinsCoins) e com vouchers usados nas trocas. A moeda interna paga as caixas e as compras da loja, enquanto os vouchers cobrem a taxa das trocas entre jogadores. Se preferir usar a moeda do seu servidor no lugar da SkinsCoins, basta ligar essa opção na configuração. Nesse caso, as compras passam a consumir o saldo do framework em vez da moeda interna.