搁置

Back-burner

一个完全在客户端运行的待办事项列表，显示在屏幕侧面，通过命令操作。

每个世界和服务器都会分别保存各自的待办事项列表。

文件位置

数据以 JSON 字符串数组的形式保存。

对于单人游戏世界，文件保存在世界目录的根目录下，名为 backlog.json

对于多人游戏，文件保存在 .minecraft/remote_backlogs/ 目录下，文件名使用服务器的 IP/地址和端口。局域网世界也采用相同方式处理。

配置

可以在游戏内通过 Cloth-Config 和 ModMenu 编辑配置。 这样可以让你更改 HUD 的位置和大小。

命令

默认情况下，所有子命令都以 /note 为根命令。为避免冲突，根命令的名称可以在配置界面中进行更改。

<text> 参数同时接受原始文本和 SNBT 文本（参见下方文本格式）。原始文本无需加引号。

<index> 参数也支持使用 first 和 last 代替数字值。

添加条目

• push <text> 在最顶部添加一个条目。
• queue <text> 在最底部添加一个条目。
• write <text> 向列表中添加一个条目。（参见配置界面。）
• add|insert <index> <text> 在任意索引位置添加一个条目。

移除条目

• pop 移除最顶部的条目。
• shift 移除最底部的条目。
• pop|remove <index> 移除指定的条目。自动补全功能会显示对应索引的文本。
• clear 清空所有条目。

编辑

• edit <index> <text> 覆盖现有的条目。自动补全功能会建议旧值。
• bump <index> 将条目向上移动一位。
• bump <index> <offset> 将条目移动指定的位数。正值向上移动，负值向下移动。
• move <from> <to> 将条目从一个索引移动到另一个索引。

HUD

• hide <bool> 切换 backlog HUD 的显示或隐藏。也可以不传入参数调用。

调试

这些命令在正常使用中不是必需的。

• save 强制将 backlog 保存到其文件中。（每当你使用其他命令做出任何更改时，都会自动调用此命令。）
• reload 强制从文件中重新加载 backlog。（加入世界时会自动调用此命令。）

文本格式

原始文本是贪婪匹配的，不需要加引号：

/note push I am an unquoted text

使用 SNBT 文本时，它也可以用于数组中，例如资源包的描述字段。该格式在不同版本的 Minecraft 中会有一些差异。

简单 SNBT：

/note push { text:"32x Redstone", color:red, bold:1, italic:1 }

部分着色文本：（MC 1.21.5 及更早版本）

/note push [{text:"32x "}, {text:Redstone,color:red}]

部分着色文本：（MC 1.21.6 及更新版本）

/note push ["32x ", {text:Redstone,color:red}]

带精灵图的文本：（MC 1.21.9 及更新版本）

/note push ["32x ", {atlas:items,sprite:item/redstone}, {text:Redstone,color:red}]

资源包

除了纹理之外，资源包还可以通过修改对应纹理的 .mcmeta 文件，来调整 backlog HUD 布局的一些次要方面。

• basis：{ width, height } 元素在屏幕上的基础尺寸。 对于 16x 资源包，这严格等于纹理的尺寸。对于 32x 资源包，这是纹理尺寸的一半。以此类推。 这些元素没有特定的纹理尺寸要求；这里指定的值才是定义期望尺寸的依据。
• basis：{ fill }（布尔值）元素是否应占用允许的最大水平空间（true），还是缩小以适应文本（false）。
• ninepatch：{ top, bottom, left, right } 九宫格的边距。即不会被拉伸以适应元素尺寸的区域。
• padding：{ top, bottom, left, right } 将添加在元素周围的空白区域。可以使用负值去除空间，并使元素重叠。
• textarea：{ top, bottom, left, right } 纹理内部不会填充文本的边距。
• text：{...} 该元素文本的不同颜色，格式为 #aarrggbb 十六进制代码。alpha 组件是必需的。
  • colour 是文本的主要颜色。
  • outline 定义主要描边颜色。
  • outerline 在第一个描边周围添加更粗的描边。需要先定义前者。
• text：{ shadow }（布尔值）文本是否应有阴影。与任何描边不兼容。