/title 与 /titleraw

/title 与 /titleraw

图片处理：未转载源站游戏图像；具体物品、实体、效果或界面说明以中文文字保留。

原文：Commands/title；源修订：3869026。

控制屏幕上显示的文字。标题画面参见标题画面。Java 版 /title 所需权限等级为 2；基岩版 /title 和 /titleraw 为 1，且需要开启作弊。

用法

屏幕标题在玩家画面中央显示为一行居中的大字，还可包含副标题，即主标题下方独立的一行文字。文字也可显示在动作栏，即玩家快捷栏正上方的空间。

Java 版中，这些文字均使用文本组件指定。基岩版中，/title 使用纯文本（仍可应用格式化代码），/titleraw 使用原始 JSON 文本组件。

可设置屏幕标题的淡入、停留和淡出时间。标题大小随 GUI 缩放设置变化；过长的标题不会自动换行，而会从屏幕两侧溢出。每名玩家的 fadeIn、stay、fadeOut 值只发送到该玩家客户端，不存储在服务器。这些值在客户端跨存档、跨服务器保留，仅重启客户端时重置。默认分别为 10 游戏刻（0.5 秒）、70 游戏刻（3.5 秒）、20 游戏刻（1 秒）。

基岩版中，可通过辅助功能设置的“背景不透明度（文本与工具提示）”调整标题黑色背景的不透明度；动作栏的不透明度受“动作栏不透明度”设置影响。

语法

Java 版

title <targets> (clear|reset)
title <targets> (title|subtitle|actionbar) <title>
title <targets> times <fadeIn> <stay> <fadeOut>

基岩版纯文本

title <player: target> <clear|reset>
title <player: target> <title|subtitle|actionbar> <titleText: message>
title <player: target> times <fadeIn: int> <stay: int> <fadeOut: int>

基岩版 JSON

titleraw <player: target> <clear|reset>
titleraw <player: target> <titleLocation: TileRawSet> <raw json titleText: json>
titleraw <player: target> times <fadeIn: int> <stay: int> <fadeOut: int>

详细行为

  • clear：清除指定玩家屏幕上的标题。
  • reset：将指定玩家的副标题重置为空，并将淡入、停留、淡出时间重置为默认值，即 10、70、20 游戏刻。
  • subtitle：若指定玩家当前显示着标题，则更改当前副标题；否则，设置下次显示标题时使用的副标题。
  • title：向指定玩家显示标题，或修改当前标题文字。淡出后副标题重置为空，但淡入、停留、淡出时间不重置。
  • actionbar：向指定玩家显示动作栏文字，或修改当前动作栏标题。
  • times：更改指定玩家当前及今后所有屏幕标题的淡入、停留、淡出时间。

参数

  • targets（Java 版，entity）/ player: target（基岩版，CommandSelector<Player>）：要显示标题的玩家。Java 版可使用玩家名、UUID 或选择多个玩家的目标选择器；基岩版可使用玩家名或玩家类型的目标选择器。
  • title（Java 版，component）：作为主标题、副标题或动作栏显示的文字，须为有效文本组件。
  • titleText: message（基岩版，CommandMessage）：要显示的纯文本消息，可包含空格；其中的目标选择器可解析为对应实体名称。
  • raw json titleText: json（基岩版，Json::Value）：要显示的文字，须为有效 JSON 对象，符合原始 JSON 文本格式。
  • fadeIn、stay、fadeOut（Java 版，time）：淡入、停留、淡出时间。须为数字，可附带 d（天，24000 游戏刻）、s（秒，20 游戏刻）或 t（游戏刻）单位；省略单位时为游戏刻，最小为 0。
  • fadeIn: int、stay: int、fadeOut: int（基岩版）：以游戏刻为单位的淡入、停留、淡出时间，一游戏刻为 1/20 秒。须为 32 位整数，负值按 0 处理。

结果

命令不完整或任一参数指定不正确时无法解析。基岩版中，原始 JSON 消息不符合原始 JSON 文本格式，或选择器不是玩家类型时失败。两版本中，目标未解析为一个或多个在线玩家时失败。其他情况成功。

输出

Java 版失败时成功次数、成功值、结果值均为 0；成功时成功次数和成功值均为 1，结果值为目标玩家数量。基岩版失败时成功次数为 0，成功时为目标玩家数量。

示例

以下三种方法均向所有玩家显示粗体主标题 Chapter I（第一章），以及灰色斜体副标题 The story begins...（故事开始了……）。先设置副标题，再显示主标题；命令中的示例字符串保留原文。

Java 版：

/title @a subtitle {"text": "The story begins...", "color": "gray", "italic": true}
/title @a title {"text": "Chapter I", "bold": true}

基岩版纯文本：

/title @a subtitle §7§oThe story begins...
/title @a title §lChapter I

基岩版原始文本：

/titleraw @a subtitle {"rawtext": [{"text":"§7§oThe story begins..."}]}
/titleraw @a title {"rawtext": [{"translate":"§lChapter %%s","with":["I"]}]}

外部链接

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。