PlaceHolderAPI

 需要插件

要跟随本教程，你必须安装 PlaceHolderAPI。

使用 PlaceHolderAPI 的占位符

如果你想使用 PlaceHolderAPI 的占位符来扩展你的故事，你可以通过检查 PlaceHolderAPI 图标是否位于文本框上方来实现（见图片）：

只需使用 PlaceHolderAPI 的格式，你就可以让它们工作。例如，%player_name% 会返回玩家的名字。

 未生效

如果占位符未生效，请确保你已经安装了相应的占位符。例如，对于 %player_name%，你必须通过 PlaceHolderAPI 的 ecloud 安装 player。为此，只需运行：/papi ecloud download player。

使用 TypeWriter 的占位符

TypeWriter 提供了两个与 PlaceHolderAPI 一起使用的占位符：

• %typewriter_entryid%
• %typewriter_entryname%

这两个占位符提供相同的信息，但你可以选择以不同的方式访问它们。通常建议使用条目 ID 以获得更可靠的结果，但条目名称也是一个选项。

要查找条目 ID，请参考以下图片：

你的 TypeWriter 占位符可能类似于 %typewriter_W2X2ZbG0pzXGsS6%。
然后，当调用占位符时，它会检查 ID 并：

• 如果条目是发言者，它会返回显示名称。
• 如果条目是变量，它会返回变量值。
• 如果条目是声音，它会返回资源包声音的 ID。
• 如果条目是实体，它会返回实体的显示名称。
• 如果条目是行条目，它会返回行条目的内容。
• 如果条目是任务，它会返回任务的显示名称。
• 如果条目是目标，它会返回目标的格式化显示名称。
• 如果条目是侧边栏，它会返回侧边栏的标题。

占位符参数

有时，你可能希望从条目中获取不同的信息。这可以通过使用占位符参数来实现。以下是一些占位符参数的非详尽列表：

变量条目

• %typewriter_<entry id>:remaining:<number>%: 返回 <number> - 变量值（当玩家需要收集一定数量的东西时，这很有用，你可以显示他们还需要收集多少）。
• %typewriter_<entry id>:time:lastUpdated%: 显示变量更新的时间。
• %typewriter_<entry id>:time:lastUpdated:relative%: 显示自变量更新以来的时间，例如 3m 20s。

可过期的变量

• %typewriter_<entry id>:time:expires%: 变量过期的时间。
• %typewriter_<entry id>:time:expires:relative%: 显示变量过期前的时间，例如 3m 20s。

自定义占位符

Typewriter 还有两个自定义占位符，它们是：

• %typewriter_tracked_quest%: 显示当前跟踪任务的显示名称。
• %typewriter_tracked_objectives%: 显示跟踪任务的活跃目标的显示名称。