Pl/Source SDK Files and Directory Structure: Difference between revisions

From Valve Developer Community
< Pl
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
Wraz z nową wersją SDK, struktura domyślna katalogu zostanie zmieniona by usunąć ograniczenie zapisywania zawartości twojej gry w drzewie katalogu \sourcesdk. Ten dokument wyjaśnia w jaki sposób jest zbudowana struktura katalogu [[Source SDK]].
Wraz z nową wersją SDK, struktura domyślna katalogu zostanie zmieniona by usunąć ograniczenie zapisywania zawartości twojej gry w drzewie katalogu \sourcesdk. Ten dokument wyjaśnia w jaki sposób jest zbudowana struktura katalogu [[Source SDK]].


== The directory structure explained ==
== Wyjaśnienie struktury katalogu ==
The SDK directory structure is now set up so that game content directories are separated from game sources directories.
Struktura katalogu SDK jest już zmieniona więc zawartość gry jest oddzielona od katalogów źródłowych gry.


* '''Game content''' files are the actual files necessary to run the game textures, maps, models, etc.
* '''Zawartość gry''' to pliki potrzebne do uruchomienia gry tekstury, mapy, modele, itp.
* '''Game sources''' are the files that are used to create that game content (the "source" of the game content).
* '''Źródło gry''' to pliki używane do stworzenia zawartości gry ("źródło" zawartości gry).


This table explains some of the different game content and game source file types in the SDK:
Ta tabelka wyjaśnia niektóre różnice występujące pomiędzy typami plików zawartości gry a jej źródłem w SDK:


{|
{|
! File type         || Description           || Location
! Typ pliku         || Opis           || Lokalizacja
|-
|-
| <code>.[[VMF]]</code>              || Map source files.                                  || <code>sourcesdk_content\<game name>\mapsrc</code>
| <code>.[[VMF]]</code>              || Pliki źródłowe map.                                  || <code>sourcesdk_content\<game name>\mapsrc</code>
|-
|-
|<code>.[[TGA]] .[[TXT]]</code>          || Texture source files.                              || <code>sourcesdk_content\<game name>\materialsrc</code>
|<code>.[[TGA]] .[[TXT]]</code>          || Pliki źródłowe tekstur.                              || <code>sourcesdk_content\<game name>\materialsrc</code>
|-
|-
|<code>.[[SCN]] .[[SMD]] .[[QC]]</code>      || Model source files.                                || <code>sourcesdk_content\<game name>\modelsrc</code>
|<code>.[[SCN]] .[[SMD]] .[[QC]]</code>      || Pliki źródłowe modeli.                                || <code>sourcesdk_content\<game name>\modelsrc</code>
|-
|-
| <code>.[[BSP]]</code>              || Map content files compiled game maps.            || <code><game name>\maps</code>
| <code>.[[BSP]]</code>              || Pliki map skompilowane mapy.            || <code><game name>\maps</code>
|-
|-
|<code>.[[MDL]] .[[VTX]]</code>          || Model content files compiled game models.  || <code><game name>\models</code>
|<code>.[[MDL]] .[[VTX]]</code>          || Pliki modeli skompilowane modele.  || <code><game name>\models</code>
|-
|-
| <code>.[[VMT]] .[[VTF]]</code>        || Texture content files compiled model skins.    || <code><game name>\materials\models</code>
| <code>.[[VMT]] .[[VTF]]</code>        || Pliki tekstur modeli skompilowane tekstury modeli skins.    || <code><game name>\materials\models</code>
|-
|-
| <code>.[[VMT]] .[[VTF]]</code>        || Texture content files compiled brush textures.    || <code><game name>\materials</code>
| <code>.[[VMT]] .[[VTF]]</code>        || Pliki tekstur skompilowane tekstury.    || <code><game name>\materials</code>
|}
|}
The following image shows the default locations for these files and folders:
Następujący obrazek pokazuje domyślną lokalizację tych plików i folderów:


[[Image:developer-contentfolders.jpg]]
[[Image:developer-contentfolders.jpg]]


{|
{|
| '''Steam Install Directory'''      || The location where you've installed Steam.
| '''Steam Install Directory'''      || Lokalizacja w której zainstalowałeś Steam.
|-
|-
| '''Game Content'''                || The game content is here, with all the files necessary to run each game under each game directory.
| '''Game Content'''                || Tutaj znajduje się zawartość gry, z wszystkimi plikami potrzebnymi do uruchomienia każdej gry pod każdym katologiem gry.
|-
|-
| '''SDK Tools'''                    || The location of the applications necessary to create and compile SDK content.
| '''SDK Tools'''                    || Lokalizacja aplikacji potrzebnych do tworzenia i kompilacji zawartości SDK..
|-
|-
| '''Content Sources'''            || Directories for each of the types of game content sources are here, with a set of directories for each game you want to create content for. '''SDK sample content is also stored here.'''
| '''Content Sources'''            || Katalogi dla każdego rodzaju źródła gry znajdują się tutaj, z zestawem katalogów dla każdej gry w którym stworzysz jej zawartość. '''Przykłady SDK są zapisane właśnie tutaj.'''
|}
|}


== Examples of using this SDK directory structure ==
== Przykłady używania struktury katalogów SDK ==
Here are some practical examples of how this structure is used:
Here are some practical examples of how this structure is used:


=== Compiling a CS:S map ===
=== Kompilowanie mapy CS:S ===
# Launch the [[Hammer]] map editor from the '''SDK Tools Directory'''.
# Uruchom edytor map [[Hammer]] z '''Katalogu narzędzi SDK'''.
# Save the map as a [[VMF]] into the <code>cstrike\mapsrc</code> directory, which is under '''Content Sources'''.
# Zapisz utworzoną mapę jako plik [[VMF]] w katalogu <code>cstrike\mapsrc</code>, który jest pod '''Content Sources'''.
# Compile the map inside Hammer. The map is compiled as a [[BSP]] and automatically placed in the <code>cstrike\maps</code> '''Game Content''' directory.
# Compile the map inside Hammer. The map is compiled as a [[BSP]] and automatically placed in the <code>cstrike\maps</code> '''Game Content''' directory.



Revision as of 05:01, 11 September 2008

Wraz z nową wersją SDK, struktura domyślna katalogu zostanie zmieniona by usunąć ograniczenie zapisywania zawartości twojej gry w drzewie katalogu \sourcesdk. Ten dokument wyjaśnia w jaki sposób jest zbudowana struktura katalogu Source SDK.

Wyjaśnienie struktury katalogu

Struktura katalogu SDK jest już zmieniona więc zawartość gry jest oddzielona od katalogów źródłowych gry.

  • Zawartość gry to pliki potrzebne do uruchomienia gry — tekstury, mapy, modele, itp.
  • Źródło gry to pliki używane do stworzenia zawartości gry ("źródło" zawartości gry).

Ta tabelka wyjaśnia niektóre różnice występujące pomiędzy typami plików zawartości gry a jej źródłem w SDK:

Typ pliku Opis Lokalizacja
.VMF Pliki źródłowe map. sourcesdk_content\<game name>\mapsrc
.TGA .TXT Pliki źródłowe tekstur. sourcesdk_content\<game name>\materialsrc
.SCN .SMD .QC Pliki źródłowe modeli. sourcesdk_content\<game name>\modelsrc
.BSP Pliki map — skompilowane mapy. <game name>\maps
.MDL .VTX Pliki modeli — skompilowane modele. <game name>\models
.VMT .VTF Pliki tekstur modeli — skompilowane tekstury modeli skins. <game name>\materials\models
.VMT .VTF Pliki tekstur — skompilowane tekstury. <game name>\materials

Następujący obrazek pokazuje domyślną lokalizację tych plików i folderów:

Developer-contentfolders.jpg

Steam Install Directory Lokalizacja w której zainstalowałeś Steam.
Game Content Tutaj znajduje się zawartość gry, z wszystkimi plikami potrzebnymi do uruchomienia każdej gry pod każdym katologiem gry.
SDK Tools Lokalizacja aplikacji potrzebnych do tworzenia i kompilacji zawartości SDK..
Content Sources Katalogi dla każdego rodzaju źródła gry znajdują się tutaj, z zestawem katalogów dla każdej gry w którym stworzysz jej zawartość. Przykłady SDK są zapisane właśnie tutaj.

Przykłady używania struktury katalogów SDK

Here are some practical examples of how this structure is used:

Kompilowanie mapy CS:S

  1. Uruchom edytor map Hammer z Katalogu narzędzi SDK.
  2. Zapisz utworzoną mapę jako plik VMF w katalogu cstrike\mapsrc, który jest pod Content Sources.
  3. Compile the map inside Hammer. The map is compiled as a BSP and automatically placed in the cstrike\maps Game Content directory.

Creating a texture for HL2:DM

  1. Create a texture in an image editor, and save it as a TGA in the hl2mp\materialsrc directory, which is under Content Sources.
  2. Compile the texture with Vtex.exe, which is in the SDK Tools Directory.
  3. The texture is compiled as a VTF file and automatically placed in the hl2mp\materials Game Content directory.
  4. Create the VMT material file with a text editor, and save it in the hl2mp\materials Game Content directory.

Creating a model for HL2

  1. Create an SCN model in Softimage|XSI EXP, and export it as an SMD in the hl2\modelsrc directory, which is under Content Sources.
  2. Create the .QC model definition file with a text editor, and save it in the hl2\modelsrc directory, which is under Content Sources.
  3. Compile the model with Studiomdl.exe, which is in the SDK Tools Directory.
  4. The model is compiled as a MDL and automatically placed in the hl2\models Game Content directory.

For in-depth descriptions of these procedures, see the appropriate section of the Source SDK Documentation.

Template:Otherlang:en Template:Otherlang:en:es, Template:Otherlang:en:fr, Template:Otherlang:en:jp, Template:Otherlang:en:pl, Template:Otherlang:en:zh-tw.