Modding de fonte - Parte 1 - O básico do básico

Existem muitos motores de jogo no mundo, mas não há um único motor que seja semelhante ao Source em sua história e recursos.

Neste tutorial (piloto), percorreremos as etapas mais simples com os códigos-fonte do SDK, bem como faremos nossa primeira alteração no código do Half-Life 2.

Introdução

Alguns termos

O código-fonte em si é um conjunto de utilitários e programas que ajudam você a desenvolver seus próprios níveis e modificações para o jogo, bem como o código-fonte para Half-Life 2 e episódios.

/ ( , :p) — SDK.

Source?!

1. . , , .
2. . Source .
3. SDK , SDK ( , ( ͡° ͜ʖ ͡°) ) ! , Source SDK ( ...) .
4. . . C++ !
5. .

?

1. C++ ( ).
2. Microsoft Visual Studio Multibyte MFC Library Microsoft Build Tools 2013 (v120/v120_xp). , VS2013.
3. Git for Windows .
4. Steam Source SDK Base 2013 [Single|Multi]player ( "" - upstream, )
5. 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, , .

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 :

1. src/creategameprojects.bat .
2. /hl2
3. .

creategameprojects.bat bash — createallprojects.bat bash.

VPC , , vrad (Radiosity!) height2normal.

, .

, , . , ( IDE?):

1. Release.
   
   : Debug !!!
2. (F6)
3. , 2.
4. , (creategameprojects) 1.

game/mod_hl2/bin/ game/mod_episodic/bin/ !

— 1 — Steam

1. mod_xxx //Steam/steamapps/sourcemods/
2. Steam ( , ...)
3. "My First Episodic Mod" "My First HL2 Mod"
4. :
   
   

   -dev -console

5. , sdk_vehicles (SP) dm_lockdown (MP)

— 2 — Visual Studio

— !

1. ( !!!) Debugging
2. Command :
   
   

   //steam/steamapps/common/Source SDK Base 2013 XXXX/hl2.exe

3. Working Directory :
   
   

   //steam/steamapps/common/Source SDK Base 2013 XXXX/

4. Command Arguments :
   
   

   -game "///xx/game/mod_xxx/" -debug -dev -console

5. , (F5)!
6. , 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 );

!

:

1. src/game/server/hl2/weapon_pistol.cpp (Server (Episodic/HL2)/HL2 DLL/weapon_pistol.cpp)
2. void CWeaponPistol::PrimaryAttack( void ) (- 255)
3. BaseClass::PrimaryAttack(); - , :
   
   

   BaseClass::PrimaryAttack(); // -   251
   Msg( "weapon_pistol: m_iClip1 = %d\n", m_iClip1 );

4. ,
5. Como escrevemos em argumentos -dev, comandos de trapaça são habilitados por padrão, então escreva o proverbial no console impulse 101e tente atirar com uma pistola!

Conclusão

O que aprendemos?

[Espero que] com este tutorial nós descobrimos:

• O que é Source SDK em geral e com o que é consumido
• Como gerar projetos usando VPC
• Como imprimir algo para o console do desenvolvedor

Qual é o próximo?

Na segunda parte, analisaremos o sistema de entidades do Source SDK.

Links Úteis

• Valve Developer Community e sua seção SSDK
• Meu mod [SP] com várias correções