View source for Ru/Gameinfo.txt

{{LanguageBar}}
{{Source topicon}}
<center style=color:white;font-size:20px;font-weight:bold;padding:5px>Game Definition Files</center>
{{TabsBar|main=Gameinfo.txt}}
{{seealso|[[:Category:Gameinfo]]}}
:''Для Half-Life 1/{{L|GoldSrc}}, см. статью {{L|The liblist.gam File Structure|liblist.gam}}.''

{{toc-right}}

'''<code>gameinfo.txt</code>''' содержит описание вашего мода. Он содержит такие метаданные, как его имя, ссылка на веб-сайт или руководство, и определяет, какие игры он использует. Он хранится в папке вашего мода и нужен для определения мода в Steam. Source и SDK инструменты используют его, для получения информации о подгружаемом контенте.

SDK launcher сгенерирует gameinfo.txt, как только вы запустите Create a Mod Wizard. Он подходит для разработки, но перед релизом, вы захотите изменить информацию об игре.

{{Note|{{L|Boolean|Логические}} значения представлены в виде {{L|integer|целых числел}}.}}
{{Warning|Если значение имеет пробелы, нужно "поместить его в кавычки".}}

== Настройки UI ==
=== Название ===
;<code>game <{{L|String|строка}}></code>
: Название вашего мода в [http://ru.wikipedia.org/wiki/ASCII ASCII]. Отображается в Steam и на панели задач Windows, но ''не'' в главном меню (если вы не определили <code>title</code>).
; <code>title <строка></code>
; <code>title2 <строка></code>
: Эти значения отображаются в виде [http://ru.wikipedia.org/wiki/%D0%AE%D0%BD%D0%B8%D0%BA%D0%BE%D0%B4 Юникода] в главном меню вашего мода. Они могут отличаться от отображаемых в Steam и на рабочем столе, если вы используете свой шрифт.
: <code>title2</code> (и 3, 4, и т.д.), чтобы применять разные стили к различным частям вашего названия. {{Note|Вполне возможно, ваш заголовок не будет отображаться, пока вы не отредактируете <code>ClientTitleFont</code> в <code>resource\clientscheme.res</code> для изменения шрифта. По умолчанию ("HalfLife2") имеет только определённый набор символов, и большая часть текста не будет отображаться правильно.}}
; {{EP2 add:ru|<code>gamelogo <{{L|boolean|логическое значение}}></code>}}
: Вместо отображения текста <code>title</code>/<code>title2</code>, отображает содержимое <code>resource\GameLogo.res</code>. См. {{L|Adding Your Logo to the Menu|Добавление Своего Лого в Меню}}.

=== Настройки ===
; <code>type <singleplayer_only | multiplayer_only></code>
: Влияет на появление закладок в настройках. Может так же влиять на скорость загрузки в Steam. Пропустите, если ваш мод как однопользовательский, так и многопользовательский.
; <code>nodifficulty <{{L|boolean|логическое значение}}></code>
: Скрывает вкладку Уровень сложности (это случается автоматически, если ваш мод <code>multiplayer_only</code>)
; {{EP2 add:ru|<code>hasportals <{{L|boolean|логическое значение}}></code>}}
: Показывает вкладку настроек "Порталы"
; <code>nocrosshair <{{L|boolean|логическое значение}}></code>
: Скрывает настройки прицела в мультиплеере
; <code>advcrosshair</code>
: Включает дополнительные настройки прицела.
; <code>nomodels <{{L|boolean|логическое значение}}></code>
: Скрывает настройку модели в мультиплеере
; <code>nohimodel <{{L|boolean|логическое значение}}></code>
: Скрывает флажок для переключения <code>cl_himodels</code>, который использовался в {{L|GoldSrc}}. Отображается правильно, только если <code>cl_himodels</code> расположен в первую очередь!

=== Список игр в Steam ===

; <code>developer <{{L|String|строка}}></code>
: Название вашей команды (или ваше имя!)
; <code>developer_url <строка></code>
: Веб-сайт мода, или ваш. Должен начинаться с <code><nowiki>http://</nowiki></code>.
; <code>manual <строка></code>
: Ссылка на руководство к моду; может быть локальная.
; <code>icon <строка></code>
: Локальный путь, относительно gameinfo.txt, иконка, отображающаяся в Steam. ''Не'' пишите расширение файла. Должна быть в несжатом 16x16 TGA.
Большие 32px иконки, которые отображаются в детальном виде должны находится там же где и обычная 16px иконка, и должна называться <code>&lt;icon&gt;_big.tga</code>. {{note|Чтобы прозрачность работала, TGA должен быть сохранён в режиме 32-bit с включённым альфа-каналом.}}
; {{2009 add|<code>SupportsDX8 <bool></code>}}
: Заставляет запустить игру в режиме DirectX8, отсюда - не все эффекты.
=== Разное ===

; <code>hidden_maps <подраздел></code>
: Карты, которые нельзя загрузить через диалог "create server" (их можно загрузить через консоль).
: Синтаксис: <code>mapname 1</code>, по одной записи на строку. Не пишите <code>.bsp</code>. Помните, чтобы открыть или закрыть подраздел, используйте { и }.
; {{EP2 add:ru|<code>nodegraph <{{L|boolean|логическое значение}}></code>}}
: Когда ложь, запрещает движку создавать {{L|nodegraph|сетку навигации для NPC}}.
; {{EP2 add:ru|<code>GameData <строка></code>}}
: Путь к FGD, относительно Hammer'а. В настоящее время не имеет никакого эффекта.
; {{EP2 add:ru|<code>InstancePath <строка></code>}}
: Найдено в gameinfo TF2 со значением <code>maps/instances/</code>...

== Подгрузка Контента ==

{{Warning|Ваш мод не будет использовать защиту {{L|VAC}}, если он базируется на одиночной игре.}}

Существуют два этапа для добавления игрового контента:

# Монтирование через AppID
# Монтирование папки через searchpath

При этом всё происходит в ключе <code>filesystem</code>. См. ниже для примера.

; <code>SteamAppID <{{L|Integer|целое число}}></code>
: {{L|Steam Application IDs|AppID}} игры, на которой базируется мод. Мод имеет доступ к любому доступному игровому контенту, если необходимый контент не установлен, он не будет воспроизводится. {{Tip|Для большинства модов это будет либо 215 (Ep1), либо 218 (OB), каждый из них использует разную версию {{L|Source SDK Base}}.}}
; {{EP2 add:ru|<code>AdditionalContentId <целое число></code>}}
: Мод для другой игры имеет доступ только к (и перечисление). В <code>AdditionalContentId</code> может быть указан любой номер. {{Bug|Эту команду понимает движок, но не SDK инструменты! Лучшим решением, на данный момент, является копирование контента игры на локальный жёсткий диск и добавления абсолютного пути в <code>SearchPath</code> (см. ниже). Не забудьте удалить SearchPath перед релизом.}}
:: {{Tip|Исправление доступно [[Mounting_Other_Content#Scripted_Mounting|здесь]]}}
; <code>ToolsAppId <целое число></code>
: Это AppID который в настоящий момент использует SDK. В текущий момент, есть только один работающий ID - 211 (the Source SDK).

=== SearchPaths ===

<code>SearchPaths</code> - это еще одна группа в рамках подраздела <code>FileSystem</code>. В ней содержится список папок (в виде <code>Game <путь></code>, на каждую линию), это список файлов, которые будет искать движок.

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

Путь поиска, как правило, является относительным к корневой директории <code>SteamAppID</code> (то есть где находится hl2.exe) или он абсолютный (например, <code>C:\SomeFolder\</code>). К счастью, существуют две строки, которые очень полезны:

# '''<code>|all_source_engine_paths|</code>''' (основная директория <code>SteamAppID</code> и директория <code>AdditionalContentId</code>, которую вы используете)
# '''<code>|gameinfo_path|</code>''' (папка с вашим gameinfo.txt)

==== Локализация ====

Source автоматически создаст SearchPaths для локализаций. Если вы монтируете <code>hl2</code>, а игрок запускает ваш мод на Французском, <code>hl2_french</code> автоматически смонтируется надлежащим образом.

{{Note|Языковые различия так же могут изменить AppID, но не волнуйтесь. Steam настроит всё самостоятельно.}}

=== Пример ===

Следующий код смонтирует контент {{L|Episode Two}} и {{L|Portal}}:

<source lang=ini>FileSystem
{
	SteamAppId	420	// Ep2
	ToolsAppId	211
	AdditionalContentId	400	// Portal

	SearchPaths
	{
		Game	|gameinfo_path|.	// В первую очередь указывается директория вашего мода
		Game	|all_source_engine_paths|ep2
		Game	|all_source_engine_paths|episodic	// Ep2 так же использует некоторый Ep1 контент
		Game	|all_source_engine_paths|portal
		Game	|all_source_engine_paths|hl2	// HL2 всегда должен быть последним
	}
}</source>

Episode Two загружается первым и имеет приоритет. Это означает, что как только Ep2 бинарники будут загружены, вы не сможете использовать порталы, однако вы ''можете'' использовать {{L|GLaDOS}} и {{L|Hunter|Охотников}}!

Если вы хотите использовать бинарники портала, вы должны просто поместить его поисковой путь выше Ep2. (Излишне говорить, что если эти бинарники в папке вашего мода, тогда будут загружены ''они''.)

== Пример Source 2013 ==

Следующий код смонтирует контент {{L|Episode Two}} и {{L|Portal}} на 2013 версии движка:

<source lang=ini>FileSystem
{
	SteamAppId					243730				// Source SDK Base 2013 Singleplayer
	SearchPaths
	{
		// No /custom/ folders because they can interfere with mod content and shouldn't be in mod gameinfo.
		game+mod+mod_write+default_write_path	|gameinfo_path|.		// Mod
		gamebin					|gameinfo_path|bin		// Mod's Binaries

		// Using SSDKBase13 path, then back to /common/ and then using Portal folder. 
		// |all_source_engine_paths| magic help here too.
		game				|all_source_engine_paths|../Portal/portal/portal_sound_vo_english.vpk 
		game				|all_source_engine_paths|../Portal/portal/portal_pak.vpk 		

		// Base Half-Life 2 Content: ep2, episodic, hl2
		game_lv					|all_source_engine_paths|hl2/hl2_lv.vpk
		game					|all_source_engine_paths|ep2/ep2_english.vpk
		game					|all_source_engine_paths|ep2/ep2_pak.vpk
		game					|all_source_engine_paths|episodic/ep1_english.vpk
		game					|all_source_engine_paths|episodic/ep1_pak.vpk
		game					|all_source_engine_paths|hl2/hl2_english.vpk
		game					|all_source_engine_paths|hl2/hl2_pak.vpk
		game					|all_source_engine_paths|hl2/hl2_textures.vpk
		game					|all_source_engine_paths|hl2/hl2_sound_vo_english.vpk
		game					|all_source_engine_paths|hl2/hl2_sound_misc.vpk
		game					|all_source_engine_paths|hl2/hl2_misc.vpk
		platform				|all_source_engine_paths|platform/platform_misc.vpk

		// TODO; find out what is it and why it's here
		game					|all_source_engine_paths|episodic
		game					|all_source_engine_paths|hl2
		platform				|all_source_engine_paths|platform
	}
}</source>

{{ACategory|File formats}}
{{ACategory|Modding}}
{{ACategory|Source SDK FAQ}}