Skip to main content
O five-codiguin é o sistema de resgate de códigos promocionais do servidor. O jogador abre um painel (/codiguin), digita um código e, se válido e ainda não usado, recebe as recompensas. O código é normalizado (maiúsculas, sem espaços), e o resgate é único por personagem (gravado em playerdata).

Funcionalidades

Painel de resgate

O jogador abre um painel NUI por /codiguin e digita o código promocional.

Resgate único

Código normalizado (maiúsculas, sem espaços) e resgate único por personagem, gravado em playerdata.

Recompensas combinadas

Dinheiro (dollar), gemas, veículo de aluguel (via five-vehicles) e itens na mesma entrada.

Códigos configuráveis

Cada código é uma entrada em Codiguin.Codes, com label, descrição e recompensas próprias.

Dependências

vrp

Framework base (Tunnel/Proxy; Passport, UserData, GenerateItem, UpgradeGemstone).

five-vehicles (opcional)

Apenas para a recompensa de veículo (generateRentalVehicle).
five_logs (opcional): registra o log CODIGUIN.

Configuração

Todo o ajuste fica em config/config.lua (tabela Codiguin).

Comandos


Localizações

O recurso não possui locais fixos no mundo (sem NPCs, blips, marcadores ou zonas). O painel é aberto apenas pelo comando /codiguin.

Exports

Não publica exports próprios. O Tunnel five-codiguin expõe Core.Redeem(code).

Banco de Dados

Não cria tabela própria, usa playerdata do vRP. Guarda um mapa { ["CODIGO"] = timestamp } por personagem sob a chave Codiguin.StorageKey.

Customização

  • Novos códigos: adicione entradas em Codiguin.Codes (chave = código em MAIÚSCULAS sem espaços).
  • Recompensas combinadas: misture money, gems, vehicle e items na mesma entrada.
  • Comando/tema: Codiguin.Command, Codiguin.ThemeColor.
A UI é distribuída compilada em web/dist/ (sem src no recurso).