跳转到正文
iPlugin

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: false

GUI 库存界面

字段类型 / 自带配置值说明生效
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整数 / 10TAB 普通内容的刷新间隔,单位 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-idMinecraft
120011.20.1~1.20.4
120051.20.5~1.21.1
121021.21.2~1.21.3
121041.21.4~1.21.5
121061.21.6~1.21.8
121091.21.9~1.21.11
26010026.1~26.1.2
26020026.2
26030026.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.0HTTP 服务监听地址重载
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在平台支持时要求客户端必须加载重载

网络配置和故障排查见资源包参考。