- Modding Tutorials

[ HL2 Level Editing Tutorials ]




Introduzione al Source SDK
by Gyppi

0. Premessa
1.Reperire ed utilizzare il Source SDK
2. I componenti del Source SDK
    2.1 Hammer Editor
    2.2 Model Viewer
    2.3 Face poser
3. Utilities
4. Altre piccole utilities



































NB: In caso non abbiate la possibilità di scaricare L’SDK, per esempio perché utilizzate una connessione tramite modem 56K, l’unica vostra possibilità è di entrare in Steam da un pc con connessione veloce (ADSL, Cavo, Fibra, ecc..), scaricare il Source SDK su quel pc, effettuare il backup e poi trasferire i dati sul vostro pc. In questo modo avrete il Source SDK a disposizione pur non avendolo scaricato direttamente sul vostro pc. In caso utilizziate una connessione tramite modem 56K è consigliabile che disabilitiate l’aggiornamento automatico del Source SDK per evitare di renderlo inutilizzabile al primo update.



































































































































































































































































































































































































 

Introduzione al Source SDK     
Per Half Life 2 e Counter Strike Source    
      0. Premessa
In questo tutorial farò una panoramica del Source SDK, descriverò gli stumenti di lavoro principali e le varie utilities. Il tutorial è naturalmente di livello base e può essere anzi considerato una raccolta delle prime cose da apprendere in vista della creazione di un mod per uno dei videogames supportati dalla Valve.
 
     1. Come reperire ed utilizzare il Source SDK
Il Source SDK, come ogni altro prodotto di Valve, è scaricabile da Steam ed è disponibile per tutti gratuitamente. Per scaricarlo bisogna andare nella scheda strumenti, presente nella modalità estesa di Steam, nella lista appariranno diversi strumenti tra cui il Source SDK, il Source SDK Base e il Source Dedicated Server. Ciò che dobbiamo scaricare noi è il primo, ovvero il Source SDK, quindi, come se fosse un qualsiasi gioco, clicchiamo col tasto destro su di lui e scegliamo dal menù a comparsa installa gioco ed attendiamo il completamento del download.



Da notare che il Source SDK subisce continui aggiornamenti, proprio come il Source: è quindi normale scaricarlo tutto e poi un giorno ritrovarselo nuovamente in download, poiché si starà aggiornando con le ultime capacità del Source o per correggere dei bug.

Una volta scaricato, possiamo passare alla modalità ridotta di Steam, sotto i giochi installati apparirà una nuova categoria “STRUMENTI” e lì sarà bello pronto il nostro SDK. Lo si avvia semplicemente con il doppio click (come un gioco), la finestra che ci apparirà subito dopo quella di caricamento sarà strutturata come la modalità ridotta di Steam, ovvero sarà tutto disposto in colonna e per categoria (non vi stupite se la skin della finestra che apparirà è differente da quella standard di Steam, l’SDK utilizza ancora la vecchia skin della piattaforma).
 
     2. I componenti del Source SDK
Prima di tutto, la struttura dell’SDK è la seguente (è come lo troviamo appena avviato):



Ora analizziamo i suoi componenti, iniziando dalla categoria Application.

2.1 Hammer Editor

L’Hammer è l’editor dei livelli; lo si può usare per creare mappe SP (Single Player – Giocatore Singolo) o MP (Multi Player – Multi Giocatore) per qualsiasi gioco che sfrutta il Source Engine, per esempio Half-Life 2, Counter Strike: Source e Day Of Defeat: Source.




2.2   Model Viewer

Questo strumento serve per avere un anteprima in tempo reale di come appariranno i modelli 3d nel gioco, non solo il semplice modello 3d ma anche le textures e gli effetti applicati sul modello tramite shader. Se per esempio stiamo creando una texture per un modello, potremmo editare la texture, salvarla e premere semplicemente F5 sul Model Viewer per fargli aggiornare il modello con la texture appena salvata per vedere direttamente il risultato.




2.3   Face Poser

Uno degli strumenti più interessanti, serve per far mimare ad un personaggio un discorso audio, ovvero serve per animare il volto di un personaggio che deve parlare.

 
     3. Utilities
In Documentation abbiamo invece le “Release Notes” e i “SDK Reference Docs”, che non sono altro che links alla Wiki ufficiale della Valve per il Source. Le prime contengono informazioni tecniche sul SDK (tipo bugfix o nuove caratteristiche aggiunte) e il secondo una guida all’utilizzo del Source SDK, tutto naturalmente in inglese.

Nella Categoria “Utilities” troviamo:

-   Create a Mod   Serve per creare un nuovo mod, in caso la nostra idea non si limiti ad una semplice mappa, dobbiamo usare questo strumento per ottenere il codice sorgente di Half-Life 2 SP o MP, o solo il codice del Source Engine. (analizzeremo il codice sorgente in un altro tutorial dedicato al coding del Source).

-   Refresh SDK Content   Serve per ripristinare i contenuti del Source SDK nel caso si sia danneggiato, l’operazione richiede qualche minuto e non cancella nessuna informazione o configurazione creata in precedenza.




-   - Reset Game Configuration   Questa utility si può utilizzare in caso la configurazione dell’Hammer (l’editor delle mappe) o dell’intero Source SDK si sia danneggiata. E’ però pericolosa poiché cancella e resetta le configurazioni dei giochi da “moddare” e quindi anche le configurazioni dei mod da noi creati tramite il “Make a Mod” vengono, purtroppo, cancellati. In caso abbiate creato dei mod tramite il “Make a Mod” è tuttavia possibile effettuare un salvataggio del nostro lavoro, come fare è riportato in questa pagina del wiki ufficiale della Valve:

                          valvesoftware.com/wiki



Infine in Links trovano posto due collegamenti: “Valve developer community” porta alla pagina web principale (la wiki) della comunità dei modder del Source Engine; “SoftImage | XSI Mod Tool” porta ad una pagina web del sito della SoftImage, software house produttrice di un software di modeling 3d (XSI) utilizzato per la creazione dei modelli di Half-Life 2 e dei giochi basati sul Source, da cui è possibile scaricare gratuitamente un kit di sviluppo per il proprio mod. Il kit “XSI Mod Tool” è compatibile con ogni gioco basato sul Source Engine e sull’Unreal Engine 2.x. Se capita che il link non funzioni si può utilizzare ques’altro in alternativa:

                            www.softimage.com

I downalods essenziali sono: “SOFTIMAGE|XSI Mod Tool” e “Mod Tool Add-On for Valve Source”, anche se consiglio di scaricare pure qualche guida. La parte sottostante all’elenco appena analizzato è dove va selezionato il gioco o il mod su cui lavorare con il Source SDK. In questo spazio trovano posto i giochi installati e supportati dal Source SDK e i nostri mod creati con “Make a Mod”.



 
     4. Altre piccole utilities
Il Source SDK però non si limita solo a questo: nella cartella BIN, all’interno della cartella dell’SDK (solitamente: X:\Programmi\Steam\SteamApps\NICK\sourcesdk\bin\), sono presenti altre utilities, funzionanti tramite linea di comando. Queste utilities sono riposte solo in questa cartella dato vengono usate con minore frequenza ed eseguono piccoli lavori, come p.e. convertire una texture .tga in .vtf e viceversa.

Gli strumenti presenti attualmente (ottobre 2006) sono:

  - Bspzip: serve per includere in una mappa materiali o oggetti unici per essa;
  - demoinfo: serve per ottenere informazioni da un file .DEM (demo);
  - glview: serve per visualizzare i file .GL creati durante la compilazione di una mappa;
  - height2normal: serve per creare una Normal map da una Height map in tga;
  - motionmapper: server per creare una mappa di movimento da uno scheletro animato
    (lo scheletro è il modello base di un personaggio 3d);
  - shadercompiler: serve per compilare uno shader per il gioco;
  - splitskybox: serve per suddividere uno skybox .PFM nelle sue immagini originali;
  - studiomdl: serve per creare file .MDL da un modello 3d SMD con script .QC;
  - vbsp: serve per compilare una mappa in .BSP;
  - vbspinfo: serve per avere informazioni dettagliate su una mappa già compilata;
  - vrad: serve per calcolare la l’illuminazione di una mappa;
  - vtex: serve per creare una texture .VTF da un file .TGA;
  - vtf2tga: serve per riportare una texture .VTF in formato .TGA (il contrario di VTex);
  - vvis: serve per indicare al motore quali aree di una mappa renderizzare e quali no,
     per aumentare le prestazioni del gioco;
  - xwad: serve per convertire file .WAD, .BMP e .SPR in .TGA o .VTF con file .VMT.


Il Source SDK non è l’unico strumento per “moddare” il Source engine, esiste anche il Source SDK Base, scaricabile esattamente come il Source SDK da Steam; questa versione però non incorpora nessuno degli strumenti qui analizzati e serve solo per testare i propri mods in assenza di Half-Life 2 installato.

E con questo abbiamo terminato l’introduzione ad questo set di strumenti per creare il nostro video gioco basato sul Source Engine di Valve Software.

 
Ok questo è quanto. Se qualcosa non ti è chiaro, non esitare a postare le tue domande nel nostro Forum.


Creative Commons License
Introduzione al Source SDK
Tutorial by Gyppi for HG&LD
- 11 Novembre 2006 -