跳转到正文
iPlugin

命令与权限

资源包生成、显示管理、物品提示与权限

先登记配置并打包后再调用显示命令。本文中的 <参数> 必填、[参数] 可选,这些尖括号与方括号不用真的输入。

所有命令以 /xerr 开头。输入不完整命令时,TabooLib 会显示可用参数并提供补全。

基础权限

权限用途
xerr.command使用主命令
xerr.command.admin.reload重载配置
xerr.command.admin.pack生成与发送资源包
xerr.command.admin.print测试图片
xerr.command.admin.popup管理 Popup
xerr.command.admin.screen管理 Screen
xerr.command.admin.compass管理 Compass
xerr.command.admin.tooltip管理物品提示、查询数据路径

重载

/xerr reload

重新读取主配置、Layout、显示配置和模板,并按新配置重启自托管服务。

重载不会替客户端重新生成资源包。修改了图片、字体、坐标或资源包结构时,请使用 /xerr pack。

生成资源包

/xerr pack

在后台生成资源包,完成后返回结果。

自托管开启时,成功打包后会向在线玩家发送最新资源包。生成失败不会发布损坏的包。

单独发送资源包

/xerr pack send [玩家]

仅向目标玩家发送当前已发布的资源包,不重新生成,也不会发送给其他玩家。玩家省略名字时发给自己;控制台必须指定在线玩家。需要启用自托管且已有成功发布的资源包,未就绪时会提示。

可以重复发送同一份包,不受 send-on-join 开关影响;沿用自托管的强制加载设置。

测试图片

/xerr print img <namespace> <basename> <图片ID>

例如:

/xerr print img xerr_ui icon health

其它显示方式:

/xerr print img xerr_ui icon health title 10 40 10
/xerr print img xerr_ui icon health subtitle 10 40 10

Title 和 Subtitle 后面的三个数字依次为淡入、停留和淡出 tick。

物品提示

/xerr tooltip types
/xerr tooltip bind <模板>
/xerr tooltip unbind
/xerr tooltip data [路径]

types 列出已加载的模板 ID。其余命令由玩家执行:bind 应用到主手物品,unbind 停止显示与自动应用,原始名称和 Lore 保持不变,data 查询物品已保存的数据。重新绑定后恢复自动应用,不提供玩家参数或物品生成操作。

绑定前需自行创建模板并加载资源包,详见制作物品提示与数据路径。

列出可用 Popup 类型:

/xerr popup

显示弹窗:

/xerr popup show <Popup ID> [玩家]

查询和管理实例:

/xerr popup list [玩家]
/xerr popup stop <实例UUID> [玩家]
/xerr popup clear [玩家]
/xerr popup clear force [玩家]

最后一个玩家参数可省略,省略时作用于自己;控制台必须指定在线玩家。force 会立即结束,不播放退场动画。

Popup ID 是类型,实例 UUID 是每次触发后生成的独立实例。修改类命令成功后静默,只在失败时返回错误;list 仍会输出实例。

Screen

/xerr screen show <效果 ID> [玩家]
/xerr screen stop <效果 ID> [玩家]
/xerr screen list [玩家]
/xerr screen clear [玩家]

示例:

/xerr screen show yellow_transition
/xerr screen show yellow_transition Steve
/xerr screen show movie Steve

省略玩家时作用于自己;控制台必须指定在线玩家。修改类命令成功后静默,list 仍会输出实例。show 统一显示幕布和播放过场;过场按配置时长自动结束。stop 按效果 ID 停止目标玩家的全部同名实例,保留退出动画,不影响其他效果或其他玩家。

Compass

列出可用罗盘及命令帮助:

/xerr compass

添加固定坐标:

/xerr compass set <罗盘> <目标ID> <世界> <x> <y> <z> [样式] [玩家]

示例:

/xerr compass set navigation home world 120 64 -300 home
/xerr compass set navigation home world 120 64 -300 home Steve

跟随在线玩家:

/xerr compass follow <罗盘> <目标玩家> [样式] [查看玩家]

示例:

/xerr compass follow navigation Alex teammate
/xerr compass follow navigation Alex teammate Steve

第二条表示让 Steve 的罗盘跟随 Alex。跟随目标的 ID 自动使用目标玩家名,不需要额外填写 leader。

使用默认样式并指定其他观看者时,明确填写 default:

/xerr compass follow navigation Alex default Steve

管理目标:

/xerr compass list <罗盘> [玩家]
/xerr compass remove <罗盘> <目标ID> [玩家]
/xerr compass clear <罗盘> [玩家]
/xerr compass hide <罗盘> [玩家]
/xerr compass show <罗盘> [玩家]

命令创建的目标优先级固定为 0;高级优先级通过 Kether 或 API 设置。clear 不删除外部 Provider 提供的只读目标。修改类命令成功后静默,list 仍会输出目标。