[FR] Poster / MaJ un addon sur le Workshop

Ce guide permet de poster un addon sur le workshop ou de mettre un de vos addons à jour.

Introduction

Déjà, commençons par le commencement.

Il existe déjà un guide pour mettre un addon en ligne, mais il est en anglais. Et pour certains, l'anglais est un fléau.

Ensuite, vous n'avez besoins de rien (sauf d'un ordinateur et de garry's mod)

Pour les "débutants de l'informatique" tout se trouve dans C:\Program Files (x86)\Steam\steamapps\common\GarrysMod\bin .

Vous aurez donc besoins : de la cmd windows (si vous êtes sur windows, évidemment) ; de gmad.exe et de gmpublish.exe du dossier bin de Garry's mod (dont l'emplacement indiqué ci-dessus) et d'un dossier pour mettre votre addon.

Préparer l'addon

Bien, maintenant que nous avons tout ce qu'il faut, on peut commencer.

Ouvrez le dossier de votre addon.

Plusieurs chose : on ne peut avoir que 5 types de sous-dossiers pour votre addon :

• lua (pour les scripts en... lua --' )
  
• models (pour les models : .mdl, .phy, .sw.vtx, .vvd, .dx80.vtx, .dx90.vtx et .xbox.vtx)
  
• materials (pour les textures : .vtf et .vmt)
  
• gamemodes (pour euh... les gamemodes)
  
• maps (pour les maps : .bsp, .ain)

Maintenant que ce petit bazar est casé dans le dossier de votre addon, on peut maintenant mettre le fichier addon.json

"Qu'est-ce que le fichier addon.json ?"

Le fichier addon.json est un fichier permettant à gmad.exe de pouvoir savoir quoi compresser.

Vous devez donc créer un fichier .json. (Pour cela, rien de plus simple, créez un fichier texte et renommez le en "addon.json".)
Editez votre fichier "addon.json" et mettez ceci (en remplacant biensûr les mots/phrases soulignées) :

ATTENTION : Vous devez remplacer tous les ( ) par [ ] !

{
	"title"		:	"Nom de votre addon",
	"type"		:	"Type",
	"tags"		:	("tag1", "tag2") ,
	"ignore"	:
	(
		"*.psd",
		"*.vcproj",
		"*.svn*"
	)
}

Certaines consignes sont à respecter :

• title : C'est le titre de votre addon, choisissez simplement un nom ;)
  
• type : C'est le type d'addon, il y a 9 catégories :
  
  • "ServerContent"
    
  • "gamemode"
    
  • "map"
    
  • "weapon"
    
  • "vehicle"
    
  • "npc"
    
  • "tool"
    
  • "effects"
    
  • "model"
    
• tags : c'est le tag qui qualifiera votre addon. Vous pouvez en mettre jusqu'à deux parmis ceux-ci :
  
  • "fun"
    
  • "roleplay"
    
  • "scenic"
    
  • "movie"
    
  • "realism"
    
  • "cartoon"
    
  • "water"
    
  • "comic"
    
  • "build"
    
• ignore : Il est là juste pour exclure certains types de fichiers non supportés pour un addon. N'y touchez pas ;) .

Bien, maintenant que tout est organisé, on peut passer à la transformation en .gma

Transformation en .gma

Bien. Vous savez ce qu'est un addon, non ?
C'est un fichier .gma, avec tout l'addon qui y est compressé, simplement.

Pour transformer votre addon en .gma, il y a deux façons :

1. La méthode de la cmd (la plus longue), pour l'utiliser, vous devez avoir votre répertoire Garry's mod sur le même disque dur que le répertoire de windows, sinon, copiez cmd.exe dans le disque dur ou se trouve Garry's mod :
   
   • Ouvrez votre cmd.exe (que vous pouvez trouver en recherchant dans la barre de recherche windows "cmd.exe", je suis désolé pour ceux sur Mac ou Linux, petite pensée a vous).
     
   • Allez chercher votre répertoire bin de Garry's mod, et marquez sur la cmd :

     cd - "<Répertoire bin copié>"

   • Marquez sur la cmd :

     gmad.exe create -folder "<Répertoire du dossier de votre addon>" -out "<Répertoire de sortie du .gma>/NOMDELADDON.gma"

2. La méthode "glissez" (la plus rapide) :
   
   • Cherchez gmad.exe
     
   • Cherchez le dossier de votre addon
     
   • Glissez le dossier de votre addon sur gmad.exe
     
   • POUFFF, un fichier .gma apparaît dans le même répertoire où se trouve le dossier de votre addon
     

Maintenant que vous avez votre fichier .gma de prêt, passons a la publication !

L'image de l'addon

ATTENDEZ !
Avant de publier un addon, il faut mettre une image ! Eh oui, désolé pour vous, il faut une image, sinon, la publication échouera. Bon, voyons le côté positif, il n'y a que deux restrictions : il faut qu'elle fasse une taille de 512x512 pixels et qu'elle soit dans le format .jpg ET QUE .jpg

Elle est prête ? Bien, maintenant, mettez-la dans le dossier de votre addon.

C'est bon, on peut VRAIMENT passer à la publication.

La publication

Bon, on peut publier !

Pour cela, (malheureusement) qu'une seule méthode :

• Ouvrez votre cmd.exe
  
• Marquez dans votre cmd :

  cd "<Répertoire bin de Garry's mod>"

• Marquez (toujours) dans votre cmd :

  gmpublish.exe create -addon "<Chemin du dossier .gma>" -icon "<Chemin de votre image .jpg>"

• Et voilà ! Votre addon va maintenant être publié !

Quand votre addon sera en ligne, il sera visible juste par vous. Vous pouvez modifier sa visibilité en cliquant, sur la page de votre addon, sur "Modifier la visibilité", et cochez "Publique" (ou "Amis seulement" selon votre choix)
De plus, il n'y aura aucune description. Vous pouvez la mettre en cliquant sur "Changer le titre et la description".

Mettre à jour

Vous avez posté un addon sur le Workshop et vous voudriez le mettre à jour ? Pas de soucis.

• Ouvrez cmd.exe
  
• Marquez dans votre cmd :

  cd - "<Répertoire du dossier bin de Garry's mod>"

• Marquez (encore) dans votre cmd :

  gmpublish.exe list

  et cherchez votre addon. Mémorisez son ID.
  
• Marquez dans votre cmd :

  gmpublish.exe update -id <ID de votre addon> -addon "<Chemin du fichier .gma>"

• Votre addon est mis à jour

Lorsque vous mettez à jour votre addon, une nouvelle ligne dans l'onglet "Note de changement" sera ajouté. Faites "modifier" et dites ce que vous avez changé ;)

Problèmes rencontrés

Certains problèmes peuvent vous barrer la route. Voici donc une liste comportant la plupart de ceux-ci :

Pour gmad.exe :

• gmad.exe peut vous dire qu'un certain fichier n'est pas autorisé par la liste blanche ("Not allowed by whitelist"). Dans ce cas, verifiez-bien que le fichier est bien dans son bon sous-dossier (par exemple, un fichier .bsp dans le sous-dossier lua va poser problème). De plus, faites attention de bien créer le fichier .gma avant de mettre votre image dans le dossier de votre addon.
  
• Si vous rencontrez une erreur d'une provenance inconnue, elle peut être dû à la trop grosse taille de votre addon.

Pour gmpublish.exe :

• Error 3 : Aucune connection
  
• Error 5 : Ticket Steam invalide (créez un compte de communauté, si ce n'est pas déjà fait)
  
• Error 6 : Le même utilisateur est connecté à deux endroits différents
  
• Error 8 : Paramètre incorrecte
  
• Error 9 : Fichier non-trouvé
  
• Error 12 : Nom invalide
  
• Error 13 : E-mail invalide
  
• Error 15 : Accès refusé
  
• Error 16 : L'opération prend trop de temps
  
• Error 17 : Bannissement par VAC2
  
• Error 18 : Compte non-trouvé (veillez à bien être connecté)
  
• Error 19 : Steam ID non-valide (veillez à bien être connecté)
  
• Error 20 : Le service de requête est indisponible
  
• Error 21 : L'utilisateur n'est pas connecté a Steam (veillez a être... connecté :3 )
  
• Error 22 : Requête suspendue
  
• Error 23 : Cryptage ou décryptage invalide
  
• Error 24 : Privilège insuffisants (si vous n'avez pas acheté de jeux a steam, vos privilèges sont restreints)
  
• Error 25 : Limite de stockage atteinte
  
• Error 26 : Accès retirés
  
• Error 31 : Adresse IP non trouvée
  
• Error 40 : L'utilisateur n'est pas autorisé à publier cela
  
• Error 42 : Aucun récepteur n'a été trouvé pour la requête

[remuzik]

Bonjour, j'aimerais moi aussi créer des Add-on pour certains jeux (notamment LOTUS-Simulator, Cities In Motion 2 , Cities Skylines, Transport Fever 1 et 2, Winter Resort Simulator 1 et 2) mais je ne suis que débutant et je n'ai pas de fichiers spécifiques Lua, Models, Maps, Materials ou Gamemodes. Faut-il les créer où les trouver sur Internet ? Merci de votre aide

[[KBRP] Dono]

est ce que tu pourrais voc pour m expliquer

[Mr Wilsøn]

Pour être franc, je pense que ton problème n'est pas lié à Gmod, mais à Windows en général.
Regarde par là https://www.commentcamarche.net/faq/6845-exe-n-est-pas-une-application-win32-valide , essaye, tente, et regarde ce que ça donne...

[guivan2525]

plus jsp comment faire pour le fichier lua

[guivan2525]

je ne sais pas comment faire pour l'image

[Dyncker]

Bonjour, j'aimerai savoir comment sa fonction si on souhaite faire un condenser de plusieurs addon (un contents pour le coup) car je n'ai pas réellement compris et c'est le seul guide que j'ai trouver ^^

[David Groove]

Bonjour je voudrais savoir comment on change l'image d'un gamemode Merci

[CrazY I あ]

Bonjour, j'ai mit des images dans mon script en .png est sa ne marche pas.

Pour ma par j'utilise le logiciel GAC.

Vous auriez un solution ?

[Taz]

Fine list verification failed, une idée ? Même avec GMPU ça ne fonctionne pas :/

[Kyrie Nissa]

Salut, quand je glisse le fichier dans gmad.exe, le cmd s'éxécute normal, pas de bug de whitelist. Mais je ne sais pas pourquoi, je n'ai pas mon fichier .gma.