Pular para o conteúdo
ModFiveM

Usar o ped no jogo

Depois que o recurso do ped estiver rodando no seu servidor, os jogadores precisam de um jeito de virar o ped. Veja como com um script seu, vMenu, illenium-appearance, fivem-appearance e qb-clothing. Os exemplos usam um ped chamado dillen.

O nome do ped

Todo menu e script encontra o ped pelo nome do modelo: o nome no peds.meta e nos arquivos dele, dillen para dillen.ydd. É o nome que o ped tinha quando você o exportou.

Confira se o ped carrega antes de adicioná-lo a um menu: o recurso dele está no server.cfg com ensure, e o servidor foi reiniciado desde então.

Por script: SetPlayerModel

Em um recurso seu, um script de cliente transforma o jogador no ped com a native SetPlayerModel. Carregue o modelo primeiro e espere até ele carregar, como diz a referência do FiveM para a native:

client.lua
-- /dillen turns the player into the pedRegisterCommand('dillen', function()    local model = GetHashKey('dillen')    if not IsModelInCdimage(model) or not IsModelValid(model) then        print('dillen is not streamed: is its resource started?')        return    end    RequestModel(model)    while not HasModelLoaded(model) do        Wait(0)    end    SetPlayerModel(PlayerId(), model)    SetModelAsNoLongerNeeded(model)end, false)

SetPlayerModel substitui o ped do jogador, então um script que guardava o ped antigo precisa pegar PlayerPedId() de novo.

Bom saber

Qualquer jogador pode rodar um comando de cliente como este. Para restringir o ped a alguns jogadores, use um dos menus abaixo, que têm permissões próprias.

vMenu

Bom saber

Estes passos são para o vMenu for FiveM Legacy, o vMenu estável. O vMenu for FiveM Enhanced é uma versão separada e mais nova, e a documentação dele não cita nenhum addons.json.

  1. Abra resources/vMenu/config/addons.json e coloque o nome do ped na lista de peds, como abaixo. Mantenha as outras listas do arquivo como estão.

  2. Dê aos jogadores que podem usar as permissões do vMenu para o menu Player Appearance e os peds de addon dele, no permissions.cfg que o seu server.cfg roda com exec.

  3. Reinicie o servidor. O ped então aparece na lista de peds de addon do vMenu.

addons.json
"peds": [  "dillen"],
permissions.cfg
# vMenu: the Player Appearance menu and its addon peds, for the admin groupadd_ace group.admin "vMenu.PlayerAppearance.Menu" allowadd_ace group.admin "vMenu.PlayerAppearance.AddonPeds" allow

Dica

O README.txt no ZIP da exportação traz a lista de peds pronta com o nome do seu ped.

illenium-appearance

  1. Abra shared/peds.lua no recurso illenium-appearance. Config.Peds.pedConfig ali é uma lista de entradas, cada uma com os peds que oferece.

  2. Adicione uma entrada com o seu ped, como abaixo.

  3. Reinicie o servidor.

shared/peds.lua
-- a new entry in Config.Peds.pedConfig: the ped for everyone{    peds = { "dillen" },},

Os peds aparecem no menu que o comando /pedmenu abre. Por padrão só group.admin pode usá-lo: Config.EnablePedMenu e Config.PedMenuGroup em shared/config.lua decidem.

Uma entrada sem limites oferece os peds a todos. Dê a ela jobs, gangs, aces ou citizenids, e só jogadores com um deles recebem os peds; uma correspondência basta:

shared/peds.lua
-- the ped only for the police job, or for whoever has the ACE{    peds = { "dillen" },    jobs = { "police" },    aces = { "pedforge.dillen" },},

Uma ACE que uma entrada cita também precisa estar em Config.Aces em shared/config.lua, e os jogadores a recebem no server.cfg com add_ace, dada a um grupo ou a um jogador:

shared/config.lua
-- every ACE the peds list namesConfig.Aces = { "pedforge.dillen" }
server.cfg
# the group vip may use dillen, and this player is in itadd_ace group.vip pedforge.dillen allowadd_principal identifier.steam:110000112345678 group.vip

Bom saber

O endereço antigo da documentação do illenium-appearance não leva mais à documentação. Siga os arquivos do recurso e a página dele no GitHub.

fivem-appearance

O fivem-appearance guarda os peds que um jogador pode escolher em peds.json na pasta do recurso, uma lista simples de nomes. Adicione o nome do ped por último, com uma vírgula depois do nome anterior:

peds.json
[  "a_f_m_beach_01",  "a_f_m_bevhills_01",  "dillen"]

Reinicie o recurso. O ped é oferecido onde os scripts do seu servidor abrem o fivem-appearance com a escolha de ped ligada. A documentação dele não diz nada sobre restringir peds a alguns jogadores.

qb-clothing (QBCore)

O qb-clothing pega os peds que oferece de duas listas no config.lua dele: Config.ManPlayerModels para personagens masculinos e Config.WomanPlayerModels para femininos. Adicione o nome do ped à lista do gênero dele:

config.lua
Config.ManPlayerModels = {    'mp_m_freemode_01',    -- the peds already in the list    'dillen',}

Reinicie o servidor. O qb-clothing então oferece o ped a personagens desse gênero no menu de roupas. A staff com qb-adminmenu também pode abrir esse menu para um jogador com Give Clothing Menu. As listas não têm limites de emprego ou permissão.

Bom saber

Muitos servidores QBCore usam illenium-appearance no lugar do qb-clothing. Aí adicione o ped como diz aquela seção.

Se o ped não estiver no menu

Se o ped não aparecer em um menu, ou aparecer invisível, confira se o recurso dele inicia e se o nome está certo, depois siga o guia sobre peds invisíveis ou que crasham. A Verificação de ped encontra quase tudo em um minuto.