config.yml
Xerr 全局功能的完整字段参考
plugins/Xerr/config.yml 只负责全局功能。具体 HUD、Popup、Compass 和 Screen 不写在这里。
文件关系
完整结构
feature:
gui:
enable: true
start: "<<"
end: ">>"
tab:
enable: true
start: "<<"
end: ">>"
refresh: 10
hide-background: false
tooltip:
enable: false
start: "<<tooltip:"
end: ">>"
actionbar:
enable: false
hide:
hud:
heart: true
food: true
oxygen: false
armor: false
version:
cross-version: true
version-id: 12104
resource-pack:
compression: true
merge: []
protection: false
self-host:
enabled: false
bind-address: "0.0.0.0"
port: 8163
public-url: ""
send-on-join: false
force: falseGUI 库存界面
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.gui.enable | 布尔 / true | 是否解析库存界面标题中的布局标记 | 重载 |
feature.gui.start | 字符串 / << | 标记开头 | 重载 |
feature.gui.end | 字符串 / >> | 标记结尾 | 重载 |
标题示例:
<<shop_title>>传入变量:
<<shop_title::name=杂货店;page=2>>库存界面使用布局的局部坐标,不使用屏幕 anchor。完整制作过程见GUI 库存界面。
TAB 页眉与页脚
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.tab.enable | 布尔 / true | 解析 TAB 页眉、页脚中的布局标记 | 重载 |
feature.tab.start | 字符串 / << | 标记开头 | 重载 |
feature.tab.end | 字符串 / >> | 标记结尾 | 重载 |
feature.tab.refresh | 整数 / 10 | TAB 普通内容的刷新间隔,单位 tick | 重载 |
feature.tab.hide-background | 布尔 / false | 隐藏原版页眉、页脚和玩家名单的默认背景 | 打包 |
在 TAB 插件的页眉或页脚填写 <<布局ID>> 即可使用。布局使用局部 X/Y,屏幕 anchor 不参与定位;玩家名单、分组和排序仍由原有 TAB 插件管理。
TAB 刷新与 HUD 的布局刷新设置独立。默认主题、变量和留白示例见 TAB 页眉与页脚。
物品提示
需要 Minecraft 1.21.2 或以上版本。
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.tooltip.enable | 布尔 / false | 启用物品提示绑定与排版 | 重载 |
feature.tooltip.start | 字符串 / <<tooltip: | Tooltip 模板标记开头 | 重载 |
feature.tooltip.end | 字符串 / >> | 标记结尾 | 重载 |
在 core/template/tooltips/ 中自行创建模板,不附带主题或物品。布局、绑定与数据路径见物品提示。更新由事件触发,没有单独的逐 tick 刷新字段。
ActionBar 接管
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.actionbar.enable | 布尔 / false | 接管原版和其它插件的 ActionBar 文字,交给 BossBar HUD 显示 | 重载 |
开启后,布局通过 {{ get @actionbar }} 读取消息。自带 action HUD 需要保持启用。完整配置与默认布局见 HUD 的 ActionBar 接管。
隐藏原版 HUD
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.hide.hud.heart | 布尔 / true | 隐藏原版生命图标 | 打包 |
feature.hide.hud.food | 布尔 / true | 隐藏原版饥饿图标 | 打包 |
feature.hide.hud.oxygen | 布尔 / false | 隐藏原版氧气图标 | 打包 |
feature.hide.hud.armor | 布尔 / false | 隐藏原版护甲图标 | 打包 |
隐藏生命图标会同时隐藏中毒、凋零、吸收生命、冰冻、硬核和载具生命等原版心形提示。Xerr 不会自动还原所有状态。
资源包版本
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
feature.version.cross-version | 布尔 / true | 生成覆盖 1.20.1~26.3 的多版本包 | 打包 |
feature.version.version-id | 整数 / 12104 | 关闭跨版本后使用的目标版本 | 打包 |
| version-id | Minecraft |
|---|---|
12001 | 1.20.1~1.20.4 |
12005 | 1.20.5~1.21.1 |
12102 | 1.21.2~1.21.3 |
12104 | 1.21.4~1.21.5 |
12106 | 1.21.6~1.21.8 |
12109 | 1.21.9~1.21.11 |
260100 | 26.1~26.1.2 |
260200 | 26.2 |
260300 | 26.3 |
资源包合并与保护
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
resource-pack.compression | 布尔 / true | 控制图片、JSON 体积优化和 ZIP 压缩;调试时可关闭 | 打包 |
resource-pack.merge | 字符串列表 / [] | 外部资源包目录或 ZIP,路径相对于 plugins | 打包 |
resource-pack.protection | 布尔 / false | 增加常见解压工具直接提取内容的难度 | 打包 |
目录和 ZIP 使用同一个列表。找不到的来源会警告并跳过;资源冲突需要处理后才能成功生成。合并后的成品是 generated/resource_pack.zip,自托管也使用这份成品。
默认开启压缩优化。调试时将 compression 设为 false,会跳过体积优化并生成无压缩 ZIP;自托管仍使用同一份成品。包体会变大,主要加快服务端生成,不保证客户端下载或重载更快。提取保护独立控制,不是加密,也不能保证内容无法提取。完整示例见与其它资源包合并。
自托管
| 字段 | 类型 / 自带配置值 | 说明 | 生效 |
|---|---|---|---|
resource-pack.self-host.enabled | 布尔 / false | 开启内置下载服务;成功打包后向在线玩家发送 | 重载 |
resource-pack.self-host.bind-address | 字符串 / 0.0.0.0 | HTTP 服务监听地址 | 重载 |
resource-pack.self-host.port | 整数 / 8163 | 独立下载端口 | 重载 |
resource-pack.self-host.public-url | 字符串 / 空 | 客户端访问地址;留空时自动探测 | 重载 |
resource-pack.self-host.send-on-join | 布尔 / false | 玩家进服时发送,并在启动后准备资源包 | 重载 |
resource-pack.self-host.force | 布尔 / false | 在平台支持时要求客户端必须加载 | 重载 |
网络配置和故障排查见资源包参考。