Es/Gameinfo.txt

From Valve Developer Community
< Es
Revision as of 06:53, 30 October 2023 by Ryo (talk | contribs) (updating)
Jump to navigation Jump to search
For su equivalente en GoldSrc GoldSrc, see liblist.gam.
For su equivalente en Source 2 Source 2, see gameinfo.gi.

GameInfo.txt es un archivo de configuración de valores clave que describe un mod Source. Además de contener metadatos como el nombre del mod o un enlace a la web del desarrollador. También define de qué juegos depende y SearchPaths que el motor lo usa para buscar recursos. Se almacena en la raíz de la carpeta del mod, las herramientas SDK y Steam trabajan con ello.

Note.pngNota:Boolean se representa como 0 o 1.
Note.pngNota:Si una cadena contiene espacios o tabulados hay que entrecomillar con " ".

Ajustes básicos

Nombre

Las claves que afectan al título de la ventana y menú.

Game ([todo internal name (i)]) <cadena(en)>
El nombre del mod en ASCII. Se muestra en Steam y se usa como ventana del título. Solo se muestra en el menú principal si el título (Title) no se especifica.
Title ([todo internal name (i)]) <cadena(en)>
Una cadena en Unicode mostrada en el menú principal del mod. Se puede añadir una nueva línea al texto del menú añadiendo otra clave con el mismo nombre «Title», pero con un 2 o un número mayor en ella.
Note.pngNota:Cuanto mayor sea el número, el texto estará más abajo.
GameLogo ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Half-Life 2: Episode Two)
En vez de mostrar el texto de «Title», se muestra el contenido en 🖿…\resource\GameLogo.res. Véase Añadir tu logotipo al menú.

Opciones

Claves que afectan a lo que mostrarán las opciones en el panel correspondiente. Véase también Opciones personalizadas: Teclado.

Type ([todo internal name (i)]) <string(en)>
Afecta a lo que aparece en el panel de opciones, el valor será Singleplayer_Only o Multiplayer_Only. Omite esta clave si tu mod tiene ambos modos, individual y multi.
NoDifficulty ([todo internal name (i)]) <boolean(en)>
Oculta la pestaña de dificultad (esto ocurre automáticamente si tu mod es Multiplayer_Only.)
HasPortals ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Half-Life 2: Episode Two)
Muestra la pestaña de opciones de Portal.
NoCrosshair ([todo internal name (i)]) <boolean(en)>
Oculta el menú de selección de mira en modo multijugador.
AdvCrosshair ([todo internal name (i)]) <boolean(en)>
Activa las opciones avanzadas de mira especial.
Pendiente: Cómo implementarlo.
NoModels ([todo internal name (i)]) <boolean(en)>
Oculta el menú de selección de modelo multijugador.
NoHIModel ([todo internal name (i)]) <boolean(en)>
Oculta la caja de cl_himodels, utilizada para los modelos multijugador en GoldSrc GoldSrc. Solo se muestra correctamente si cl_himodels existe en primer lugar. Template:MmodernConfirm
Hidden_Maps ([todo internal name (i)]) <subkey(en)>
Los mapas en la subclave no aparecen en «Crear un servidor». No impide que los usuarios creen su partida cargando el mapa desde la consola. Su sintaxis es mapname 1, con una entrada por línea. No incluye .bsp. Recuerda abrir y cerrar la subclave con las llaves «{» y «}».
CommandLine ([todo internal name (i)]) <subkey(en)> (only in Mapbase)
Lista de opciones de lanzamiento con las que empieza el mod. La sintaxis es -launchoption "value", con una entrada por línea. Recuerda abrir y cerrar la subclave con las llaves «{» y «}».

Lista de juegos de Steam

Las claves que afectan a cómo se mostrará la página de la biblioteca de Steam de tu juego o mod.

Developer ([todo internal name (i)]) <string(en)> Obsolete
Obsoleto.
El desarrollador del mod. Suele poner el nombre del equipo o de la persona si es una única persona. No funciona en la versión actual de Steam.
Developer_URL ([todo internal name (i)]) <string(en)> Obsolete
Obsoleto.
Tu URL o la URL del mod. Debe iniciar con http://. No funciona en la versión actual de Steam.
Manual ([todo internal name (i)]) <string(en)> Obsolete
Obsoleto.
URL manual al mod. También puede ser un archivo local. No funciona en la versión actual de Steam.
Icon ([todo internal name (i)]) <string(en)>
Ruta local a GameInfo.txt, a un archivo TGA 16x16 sin comprimir que será el icono del mod en Steam. NO incluye la extensión del archivo. El icono más grande de 32 píxeles aparecerá en la vista detallada de Steam, junto al de 16 píxeles y llamado <icon>_big.tga.
Note.pngNota:Para que funcionen las transparencias, el TGA debe guardarse en 32 bits con un canal alfa activo.

Motor y herramientas

Las claves que afectan a cómo el motor y las herramientas se ejecutan y realizan algunas opciones.

Nodegraph ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Half-Life 2: Episode Two)
Permite activar o no nodegraph (archivos .ain) en mapas.
GameData ([todo internal name (i)]) <string(en)>
Ruta a un archivo FGD, relativo a la ubicación de Hammer. Es necesario compilarlo en el mapa. No lo usa el propio Hammer.
InstancePath ([todo internal name (i)]) <string(en)> (en todos juegos desde Source 2013)
La ubicación por defecto para buscar instancias VMF.
SupportsDX8 ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Left 4 Dead)
Al desactivarse evita que el juego se ejecute en versiones de DirectX antiguas, como DX8 o inferior. No permite graficos a máximo nivel y evita también que Studiomdl produzca code>.sw.vtx y .dx80.vtx para modelos, ya que no se necesitan.
SupportsVR ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Source 2013)
Hace que el juego se pueda ejecutar o no en modo RV.
SupportsXBox360 ([todo internal name (i)]) <boolean(en)> (en todos juegos desde Left 4 Dead)
Hace que el juego se puede ejecutar o no en Xbox 360 (y posiblemente otras consolas o su mando).
Confirmar:Does this enable being able to use a Xbox 360 controller with the game?, this was disabled in Counter-Strike 2, according to csgo_core\gameinfo.gi.

FileSystem

Las claves que se encuentran en la subclave FileSystem.

SteamAppID ([todo internal name (i)]) <integer(en)>
La id. de aplicación del juego en el que se basa el mod. El mod tendrá acceso a todo el contenido de dicho juego y no será jugable si no está instalado. El mod se ejucatará a la par que el juego base. Si estás subiendo tu juego Source a Steam, esta será tu id. de aplicación. De otro modo será 243750 para Source 2013 Multiplayer Source 2013 Multiplayer, 243730 para Source 2013 Source 2013, 630 para Alien Swarm Alien Swarm o el id. de aplicación del juego correspondiente si no pretenece a Source.
Note.pngNota:Los mods Source mas antiguos usarán el id. 215 para Source 2006 y 218 para Source 2007. Si estás creando un mod nuevo, no deberías usar estos id., ya que están desactualizados y fueron sustituidos por Source 2013 y Alien Swarm. Solo se usan para dar apoyo a versiones.
Note.pngNota:Tu mod no estará protegido por VAC VAC si está desarrollado para un jugador.
AdditionalContentId ([todo internal name (i)]) <integer(en)> Obsolete
Obsoleto.
Otro id. de aplicación al que tiene acceso el mod. Esta característica se añadió al código fuente de SDK pero nunca se usó en otros juegos de Valve; tendrás que compilar tus propios elementos para usarlo. Si tienes que usarlo en varias aplicaciones, realiza estos cambios.
Icon-Bug.pngError:El motor entiende este comando, pero las herramientas de SDK desafortunadamente no. La mejor solución, actualmente, es copiar el contenido del juego a una ubicación de tu disco duro y añadir un SearchPath a él. Recuerda eliminar SearchPath antes del lanzamiento.  [todo tested in ?]
ToolsAppId ([todo internal name (i)]) <integer(en)> Obsolete
Obsoleto.
Esta es la id. de aplicación que usa el SDK actualmente.

SearchPaths

SearchPaths es una subclave con FileSystem. Contiene una clave para cada ruta de búsqueda. Cuando el motor necesita un archivo atraviesa las rutas de búsqueda, deteniéndose al encontrar el archivo deseado.

Note.pngNota:Una cosa a tener ene mente, se realiza en el orden que el usuario ponga como más importante, si hay 2 archivos con el mismo nombre en 2 rutas distintas y el usuario las pone al final, se elegirá la que esté primero.

Directorios

El directorio, que es el valor de clave, será relativo al SteamAppID del directorio (por ejemplo, donde está el ejecutable del juego), relativo a GameInfo.txt o absoluto. Un ejemplo de cada uno, respectivament, sería:

Game |All_Source_Engine_Paths|HL2 // Go to the executable directory, and mount a folder called HL2 in it. Game HL2 // Also go to the executable directory, and mount a folder called HL2 in it. Game |GameInfo_Path|. // Go to the directory of where GameInfo.txt is located, and mount the folder it’s in. Game "C:\MyFolderOfContent\content" // Mount this absolute directory, useful for mounting content temporarily.
Note.pngNota:In order to mount a VPK file, you need to add the VPK’s name at the end of the directory with the .vpk extension. If the VPK is a multi-chunk VPK, then put the name of the VPK in without the "_dir" or "_###" at the end.

The 2 variables above will start the search in a certain directory, |All_Source_Engine_Paths| will start the directory within the root folder, and |GameInfo_Path| will start it in the folder where GameInfo.txt is located. Both of these variables can be appended with any number of folders. There are also some special commands you can append in addition to the folders and variables, the known ones are:

  • ../
    Goes back one folder, this will useful for mounting other games’ content like Portal Portal, since AdditionalContentID is deprecated. If you wanted to mount Portal, and your game is in, say for example "<SteamFolder>\SteamApps\Common\MyGame\FolderWhereGameInfoIs", you would create a search path like this to mount it’s content:
// Start in the executable directory, then go back one folder so we're in Common, and then go into Portal/portal and mount portal_pak.vpk Game |All_Source_Engine_Paths|../Portal/portal/portal_pak.vpk


Here is also an example of how to mount a SourceMod:

// Start in the executable directory, then go back two folders so we're in SteamApps, and then go into SourceMods and mount the MySourceMod folder. Game |All_Source_Engine_Paths|../../SourceMods/MySourceMod


  • .
    This stops the search in the current directory, this should only be used if you want to directly mount where |All_Source_Engine_Paths| or |GameInfo_Path| are. An example of both:
// Mount both |All_Source_Engine_Paths| and |GameInfo_Path| variables' path. Game |All_Source_Engine_Paths|. Game |GameInfo_Path|.


  • /*
    Mount every sub-folder and VPK in the current directory, this command is what makes the custom folder work in most update to date Source games. An example of it's use:
// Mount the custom folder's sub-folders and VPKs. Game |GameInfo_Path|custom/*

Claves

En la mayoría de juegos Source, las únicas claves de búsqueda de rutas son Game y Platform, las cuales sirven para la mayoría de rutas de búsqueda, en Source 2013 se introdujeron algunas nuevas para añadir más control.

Tip.pngConsejo:Insurgency Insurgency y Day of Infamy Day of Infamy usan el mismo sistema de ruta de búsqueda de Source 2013, ¡por lo que los comandos y claves que funcionan en Source 2013 también lo harán en ellos!

Las claves conocidas actualmente son:

  • Game
    Añade la ruta como ruta de búsqueda simple. Añadirá cualquier contenido que encuentre. También crea sound.cache en cada directorio de juego.
  • Game_Write (en todos juegos desde Source 2013)
    Marca la ruta de búsqueda en una ruta de juego escrita. Marca el directorio como predeterminado para escribir en dicho juego.
  • GameBin (en todos juegos desde Source 2013)
    Una clave especial que requiere que la ruta lleve a archivos binarios del juego (donde Server.dll y Client.dll están) y usará cualquier otro DLL que encuentre. Esto te llevará a tu propia carpeta Bin del mod o del juego en el que se basa la carpeta Bin, si no compilas tus propios DLL.
  • Platform
    Añade una ruta de búsqueda especial a la carpeta que contiene los archivos del motor, esto llevará a la carpeta Platform del juego.
  • Mod (en todos juegos desde Source 2013)
    Marca la ruta de búsqueda como una ruta de mod. Suele ser donde se encuentra el ejecutable. Esencial para mostrar la lista de capítulos en el menú de Nueva partida y alguna cosa más.
  • Mod_Write (en todos juegos desde Source 2013)
    Marca la ruta de búsqueda como una ruta de mod. Suele ser donde se encuentra GameInfo.txt. Marca el directorio como predeterminado para escribir los archivos guardados y listas de descarga de este mod.
  • Default_Write_Path
    Marca la ruta de búsqueda como una ruta de escritura por defecto. Suele ser donde se encuentra GameInfo.txt. Marca el directorio como predeterminado para archivos config.cfg, node_graphs, capturas de pantalla y otros archivos del mod. Además es un recurso para cuando Mod_Write o Game_Write no se ha especificado.
  • VPK (en todos juegos desde Contagion)
    Usado para montar un VPK por nombre. No hay que poner .vpk al final.


En Source 2013, también se pueden combinar claves con otras, separando cada nombre por un símbolo +, de este modo, si necesitas usar un directorio para varias claves, en vez de escribir esto:

Game |GameInfo_Path|MyFolder Mod |GameInfo_Path|MyFolder

Se puede abreviar así:

Game+Mod |GameInfo_Path|MyFolder

Esto ahorra tiempo a la hora de reescribir el directorio de nuevo.

Localización automática

Source crea automáticamente rutas de búsqueda localizadas. Si se monta la carpeta HL2, al ejecutar el mod en frances HL2_French se monta automáticamente sobre él, sobrescribiendo HL2.