Контент в проектах

So, everything that can be moved with the help of our engine or somehow used in our project is considered content: characters, items, weapons, buildings, rooms, land and even the sky, as well as music, pictures, videos, all kinds of settings, texts, etc.Итак, все “движимое” при помощи нашего движка или так или иначе используемое в нашем проекте – это контент: персонажи, предметы, оружие, здания, помещения, земля и даже небо, а также музыка, картинки, видео, всевозможные настройки, тексты и т.п.

The unit of content in a project is an asset — a resource that can be used in your world or project. The resource can be obtained from a file created using some third-party software (3D model, audio file, image, etc.) or using UnigineEditor (node, material, lightmap, render settings, etc.).Единицей контента в проекте является ассет – ресурс, который можно использовать в вашем мире или проекте. Ресурс может быть получен из файла, созданного с использованием какого-либо стороннего ПО (3D-модель, аудиофайл, изображение и т.д.) или с помощью редактора UnigineEditor (нода, материал, карта освещения, настройки рендера, и др.).

Let's take a look at the main types of assets:Давайте рассмотрим основные типы ассетов:

• Geometry and animation (*.fbx, *.mesh, *.anim). Mesh is a basic unit that consists of a set of polygons and is used to create the object's geometry. Some meshes can be animated, and in addition to polygons they have: a set of associated bones (skeleton or rig) with a sequence of bone positions specifying the object motion, or a set of "deformed" versions of the object (morph targets or blend shapes) defining a smooth change in its shape over time.Геометрия и анимация (.fbx, .mesh, .anim). Меш (сетка) – это базовая единица, которая состоит из набора многоугольников и используется для создания геометрии объектов. Некоторые меши могут быть анимированы, вдобавок к полигонам они имеют: набор связанных с ними костей (скелет или rig) с последовательностью положений костей, задающей движение объекта, либо набор «деформированных» версий объекта (morph targets или blend shapes), задающих плавное изменение его формы во времени.

  

• Materials (*.mat, *.mgraph). Material defines how the surface to which it is assigned will look like — its interaction with light sources, reflection parameters, etc. The material asset is usually associated with several texture assets.Материалы (.mat, .mgraph). Материал определяет, как будет выглядеть поверхность, на которую он назначен: ее взаимодействие с источниками света, параметры отражения и т.д. Ассет материала обычно связан с несколькими текстурными ассетами.

• Textures (*.png, *.tga, *.hdri). These are images that are typically used in materials. When a material is assigned to a surface, textures are either projected onto it directly (albedo) or used as masks (for example, to define transparent areas), in addition pixel values of a texture can be used for other calculations. Textures can also be used, for example, to simulate the environment (cube maps that are projected onto the cube walls from the inside) or as light filters on projected light sources. Textures are usually created using a third-party image editing application such as GIMP or Photoshop and then imported through Asset Browser. Some textures, such as rendering textures, are generated by the UNIGINE engine. Usually certain data are taken from the scene and converted into a texture to be used elsewhere.Текстуры (.png, .tga, .hdri). Это изображения, которые обычно используются в материалах. Когда материал назначается на поверхность, текстуры либо проецируются на нее непосредственно (albedo), либо используются в качестве масок (например, определять прозрачные области), кроме того значения пикселей текстуры могут использоваться для других вычислений. Текстуры также можно использовать, например, для имитации окружающей среды (кубические карты, которые проецируются на стенки куба изнутри) или как светофильтры на источниках света типа прожектор. Текстуры обычно создаются с помощью внешнего приложения для редактирования изображений, такого как GIMP или Photoshop, а затем импортируются через Asset Browser. Некоторые текстуры, такие как текстуры рендеринга, генерируются движком UNIGINE. Обычно берется некоторая информация из сцены и преобразуется в текстуру, которая будет использоваться в другом месте.

  

• Sound files (*.mp3, *.oga). These assets define the setting and extent of immersion: background music, footstep sounds, wind noise, etc.Звуковые файлы (.mp3, .oga). Эти ассеты определяют атмосферу и глубину погружения: от фоновой музыки, до звуков шагов, шума ветра и т.д.
• Video files (*.ogv). These assets can be used as a cinematic between different stages of gameplay, or, for example, to simulate a working TV in a room.Видеофайлы (.ogv). Такие ассеты могут использоваться в качестве кинематографических заставок между различными этапами игрового процесса, или, например использоваться для имитации работающего телевизора в комнате.
• Presets (*.render, *.physics, ...). This type of assets can be used to configure worlds in the project (settings for rendering, gravity, sound speed, volume, etc.). Предустановки (.render, .physics,...). Этот тип ассетов можно использовать для конфигурации миров в проекте (настройки рендеринга, гравитации, скорости звука, громкости и т.д.).

In addition, there are many more types of assets — scenes/worlds (*.world), nodes or their hierarchies (*.node), fonts (*.ttf), landscape maps (*.lmap), and many other things you will get acquainted with while working with UNIGINE. Кроме этого есть еще множество типов ассетов – это и сцены/миры (*.world), и ноды или целые их иерархии (*.node), и шрифты (*.ttf), и карты ландшафта (*.lmap), и много чего еще, с чем вы познакомитесь в процессе работы с UNIGINE.

The Asset System is designed to unify file management within a project and make it simple and intuitive.Ассет-Система призвана унифицировать управление файлами в рамках проекта и сделать его простым и интуитивно понятным.

Each asset is represented by a pair: an asset file and a metadata file (*.meta, not displayed in the editor). The meta file stores auxiliary information and its GUID (globally unique identifier), which defines the path to the asset (i.e. its location in the project) and is used by the Asset System to store all links and dependencies between resources. Therefore, you don't have to worry that your material will lose a texture if you change its name or move it to a different folder.Каждый ассет представлен парой: файл ассета и файл метаданных (*.meta, в редакторе он не виден). В мета-файле хранится вспомогательная информация и его уникальный идентификатор GUID (globally unique identifier), который определяет путь к ассету (т.е. его расположение в проекте) и используется Ассет-Системой для сохранения всех связей и зависимостей между ресурсами. Поэтому, вам не нужно беспокоиться о том, что ваш материал потеряет текстуру, если изменится ее имя или вы переместите ее в другую папку.

Another important feature of the Asset System is real-time tracking of changes: the system registers the moment when changes are saved to a file (for example, when editing a texture in third-party software) and re-imports it if necessary.Еще одна важная особенность Ассет-Системы – отслеживание изменений в реальном времени, система зафиксирует момент сохранения изменений в файл (например, при редактировании текстуры в стороннем ПО) и при необходимости повторно импортирует его.

It is fine to work with assets in the Editor, but the Engine at runtime won't always use directly the asset files that we deal with in the Editor. The point is that the Engine doesn't know anything about the internal structure of most of them — it has its own specific limited set of file formats that it can work with (*.mesh, *.node, *.prop, *.texture), and doesn't know about other, third-party ones (*.fbx, *.3ds, *.psd).С ассетами хорошо и удобно работать в Редакторе, но Движок во время выполнения (или, как его еще называют, runtime) далеко не всегда использует непосредственно те самые файлы ассетов, с которыми мы имеем дело в Редакторе. Дело в том, что о внутренней структуре многих из них он (Движок) ничего не знает – у него есть свой конкретный ограниченный набор форматов файлов, с которыми он может работать (*.mesh, *.node, *.prop, *.texture), а про другие, сторонние, (*.fbx, *.3ds, *.psd) он вообще не в курсе.

For all such non-native files (e.g. *.fbx, *.obj, *.hdr, etc.), the Editor automatically generates corresponding files in its own format, which are used by the Engine at runtime. This operation is called import, and such files are called runtimes.Для всех таких “неродных” файлов (например, *.fbx, *.obj, *.hdr, и т.д.) Редактор автоматически генерирует соответствующие файлы в собственном формате, которые и будут использоваться Движком во время выполнения. Эта операция называется импорт, а такие файлы называются файлами времени выполнения (runtimes).

Thus, depending on the relationship between assets and the Engine, assets can be divided into two categories:Итак, по принципу отношения к Движку ассеты можно разделить на две категории:

• Native – files in UNIGINE's own native format, no runtime files are created for them. Such an asset is deemed and used as an executable file, and will be included in the final build of the application "as is".Нативные – файлы в собственном “родном” формате UNIGINE, для них runtime-файлы не создаются. Сам такой ассет будет рассматриваться и использоваться как исполняемый файл, а также будет включен в финальную сборку приложения «как есть».
• Non-Native – files in any third-party format, which have been created and originally used not in UNIGINE. For some of these assets, the Editor will generate corresponding runtime files in the data/.runtimes folder, and it's actually these files (not the asset itself) that will be included in the final build of the application.Ненативные – это файлы в каком-либо из сторонних форматов, придуманных и изначально использованных не в UNIGINE. Для некоторых из таких ассетов в папке data/.runtimes Редактор сгенерирует соответствующие runtime-файлы и именно они (а не сам ассет) и попадут в финальную сборку приложения.

The Container Asset is a special case of non-native asset — for such assets several runtime files are created (for example, the FBX asset can create *.node, *.mesh, *.mat, etc.).Частным случаем ненативного ассета является контейнер-ассет – для таких ассетов создается несколько runtime-файлов (например, FBX-ассет может создавать файлы *.node, *.mesh, *.mat и т.д.).

All assets are stored in the data folder of your project.Все ассеты хранятся в папке data вашего проекта.

As already mentioned, a texture asset can be used in a material asset, which in turn can be used by an object stored in a node asset, and an FBX asset container can create multiple files (mesh asset, material asset, etc.) when imported. These are all links between assets — a link means that an asset is either used as part of a more complex asset, or is itself made up of a number of assets. As already mentioned, assets are linked using GUIDs.Как мы говорили ранее, ассет текстуры может быть использован в ассете материала, который в свою очередь может использоваться объектом, сохраненным в node-ассет, а ассет-контейнер FBX при импорте может породить несколько файлов (mesh-ассет, ассет материала и т.д.). Все это связи между ассетами – связь означает, что ассет либо используется как часть более сложного ассета, либо сам состоит из ряда ассетов. Связываются ассеты, как мы уже говорили, при помощи GUID-ов.

To find out what connections an asset has, right-click on it in the Asset Browser and choose Show Assets Using This One or Show Assets Used from the context menu, and to find the runtime file created for the asset, choose Show Runtime in Explorer.Чтобы узнать, в каких связях участвует ассет, щелкните по нему в Asset Browser правой кнопкой мыши и выберите в контекстном меню, Show Assets Using This One или Show Assets Used, а чтобы найти runtime-файл, созданный для ассета – выберите Show Runtime in Explorer.

You can also use the assets_info and assets_list console commands to view information about assets and runtime files.Также для просмотра информации об ассетах и runtime-файлах можно использовать консольные команды assets_info и assets_list.

Not all content for your UNIGINE project can be created in UnigineEditor. Most assets are created using third-party digital content creation tools such as 3ds Max, Maya, Photoshop, and others. These are all non-native assets, which, as we mentioned earlier, must be imported before they can be used. For each of the imported asset types, the Editor will automatically offer you an appropriate set of customizable import settings that determine the appearance and behavior of the assets. These settings are displayed in the window that appears when you import an asset.Не весь контент для вашего проекта UNIGINE можно создать в UnigineEditor. Большинство ассетов создается с использованием сторонних инструментов создания цифрового контента, таких как 3ds Max, Maya, Photoshop и других. Все это ненативные ассеты, которые, как мы уже говорили ранее, должны пройти процедуру импорта прежде, чем их можно будет использовать. Для каждого из импортируемых типов ассетов Редактор автоматически предложит вам соответствующий набор настраиваемых параметров импорта, которые определяют внешний вид и поведение ассетов. Эти настройки отображаются в окне, которое появляется при импорте ассета.

For example, import settings for an image allow selecting the texture type, image format, size, etc. Import settings for an FBX file allow you to customize the scale, decide whether you will import materials and light sources or use animations available in the file. For some types of assets (for example, textures), you can specify whether to use it "as is" (e.g. HDR textures, so as to avoid quality loss during conversion) or to generate a runtime file for it.Например, настройки импорта для изображения позволят вам выбрать тип текстуры, формат изображения, размер и т.д. Настройки импорта для файла FBX позволяют настроить масштаб, решить, будете ли вы импортировать материалы и источники света или использовать анимацию, определенную в файле. Для некоторых типов ассетов (текстур, например) можно указать, использовать его «как есть» (например hdr-текстуру, чтобы не потерять качество при конвертировании) или сгенерировать для него runtime-файл.

If necessary, you can change the asset's import settings by selecting it in the Asset Browser and the available settings will appear in the Parameters window. After changing the import settings, click Apply to re-import the asset with the updated settings.При необходимости настройки импорта ассета можно изменить, для этого достаточно выбрать его в Asset Browser, и доступные настройки появятся в окне Parameters. После изменения настроек импорта нажмите Apply, чтобы повторно импортировать ассет с новыми настройками.

Preparing content for a game or another 3D application, unless it's a cube game, can be time-consuming and require additional knowledge and skills, and maybe more team members. Every engine has a community of developers who share their experience and ready-made resources, program code or content with each other, either for free or for money. UNIGINE has such a community and there is a marketplace — Add-On Store, where you can search for ready resources for your projects before you start making them yourself, it can save time and money, even taking into account the fact that some of the content on the marketplace is paid. That's what we're going to overview. Подготовка контента для игры или другого 3D-приложения, если это конечно не кубики, может занимать немало времени и потребовать дополнительных знаний и умений, а возможно и дополнительных членов в команду. У каждого движка есть сообщество разработчиков, которые делятся друг с другом опытом, а нередко и готовыми ресурсами, программным кодом или контентом, бесплатно или за деньги. Есть такое сообщество и у UNIGINE и есть площадка – Add-On Store, на которой стоит поискать готовые ресурсы для своих проектов прежде чем начинать делать их самостоятельно, это может сэкономить время и деньги, даже с учетом того, что часть контента на маркетплейсе платная. С ним мы и познакомимся.

Add-On Store as a source of ready-made assets

Add-On Store, как источник готовых ассетов#

How do I find what I need?

Как найти то, что нужно?#

Adding add-on content to a project

Добавление содержимого дополнения в проект#

Naturally, Add-On Store may not offer everything you need, so you are likely to deal with some modeling, texture creation, sound recording, and so on. We've compiled for you a list of third-party software and resource libraries that could prove useful.В Add-On Store, конечно, есть не все, поэтому вполне вероятно, что вам все же придется заняться моделированием, созданием текстур, звукозаписью и так далее. Ниже мы собрали для вас список стороннего программного обеспечения и библиотек ресурсов, который может быть полезным в этом нелегком деле.

Tools

Инструменты#

Assets for your projects:

Ассеты для ваших проектов:#