跳到主要内容

🅿️ 占位符

危险

请先查看注意事项

%image_%​

image 占位符用于根据给定的标识符返回对应图像的原始 Unicode 字符及其关联字体。

警告

row 和 column 都是可选的，但如果使用其中一个，就必须同时使用另一个。

%image_mm_<命名空间>:<路径>:[行]:[列]%​

返回 minimessage 格式的图像。

%image_md_<命名空间>:<路径>:[行]:[列]%​

返回 minedown 格式的图像。

%image_raw_<命名空间>:<路径>:[行]:[列]%​

返回原始图像字符

%shift_%​

shift 占位符用于获取偏移字符，常用于菜单标题对齐等操作。

%shift_mm_<数值>%​

返回 minimessage 格式的偏移字符

%shift_md_<数值>%​

返回 minedown 格式的偏移字符

%shift_raw_<数值>%​

返回原始偏移字符

提示

如果你需要在其他插件中使用占位符显示图片，务必确保这些插件支持 MiniMessage 或 MineDown 格式，并能正确发送文本组件。 (我之所以强调这一点，是因为有些设计不佳的插件会强制将富文本转换为旧版的颜色代码。)

另外，你也可以通过 CraftEngine 的数据包拦截功能来显示自定义图片。具体细节请参考此页面。

%checkceitem_%​

checkceitem 占位符用于在其他菜单插件中检查玩家物品栏的 CraftEngine 物品。

%checkceitem_count_<命名空间>:<路径>%​

返回玩家物品栏中指定物品的数量。

%checkceitem_has_<命名空间>:<路径>:[数量]%​

返回玩家物品栏中是否有指定数量的物品。

%checkceitem_id_[槽位]%​

槽位可写不小于 0 的数字，或者 main_hand 和 off_hand 用于分别指定主手和副手槽位。
返回玩家物品栏中指定槽位物品的命名空间ID。

%checkceitem_iscustom_[槽位]%​

槽位可写不小于 0 的数字，或者 main_hand 和 off_hand 用于分别指定主手和副手槽位。
返回玩家物品栏中指定槽位物品是否为自定义物品。

提示

物品槽位数字

%cejs_%

由 JavaScript 脚本通过 //@Placeholder 注解注册的变量。完整使用指南见 📜 脚本。

//@Placeholder("random_number")
function randomNumber(player) {
    return Math.floor(Math.random() * 100)
}

%cejs_<id>%​

求值注册在 <id> 下的脚本函数。函数接收 Bukkit Player/OfflinePlayer 玩家对象（离线上下文可能为 null），需返回字符串。

%cejs_<id>_<参数>%​

如果 <id> 是已注册的前缀，剩余部分会作为 args 绑定传给函数。

// %cejs_top_1_extra%  ->  args = "1_extra"
//@Placeholder("top")
function topN(player, args) {
    return `第 ${args} 名`
}

%rel_cejs_%​

由 //@RelationalPlaceholder 注解注册的关系占位符。函数接收两个 Bukkit 玩家对象（one、two）和原始 args 字符串：

//@RelationalPlaceholder("relation")
function relation(one, two, args) {
    return one.getName() + " -> " + two.getName()
}