Aller au contenu
ModFiveM

Utiliser le ped en jeu

Une fois la ressource du ped lancée sur ton serveur, les joueurs ont besoin d’un moyen de devenir le ped. Voici comment faire avec ton propre script, vMenu, illenium-appearance, fivem-appearance et qb-clothing. Les exemples utilisent un ped appelé dillen.

Le nom du ped

Chaque menu et script trouve le ped par son nom de modèle : le nom dans son peds.meta et ses fichiers, dillen pour dillen.ydd. C’est le nom qu’avait le ped quand tu l’as exporté.

Assure-toi que le ped se charge avant de l’ajouter à un menu : sa ressource est dans server.cfg avec ensure, et le serveur a été redémarré depuis.

Depuis un script : SetPlayerModel

Dans ta propre ressource, un script client transforme le joueur en ped avec la native SetPlayerModel. Charge d’abord le modèle et attends qu’il soit chargé, comme le dit la référence de FiveM pour cette 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 remplace le ped du joueur, donc un script qui gardait l’ancien ped doit reprendre PlayerPedId().

Bon à savoir

N’importe quel joueur peut lancer une commande client comme celle-ci. Pour réserver le ped à certains joueurs, utilise un des menus ci-dessous, qui ont leurs propres permissions.

vMenu

Bon à savoir

Ces étapes sont pour vMenu for FiveM Legacy, le vMenu stable. vMenu for FiveM Enhanced est une version séparée, plus récente, et sa doc ne mentionne aucun addons.json.

  1. Ouvre resources/vMenu/config/addons.json et mets le nom du ped dans sa liste peds, comme ci-dessous. Laisse les autres listes du fichier telles quelles.

  2. Donne aux joueurs qui peuvent l’utiliser les permissions vMenu pour le menu Player Appearance et ses addon peds, dans le permissions.cfg que ton server.cfg lance avec exec.

  3. Redémarre le serveur. Le ped est alors dans la liste des addon peds de 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

Astuce

Le README.txt du ZIP de l’export contient la liste peds prête avec le nom de ton ped.

illenium-appearance

  1. Ouvre shared/peds.lua dans la ressource illenium-appearance. Config.Peds.pedConfig y est une liste d’entrées, chacune avec les peds qu’elle propose.

  2. Ajoute une entrée avec ton ped, comme ci-dessous.

  3. Redémarre le serveur.

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

Les peds apparaissent dans le menu qu’ouvre la commande /pedmenu. Par défaut, seul group.admin peut l’utiliser : Config.EnablePedMenu et Config.PedMenuGroup dans shared/config.lua en décident.

Une entrée sans limites propose ses peds à tout le monde. Donne-lui jobs, gangs, aces ou citizenids, et seuls les joueurs qui ont l’un d’eux reçoivent ses peds ; une correspondance suffit :

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

Une ACE citée par une entrée doit aussi être dans Config.Aces dans shared/config.lua, et les joueurs la reçoivent dans server.cfg avec add_ace, donnée à un groupe ou à un joueur :

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

Bon à savoir

L’ancienne adresse de la documentation d’illenium-appearance ne mène plus à sa documentation. Fie-toi aux fichiers de la ressource et à sa page GitHub.

fivem-appearance

fivem-appearance garde les peds qu’un joueur peut choisir dans peds.json dans le dossier de la ressource, une simple liste de noms. Ajoute le nom du ped en dernier, avec une virgule après le nom qui le précède :

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

Redémarre la ressource. Le ped est proposé là où les scripts de ton serveur ouvrent fivem-appearance avec le choix de ped activé. Sa documentation ne dit rien sur la façon de réserver des peds à certains joueurs.

qb-clothing (QBCore)

qb-clothing prend les peds qu’il propose dans deux listes de son config.lua : Config.ManPlayerModels pour les personnages masculins et Config.WomanPlayerModels pour les féminins. Ajoute le nom du ped à la liste de son genre :

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

Redémarre le serveur. qb-clothing propose alors le ped aux personnages de ce genre dans son menu de vêtements. Le staff avec qb-adminmenu peut aussi ouvrir ce menu pour un joueur avec Give Clothing Menu. Les listes n’ont aucune limite de job ou de permission.

Bon à savoir

Beaucoup de serveurs QBCore utilisent illenium-appearance au lieu de qb-clothing. Ajoute alors le ped comme l’explique cette section.

Si le ped n’est pas dans le menu

Si le ped n’apparaît pas dans un menu, ou apparaît invisible, vérifie que sa ressource démarre et que le nom est correct, puis parcours le guide sur les peds invisibles ou qui crashent. Le Contrôle de ped trouve l’essentiel en une minute.