Editing MinecraftCommands (section)

=== title ===

{{/infobox
|title
|op
|1.8|14w20a
}}

Controls screen titles.

Screen titles are displayed to players as a single line of large center-aligned text in the middle of their displays and can include a second line of text called a "subtitle". Both lines are specified using [[#Raw JSON text|complicated formatting]]. Screen titles can be set to fade in and fade out, and the duration they are displayed can also be specified. Screen titles scale in size with the [[Options#Video Settings|GUI Scale]] and screen titles which are too big to fit on the screen are not line-wrapped (they just overflow off the screen on both sides).

;Syntax

: The command has five variations, each with different arguments.

: <code>title <''player''> clear</code> (removes the screen title from the screen)
: <code>title <''player''> reset</code> (resets options to default values)
: <code>title <''player''> subtitle <''title''></code> (specifies the subtitle text)
: <code>title <''player''> times <''fadeIn''> <''stay''> <''fadeOut''></code> (specifies fade-in, stay, and fade-out times)
: <code>title <''player''> title <''title''></code> displays the screen title)

;Arguments

: ''player''
:: Specifies the player(s) to display a screen title to. Must be a player name or [[#Target selectors|target selector]].

: ''title'' (<code>subtitle</code> and <code>title</code> mode only)
:: Specifies the text to display as a title or subtitle. Must be valid [[#Raw JSON text|raw JSON text]] (for example, <code>{"text":"Chapter I","bold":true}</code>).

: ''fadeIn'', ''stay'', and ''fadeOut'' (<code>times</code> mode only)
:: Specifies the time in [[Tick|game tick]]s (1/20ths of a second) for the screen title to fade in, stay, and fade out. All values must be between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas), but values below 0 will be treated as 0. If not specified (or if reset), defaults to 20 (1 second), 60 (3 seconds), and 20 (1 second).

;Result
[[File:Title command.png|thumb|Example result of the title command.]]

: Fails if the arguments are not specified correctly, or if ''player'' fails to evaluate to one or more online players.

: On success:
:* <code>clear</code> — Clears the screen title from the screens of the specified player(s). If no screen title is currently being displayed, has no effect.
:* <code>reset</code> — Resets the subtitle text to blank text, and the fade-in, stay and fade-out times to their default values for the specified player(s).
:* <code>subtitle</code> — If a screen title is currently being displayed to the specified player(s), changes the current subtitle to ''title''; otherwise, specifies the subtitle for the next screen title to be displayed to the specified player(s).
:* <code>times</code> — Changes the fade-in, stay, and fade-out times of all current and future screen titles for the specified player(s).
:* <code>title</code> — Displays a screen title to the specified player(s), or changes the current screen title to ''title''. After fading out, resets the subtitle back to blank text, but does not reset fade-in, stay, and fade-out times.

;Examples

: To display a bold screen title "Chapter I" with a gray italic subtitle "The story begins…" to all players:
:# <code>title @a subtitle {"text":"The story begins…","color":"gray","italic":true}</code>
:# <code>title @a title {"text":"Chapter I","bold":true}</code>


<!-- please retain double newline above for section differentiation -->