DRS Ped VIP

Peds exclusivos para os teus VIPs, guardados na personagem e reaplicados sempre que entram, com ferramentas completas para a staff.

v2.2.3 QBCore drs_pedvip

Peds exclusivos para VIPs: a staff dá um ped a um jogador, o ped fica guardado na personagem e volta sozinho sempre que o jogador entra. Inclui tirar o ped, bloquear só nesta sessão e registo no Discord.

#Requisitos

Recurso	Obrigatório
`qb-core`	Sim
RufiUniqueID	Não — só se quiseres usar UIDs nos comandos

#Instalação

Coloca drs_pedvip em resources e adiciona ao server.cfg:

server.cfg

ensure qb-core
ensure drs_pedvip

Define quem é staff no config.lua. Basta cumprir uma das três:
- permissão QBCore em Config.StaffPermission (ex.: 'admin');
- ACE drs.pedvip;
- license em Config.StaffLicenses.

server.cfg

add_ace group.admin drs.pedvip allow

#Comandos

Comando	Quem	O que faz
`/setped [id] [modelo]`	Staff	Dá e guarda um ped VIP
`/resetped [id]`	Staff	Apaga o ped VIP guardado
`/unped [id]`	Staff	Tira o ped agora; o VIP continua guardado
`/unped`	Todos	Tira o teu próprio ped
`/desativarped [id]`	Staff	Bloqueia o ped VIP até ao próximo restart (funciona com o jogador offline, usando o UID)
`/ativarped [id]`	Staff	Tira o bloqueio e volta a pôr o ped
`/pedme`	Todos	Volta a pôr o teu ped VIP

[id] é o UID (com o RufiUniqueID ligado) ou o ID do servidor, conforme Config.PlayerIdType. Os nomes dos comandos mudam-se em Config.Commands.

Nota

O bloqueio de /desativarped não se contorna saindo e voltando a entrar — dura até ao restart do servidor ou até /ativarped.

#Opções principais

Opção	Por defeito	Descrição
`Config.PlayerIdType`	`'auto'`	`auto`, `uid` ou `id`
`Config.BlockedPeds`	3 modelos	Peds que não podem ser usados
`Config.LockClothingWhenVipPed`	`true`	Bloqueia a loja de roupa com um ped VIP (o teu script de roupa tem de ler o state `vipPedLocked`)
`Config.AutoApplyOnLoad`	`true`	Reaplica o ped ao entrar
`Config.DiscordWebhook`	`''`	Regista as ações da staff

#Configuração completa

config.lua

Config = {}

-- Idioma / Language: 'pt' ou 'en'
Config.Locale = 'pt'

-- Quem é staff (basta cumprir uma) / Who counts as staff (any one is enough):
--   1) permissão do QBCore / QBCore permission ('admin', 'god', 'mod'...)
--   2) ACE: add_ace group.admin drs.pedvip allow
--   3) licenses abaixo / licenses below
Config.StaffPermission = 'admin'
Config.StaffLicenses = {
    -- 'license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
}

-- Como identificar o jogador nos comandos: 'auto' (UID se o RufiUniqueID estiver ligado, senão ID), 'uid' ou 'id'
-- How players are identified in commands: 'auto' (UID if RufiUniqueID is running, else server ID), 'uid' or 'id'
Config.PlayerIdType = 'auto'

-- Peds que NÃO podem ser usados / Peds that can NOT be used
Config.BlockedPeds = {
    'a_m_m_acult_01',
    'u_m_y_juggernaut_01',
    's_m_m_movingtrucks_01',
}

-- Bloquear a loja de roupa enquanto o jogador usa um ped VIP (o qb-clothing tem de ler o state 'vipPedLocked')
-- Lock the clothing shop while a VIP ped is in use (qb-clothing must check the 'vipPedLocked' state)
Config.LockClothingWhenVipPed = true

-- Reaplicar o ped VIP sozinho quando o personagem entra / Reapply the VIP ped automatically on character load
Config.AutoApplyOnLoad = true

-- Webhook do Discord para registar as ações da staff ('' = desligado) / Discord webhook for staff actions ('' = off)
Config.DiscordWebhook = ''

-- Nomes dos comandos / Command names
Config.Commands = {
    setped   = 'setped',        -- /setped [id] [modelo]  (staff) dá e guarda um ped VIP
    resetped = 'resetped',      -- /resetped [id]         (staff) apaga o ped VIP guardado
    unped    = 'unped',         -- /unped [id]            (staff) tira o ped agora; /unped sozinho = o próprio jogador
    disable  = 'desativarped',  -- /desativarped [id]     (staff) bloqueia o ped VIP até ao restart
    enable   = 'ativarped',     -- /ativarped [id]        (staff) tira o bloqueio
    pedme    = 'pedme',         -- /pedme                 volta a pôr o teu ped VIP
}

#Para programadores

server

exports.drs_pedvip:SetVipPed(source, 'a_c_chimp')   -- dá e guarda um ped
exports.drs_pedvip:ResetVipPed(source)              -- apaga o ped guardado
exports.drs_pedvip:IsPedDisabled(source)            -- true se estiver bloqueado nesta sessão

Útil para lojas VIP ou sistemas de doações.