View source for Game text

{{LanguageBar}}
[[Category:GUI Entities]]
{{CD|CGameText|file1=maprules.cpp}} 
{{tabs|game_text|goldsrc=1|source=2|main=source}}
[[File:Game text.png|left|link=]]
{{this is a|point entity|name=game_text|except-multi={{L4d2|4}}}}{{ref|1}}
This entity displays text on player's screens. This text can be defined directly in the Hammer editor (unlike the similar {{ent|env_message}} entity, which uses the <code>[[titles.txt]]</code> file). In multiplayer games, the text will normally only display for the activator of the "Display" input. The "All Players" flag can be ticked in order to display on the screens of all players.


{{note|If you are creating a mod with its own files and scripts, it's recommended to use the aforementioned <tt>env_message</tt> entity, which uses the <code>titles.txt</code> script for text parameters instead of keyvalues, allowing the text to be changed without having to recompile any maps. It also supports newlines and quotation marks, unlike regular <code>game_text</code>.}}
{{tip|Despite comments stating otherwise, <code>game_text</code> supports localized strings (e.g., <tt>#HL2_Chapter4_Title</tt>) in most or all Source games.}}
{{Warning|VMFs can become corrupted when using quotation marks (<tt>"</tt>) in any entity's keyvalues or I/O, so quotation marks cannot be used in the ''Text Message'' field (not even <tt>\"</tt> characters). You can use two apostrophes (<tt><nowiki>''</nowiki></tt>) or detailed quotes (i.e., <tt>&ldquo;</tt> and <tt>&rdquo;</tt>) instead.}}
__TOC__
== Caveats ==
<code>Game_text</code> works as a [[HUD]] element, specifically, a {{code|HudMessage}} element, defined in {{path|<nowiki>/scripts/HudLayout</nowiki>|txt}}. 

Because it was created aiming at low-resolution monitors (owing to Source's age), it is by default restricted to scaling based on 640x480 resolution.

This causes it to scale incorrectly at resolutions higher than 1920x1080. Text will be much larger and some text will be hidden.

It also causes it to only use a limited region of the screen for drawing, and long lines of text, or text near the edges, get cropped on widescreen. This affects other text that uses {{code|HudMessage}}, such as the infamous "A. I. Disabled" message. 

{{fix|Go to {{path|<nowiki>/scripts/HudLayout</nowiki>|txt}} and find the section "HudMessage". Change its <code>"wide"</code> and <code>"tall"</code> values (default: 640 and 480) to "f0" (full size of the viewport). This will increase the maximum size of the invisible VGUI screen that text appears on, making it scale above 1920x1080 resolutions.{{inline note|name=Tested on 2k, 4k, and ultrawide resolutions. Does this work on all resolutions?}}}}
== Flags ==
{{Fl|1|All Players|If this is not set, the message will only show to {{ent|!activator}}.}}

== Keyvalues ==
{{KV Targetname}}
{{KV|Message Text|intn=message|string|Message to display onscreen. <tt>\n</tt> signifies a new line in the text.}}
:{{bug|Hammer will automatically change backslashes to forward slashes, making <tt>\n</tt> impossible to enter.<!--
-->{{workaround|<ul><!--
--><li> Edit the VMF with a text editor, although this will need to be reapplied after each save<!--
--><li> Edit the BSP entity lump with a hex editor, although this will need to be reapplied after each compile<!--
--><li> Use [[AddOutput]] to set the message, as outputs are not affected</ul>}}<!--
-->{{tip|{{hammerpp|2}} does not do this.}} }}
{{KV|X (0 - 1.0 {{=}} left to right) (-1 centers)|intn=x|string|Horizontal position on the player's screens to draw the text. The value should be between 0 and 1, where 0 is the far left of the screen and 1 is the far right. -1 centers the text.}}
{{KV|Y (0 - 1.0 {{=}} top to bottom) (-1 centers)|intn=y|string|Vertical position on the player's screens to draw the text. The value should be between 0 and 1, where 0 is the top of the screen and 1 is the bottom. -1 centers the text.}}
{{KV|Text Effect|intn=effect|choices|Text scan effect}}
:*0: Fade In/Out. The whole text is faded in, and then faded out.
:*1: Credits {{todo|Unknown—seems to act like Fade In/Out. Provide description.}}
:*2: Scan Out. The text is scanned in letter by letter, and the whole text is then faded out.
{{KV|Color1|intn=color|color255|The primary color used by all the text effects. {{note|The color values seem to be added to the background, so either a bright white background or black text will cause the message to be invisible.}} {{note|This keyvalue will default to black for entities not created in Hammer.}} }}
{{KV|Color2|intn=color2|color255|The scanning color for the letter being scanned if the ''Text Effect'' keyvalue is set to ''Scan Out''—usually a different shade of Color1.}}
{{KV|Fade in Time (or character scan time)|intn=fadein|string|The time it should take for the text to fully fade in.}}
{{KV|Fade Out Time|intn=fadeout|string|The time it should take for the text to fade out, after the hold time has expired.}}
{{KV|Hold Time|intn=holdtime|string|The time the text should stay onscreen, after fading in, before it begins to fade out.{{note|This value defaults to zero for entities not created in Hammer.}}}}
{{KV|Scan time (scan effect only)|intn=fxtime|string|If the 'Text Effect' is set to Scan Out, this is the time it should take to scan out all the letters in the text.}}
{{KV|Text Channel|intn=channel|choices|You can have up to six individual <tt>game_text</tt> messages onscreen at once, stored in channels. Select which channel this text should be placed in, which will overwrite any active message already in that channel.}}
:*0: Channel 0 (may be used by some HUD elements) {{Not in FGD}}
:*1: Channel 1
:*2: Channel 2 ({{portal2}} Small text size)
:*3: Channel 3 ({{portal2}} Large text size)
:*4: Channel 4
:*5: Channel 5 (may be used by some HUD elements) {{Not in FGD}}
{{warning|Some HUDs may use Channel 0 and/or Channel 5.}}
{{KV|Master|intn=master|string|Legacy support: The name of a master entity. If the master hasn't been activated, this entity will not activate.}}

== Inputs ==
{{IO|Display|Display the message text.{{note|If the All Players flag is not set, the player must be the {{ent|!activator}} of this input in order for the text to be shown.}}}}
{{IO|SetText|Set the text to display.|param=string|since={{as}}}}
{{tip|{{ent|AddOutput|message}} can be used to change text at runtime in older games which do not support <tt>SetText</tt>, although the <code>Display</code> input must be fired again.}}
{{IO|SetPosX|Set the X position of the text. (0 - 1.0 {{=}} left to right) (-1 centers)|param=float|since={{portal2}}}}
{{IO|SetPosY|Set the Y position of the text. (0 - 1.0 {{=}} top to bottom) (-1 centers)|param=float|since={{portal2}}}}
{{IO|SetTextColor|Set color of the front text.|param=color255|since={{portal2}}}}
{{IO|SetTextColor2|Set color of the transition text.|param=color255|since={{portal2}}}}

== See also ==
* {{ent|game_text_tf}} - {{tf2}} Displays a custom HUD message with icons on a specified team's screen.
* {{ent|point_worldtext}} - {{tf2}}{{csgo}} A similar entity that displays a custom message in the world with far more flexibility.
* {{ent|training_annotation}} - {{tf2}} A similar entity that points to a specified location in the world.
* {{ent|env_hudhint}} - Displays a custom HUD message.  Commonly used to show key-binds. 
* {{ent|env_message}} - Displays a pre-defined message on the players screen.
* {{ent|point_message}} - A similar entity that displays a small custom message at a specific position in the game world.
* [[Customizable triggered HUD-message]] - How to create a new entity that is similar to <tt>game_text</tt> but can receive the message string via a triggered input.

== References ==
# [https://forums.alliedmods.net/showthread.php?t=340355|In Left 4 Dead 2, the feature is not functioning. Here is a technical explanation for this issue.]