[C++, Разработка игр] Source Modding — Часть 1 — Основы основ
Автор
Сообщение
news_bot ®
Стаж: 6 лет 9 месяцев
Сообщений: 27286
В мире существует множество игровых движков, но нет ни одного движка, похожего на Source своей историей и особенностями.
В этом (пилотном) уроке мы разберем простейшие действия с исходными кодами SDK, а также внесем наше первое изменение в код Half-Life 2.
Вступление
Немножко терминов
Сам по себе Source SDK — набор утилит и программ, помогающих в разработке собственных уровней и модификаций для игры, а также исходные коды Half-Life 2 и эпизодов.
Игра/Мод (Для сурса нет никакой разницы, игра это или мод :p) — скомпилированные исходные коды SDK.
Так почему же именно Source?!
- Модульность. Это может показаться минусом для некоторых, но почти все подсистемы движка вынесены в отдельные модули, каждый из которых может быть заменен без пересборки всего движка.
- Чрезвычайная гибкость. При достаточном количестве усилий вы можете сделать на Source игру абсолютно любого жанра.
- Движок и SDK разрабатывались огромным количеством людей, поэтому код SDK (а также утекший в сеть три раза код движка разных версий, но об этом позже ( ͡° ͜ʖ ͡°) ) состоит из множества разных стилей программирования! Я почти уверен, что именно работа с Source SDK подарила мне умение (но не желание...) читать чужой код.
- Порог вхождения. Он не слишком низок и не слишком высок. Достаточно знать C++ и уметь вчитываться в документацию!
- К моменту появления идеи о написании туториала у автора попросту не было новой версии юнити.
Что нам необходимо?
- Ну прежде всего хотя бы базовые знания C++ (Достаточно знать его на уровне Си с классами).
- Любая Microsoft Visual Studio с Multibyte MFC Library и Microsoft Build Tools 2013 (v120/v120_xp). Чтобы не морочить себе голову, можно просто установить VS2013.
- Git for Windows или любой другой.
- Steam с установленным Source SDK Base 2013 [Single|Multi]player (также необходимо в свойствах "игры" установить бета-версию upstream, иначе мод будет падать)
- В будущем также знание HLSL, но не сейчас :)
Введение в сурс дела
Репозиторий
Исходный код SDK находится в репозитории на GitHub. Склонируйте его в любое удобное для вас место:
git clone https://github.com/ValveSoftware/source-sdk-2013.git
Выбор ветки
Если вы хотите написать свой первый мод для Half-Life 2/Episode 1/2, то используйте директорию sp/ и Source SDK Base 2013 Singleplayer.
Если же вы извращенец и хотите написать свой первый мод для Half-Life 2: Deathmatch, то используйте директорию mp/ и Source SDK Base 2013 Multiplayer.
ВАЖНО: Туториал будет рассматривать программирование под ветку SP, поэтому пути, содержащие hl2 в пересчете на MP могут содержать hl2mp вместо hl2!!!
Стиль кода
Клиентские (client.dll) классы именуются с префиксом C_, а серверные (server.dll) — с префиксом C:
// client.dll
class C_BaseWeapon { ... };
// server.dll
class CBaseWeapon { ... };
Поля класса именуются с префиксом m_, использование венгерской нотации рекомендуется (на то есть свои причины, которые здесь обсуждать нет смысла):
class C_SomeClientClass {
private:
float m_flTime = 0.0;
};
extern float g_flSomeFloat;
static float s_flSomeStaticFloat;
void SomeFunction(float flValue);
Структура кода
SDK, также как и движок, разделён на несколько частей. Вот список проектов, сгенерированных при помощи creategameprojects:
- client.dll
Клиентская часть игры.
Отвечает за рендеринг, предсказания и ввод.
Расположена: src/game/client/
- server.dll
Серверная часть игры.
Отвечает за игровую логику, ИИ и т.д.
Расположена: src/game/server/
- tier1.lib
Библиотека, содержащая в себе множество полезных фич, например UTL ("валвовская" версия STL), interface convention и т.д.
Расположена: src/tier1/
- raytrace.lib
Библиотека, внезапно содержащая в себе функции и типы, предназначенные для рейтрейсинга. Честно говоря, я так и не понял, что библиотека для компиляторов делает здесь.
Используется компилятором vrad и, судя по утечкам исходных кодов, редактором уровней Valve Hammer Editor.
Расположена: src/raytrace/
- mathlib.lib
Библиотека, содержащая в себе множество типов и функций, используемых в "повседневной" математике Source.
Расположена: src/mathlib/
- vgui_controls.lib
Библиотека, содержащая в себе реализации разных элементов (кнопки, панели) VGUI2.
Используется почти повсеместно.
Расположена: src/vgui2/vgui_controls/
VPC
Source SDK имеет свой генератор проектов (sln, Makefile, etc.) с блэкджеком и… кхм…
Называется он Valve Project Creator и находится в src/devtools/bin.
Проекты генерируются автоматически с использованием специальных .VPC файлов. Синтаксис этих файлов прост до безобразия — простой набор пар ключ-значение.
Вот пути до некоторых таких файлов:
src/game/client/client_episodic.vpc
src/tier1/tier1.vpc
src/utils/vrad/vrad_dll.vpc
ВАЖНО: При внесении ЛЮБЫХ изменений в VPC файл решение должно быть заново перегенерировано!
Генерация проектов
Проекты генерируются вызовом скрипта, расположенного в директории src/.
В самом простом случае — достаточно просто открыть src/creategameprojects.bat.
После генерации в src/ будет находиться games.sln.
Исключение HL2
SDK имеет внутри себя также разделение на HL2 и Episodic. Использование второго позволит нам иметь некоторые фичи, например отдельную от стамины шкалу заряда фонарика.
И поэтому, чтобы не компилировать лишний код, мы можем просто исключить HL2 из скриптов:
- Откройте src/creategameprojects.bat в любом текстовом редакторе.
- Удалите из командной строки часть /hl2
- Сохраните файл и сгенерируйте проект.
Другие скрипты
Рядом с creategameprojects.bat также лежит его клон для bash а также два интересных файла — createallprojects.bat и его клон для bash.
Эти два скрипта заставляют VPC создавать проекты не только для чистых библиотек мода, но и для различных утилит, таких как vrad (Radiosity!) или height2normal.
Сейчас использовать я его вам настоятельно не рекомендую, так как свои собственные компиляторы карт нам пока не нужны.
Первичная сборка и запуск
Сборка
Чтобы удостовериться, что вы всё сделали правильно, необходимо собрать всё сгенерированное решение. Итак, собираем (вы же ведь открыли решение в IDE?):
- Переключите конфигурацию в Release.
ВАЖНО: При сборке в Debug мод крайне нестабилен!!!
- Соберите ВСЁ решение (F6)
- Если сборка закончилась с ошибками, повторите шаг 2.
- Если ошибки повторяются, пересоздайте проекты (creategameprojects) и повторите все шаги начиная с 1.
После сборки в папке game/mod_hl2/bin/ или game/mod_episodic/bin/ должны появится наши клиентская и серверная библиотеки!
Запуск — Способ 1 — Steam
- Копируем нашу папку mod_xxx в путь/до/Steam/steamapps/sourcemods/
- Перезапускаем Steam (либо запускаем, если еще этого не сделали...)
- Ищем в библиотеке "My First Episodic Mod" или "My First HL2 Mod"
- В свойствах устанавливаем дополнительные параметры командной строки:
-dev -console
- Запускаем, в консоли запускаем карту sdk_vehicles (SP) или dm_lockdown (MP)
Запуск — Способ 2 — Visual Studio
Я рекомендую использовать именно этот способ — не копировать же бинарники мода каждый раз после сборки!
- Заходим в свойства проекта (не решения!!!) во вкладку Debugging
- В поле Command вписываем:
путь/до/steam/steamapps/common/Source SDK Base 2013 XXXX/hl2.exe
- В поле Working Directory вписываем:
путь/до/steam/steamapps/common/Source SDK Base 2013 XXXX/
- В поле Command Arguments вписываем:
-game "путь/до/репо/xx/game/mod_xxx/" -debug -dev -console
- Сохраняем, запускаем (F5)!
- Запускаем, в консоли запускаем карту sdk_vehicles (SP) или dm_lockdown (MP)
Если карта загрузилась и вы можете передвигаться и двигать камеру мышью — сборка успешна!
Первая модификация в коде
Функции семейства Msg()
Функции Msg(), DevMsg(), Warning(), DevWarning() и ConColorMsg() являются чем-то вроде классического printf(), но в мире программирования под Source SDK. Эти функции так или иначе выводят какой-то текст в консоль разработчика и debug output.
// somewhere in tier0/dbg.h
void Msg( const tchar* pMsg, ... );
// somewhere in code
Msg( "This is a message! %d\n", 42 );
Говорящий пистолет!
Давайте научим пистолет писать сообщение с количеством патронов в магазине:
- Откройте src/game/server/hl2/weapon_pistol.cpp (Server (Episodic/HL2)/HL2 DLL/weapon_pistol.cpp)
- Найдите там метод void CWeaponPistol::PrimaryAttack( void ) (Где-то вокруг строки 255)
- Аккурат после строчки BaseClass::PrimaryAttack(); добавьте какое-нибудь сообщение, например:
BaseClass::PrimaryAttack(); // где-то на строке 251
Msg( "weapon_pistol: m_iClip1 = %d\n", m_iClip1 );
- Соберите мод, запустите и откройте карту
- Поскольку мы писали в аргументы -dev, чит-команды включены по умолчанию, поэтому пишите в консоль пресловутый impulse 101 и пробуйте стрелять из пистолета!
Заключение
Чему мы научились?
[Я надеюсь, что] из данного урока мы выяснили:
- Что вообще такое Source SDK и с чем его едят
- Как генерировать проекты используя VPC
- Как печатать что-то в консоль разработчика
Полезные ссылки
- Valve Developer Community и его раздел про SSDK
- Мой мод [SP] с многочисленными фиксами
===========
Источник:
habr.com
===========
Похожие новости:
- [Дизайн игр, Разработка игр] Как мы сделали детскую образовательную веб-игру для Банка России
- [CSS, HTML, JavaScript, Программирование, Разработка игр] Создание браузерных 3d-игр с нуля на чистом html, css и js. Часть 1/2
- [Разработка игр] Страх и ненависть в геймдеве: от первых шагов до первых денег
- [Lua, Алгоритмы, Высокая производительность] Создаём с нуля высоконагруженное приложение на Tarantool
- [Облачные вычисления, DevOps, Google Cloud Platform, Python] Production-ready chatbot in GCP for less than a dollar
- [C++, Программирование] Отображение данных в формате json на структуру c++ и обратно (работа над ошибками)
- [Занимательные задачки, Космонавтика, Разработка игр, Учебный процесс в IT] Игры от Илона Маска для детей 8-14 лет (играем всем Хабром в комментах)
- [Игры и игровые приставки, Разработка игр] Выжимаем из Gears Tactics максимальную производительность с минимальными артефактами при помощи VRS (перевод)
- [Программирование, Разработка игр, Алгоритмы] Armored Warfare: Проект Армата. Хроматическая аберрация
- [C++, Python, Учебный процесс в IT] Яндекс.Практикум запустил онлайн-курсы для Junior-разработчиков
Теги для поиска: #_c++, #_razrabotka_igr (Разработка игр), #_tutorial, #_source_engine, #_source_sdk, #_c++, #_gamedev, #_c++, #_razrabotka_igr (
Разработка игр
)
Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах
Вы не можете прикреплять файлы к сообщениям
Вы не можете скачивать файлы
Текущее время: 22-Ноя 20:11
Часовой пояс: UTC + 5
| Автор | Сообщение |
|---|---|
|
news_bot ®
Стаж: 6 лет 9 месяцев |
|
|
В мире существует множество игровых движков, но нет ни одного движка, похожего на Source своей историей и особенностями. В этом (пилотном) уроке мы разберем простейшие действия с исходными кодами SDK, а также внесем наше первое изменение в код Half-Life 2.  Вступление Немножко терминов Сам по себе Source SDK — набор утилит и программ, помогающих в разработке собственных уровней и модификаций для игры, а также исходные коды Half-Life 2 и эпизодов. Игра/Мод (Для сурса нет никакой разницы, игра это или мод :p) — скомпилированные исходные коды SDK. Так почему же именно Source?!
Что нам необходимо?
Введение в сурс дела Репозиторий Исходный код SDK находится в репозитории на GitHub. Склонируйте его в любое удобное для вас место: git clone https://github.com/ValveSoftware/source-sdk-2013.git
Выбор ветки Если вы хотите написать свой первый мод для Half-Life 2/Episode 1/2, то используйте директорию sp/ и Source SDK Base 2013 Singleplayer. Если же вы извращенец и хотите написать свой первый мод для Half-Life 2: Deathmatch, то используйте директорию mp/ и Source SDK Base 2013 Multiplayer. ВАЖНО: Туториал будет рассматривать программирование под ветку SP, поэтому пути, содержащие hl2 в пересчете на MP могут содержать hl2mp вместо hl2!!! Стиль кода Клиентские (client.dll) классы именуются с префиксом C_, а серверные (server.dll) — с префиксом C: // client.dll
class C_BaseWeapon { ... }; // server.dll class CBaseWeapon { ... }; Поля класса именуются с префиксом m_, использование венгерской нотации рекомендуется (на то есть свои причины, которые здесь обсуждать нет смысла): class C_SomeClientClass {
private: float m_flTime = 0.0; }; extern float g_flSomeFloat; static float s_flSomeStaticFloat; void SomeFunction(float flValue); Структура кода SDK, также как и движок, разделён на несколько частей. Вот список проектов, сгенерированных при помощи creategameprojects:
VPC Source SDK имеет свой генератор проектов (sln, Makefile, etc.) с блэкджеком и… кхм… Называется он Valve Project Creator и находится в src/devtools/bin. Проекты генерируются автоматически с использованием специальных .VPC файлов. Синтаксис этих файлов прост до безобразия — простой набор пар ключ-значение. Вот пути до некоторых таких файлов: src/game/client/client_episodic.vpc
src/tier1/tier1.vpc src/utils/vrad/vrad_dll.vpc ВАЖНО: При внесении ЛЮБЫХ изменений в VPC файл решение должно быть заново перегенерировано! Генерация проектов Проекты генерируются вызовом скрипта, расположенного в директории src/. В самом простом случае — достаточно просто открыть src/creategameprojects.bat. После генерации в src/ будет находиться games.sln.  Исключение HL2 SDK имеет внутри себя также разделение на HL2 и Episodic. Использование второго позволит нам иметь некоторые фичи, например отдельную от стамины шкалу заряда фонарика. И поэтому, чтобы не компилировать лишний код, мы можем просто исключить HL2 из скриптов:
Другие скрипты Рядом с creategameprojects.bat также лежит его клон для bash а также два интересных файла — createallprojects.bat и его клон для bash. Эти два скрипта заставляют VPC создавать проекты не только для чистых библиотек мода, но и для различных утилит, таких как vrad (Radiosity!) или height2normal. Сейчас использовать я его вам настоятельно не рекомендую, так как свои собственные компиляторы карт нам пока не нужны. Первичная сборка и запуск Сборка Чтобы удостовериться, что вы всё сделали правильно, необходимо собрать всё сгенерированное решение. Итак, собираем (вы же ведь открыли решение в IDE?):
После сборки в папке game/mod_hl2/bin/ или game/mod_episodic/bin/ должны появится наши клиентская и серверная библиотеки! Запуск — Способ 1 — Steam
Запуск — Способ 2 — Visual Studio Я рекомендую использовать именно этот способ — не копировать же бинарники мода каждый раз после сборки!
Если карта загрузилась и вы можете передвигаться и двигать камеру мышью — сборка успешна!  Первая модификация в коде Функции семейства Msg() Функции Msg(), DevMsg(), Warning(), DevWarning() и ConColorMsg() являются чем-то вроде классического printf(), но в мире программирования под Source SDK. Эти функции так или иначе выводят какой-то текст в консоль разработчика и debug output. // somewhere in tier0/dbg.h
void Msg( const tchar* pMsg, ... ); // somewhere in code Msg( "This is a message! %d\n", 42 ); Говорящий пистолет! Давайте научим пистолет писать сообщение с количеством патронов в магазине:
 Заключение Чему мы научились? [Я надеюсь, что] из данного урока мы выяснили:
Полезные ссылки
=========== Источник: habr.com =========== Похожие новости:
Разработка игр ) |
|
Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах
Вы не можете прикреплять файлы к сообщениям
Вы не можете скачивать файлы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах
Вы не можете прикреплять файлы к сообщениям
Вы не можете скачивать файлы
Текущее время: 22-Ноя 20:11
Часовой пояс: UTC + 5