snt-inventory-pro

O inventário é a tela que o jogador mais abre no seu servidor. Se ela duplica item, trava no meio de uma troca ou parece ter saído de 2019, é o servidor inteiro que passa a parecer amador.

O SNT Inventory Pro foi reconstruído do zero para juntar inventário, armas, economia, baús, veículos e administração num resource só, com uma interface dark glass que se ajusta a qualquer resolução. É standalone: funciona em qualquer framework e só precisa do oxmysql. E tudo se configura dentro do jogo: você muda uma loja, um item ou uma tecla, clica em "Salvar tudo" e a mudança chega a todos os jogadores na hora, sem reiniciar nada.

Uma interface que o jogador entende em segundos

• Arrastar e soltar de verdade: mova itens entre inventário, baú, porta-malas e revista. Solte a munição na arma para recarregar e o acessório para instalar.
• Atalhos para quem joga rápido: botão do meio usa, Shift+clique transfere na hora, Shift+arrastar divide a pilha e Ctrl+clique manda para a hotbar. Baús, lojas e painéis têm barra de busca.
• Cabeçalho de identidade: foto, nome, ID, telefone, profissão, VIP, saldo no banco e coins, sempre à vista.
• Hotbar nas teclas 1 a 5, com prévia na tela ao segurar Shift.
• Tutorial interativo de 10 passos, com destaque na área explicada e demonstrações animadas. Ele roda numa demonstração e devolve o inventário do jogador intacto.
• 6 raridades com brilho próprio, barra de durabilidade ao vivo e tooltip com peso, usos restantes e contagem regressiva até estragar.
• Notificações repaginadas com som para cada item que entra ou sai do inventário.
• Cabe em qualquer tela: todo o layout escala por uma unidade só, então funciona em 16:9, 21:9 ou 4:3 sem quebrar.
• Sem tela travada: se um painel falhar, a interface solta o cursor e se recupera sozinha. O jogador não precisa relogar.

Itens com vida própria

• Durabilidade em tempo real, que continua correndo com o jogador offline. O valor máximo fica gravado em cada item, então mudar a configuração não estraga o que já existe.
• Três destinos ao estragar: sumir, ficar quebrado e inutilizável, ou virar outro item (a pizza vira lixo).
• Itens com número de usos: um kit que dura 5 aplicações e depois some, quebra ou se transforma.
• A água estraga o bolso: nadou com dinheiro, perdeu. Dinheiro sujo pode virar outro item. Você decide a lista.
• Consumíveis com barra de progresso, animação, props na mão, item exigido e cooldown por item. O jogador cancela a qualquer momento com F6.
• Baús que conservam: cada baú pode desacelerar o desgaste dos itens, ideal para geladeiras e armazéns.
• Metadados no próprio item: nome e descrição únicos, e a munição e os acessórios viajam junto com a arma quando ela é enviada a outro jogador.
• Empilhamento opcional de itens com a mesma durabilidade.

Arsenal completo

• Munição guardada na própria arma, com limite próprio por arma (até 250) e recarga por arrasto. Crie munições como quiser: uma por categoria ou uma para cada arma.
• Descarregar devolve tudo: a munição e os acessórios exatos que estavam na arma voltam para o inventário.
• Acessórios por arrasto, mapeados por arma e por componente do GTA.
• Desgaste por tiro: a cada N disparos, a arma perde X%. Quebrou, ela sai da mão e a regra de estrago é aplicada.
• HUD de munição com pente, reserva e durabilidade, posicionado por arrasto no painel.
• 3 modos de equipar: sem animação, puxar e guardar nas costas, ou puxar na lateral e guardar na frente.
• 11 arremessáveis que gastam uma unidade por arremesso.
• Alerta de cheat: munição que sobe sem recarga ou arma que não está no inventário gera alerta, e a arma é tirada da mão.

A economia inteira dentro do inventário

• Marketplace entre jogadores: anúncio com taxa, limite de anúncios e validade por permissão, preço mínimo e máximo por item, e busca, filtro e ordenação no servidor. O vendedor recebe mesmo offline.
• Trocas sem risco de golpe (/negociar): convite com Y/N e itens e dinheiro dos dois lados. Qualquer alteração derruba as duas confirmações, e no fechamento peso, espaço e saldo são conferidos de novo antes de tudo ser executado de uma vez.
• Lojas com compra e venda, preço e moeda por item (inclusive moedas personalizadas), "vender tudo" com Shift, várias localizações, blip, permissão e restrição por routing bucket.
• Correio: entregue itens até para quem está offline, com remetente e validade. O jogador retira por comando ou em pontos do mapa com blip, e dentro do correio o item não se desgasta.

Monetização nativa

• Slots extras e bolsos seguros à venda em qualquer moeda: dinheiro do jogo, coins ou moedas personalizadas. O jogador clica no cadeado e compra. Os bolsos seguros guardam os itens mais importantes num espaço à parte, que não pode ser roubado na revista nem se perde ao morrer.
• Upgrades de baú em slots e em peso, também pagos.
• Vantagens VIP por permissão: consumir itens mais rápido, craft e reparo mais rápidos, desconto na taxa do marketplace, mais anúncios e anúncios que duram mais.
• Botão "Loja VIP" dentro do inventário, com brilho e onda animados, que abre o seu site ou roda um comando.

Baús, veículos e o mundo do seu servidor

• Baús configuráveis: permissão, slots, peso, logo próprio, modo só-guardar ou só-retirar, routing buckets exclusivos e webhook próprio. Um jogador por vez, sem disputa pelo mesmo slot.
• Porta-malas e porta-luvas: peso por modelo de veículo, e veículo trancado não abre. A porta do porta-malas abre de verdade para quem está perto, e o porta-luvas só abre para motorista e carona.
• Containers de aluguel: o jogador aluga por diárias, dá nome, divide com membros e renova. Atrasou, bloqueia. Passou do prazo, o container é removido sozinho.
• Bancadas de crafting com receitas, tempo por receita, animação própria, cálculo do máximo que dá para fabricar e bônus de tempo por permissão.
• Estações de reparo: arraste o item danificado, veja o material e o custo, e ele volta a 100%.
• Revista completa (/revistar): consentimento do alvo, liberação para polícia e staff, regras para alvo morto ou desarmado e opção de esconder a identidade. Hooks na retirada de itens permitem até apreensão automática pela polícia.
• Descarte em lixeiras reais do mapa (13 modelos configuráveis): nenhum prop largado no chão pesando no servidor.
• Blips e ícones flutuantes para lojas, bancadas, reparo, aluguel e marketplace, com seletor visual de sprite e cor.

Administração sem reiniciar o servidor

O /sntinventory abre um painel dentro do jogo com os 14 arquivos de configuração organizados em abas, sem nenhum JSON cru à vista. Cada campo tem o controle certo: seletor de cor, captura de tecla, coordenadas com "usar minha posição" e teleporte.

• Alterações ao vivo: o servidor manda aos clientes só a diferença, por evento latente com banda controlada. Lojas, blips, teclas e comandos são recriados na hora.
• Rascunho com diff: edite várias abas, veja o que mudou e grave tudo com um "Salvar tudo" (ou Ctrl+S).
• Busca global em todas as configurações, com o trecho encontrado em destaque.
• Posicionamento por arrasto do HUD de munição, das notificações e do botão da loja, com guias de alinhamento.
• Descrição de item gerada por IA, sem chave de API e sem custo.
• Importação do catálogo em Lua (shared.items.lua e similares) e editor de todos os textos da interface.
• 12 comandos de staff: vinv (funciona até com o jogador offline), vchest, gitem, clearinv, clearinvfull, resetinv, adjustslots, adjustweight, clearchest, vcorreio, vmarket e vcontainers. Nome, permissão e liga/desliga editáveis ao vivo.
• Logs no Discord em 16 categorias, com webhook separado por loja, baú, bancada e reparo. As URLs ficam no banco de dados, nunca no JSON que vai para o cliente.

Segurança e desempenho de verdade

• Anti-dupe por design: cada inventário tem trava própria, e toda transferência trava os dois lados sempre na mesma ordem. Sem corrida, sem item duplicado, sem deadlock.
• Negociação atômica: itens, dinheiro e espaço são conferidos de novo no fechamento, e os dois lados são cobrados antes de alguém receber.
• Chamadas protegidas: token por jogador, limite de 30 chamadas a cada 1,5 s por método e checagem de distância no servidor para lojas, bancadas, reparo e marketplace.
• Salvamento inteligente: gravações agrupadas, uma escrita por vez por inventário, nova tentativa com backoff e tudo salvo quando o resource para.
• Memória sob controle: baús ociosos saem da memória em 10 minutos, identidade e permissões ficam em cache, e uma única requisição abre qualquer interface.
• Interface leve: grade virtualizada e atualização slot a slot, sem recarregar o inventário inteiro a cada mudança.

Feito para desenvolvedores

A documentação completa traz toda a API para integrar o inventário a qualquer sistema do seu servidor ou de terceiros.

• 98 exports para itens, inventário, baús, correio e para abrir qualquer interface, publicados também sob o nome snt-inventory.
• 18 hooks no servidor (onItemAdded, onChestStorage, onTryInspect...) para aprovar, bloquear ou reagir a cada ação.
• Itens registrados em tempo de execução com registerItem, sincronizados com todos os clientes.
• 42 funções de uso prontas como ponto de partida: kit médico, comida, mochila, colete, paraquedas, lockpick, nitro e outras.
• Standalone de verdade: pagamento, permissão, identidade e morte ficam isolados em config/framework.lua. Ligue em qualquer framework e cadastre moedas personalizadas com a sua própria função de pagamento.

Migração sem dor

• Vindo do Creative Network? Um comando de console converte o seu itemlist e migra inventários, peso, munição e acessórios equipados, baús e porta-malas. O que não couber vai para o correio do jogador, e o que falhar fica registrado em log.
• Banco pronto sozinho: o resource cria as tabelas que precisa e adiciona as colunas que faltarem nas atualizações.
• Atualização automática que respeita a sua configuração: config/, data/ e as suas imagens nunca são sobrescritos.

Requisitos

• oxmysql. Só isso: o resource é standalone e funciona em qualquer framework.

Um resource no lugar de uma dúzia. Inventário, armas, lojas, marketplace, correio, baús, aluguel, crafting, reparo, negociação, revista e logs, todos falando a mesma língua e configuráveis sem reiniciar. Coloque o SNT Inventory Pro no carrinho e veja o seu servidor subir de nível no primeiro login.