Gameinfo.txt

Материал из Наша Wiki - Наша энциклопедия Half-Life
Перейти к: навигация, поиск

Файл GameInfo.txt указывает SDK tools и движку Source какой контент нужен для данного мода или игры. Именно так утилиты SDK и движок узнают загружать ли им контент Half-Life 2, Counter-Strike, или Half-Life 2: Deathmatch когда они были запущены в директории мода. Это также маркер, по которому утилиты находят директорию мода.

note

В большинстве случаев Вам не придётся редактировать этот файл, но если вы хотите сделать игру на контенте, отличном от контента Half-Life 2, изменить пути поиска контента, иконки и другую информацию, тогда Вам потребуется редактировать его. Однажды настроенный, этот файл должен распространяться вместе с контентом мода. Точно такой же gameinfo.txt должен лежать в папке мода всех его разработчиков. Пользователи могут модифицировать gameinfo.txt на своё усмотрение. Однако следует учесть, если вы редактировали файл gameinfo.txt от какой-либо Source-игры, Steam при её запуске переизвлечёт оригинальный файл. Для исправления этой ошибки следует создать отдельный gameinfo.txt в другой папке и в параметрах запуска игры установить -game -"путь к папке с новым gameinfo.txt".

Настройки пользовательского интерфейса (UI)

Много настроек UI, включая заголовок Вашей игры (game's title), обрабатываются gameinfo.txt. Ключи:

note

//Generic information (пер: "Общая информация")
game		"Название игры"		//Это то, что отображается в названии запущенной игры в окне Windows и 
                                        //игровом меню Steam.
title		"Заголовок игры"	//Основной заголовок игры. Это то, что отображается в игровом меню.
title2		"Дополн. заголовок"     //Дополнительный заголовок игры (может отсутствовать).
type		singleplayer_only	//Также может принимать значение "multiplayer_only".  Определяет какие
                                        //элементы UI необходимо создать в панели параметров. Пропустите для
					//модов, имеющих оба режима игры MP and SP (одиночная и сетевая).
					//Если установлено в "multiplayer_only", то вкладка "сетевая игра" в меню "параметры"
					//будет добавлена первой, иначе - последней, если не задан "singleplayer_only".
fallback_dir	"Dir"			//Непроверенная функция (Работает в Goldsource)

//Новое в Portal:
 nodifficulty	boolean			//Скрывает вкладку "Уровень сложности"
 hasportals	boolean			//Показывает вкладку "Порталы" на панели параметров
//Multiplayer tab in the Options panel (пер: "Вкладка 'сетевая игра' в панели 'параметры' ")
nocrosshair	boolean			//Скрыть меню выбора прицела
nohimodel	boolean			//Hides cvar toggles checkbox for cl_himodels
					//Отображается правильно только, если cl_himodels установлено
nomodels	boolean			//Скрыть меню выбора модели во вкладке сетевой игры на панели параметров

//Steam Games List (пер: Список игр Steam)
developer	"Имя разработчика"	//Имя или название команды разработчика, отображаемое в Steam
developer_url	"Сайт разработчика"	//Домашняя страница разработчика. Должно начинаться с http://.
//--------------------------------------------------------------------------------------
manual	   "Адрес веб-страницы"	        //Путь к руководству пользователя
					//Это может быть локальный путь. Программа-установщик 
					//может быть разработана так, что установит этот параметр равным 
					//установочному пути.
//--------------------------------------------------------------------------------------
icon		"путь к иконке"		//Иконка, отображаемая в окне игры в Windows и меню Steam
                                        //Иконка должна быть несжатым TGA 16x16 пикселей.
					//Что бы работала прозрачность, TGA должен быть сохранён в 32-битном
					//режиме с активным альфа-каналом.
					//Этот путь относителен к установочному пути мода
					//(т.е. к тому, месту где GameInfo.txt) и не должен включать
					//расширение TGA файла.

//Create games dialog (пер: Диалог создания игры)
hidden_maps				//Карты, заданные между скобками, не будут появляться в интерфейсе
{					//но останутся доступными
	"mapname" 1			//(то есть появятся в автоматических списках)
	"mapname" 1			//для команд "map" и "changelevel".
}

 nodegraph	boolean			// Информация для движка: генерировать Node Graph или нет

Когда вы только создайте новый мод, gameinfo.txt не содержит ключей "title" и "type", так что не забудьте их добавить.

note

Файловая система

За описанием информации о моде идёт описание файловой системы мода - здесь указывается какой контент следует просматривать и в каких папках искать ресурсы. Ниже приведена структура описания файловой системы:

FileSystem  
{
       SteamAppId	     "номер AppId игры"       // указывает AppId игры в качестве основы для мода
       ToolsAppId	     "номер AppId утилит"    // указывает AppId утилит для мода
       AdditionalContentId   "номер дополн. AppId"   // указывает дополнительный подключаемый контент AppId     
               
       SearchPaths   // в этой секции задаются пути для загрузки игрой ресурсов
       {
               Game	"путь поиска №1"	
                               //  и так далее ...
               Game	"путь поиска №n"	
               GameBin	"путь к дополнительным бинарным файлам (DLL) №1"
                               //  и так далее ...
               GameBin	"путь к дополнительным бинарным файлам (DLL) №m"
       }                      
}                                                             

Ниже каждый параметр будет рассмотрен более подробно.

SteamAppId

Ещё одна важная вещь в файле GameInfo.txt - это переменная SteamAppId. Если Вы загляните внутрь GameInfo.txt, вы увидите кусок, который выглядит примерно так:

SteamAppId "номер AppId игры" //This will mount all the GCFs we need (240=CS:S, 220=HL2). 
                              // Пер: Это смонтирует все GCF, которые нам нужны (240=CS:S, 220=HL2)

Значение SteamAppId определяет, контент какой игры (т.е. GCF файлы) доступен этой игре/модификации. Например SteamAppId 220 будет использовать как базу игру Half-Life 2, а SteamAppId 240 - Counter-Strike Source.

note warning-ru warning-ru

Значения SteamAppId для основных игр Source можно найти в Steam Application IDs. Общедоступные GCF имеют слово 'shared' в своём имени файла и всегда могут быть использованы; всё остальное - собственность данной игры.

Раздел AdditionalContentId (только для игр и модов на Source Engine 14 и выше)

AdditionalContentId "номер дополнительного AppId" // подключение дополнительного контента

AdditionalContentId поддерживается только на движке Orange Box (Source Engine 14 и 15) и используется для подключения контента из игр, имеющих другой номер AppId в порядке указания. Данная функция позволит игре использовать контент из виртуальной файловой системы с указанным AppId. Например если вы задали основным SteamAppId 420 (Episode Two) и прописали AdditionalContentId 400 (Portal), это значит, что вы сможете использовать модели, текстуры, звуки и карты из Portal в моде, при условии что папка Portal задана в разделе SearchPatchs (об этом разделе рассказано ниже). Учтите, что функция работает в игре, но НЕ работает в редакторе карт Hammer, поэтому при маппинге с использованием контента из нескольких игр необходимо распаковать содержимое GCF от игр с дополнительными AppId. В дальнейшем при завершении маппинга распакованные файлы можно удалить.

Раздел ToolsAppId

Все файлы GameInfo.txt будут содержать строку типа этой:

ToolsAppId 211	//Утилиты используют это (в том числе: source SDK), чтобы взять 
		//такие вещи как materials\debug, materials\editor, и т.п..

Это специальный случай, который используется только утилитами, которым нужно загрузить особый контент. Он используется только утилитами и не используется игрой. Для всех Source-игр используется только одна утилита - Source SDK, имеющая AppId 211.

Раздел SearchPaths

Раздел SearchPaths файла GameInfo.txt описывает, где может быть найден игровой контент, на жестком диске или внутри файлов кэша Steam. Пути могут быть как относительными (относительно hl2.exe), так и абсолютными. Все файлы, к которым обращается игра, должны иметь существующий path ID (Идентификатор пути). Path ID описывает одно или более местоположений на Вашем жестком диске или внутри виртуальных файловых систем Steam.

Например, большинство ресурсов Вашей игры, таких как скрипты (scripts), звуки (sounds), файлы моделей и материалы доступны через path ID равный "Game". Пользователь может сказать "открой файл, называемый scripts\weapon_m4a1.txt внутри path ID с именем 'Game'". Если вы запускаете мод в C:\MyMod\Blasters, и используете SteamAppId 240 , который загрузил бы контент Counter-Strike: Source, тогда бы он искал файл в следующих местах:

  • C:\MyMod\Blasters\scripts\weapon_m4a1.txt
  • <установочная папка Steam>\Steam\SteamApps\username\Counter-Strike Source\cstrike\scripts\weapon_m4a1.txt
  • <Внутри виртуальной файловой системы Steam>\cstrike\scripts\weapon_m4a1.txt

Использование path ID для описания места хранения файла избавляет игрока, программиста и художника от опасений, что они работают с разными папками. Они могут использовать относительные к игровой папке имена (такие как scripts\weapon_m4a1.txt или materials\brick\brickwall001a.vmt) и движок, и утилиты найдут полный путь к файлу, независимо от того, где он находится, только если GameInfo.txt описывает что значит path ID с именем "Game".

В файле GameInfo.txt , этот раздел называется "SearchPaths", в нём описываются path ID. Если модификация не использует каких-либо ресурсов из игр, отличных от Half-Life 2 (кроме её карт), то менять пути, после того, как вы создали мод, нажав Create a Mod из SDK launcher, не требуется.

Первая часть каждой строки - это имя path ID, а вторая часть - это где искать файлы, когда используется этот path ID. Вот простой пример для иллюстрации, который бы Вы никогда не использовали, потому что там применяются абсолютные пути, включая буквы дисков, которых может и не быть на компьютере игрока:

SearchPaths
{
	TestPathID	C:\TestMod1
	TestPathID	C:\TestMod2
	TestPathID	C:\TestMod3
}

Если программист или пользователь напишет код, который запрашивает scripts\weapon_m4a1.txt и укажет "TestPathID" как path ID в коде, тогда движок будет искать файл в следующих местах:

  • C:\TestMod1\scripts\weapon_m4a1.txt
  • C:\TestMod2\scripts\weapon_m4a1.txt
  • C:\TestMod3\scripts\weapon_m4a1.txt

С тех пор как Source-игра получает свой контент используя path ID с именем "Game", она делает некоторые вещи для Вас автоматически, если у Вас есть path ID с именем "Game". Для каждой записи с path ID равным "Game":

  1. Добавляется path ID с именем "GameBin" , и путём <dir>\bin
  2. Добавляется другой путь с "Game" в начале, и заканчивающийся на _<язык>. Например: c:\hl2\cstrike даст дополнительный путь c:\hl2\cstrike_russian, если вы запускаете мод на компьютере с русской локализацией.

Для первого пути поиска "Game":

  1. Добавляется путь поиска с именем "MOD" в той же папке.
  2. Добавляется путь поиска с именем "DEFAULT_WRITE_PATH".

В абсолютных и относительных путях также могут присутствовать два специальных префикса-вставки:

  • 1. |all_source_engine_paths| - просматривает содержимое в указанной после данного префикса директории во всех задействованных AppId, включая SteamAppID и все AdditionalContentId. Например |all_source_engine_paths|hl2 будет просматривать содержимое папки hl2 во всех подключенных файлах с разными AppId.
  • 2. |gameinfo_path| - указывает игре ту папку в которой находится сам gameinfo.txt.

По умолчанию SearchPaths который может использоваться в большинстве игр выглядит примерно так:

SearchPaths
{
	Game        |gameinfo_path|.
	Game        hl2
}

В норме, путь (правая часть) - относителен к базовой директории - директории, где находится hl2.exe. Если |gameinfo_path| выше базовой директории, тогда пути относительны того места, где находится GameInfo.txt . Например, если файл GameInfo.txt находится в C:\MyMod\Blasters, и есть путь типа |gameinfo_path|SomeTestDirectory, тогда path ID , который вы создали, указывает на:

C:\MyMod\Blasters\SomeTestDirectory

Если для Counter-Strike: Source, файл GameInfo.txt имеет часть SearchPaths , которая выглядит как вышепредставленная. И если ваша папка с Counter-Strike:

C:\Program Files\Valve\Steam\SteamApps\username\Counter-Strike Source

тогда поиск файла будет производится в следующих двух папках:

  • C:\Program Files\Valve\Steam\SteamApps\username\Counter-Strike Source\cstrike

потому что GameInfo.txt существует здесь.

  • C:\Program Files\Valve\Steam\SteamApps\username\Counter-Strike Source\hl2

потому что папка hl2 (как в реальной, так и в виртуальной файловой системе) расположена в той же директории, что и hl2.exe.

Если Вы хотите подключить в мод контент другого мода, то Вам будет необходимо прописать относительный или абсолютный путь к папке этого мода. Поскольку все Source-моды по-умолчанию находятся в одной папке SourceMods, то для подключения его контента нужно прописать строку Game |gameinfo_path|.\..\имя папки с модом. В данном случае игра сначала обратится к папке нашего мода поскольку в ней лежит gameinfo.txt, затем перейдёт на уровень выше (в данном случае папка SourceMods), после чего - в директорию нужного мода.

Помимо path ID "Game" существует также специальный path ID равный "GameBin", используемый для поиска и загрузки игрой отдельных бинарных файлов. Создавать GameBin для игр нет необходимости - при создании path ID Game "директория" автоматически создаётся path ID GameBin "директория"/bin. Однако в тех случаях, когда нам надо использовать только бинарные DLL-файлы, например серверные плагины, нужно использовать GameBin. Например GameBin "|gameinfo_path|addons/addon1" подключит библиотеки аддона addon1, расположенного в папке мода\addons.

Пример

Ниже приведён пример, демонстрирующий принцип работы файловой системы.

FileSystem
{
  SteamAppId	420   // определение AppId базовой игры для мода - Half-Life 2: Episode 2
  ToolsAppId	211   // определение AppId утилит для мода
  AdditionalContentId	400	// подключение контента Portal
  AdditionalContentId	380	// подключение контента Half-Life 2: Episode 1
  AdditionalContentId	220	// подключение контента Half-Life 2
 
  SearchPaths
   {

Game |gameinfo_path|. // загрузка контента данного мода Game |gameinfo_path|.\..\Mod1 // загрузка контента мода Mod1 (лежит в той же папке

                                                 // что и данный мод (по умолчанию SourceMods))

Game |all_source_engine_paths|ep2 // загрузка контента Hl2:Ep2 Game |all_source_engine_paths|episodic // загрузка контента Hl2:Ep1 Game |all_source_engine_paths|portal // загрузка контента Portal Game |all_source_engine_paths|hl2 // загрузка контента Half-Life 2 GameBin "..\source dedicated server\hl2\addons\plugin1" // загрузка бинарных файлов плагина

                                                                  // plugin1, установленного в папку
                                                                  // Source Dedicated Server\addons
   }
}

В данном случае наивысший приоритет имеют файлы нашего мода, затем файлы мода Mod1, затем игр - Episode 2, Episode 1, Portal, Half-Life 2 и наконец дополнительный плагин. Контент будет загружаться как из реальной файловой системы относительно hl2.exe в папке steamapps\username\half-life 2 episode two, так и из виртуальной. Но при этом будет задействован код только первых найденных DLL. Например если моды не имеют своих DLL, то будет загружен код Episode Two - соответственно нельзя будет например использовать код из Portal и как следствие портальную пушку, поскольку папка ep2 имеет больший приоритет, чем папка portal. Но в то же время можно будет использовать модели из этой игры, и например, создать сражение заскриптованной GlaDOS против охотников из Episode Two. Чтобы использовать физику из Portal, папка portal должна быть указана выше чем ep2.


оригинал Valve