Публикация аддона в Steam Workshop

Подробно о создании аддона и его публикации в воркшоп.

Начало

В этом гайде я покажу как выложить собственный аддон в Steam Workshop Garry's Mod'а. Это делать несложно, но и не слишком просто. Есть 2 способа публикации аддонов. Начнём с первого

Способ 1 (через GMPT)

Первым способом мы будем публиковать аддон через программу GMPT[sourceforge.net]. Для работы программы обязательно нужна Java! Скачать её можно здесь[www.java.com].
Извлекаем архив и открываем gmpu.jar. Программа автоматически обнаружит пути к GMOD.
Перед нами откроется программа:

Для начала, разберёмся с интерфейсом.
Mode - режимы самого GMPT.

• Create - создаёт и сразу выкладывает аддон.
  
• Create GMA - создаёт только файл аддона с расширением .gma.
  
• Update - обновляет уже опубликованный в Workshop аддон.
  
• Extract - распаковывает файлы .gma.

Addon List - список уже опубликованных вами аддонов или аддонов где вы являетесь автором.
File or Folder - путь к папке или файлу.
Icon: - путь к иконке.
Addon.json - поле с названием типом и тэгами аддона. Он содержит:

• Title - название аддона(появится в Workshop при публикации аддона).
  
• Type - тип аддона. Просто выбираете из типов чем является ваш аддон.
  
• Tags - тэги аддона. Максимально можно выбрать только 2 тэга на аддон!
  
• Ignore - список файлов, которые GMPT при публикации аддона будет игнорировать. Оставьте по умолчанию.

Changes - поле для ввода изменений. Нужен для Update.
GMA Output - путь, куда сохранять GMA файл. Нужен для Create GMA.
Extract - поле со следующими подпунктами:

• File - путь к .gma файлу
  
• Out - путь, куда сохранить распакованный контент из аддона.

Дальше там лишь Settings и Add To Queue.
Теперь, когда вы освоились с интерфейсом, можно приступать дальше.
Для начала, выберите режим Create. Потом откройте папку с вашим аддоном кнопкой Folder. Затем, загрузите иконку аддона кнопкой Load у Icon. Иконка должна быть в формате JPEG, размерами 512x512px и сохранена как Baseline JPEG(сохраните через Paint, если нет Photoshop). Далее, введите название вашего аддона, выберите тип и поставьте нужные вам теги к вашему аддону в Addon.json. Теперь нажмите Add To Queue. Это добавит аддон в очередь действий GMPT. Дальше нажмите Execute. Если всё прошло без ошибок в Log, то на странице Workshop у вас появится новый аддон. Вам останется лишь только добавить описание и включить показ для всех.

Если же вы хотите обновить уже существующий аддон, то:
Выберите в Mode режим Update. Выберите аддон, кликнув ЛКМ по нужному ID в Addon List. Выберите путь к аддону через Folder или File.
Затем. если хотите, обновите иконку через Icon и напишите в поле Changes изменения, которые добавит обновление. Теперь можете нажать Add To Queue и Execute. На этом весь первый способ.

Второй способ (через gmad и gmpublish)

Если у вас по какой-то причине проблемы с GMPU или же вы не хотите пользоваться лишним софтом, то аддон можно выложить при помощи инструментов самого Garry's Mod'a. Для этого нужно лишь обладать терпением и внимательно читать этот раздел. Для начала, вам нужно создать в папке вашего аддона файл и назвать его addon.json. Затем откройте его Блокнотом или Notepad++'ом и добавьте в него следующее:

 {
 	"title"		:	"My Server Content", 	
        "type"		:	"ServerContent",
	"tags"		:	[ "roleplay", "realism" ],
 	"ignore"	:
 	[
 		"*.psd",
		"*.vcproj",
		"*.svn*"
 	]
 }

"title" - это название аддона в Workshop,
"type" - тип аддона, список всех типов аддонов, обязательно учитывайте регистр!

"ServerContent" - контент сервера
"gamemode" - игровой режим(аля гейммод)
"map" - карта
"weapon" - оружие
"vehicle" - транспорт
"npc" - NPC
"tool" - Тул(Инструмент)
"effects" - Эффекты
"model" - Модели

"tags" - тэги аддона(максимум можно только 2). Список всех тэгов:

"fun"
"roleplay"
"scenic"
"movie"
"realism"
"cartoon"
"water"
"comic"
"build"

"ignore" - как и в GMPT, ignore позволяет игнорировать файлы. Сохраняем файл. Теперь нам нужно запаковать аддон в файл с расширением .gma. Для этого откройте корень Garry's Mod, откройте папку bin и перетащите Drag'n'Drop'ом папку с аддоном.
Теперь в папке addons рядом с папкой аддона появился файл с расширением .gma.Теперь нам нужно опубликовать сам аддон. Теперь вам нужно сделать иконку. Иконка должна быть в формате JPEG, размерами 512x512px. Обязательно сохраните иконку в JPEG Baseline(Базовый). Так же, вы можете в качестве иконки использовать .gif картинку. Обязательно назовите иконку так же как и .gma файл. Теперь переместите иконку и аддон в папку bin. Создайте .bat файл в папке bin и назовите его Upload Addon.bat.
Затем, добавьте следующее в файл и сохраните.

gmpublish.exe create -addon %~n1.gma -icon %~n1.jpg

Теперь переместите Drag'n'Drop'ом аддон с иконкой.

Поздравляем! Вы успешно опубликовали свой аддон! Рекомендую сначала проверить аддон на наличие в Workshop и в игре, а затем на странице аддона сделать его публичным
Если вы хотите обновить свой аддон, то ни в коем случае для обновления не удаляйте старый аддон, так как тем кто его скачал придётся на него заново подписываться в воркшопе!
Удобнее для обновления будет создать ещё один .bat файл с этим кодом своего сочинения:

@echo off
@echo Workshop Item ID:
set /p itemid= 
@echo Changes(Will be written in changes list):
set /p changes=
@echo Path to .gma file(including extension)
set /p gmafile=
@echo Path to .jpg icon(including extension)
set /p iconpath=
@echo on
gmpublish.exe update -addon "%gmafile%" -id "%itemid%" -changes "%changes%" -icon "%iconpath%"
pause

Сохраните его в папку bin.
Workshop Item ID - ID вашего аддона. Чтобы его достать, достаточно зайти на страницу вашего аддона в любом браузере и скопировать ID в адресной строке.К примеру: http://steamcommunity.com/sharedfiles/filedetails/?id=[ID].
Changes - изменения которые вы пишите для аддона в вашем обновлении.
Path to .gma file. - путь к вашему файлу .gma. Не забудьте дописать название файла и его расширение. Пример: C:/Program Files/Steam/SteamApps/common/GarrysMod/bin/myaddon.gma.
Path to icon - путь к иконке. Когда всё закончится, в браузере откроется ссылка с обновленным аддоном. Поздравляем, вы успешно обновили свой аддон!

Заключение

Спасибо за то, что прочитали мой гайд, надеюсь я вам помог. Только прежде чем загружать аддоны, прочитайте правила публикации аддонов GMOD. Гайд написал Alivebyte!.

[Виктор Корнеплод]

Я уже час жду проверки аддона, когда проверят блят?

[Alivebyte!]

Можно уменьшить размер гифки или сжать с помощью разных вебсайтов

[Domi Gamer]

Кто знает как опубликовать гифку как иконку аддона? Я пробовал и мнего говорят что моя гифка не должна весить больше одного мегабайта

[cotan]

Честно говоря я не знал что можно добавлять исключения для него, примного вам благодарен

[Alivebyte!]

Отключать полностью не стоит, попробуйте gmad.exe и gmpublish.exe добавить в исключения браундмауэра.

[Win Xp enjoyer あ!]

реально, стоило лишь отключить этот брандмауэр и как всё сразу заработало!

[cotan]

Всем у кого есть такие проблемы кстати советую попробовать отключить брандмауэр

[cotan]

Незнаю как у вас но у меня максимально смешная ситуация оказалась, что бы все заработало стоило лишь отключить брандмауэр, больше нет проблем

[Alivebyte!]

Возможно, вы неправильно запаковали аддон через gmad. Всё остальное должно работать

[Win Xp enjoyer あ!]

почему при публикации пишет "failed to upload workshop files to steam"
(сам аддон как бы есть, но он полностью пустой)