Не партнёр

Главная Документация и помощь
Документация Steamworks
Мастерская Steam

Введение

Мастерская Steam задумана служить местом, где ваши фанаты и участники сообщества могут поучаствовать в создании контента для вашей игры. Создание контента может принимать различные формы в зависимости от игры и степени контроля, который вы хотите осуществлять над содержанием вашей игры.

На этой странице вы найдёте обзор информации о Мастерской Steam и различных её моделях. Подробную техническую информацию об интеграции Мастерской Steam с вашей игрой читайте в разделе Руководство по Мастерской Steam.

Видео: знакомство с пользовательским контентом и Мастерской Steam.

https://www.youtube.com/watch?v=SRyUpR4qOxU

Видео: пользовательский контент и Мастерская в игре ARK: Survival Evolved

Презентация Джереми Стиглица из Studio Wildcard на Steam Dev Days 2016 г. о том, как создание пользовательского контента в Мастерской Steam способствовало развитию активного сообщества игры ARK: Survival Evolved, а также обсуждение технических и художественных средств, предпринятых для достижения этой цели:
https://www.youtube.com/watch?v=faweKXUTKgQ

Руководство по фирменному стилю Мастерской Steam

Вы можете воспользоваться фирменным стилем Мастерской при продвижении своей Мастерской. Нажмите сюда, чтобы скачать ресурсы по фирменному стилю Мастерской. Дополнительную информацию по общему фирменному стилю Steam смотрите в разделе Руководство по фирменному стилю Steam.

Типы Мастерской

Существует два основных типа Мастерской Steam, доступных для интеграции. Каждый из них имеет свои плюсы и минусы, поэтому тщательно обдумайте, какой из них вам больше подойдёт.
  1. Открытая Мастерская - любой пользователь может свободно загружать и скачивать контент. Это наиболее оптимальный способ поддержки большого числа простых или сложных по составу предметов, модификаций или карт в игре. Он упростит процесс проверки предметов, однако более вероятно, что вам придётся больше потрудиться заранее, чтобы создать соответствующий редактор или инструмент проверки, чтобы удостовериться в безупречном функционировании авторского контента. Авторы предметов смогут обновить свой контент в любое время. Если вы разрешите продажу предметов, вы сможете либо установить контроль над тем, какие из предметов можно продавать, либо сделать доступным выставление их на продажу самими авторами. Авторы установят цену предмета, а продажа состоится напрямую через Мастерскую Steam.

  2. Модерируемая Мастерская - наиболее оптимальный способ поддержания более строгого контроля над добавленными в игру предметами. Однако следует учитывать, что каждый раз при добавлении нового предмета от вас потребуется произвести обновление. Этот способ лучше приспособлен для контента меньшего размера и упрощённой структуры: оружий, шляп и других аксессуаров. При продаже предметов должна использоваться служба инвентаря для отслеживания игроков с разрешением использовать предметы в игре. Также необходимо создать магазин для внутриигровых продаж. Установка цен будет под контролем разработчика.

Открытая Мастерская

Причины для использования

  • Поддержка большего числа предметов. Открытая Мастерская упрощает поддержку большого числа простых или сложных по составу предметов, модификаций или карт в игре. Заранее обеспечив инструменты по созданию и редактированию предметов, вы будете поощрять творческую активность пользователей по отношению к вашей игре.
  • Возможность обновлять контент в любое время. Авторы предметов в открытой Мастерской смогут обновлять свои предметы, то есть: редактировать контент, исправлять ошибки, расширять контент и возможности своих модификаций и предметов.

С чего начать

Для начала следует подумать, какой контент могут создать пользователи для расширения возможностей вашей игры. Контент, необходимый для многопользовательских игр, отличается от предметов однопользовательской игры. После того, как вы это определили, потребуется обдумать, как произойдёт загрузка контента вашим клиентом и какие инструменты понадобятся пользователям для создания контента. Если пользователям пришлась по душе ваша игра, они найдут пути для создания контента для неё. Однако как упоминалось ранее, если вы хотите поддерживать создание крупномасштабных модификаций вашей игры, будет целесообразным выпустить как можно больше своих собственных инструментов, чтобы помочь пользователям в создании специфического контента и модификаций вашей игры.

После установки и запуска базовых механизмов создания модификаций вам понадобится интегрировать API ISteamUGC, чтобы ваш клиент распознавал, на какие из файлов Мастерской подписан пользователь, и мог скачивать контент по необходимости. После этого будет легко добавить опцию продажи предметов. Мастерская Steam будет ответственна за сбор банковской и налоговой информации авторов, обеспечение инструментов для указания цены и необходимых пользовательских соглашений, а также позаботится об обработке платежей и удержании налогов на внутреннем сервере. Вашей игре лишь понадобится распознать, какие из файлов нужно загрузить в клиент игры.

Процесс интеграции

Ниже приведены типичные компоненты, которые следует учитывать при интеграции открытой Мастерской с вашей игрой:
  • Загрузка контента в клиент однопользовательской игры. Если вы хотите, чтобы созданный пользователями контент был готов к использованию в игре, вам понадобится организовать вашу игру для соответствующей обработки контента. Обычно это означает, что игре понадобится проверять, какие из файлов следует загружать. Если вы работаете над внедрением нового элемента, рекомендуется, чтобы клиент игры сначала проверил список файлов, на которые подписан пользователь Steam, а затем загрузил соответствующие папки. Вам также понадобится определённая тестовая среда, в которой создатели модификаций смогут работать над их совершенствованием и загружать файлы из соответствующей папки.
  • Загрузка контента в клиент многопользовательской игры. Предметы или контент, необходимые для бесперебойного функционирования игры нескольких пользователей, можно скачать на все нужные клиенты. Например, если игрок подписался на пользовательскую карту в Мастерской, а затем пригласил друзей на матч, ваша игра должна распознать пользовательскую карту и скачать контент из Мастерской для использования другими игроками перед началом игры.
  • Загрузка контента его авторами. Вам понадобится инструмент, чтобы авторы могли загружать созданный контент в вашу Мастерскую, используя API ISteamUGC. Он может представлять собой либо часть вашей игры, либо отдельное приложение. Поскольку предметы, созданные для вашей Мастерской, должны быть готовы к немедленному использованию, ваш инструментарий должен пропускать файлы только в формате, который клиент игры готов загрузить вместе с изображением для предпросмотра. В зависимости от контента, который вы просите авторов загрузить в Мастерскую, вам, возможно, понадобится собственный инструментарий (особенно в случае таких крупномасштабных модификаций игры, как изменение её логики, процессов и всего того, что выходит за пределы модификации лишь внешнего вида). К примеру, игры, более всего подходящие для модификаций, выпустили свои собственные инструменты, чтобы авторы могли воспользоваться теми же средствами, что и разработчик. Подобные инструменты также могут проверять и подтверждать созданный контент, если вы хотите сохранять контроль над перезаписью файлов или списком доступных для изменения элементов игры. В качестве информации, предоставляемой потенциальным создателям предметов Мастерской, рекомендуется создать руководство по стилю, а также сводку правил относительно того, какой контент вы хотели бы видеть в своей игре, а какой считаете недопустимым.

    Обратитесь к разделу Руководство по Мастерской Steam за подробной информацией о том, как приступить к использованию материала по Мастерской Steam в разделе Steamworks API.

Доставка предметов пользователям

Предметы, размещённые в открытой Мастерской, автоматически доступны для подписки (если бесплатные) или покупки (если платные) и автоматического скачивания через клиент Steam (интеграция API ISteamUGC с вашим продуктом необходима для того, чтобы это сработало. Обратитесь к технической документации в разделе doclink=features/workshop/implementation][/doclink]). Мастерская Steam выполняет обновление клиента до последних версий модификаций. При покупке модификации Steam занимается обработкой покупки, оплаты, выплат авторам и разработчику, а также удержания всех необходимых налогов.

По желанию вы можете создать внутриигровой браузер Мастерской для выставления списка предметов.

Модерируемая Мастерская

Характерная особенность модерируемой Мастерской Steam состоит в том, что вам как разработчику необходимо подтверждать каждый предмет, на что вам может понадобиться сервер предметов (или служба инвентаря Steam) для управления правами владения предметами. Подобный тип Мастерской предоставляет значительный контроль над предметами, создаваемыми для вашей игры, однако требует от вас дополнительных действий для подтверждения каждого нового предмета.

Выставленные в модерируемой Мастерской предметы недоступны для использования напрямую в Мастерской. Вместо этого пользователям предоставляется список предметов для голосования. Голосование позволит определить, какие предметы наиболее востребованы пользователями, и исключить незаконченные или неуместные предметы.

Причины для использования

Модерируемая Мастерская подходит вашей игре, если вы:
  • испытываете необходимость определения особых характеристик для каждого предмета. Если вы принимаете оружие через Мастерскую, для вас, вероятно, важно назначить такие характеристики, как скорость, мощность, урон и скорость перезарядки, чтобы наилучшим образом уравновесить игровой процесс.
  • хотите строго контролировать контент, создаваемый для вашей игры. В зависимости от настроек игры вы сможете принимать предметы двумя различными способами:
    • Загрузка и сборка. Можно загрузить ресурсы на свой компьютер и добавить контент в хранилища игры. Этот способ предоставляет вам возможность редактировать и изменять предмет, чтобы обеспечить наилучший результат, или гарантировать строгое следование правилам руководства по стилю для каждого предмета.
    • Загрузка напрямую в клиент. Можно по необходимости напрямую скачать каждый подтверждённый предмет в клиенты игры. Это позволит авторам обновлять предметы, чтобы исправить ошибки.

С чего начать

Вы можете немедленно приступить к работе и настроить страницу модерируемой Мастерской, добавив простую форму в игре и опубликовав рекомендации и информацию по фирменному стилю для потенциальных создателей предметов. Для загрузки контента в Мастерскую вам понадобится интеграция с API ISteamUGC (см. Руководство по Мастерской Steam). Это позволит авторам предметов начать разработку идей и публиковать свои предметы в Мастерской для оценки сообществом. Как правило, рекомендуется, чтобы авторы публиковали в Мастерской законченные продукты. Если вы разрешите публикацию незаконченных проектов или идей, тогда вам понадобится продумать процесс превращения идей в реальные предметы, что чаще всего сложно масштабировать.

После подготовки и запуска Мастерской рекомендуется начать работу над интеграцией API микроплатежей Steam и службой инвентаря Steam в ожидании предстоящих продаж подтверждённых предметов. Когда магазин будет готов начать продажи, вы сможете приступить к утверждению предметов, установке правил выплат и продаже предметов.

Процесс интеграции

Ниже приведены типичные компоненты, которые следует рассмотреть при интеграции модерируемой Мастерской с вашей игрой:
  • Загрузка контента от авторов. Вам понадобится инструмент, чтобы авторы могли загружать созданный контент в вашу Мастерскую. Он может представлять собой либо часть вашей игры, либо отдельное приложение. Можно начать с простого загрузчика, который требует от автора выбрать .zip-файл и изображение для предпросмотра, или интегрировать дополнительные механизмы проверки в систему публикации в вашей Мастерской. Например, Мастерская Team Fortress 2 начинала лишь с формы заявки, требующей от автора предмета выбрать .zip-файл и изображение для предпросмотра. По мере развития процесса мы добавили тестовую среду и проверку, чтобы убедиться, что предоставленный файл будет легко интегрировать в игру.
    В качестве информации, предоставляемой потенциальным создателям предметов Мастерской, рекомендуется создать руководство по стилю, а также сводку правил относительно того, какой контент вы хотели бы видеть в своей игре, а какой — нет.
    После загрузки автором предмета в Мастерскую рекомендуется направить пользователя на страницу предмета, который он только что опубликовал. Это даст автору возможность принять условия всех соглашений, которые он ещё не принял: соглашение подписчика Steam или соглашение Мастерской.
  • Интеграция предмета в игру (необязательно). Если вам необходимо назначить особые характеристики, например, эффекты оружия или всё остальное, что не может назначить автор во время загрузки, вам понадобится скачать предмет с сайта Мастерской и добавить контент в свои хранилища. Одновременно вам потребуется назначить соответствующие характеристики и внести нужные изменения. Объём работы на данном этапе будет зависеть от того, насколько тщательная проверка проводится вашим инструментарием, а также от качества контента, создаваемого авторами предметов.
  • Загрузка без проверки. Если нет необходимости редактировать предметы или назначать особые характеристики, вы можете запросить получение предметов напрямую из серверов данных Мастерской. Для получения списка предметов, которыми обладает пользователь, необходимо применить ISteamInventory (при использовании службы инвентаря Steam). Проверьте, являются ли предметы во владении пользователя предметами Мастерской, а затем:
    • Вызовите ISteamUGC::GetItemState с параметром ID предмета Мастерской и проверьте, является ли функция k_EItemStateNeedsUpdate установленной, а функция k_EItemStateInstalled — неустановленной;
    • Вызовите ISteamUGC::DownloadItem при необходимости;
    • Дождитесь обратного вызова ISteamUGC::DownloadItemResult_t и сделайте контент доступным в игре.
  • Служба инвентаря и создание определений предметов. Eсли ваши предметы предназначены для продажи в игре или выдачи ограниченному числу пользователей, вам понадобится сервер предметов (или служба инвентаря Steam) для отслеживания игроков с разрешением использовать предметы в игре. Служба инвентаря также понадобится для продажи предметов, управления их выдачей и событиями, вызывающими случайную выдачу предметов пользователям.
  • Установка правил о выплатах. Когда вы будете готовы к продаже предметов, Steam понадобится информация о том, какие предметы Мастерской соотносятся с определениями предметов на вашем сервере предметов или в службе инвентаря Steam. Эта ссылка устанавливает правила выплат, чтобы Steam правильно распределил выручку от продажи каждого предмета соответствующим пользователям. Когда ваша служба инвентаря будет инициировать продажу через API микротранзакций Steam, Steam получит информацию о проданном предмете и сможет рассчитать сумму выручки и выплат авторам предмета.

    Управлять правилами выплат можно с помощью опции «Новые правила выплат» под вкладкой Мастерской на странице настроек вашего приложения.

  • Продажа предметов. Если вы планируете завести магазин для продажи предметов, вы можете создать интерфейс магазина самостоятельно или использовать магазин предметов Steam. При каждой покупке Steam будет выполнять следующее:
    • Собирать и хранить банковскую и налоговую информацию о каждом авторе предметов Мастерской;
    • Производить расчёт и соответствующие выплаты авторам предметов;
    • Удерживать подоходный налог с выручки авторов предметов;
    • Предоставлять годовые налоговые отчёты каждому автору предметов.

Доставка предметов пользователям

При использовании модели модерируемой Мастерской существует несколько способов обеспечить пользователям доступ к предметам:
  • Продажа предметов во внутриигровом магазине посредством микротранзакций. Если вы используете собственную службу инвентаря, от вас потребуется интеграция с API микротранзакций Steam. Также вы можете воспользоваться службой инвентаря Steam с настраиваемым магазином предметов, чтобы с лёгкостью выставлять и продавать предметы.
  • Случайная выдача предметов. Потребуется сервер предметов (или служба инвентаря Steam) для того, чтобы управлять выдачей предметов и вести учёт списка владельцев каждого предмета.
  • Набор дополнительного контента. Данное решение не требует использования сложной всеобъемлющей системы, однако вам придётся самому договориться об условиях выплат с авторами предметов Мастерской. Для каждого предмета, проданного как целое или часть дополнительного контента, вам потребуется самому договориться с автором предмета об оплате (либо единовременной выплате (проще), либо долгосрочной выплате процента авторских отчислений (дополнительная работа для вас). Вам также понадобится вести учёт об этих выплатах, рассчитать ставку удержания налогов и предоставить необходимые налоговые формы в зависимости от места проведения вашей коммерческой деятельности.
  • Предметы, добавленные в игру для бесплатного пользования. Данная опция содержит минимальные требования, однако вряд ли вдохновит авторов на создание предметов высокого художественного качества.

Объявление и выпуск

Материалы, необходимые для продвижения

Для подготовки Мастерской к выпуску вам будет необходимо предоставить следующее:
  • Основное изображение Мастерской. Это изображение предназначено для того, чтобы придать узнаваемость главной странице продукта. Шаблон Photoshop можно найти здесь. При создании изображения используйте узнаваемые иллюстрации и логотип игры. Оставьте свободное место справа для названия и краткого описания того, как ваш продукт использует Мастерскую Steam.
  • Краткое описание. Укажите название и краткое описание того, как ваше приложение использует Мастерскую Steam. Это поможет пользователям понять, какие инструменты они смогут найти в вашей Мастерской и как они смогут ими воспользоваться.
  • Документация для ваших инструментов. Если на вашем веб-сайте или вики-странице уже есть документация с инструкциями по использованию инструментов Мастерской, укажите ссылку на странице управления данными Мастерской вашего приложения.

Объявление о выпуске и его сроки

При публикации интеграции вашей Мастерской существует отличная возможность установить недельную скидку на ваш продукт, чтобы извлечь выгоду из дополнительного освещения, вызванного её появлением, и привлечь интерес большой группы пользователей к вашей игре и использованию Мастерской. Вы можете установить особую скидку в связи с выпуском Мастерской. Чтобы узнать больше, обратитесь к разделу документации Предоставление скидок.

Кроме того, можно использовать цикл показов обновлений для отображения вашей игры на главной странице и продвижения вашей новой Мастерской и распродажи (в случае предоставления вами скидок). Чтобы узнать больше о циклах показов, обратитесь к разделу документации Показы продукта в Steam.

Широкое объявление о Мастерской служит подходящим инструментом по продвижению, поэтому существование какого-либо контента, уже доступного в Мастерской для вашей игры, может оказаться полезным для пользователей. Оно предоставит новым пользователям более глубокое понимание вашей игры, а также продемонстрирует активную и заинтересованную основную базу пользователей. Опытным пользователям, таким образом, предоставляется возможность незамедлительных действий, а создатели контента могут открыть для себя новые возможности инструментария вашей Мастерской. По крайней мере один предмет должен быть опубликован в Мастерской, чтобы появиться в списке на главной странице магазина Steam.

Существует два способа это сделать:
  1. Существует возможность использования закрытого бета-тестирования, пригласив ограниченное число пользователей, чтобы создать контент негласно до выпуска. Дополнительную информацию об использовании бета-тестирования можно найти в рубрике ниже.
  2. Вы также можете создать несколько предметов во внутреннем режиме, чтобы продемонстрировать возможности вашего инструментария Мастерской.

Использование закрытого бета-тестирования

Steam и Мастерская Steam облегчают использование закрытого бета-тестирования, чтобы позволить группе тестировщиков на раннем этапе воспользоваться вашими новыми инструментами и испытать интеграцию с Мастерской. Это отличный способ проследить процесс создания контента и его опубликования, а также возможного выпуска Мастерской, содержащей набор готовых предметов, доступных для поклонников вашей игры.

Процедура бета-тестирования состоит из двух частей:
  1. Бета-версия вашей игры (посредством Steam) - для начала необходимо создать обновлённую сборку вашей игры и настроить её в качестве бета-версии в Steam. Это позволяет Steam предоставить отдельную версию вашей игры, которую смогут выбрать пользователи для тестирования, а также по желанию защитить её паролем.
  2. Бета-версия вашей Мастерской (посредством группы) - существует возможность создать закрытую группу в сообществе Steam и обеспечить доступ к Мастерской Steam только участникам этой группы. Также существует возможность открыть доступ всем пользователям, владеющим вашим приложением.
    1. Создайте группу сообщества Steam в целях тестирования. Рекомендуется создать закрытую группу, если вы хотите предоставить доступ только избранным пользователям.
    2. Получите Steam ID группы. На странице группы нажмите «Редактировать профиль группы» и найдите ID группы вверху страницы (например: 2667495)
    3. На странице управления вашей игрой в Steamworks в разделе «Общие» под вкладкой «Мастерская» введите этот номер ID в поле под заголовком «Ввести номер группы пользователя Steam». Опубликуйте изменения.

Teхническая реализация

Подробную техническую информацию об интеграции Мастерской Steam с вашей игрой читайте в разделе Руководство по Мастерской Steam.