Ru/Source 2/Docs/Porting Legacy Content/Models

Welcome to the

Valve Developer Community

13,093 articles documenting the development process.

Sign up to become part of the community!

Whether you're building a commercial project or a modification for Half-Life® 2, you'll want to sign up as a Valve developer today. It's free to join and is open to anyone working with the Source engine and its software development kit.

 GoldSrc and the Half-Life SDK 

If you want to create a Mod for Half-Life or looking for more GoldSrc documentation, click above.

 Source and the Source SDK 

If you want to create a Source SDK Base mod, or content-based mod for Half-Life 2, Team Fortress 2 or looking for more Source documentation, click above.

 Source 2 Documentation 

If you want to port Source content to Source 2, create a content-based mod for Source 2 games or looking for more Source 2 documentation, click above. Otherwise, you can check out the following Source 2 games with Workshop Tools:

• Dota 2 Workshop Tools 

• SteamVR Workshop Tools 

• Half-Life: Alyx Workshop Tools 

• Counter-Strike 2 Workshop Tools 

The engine under the hood of Half-Life 2 can make your game a success. Let Source™ do the heavy lifting so that your team can focus on building great games.

---

If you're interested in building a product using Source or Source 2, talk to us about options for distribution on Steam.

Read about Valve Technology 

For Mod Teams

• Source Engine Features
• Why choose the Source engine for your mod?
• Read Making a Mod - building a team through the shipping process.
• Already using the SDK? Check the Source SDK FAQ for some helpful answers.
• New to Source coding? Get started with basic programming articles.
• Read (or add) a tutorial on Source development, or any part of the content creation process.

New to the wiki?

For help with using the wiki, see Help:Contents. For help with navigating the wiki, see Category:Entry pages or Category:Valve Developer Community. For more information on the community itself, see Community Portal.

Wiki Contents 

Community Portal 

© 2005–2025 Valve Corporation. All rights reserved. All trademarks are property of their respective owners in the US and other countries. See the Terms of Use for details
About Valve Developer Community · Privacy Policy · Third Party Legal Notices

Welcome to the

Valve Developer Community

13,093 articles documenting the development process.

Sign up to become part of the community!

Whether you're building a commercial project or a modification for Half-Life® 2, you'll want to sign up as a Valve developer today. It's free to join and is open to anyone working with the Source engine and its software development kit.

 GoldSrc and the Half-Life SDK 

If you want to create a Mod for Half-Life or looking for more GoldSrc documentation, click above.

 Source and the Source SDK 

If you want to create a Source SDK Base mod, or content-based mod for Half-Life 2, Team Fortress 2 or looking for more Source documentation, click above.

 Source 2 Documentation 

If you want to port Source content to Source 2, create a content-based mod for Source 2 games or looking for more Source 2 documentation, click above. Otherwise, you can check out the following Source 2 games with Workshop Tools:

• Dota 2 Workshop Tools 

• SteamVR Workshop Tools 

• Half-Life: Alyx Workshop Tools 

• Counter-Strike 2 Workshop Tools 

The engine under the hood of Half-Life 2 can make your game a success. Let Source™ do the heavy lifting so that your team can focus on building great games.

---

If you're interested in building a product using Source or Source 2, talk to us about options for distribution on Steam.

Read about Valve Technology 

For Mod Teams

• Source Engine Features
• Why choose the Source engine for your mod?
• Read Making a Mod - building a team through the shipping process.
• Already using the SDK? Check the Source SDK FAQ for some helpful answers.
• New to Source coding? Get started with basic programming articles.
• Read (or add) a tutorial on Source development, or any part of the content creation process.

New to the wiki?

For help with using the wiki, see Help:Contents. For help with navigating the wiki, see Category:Entry pages or Category:Valve Developer Community. For more information on the community itself, see Community Portal.

Wiki Contents 

Community Portal 

© 2005–2025 Valve Corporation. All rights reserved. All trademarks are property of their respective owners in the US and other countries. See the Terms of Use for details
About Valve Developer Community · Privacy Policy · Third Party Legal Notices

Source 2 имеет встроенную систему для извлечения старых файлов .mdl из Source 1 и преобразования их в Source 2. Вы применить эту возможность для конвертации файлов при отсутствии исходников, но вместе с этим имеются некоторые проблемы.

Примечание:Модели, имеющие свойство деформации (например, персонажи), нуждаются в дополнительной работе, чтобы сделать их функциональными в Source 2, и в большинстве случаев потребуется наличие исходников.

Предпосылки (Prerequisites)

Эта система очень требовательна к тому, какие версии .mdl импортируются. В настоящее время Source Filmmaker до сих пор является наиболее успешным местом для портирования моделей, что может быть полезным, поскольку SFM уже поставляется с контентом из множества игр. Тем не менее, Half-Life 2 и Left 4 Dead 2, среди прочих, были протестированы и несовместимы, но, к счастью, Valve уже портировала много контента из этих игр.

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

Создание .vmdl файла

Для конвертации .mdl файла, вы, сперва, должны создать структуру для вашего контента. Допустим, что я конвертирую модель из Half-Life 2, пусть это будет "models/humans/group01/male_07.mdl" для использования в Half-Life: Alyx. Чтобы сделать это, нужно установить инструменты и папку с контентом для мода, для которого вы пытаетесь скомпилировать эти модели. В этом случае у меня есть папка hl2 в папках content и game, которые находятся по пути "steamapps/content/Half-Life Alyx".

Затем переместите ваш .mdl и соответствующие ему файлы в ту же файловую структуру, что и в Source 1. Так, например, мои файлы модели male_07 теперь будут в Half-Life Alyx/content/hl2/models/humans/group01/male_07.mdl.

Наконец, создаёте новый файл .vmdl с именем необходимой для переноса модели (в нашем случае, male_07.vmdl). Откройте его в вашем любимом текстовом редакторе и добавьте в него следующий код. Закройте файл и затем откройте Source 2 Tools. Стоит отметить, что путь всегда должен соответствовать пути расположения вашей модели. В нашем случае это:

<!-- kv3 encoding:text:version{e21c7f3c-8a33-41c5-9977-a76d3a32aa0d} format:generic:version{7412167c-06e9-4698-aff2-e63eb59037e7} -->
{
	m_sMDLFilename = "models/humans/group01/male_07.mdl"
}

После этого вы можете открыть файл .vmdl и он автоматически будет скомпилирован в файл .vmdl_c!

Осталась только создать файлы материалов, которые должны иметь одинаковые имена и файловую структуру подобно .vmt файлам в Source 1. Так, например, я хотел бы создать citizen_sheet.vmat в следующей файловой структуре: materials/models/humans/male/group01/citizen_sheet.vmat

Примечание:Вам не нужно делать это, если вы используете '-nocustomermachine' в качестве параметра запуска. Это позволит вам изменить строку m_sMDLFilename в Редактор моделей.

Half-Life: Alyx и ModelDoc

Half-Life Alyx представила новый редактор моделей под названием ModelDoc. ModelDoc предоставляет нам гораздо более широкий спектр возможностей наших моделей и предоставляет доступ к специальным инструментам, недоступным в старом редакторе моделей.

С ModelDoc вы можете импортировать старый файл .vmdl щелкнув Файл > Импорт > Импортировать и конвертировать старый .VMDL. Когда вы сделаете это, модель фактически обработает все свои исходники (используя ранее скомпилированный файл .VMDL_C) и выдаст некоторые FBX-файлы, с которыми вы можете возиться. Затем у вас будет возможность удалить старый файл .mdl, так как он станет ненужным.

Это идеально, если вы хотите внести изменения, чтобы облегчить переход вашей модели на Source 2. В настоящее время не существует известного способа пакетной обработки всех файлов .VMDL в игре, но вы можете использовать этот инструмент для устранения проблем с импортером..

Поиск проблемы (Troubleshooting)

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

Некоторые более сложные модели будут вызывать как случайные сбои, так сбои в системе и не будут правильно импортироваться. На данный момент мало что можно сделать, решить такие проблемы, но если взглянуть на VConsole (Альтернатива старой консоли в Source 1), это поможет понять, в чем дело.

Нужно сделать: Обратите внимание на другие проблемы и проверьте совместимость с другими играми.

Дополнительно

Для более удобного импорта множества моделей и материалов можете воспользоваться любительским конвертером. Для конвертации ".vmt" в ".vmat", запустите соответствующий конвертер и таким же образом вставьте адрес до нужных материалов. Внимание: для корректной работы нужно изначально иметь в той же папке .tga файлы текстур материалов. Это можно сделать быстро через программу VTFEdit - VTFEdit > Tools > Convert Folder. Также стоить отметить, что конвертация моделей таким способом может вызывать проблемы их отображения. Например, модель может не отображаться непосредственно в игре, нежели в режиме инструментария. Решается это путём переконвертации уже через ModelDoc в самих инструментах Мастерской Steam.

Смотрите также

• MDL
• VMDL
• Model Editor
• ModelDoc