跳转至

CMI 占位符大全🔗


语言文件(Locale file)中可以包含 PlaceholderAPI 占位符,用于在 CMI 消息中显示。只有以 %cmi_ 开头的占位符才会被 PlaceholderAPI 使用,但 CMI 在大多数地方可以使用所有这些占位符。

截至目前,占位符列表可以随时在游戏内使用 /cmi placeholders 命令查看。

占位符内还可以嵌套另一个占位符。例如 %cmi_equationint_{cmi_user_maxperm_cmi.command.sethome_1}+1%,这意味着你有 2 个占位符,首先被处理的是被 { 和 } 括起来的那一个,本例中它会根据权限节点返回最大值。之后,它会作为常规算式处理并返回结果。

以下是一些自定义/非静态占位符:

礼包冷却(Kit cooldowns)🔗

  • %cmi_user_kitcd_[礼包名]% - 用于显示礼包剩余的冷却时间。如果礼包可以使用,将显示短横线(-)。

投票排行(Top Votes)🔗

  • %cmi_votetop_[1-10]% - 用于显示按投票数排序的前 10 名。

物品价值(Worth)🔗

  • %cmi_worth_buy_[物品ID名:数据]% - 用于从 worth 文件中显示物品的购买价格。
  • %cmi_worth_sell_[物品ID名:数据]% - 用于从 worth 文件中显示物品的出售价格。

例如 %cmi_worth_buy_diamondsword%

玩家元数据(User Meta)🔗

  • %cmi_user_meta_[键]% - 用于自定义占位符。通过使用 /cmi usermeta [玩家名] [add/remove/clear/list/increment] (键) (值) (-s) 命令来利用它。例如使用 /cmi usermeta Zrips add testkey Coffee,并在 CMI 或其它插件中使用 %cmi_user_meta_testkey%,你将得到结果 Coffee。一个玩家可以拥有的自定义元数据数量没有限制,但强烈建议保持在合理的数量内。
  • increment(递增)可用于改变数值。例如 /cmi usermeta Zrips increment counting +0.5 将得到 0.5,再次执行将得到 1。负数可以用来减去数值。
  • %cmi_user_metaint_[键]% - 会尝试将元数据值作为整数输出。

监狱(Jail)🔗

  • %cmi_jail_reason_[监狱名]_[牢房ID]% - 用于显示玩家被关入特定监狱和牢房时定义的入狱原因。如果同一牢房内有超过 1 名玩家,则显示最近一次的原因。
  • %cmi_jail_time_[监狱名]_[牢房ID]% - 用于显示在特定监狱和牢房中的剩余服刑时间。如果同一牢房内有超过 1 名玩家,则显示最近一名玩家的剩余时间。
  • %cmi_jail_username_[监狱名]_[牢房ID]% - 用于显示关押在特定监狱和牢房中的玩家名称。如果同一牢房内有超过 1 名玩家,则显示最近一名玩家的名称。

权限检查(Permission Check)🔗

  • %cmi_user_maxperm_[核心权限]_[默认值]% - 从权限节点中获取最大值。例如,如果玩家拥有以下权限:

  • cmi.command.sethome.1

  • cmi.command.sethome.3
  • cmi.command.sethome.4

那么像 %cmi_user_maxperm_cmi.command.sethome_0% 这样的占位符将返回 4。其中 0 是默认值,用于玩家没有任何这类带数值的权限节点的情况。

如果你的占位符默认值高于玩家实际拥有的值,那么将使用默认值。在这种情况下,如果你使用 %cmi_user_maxperm_cmi.command.sethome_6% 占位符,它将返回 6 而不是 4。

随机值(Random values)🔗

  • %cmi_random_[from]_[to]% - 将返回给定范围之间的随机值。例如 %cmi_random_1_5% 可以返回数值:1 2 3 4 5。
  • 这可用于某些特殊命令中,在执行时获得随机结果。

BungeeCord🔗

围绕 bungee 网络的占位符。为获得最佳效果,你需要在网络中设置有关你服务器的信息。请查看 config.yml 文件中 BungeeCord 部分的配置。

  • %cmi_bungee_total_[服务器名]% - 返回该服务器的最大在线人数
  • %cmi_bungee_current_[服务器名]% - 返回当前玩家数量
  • %cmi_bungee_motd_[服务器名]% - 返回该服务器的 motd
  • %cmi_bungee_onlinestatus_[服务器名]% - 返回服务器的在线/离线状态

算式求解器(Equation solver)🔗

  • %cmi_equation_[算式]%%cmi_equationint_[算式]% - 将处理数学算式并返回结果。在第一种情况下,结果可以带小数,如 2.4;在第二种情况下,只返回整数,如 2。
  • 算式可以简单到 2+2,也可以复杂到 sin(6)+pi*tan(5)/1.5。

统计(Statistics)🔗

  • %cmi_user_stats_[主统计(:可选子统计)]% - 根据提供的条件返回玩家统计数据。格式与位阶晋升系统使用的格式相同。例如 %cmi_user_stats_MonsterKills% 返回怪物击杀总数,而 %cmi_user_stats_MonsterKills:zombie% 返回僵尸击杀总数。
  • 此占位符可以返回 3 种类型的值:纯数字(如怪物击杀数)、时间(如总游戏时长)和距离。

完整占位符列表(Full List of Placeholders)🔗

静态占位符可以在游戏内通过 /cmi placeholders 命令查看,该命令会显示带有可能输出值的示例:

  • %cmi_user_charges_left% - 刷怪笼剩余的能量次数
  • %cmi_user_charges_max% - 刷怪笼能量允许的最大值
  • %cmi_user_charges_time% - 距离下次刷怪笼能量补充的时间
  • %cmi_user_charges_cooldown% - 刷怪笼能量补充的冷却时间
  • %cmi_user_display_name% - 格式化后的玩家显示名称
  • %cmi_p_[玩家名]_display_name% - 格式化后的玩家显示名称
  • %cmi_user_cleannickname% - 玩家的昵称(如已设置),否则为玩家名称。不含颜色代码
  • %cmi_user_nickname% - 玩家的昵称(如已设置),否则为玩家名称
  • %cmi_user_name% - 玩家的原始名称
  • %cmi_p_[玩家名]_name% - 玩家的原始名称
  • %cmi_user_uuid% - 玩家 UUID
  • %cmi_user_uuid_[玩家名]% - 玩家 UUID
  • %cmi_user_deathloc% - 玩家上一次死亡地点
  • %cmi_user_backloc% - 玩家的返回地点
  • %cmi_user_cuffed% - 标识玩家是否被铐住
  • %cmi_p_[玩家名]_cuffed% - 标识玩家是否被铐住
  • %cmi_user_muted% - 标识玩家是否被禁言
  • %cmi_p_[玩家名]_muted% - 标识玩家是否被禁言
  • %cmi_user_inpvp% - 标识玩家是否处于 PvP 模式
  • %cmi_user_god% - 标识玩家是否启用了上帝模式
  • %cmi_p_[玩家名]_god% - 标识玩家是否启用了上帝模式
  • %cmi_user_sneaking% - 标识玩家是否正在潜行
  • %cmi_user_mail_count% - 玩家拥有的邮件数量
  • %cmi_user_warning_count% - 玩家收到的警告数量
  • %cmi_user_warning_points% - 玩家的警告点数
  • %cmi_user_afk% - AFK 状态
  • %cmi_user_afk_symbol% - AFK 符号
  • %cmi_user_afk_msg% - AFK 消息(如存在)
  • %cmi_user_afk_for% - 玩家处于 AFK 模式的时长
  • %cmi_user_afk_in% - 玩家进入自动 AFK 模式的时间
  • %cmi_user_spy% - 间谍状态
  • %cmi_user_cmdspy% - 命令间谍状态
  • %cmi_user_signspy% - 牌子间谍状态
  • %cmi_user_joinedcounter% - 标识玩家是否加入计数器
  • %cmi_user_banned% - 标识玩家是否被封禁
  • %cmi_p_[玩家名]_banned% - 标识玩家是否被封禁
  • %cmi_user_maxhomes% - 玩家可以拥有的家的最大数量
  • %cmi_user_homeamount% - 玩家拥有的家的数量
  • %cmi_user_homelist% - 玩家家的列表
  • %cmi_user_missingexp% - 距离下一级缺少的经验值
  • %cmi_user_missingexpp% - 距离下一级缺少的经验值百分比
  • %cmi_user_exp% - 当前等级的经验值
  • %cmi_user_expp% - 当前等级的经验值百分比
  • %cmi_user_totalexp% - 玩家拥有的总经验值
  • %cmi_user_level% - 玩家等级
  • %cmi_user_ping% - 延迟(Ping)
  • %cmi_user_gamemode% - 游戏模式
  • %cmi_user_op% - OP 状态
  • %cmi_user_pweather% - 玩家的个人天气
  • %cmi_user_weather% - 玩家所在世界的天气
  • %cmi_user_weatherduration% - 玩家所在世界的天气持续时间
  • %cmi_user_canfly% - 玩家是否可以飞行
  • %cmi_user_flying% - 玩家当前是否在飞行
  • %cmi_user_vanished_symbol% - 隐身符号
  • %cmi_user_balance_formated%
  • %cmi_user_balance_formatted% - 格式化后的玩家余额
  • %cmi_user_balance% - 玩家余额
  • %cmi_user_prefix% - 由权限插件设置的玩家前缀
  • %cmi_user_suffix% - 由权限插件设置的玩家后缀
  • %cmi_user_group% - 玩家的主权限组名称
  • %cmi_user_nameplate_prefix% - 玩家名牌前缀
  • %cmi_user_nameplate_suffix% - 玩家名牌后缀
  • %cmi_user_tfly% - 剩余临时飞行时间(秒)
  • %cmi_user_tfly_formated%
  • %cmi_user_tfly_formatted% - 格式化后的临时飞行时间
  • %cmi_user_flightcharge% - 飞行能量值
  • %cmi_user_tgod% - 临时上帝模式的剩余时间(秒)
  • %cmi_user_tgod_formated%
  • %cmi_user_tgod_formatted% - 格式化后的临时上帝模式时间
  • %cmi_user_votecount% - 投票数量
  • %cmi_user_dailyvotecount% - 每日投票数量
  • %cmi_user_chatcolor% - 玩家聊天颜色
  • %cmi_user_rank%
  • %cmi_user_rank_displayname% - 当前位阶的显示名称
  • %cmi_user_rank_name% - 当前位阶名称
  • %cmi_user_nextranks% - 下一级位阶列表
  • %cmi_user_nextrankpercent% - 下一级位阶的完成百分比
  • %cmi_user_nextvalidranks% - 玩家可以晋升到的位阶列表
  • %cmi_user_canrankup% - 如果玩家可以晋升则返回 true
  • %cmi_user_country% - 来自 geoip 功能的玩家国家/地区。示例:Germany
  • %cmi_user_country_code% - 来自 geoip 功能的玩家国家/地区代码。示例:UK
  • %cmi_user_city% - 来自 geoip 功能的玩家城市名称
  • %cmi_user_name_colorcode% - 来自 nameplate 命令和 -c: 变量的 Bukkit 颜色代码
  • %cmi_user_glow_code% - 来自 glow 命令的 Bukkit 颜色代码
  • %cmi_user_glow_name% - 来自 glow 命令的颜色名称。示例:Red
  • %cmi_user_jailed% - 玩家是否被关进监狱,返回 true 或 false
  • %cmi_p_[玩家名]_jailed% - 玩家是否被关进监狱,返回 true 或 false
  • %cmi_user_jailname% - 玩家当前所在的监狱名称。示例:Prison
  • %cmi_p_[玩家名]_jailname% - 玩家当前所在的监狱名称。示例:Prison
  • %cmi_user_jailcell% - 玩家当前所在的牢房 ID。示例:1
  • %cmi_p_[玩家名]_jailcell% - 玩家当前所在的牢房 ID。示例:1
  • %cmi_user_jailtime% - 剩余服刑时间。示例:1hour 5minutes
  • %cmi_p_[玩家名]_jailtime% - 剩余服刑时间。示例:1hour 5minutes
  • %cmi_user_jailreason% - 入狱原因
  • %cmi_p_[玩家名]_jailreason% - 入狱原因
  • %cmi_user_jailedby% - 关押玩家的监狱官名称
  • %cmi_p_[玩家名]_jailedby% - 关押玩家的监狱官名称
  • %cmi_user_riding% - 玩家骑乘的实体名称
  • %cmi_user_beingriddenby% - 骑乘该玩家的玩家名称
  • %cmi_user_bungeeserver% - Bungee 服务器名称
  • %cmi_user_rt_cooldown% - 随机传送的剩余冷却时间
  • %cmi_user_rt_cooldown_[世界名]% - 按世界区分的随机传送剩余冷却时间
  • %cmi_user_playtime_formatted% - 格式化后的游戏时长
  • %cmi_user_playtime_days% - 以天计的游戏时长
  • %cmi_user_playtime_dayst% - 以天计的游戏时长(含小数)
  • %cmi_user_playtime_hours% - 以小时计的游戏时长
  • %cmi_user_playtime_hoursf% - 以小时计的总游戏时长
  • %cmi_user_playtime_hourst% - 以小时计的总游戏时长(含小数)
  • %cmi_user_playtime_minutes% - 以分钟计的游戏时长
  • %cmi_user_playtime_minutest% - 以分钟计的总游戏时长
  • %cmi_user_playtime_seconds% - 以秒计的游戏时长
  • %cmi_user_playtime_secondst% - 以秒计的总游戏时长
  • %cmi_user_prewards_count% - 可领取的在线奖励数量
  • %cmi_user_world_formatted% - 使用自定义标识的当前玩家世界名称
  • %cmi_user_online% - 返回玩家在线状态
  • %cmi_p_[玩家名]_online% - 返回玩家在线状态
  • %cmi_user_itemcount_[物品ID名(:数据)]% - 按提供的物品材质统计玩家背包中的物品数量
  • %cmi_user_maxperm_[核心权限]_[默认值]% - 按提供的权限节点返回最大值,如果该节点不存在则返回默认值
  • %cmi_user_toggle_[holograms|shiftedit|totembar|compass|tagsound|chatspy|cmdspy|signspy|msg|tp|pay|chatbubble|pmsound|rideme|pvenumbers|pvpnumbers|durability|receivepets|deathmessages|notarget|schest|staffchat|autoflightrecharge]% - 如果定义的功能开启则输出 1,关闭则输出 0
  • %cmi_user_togglename_[holograms|shiftedit|totembar|compass|tagsound|chatspy|cmdspy|signspy|msg|tp|pay|chatbubble|pmsound|rideme|pvenumbers|pvpnumbers|durability|receivepets|deathmessages|notarget|schest|staffchat|autoflightrecharge]% - 如果定义的功能开启或关闭,输出格式化后的 True 或 False
  • %cmi_user_holo_page_[全息图名称]% - 输出玩家当前所在全息图的页码
  • %cmi_equation_[算式]% - 提供的数学算式的结果(含小数)
  • %cmi_equationint_[算式]% - 提供的数学算式的结果(不含小数)
  • %cmi_color_[文本]% - 为文本着色,用 _ 替换空格,下划线可通过双写(如 __)添加
  • %cmi_stripcolor_[文本]% - 从文本中移除颜色代码
  • %cmi_iteminhand_displayname% - 主手物品的显示名称或格式化后的材质名称
  • %cmi_iteminhand_realname% - 主手物品的格式化材质名称
  • %cmi_iteminhand_type% - 主手物品的材质名称
  • %cmi_iteminhand_itemdata% - 主手物品的数据值。1.13+ 版本返回 0
  • %cmi_iteminhand_amount% - 主手物品的数量
  • %cmi_iteminhand_durability% - 主手物品的剩余耐久度
  • %cmi_iteminhand_maxdurability% - 主手物品的最大耐久度
  • %cmi_iteminhand_custommodeldata% - 主手物品的自定义模型数据
  • %cmi_iteminhand_worth% - 返回主手物品的总价值
  • %cmi_iteminhand_worth_one% - 返回主手单个物品的价值
  • %cmi_iteminhand_worthc% - 返回主手物品的总价值(不带格式化)
  • %cmi_iteminhand_worthc_one% - 返回主手单个物品的价值(不带格式化)
  • %cmi_material_realname_$1% - 主手物品的格式化材质名称
  • %cmi_schedule_nextin_[计划名]% - 距离下一次计划任务触发的时间
  • %cmi_schedule_endat_[计划名]% - 距离计划任务触发最后一条命令的时间
  • %cmi_baltop_cname_[1-10]% - 列表中指定位置玩家的纯净名称
  • %cmi_baltop_name_[1-10]% - 列表中指定位置玩家的名称
  • %cmi_baltop_money_[1-10]% - 列表中指定位置玩家的余额
  • %cmi_baltop_shortmoney_[1-10]% - 列表中指定位置玩家的余额
  • %cmi_playtimetop_cname_[1-10]% - 列表中指定位置玩家的纯净名称
  • %cmi_playtimetop_name_[1-10]% - 列表中指定位置玩家的名称
  • %cmi_playtimetop_time_[1-10]% - 列表中指定位置玩家的游戏时长
  • %cmi_votetop_[1-10]% - 列表中指定位置玩家的名称
  • %cmi_votetopcount_[1-10]% - 列表中指定位置玩家的投票数量
  • %cmi_worth_buy_[物品ID名(:数据)]% - 物品的价值
  • %cmi_worth_sell_[物品ID名(:数据)]% - 物品的出售价值
  • %cmi_worthc_buy_[物品ID名(:数据)]% - 物品的价值(不带格式化)
  • %cmi_worthc_sell_[物品ID名(:数据)]% - 物品的出售价值(不带格式化)
  • %cmi_bungee_total_[服务器名]% - 指定服务器允许的玩家总数
  • %cmi_bungee_current_[服务器名]% - 指定服务器的当前玩家数量
  • %cmi_bungee_motd_[服务器名]% - 指定服务器的 motd
  • %cmi_bungee_onlinestatus_[服务器名]% - 服务器在线状态的 true/false
  • %cmi_tps_1% - 最近 1 秒的 TPS
  • %cmi_tps_60% - 最近 60 秒的 TPS
  • %cmi_tps_300% - 最近 5 分钟的 TPS
  • %cmi_tps_[范围]_colored% - 指定范围的 TPS(带颜色)
  • %cmi_tps_[范围]% - 指定范围的 TPS
  • %cmi_random_player_name% - 返回随机在线玩家名称
  • %cmi_lastrandom_player_name% - 返回上一次随机到的在线玩家名称
  • %cmi_random_[from]_[to]% - 指定范围内的随机数
  • %cmi_lastrandom_[玩家名]% - 通过随机占位符分配给玩家的上一次随机数
  • %cmi_user_rank_percent_[位阶名]% - 指定位阶的晋升进度百分比
  • %cmi_user_meta_[键]% - 按指定键返回的玩家元数据
  • %cmi_user_metaint_[键]% - 按指定键返回的玩家元数据(数值形式)
  • %cmi_chatmute_time% - 返回全局聊天禁言的剩余时间
  • %cmi_chatmute_reason% - 返回全局聊天禁言的原因
  • %cmi_user_baltop% - 玩家在财富排行榜中的位置
  • %cmi_user_playtimetop% - 玩家在游戏时长排行榜中的位置
  • %cmi_user_stats_[主统计(:可选子统计)]% - 玩家统计
  • %cmi_user_kitcd_[礼包名]% - 指定礼包的冷却时间
  • %cmi_user_kit_available% - 你可以领取的礼包数量
  • %cmi_user_kit_available_[礼包名]% - 礼包是否可用,返回 true/false
  • %cmi_user_kit_hasaccess_[礼包名]% - 玩家能否使用此礼包,返回 true/false
  • %cmi_jail_time_[监狱名]_[牢房ID]% - 牢房的剩余服刑时间
  • %cmi_jail_username_[监狱名]_[牢房ID]% - 关押在指定牢房中的玩家名称
  • %cmi_jail_reason_[监狱名]_[牢房ID]% - 指定牢房的入狱原因
  • %cmi_weather_[世界名]% - 世界天气
  • %cmi_weatherduration_[世界名]% - 世界天气持续时间
  • %cmi_afk_count% - AFK 玩家数量
  • %cmi_maintenance_state% - 维护状态
  • %cmi_maintenance_message% - 维护消息
  • %cmi_chat_range% - 聊天消息的范围
  • %cmi_server_uptime% - 服务器已运行时长
  • %cmi_server_uptime_seconds% - 服务器已运行的时长(秒)
  • %cmi_server_worlds% - 服务器上所有世界的列表
  • %cmi_server_vanished% - 在线隐身玩家数量
  • %cmi_server_users% - 计数器用户数量
  • %player_world% - 玩家当前所在世界名称
  • %cmi_player_world% - 玩家当前所在世界名称
  • %player_x% - 玩家当前的 X 坐标
  • %cmi_player_x% - 玩家当前的 X 坐标
  • %player_y% - 玩家当前的 Y 坐标
  • %cmi_player_y% - 玩家当前的 Y 坐标
  • %player_z% - 玩家当前的 Z 坐标
  • %cmi_player_z% - 玩家当前的 Z 坐标
  • %player_biome% - 玩家当前所在生物群系名称
  • %cmi_player_biome% - 玩家当前所在生物群系名称
  • %vault_eco_balance_formatted% - 格式化后的玩家余额。已废弃
  • %server_online% - 在线玩家数量
  • %cmi_server_online% - 在线玩家数量
  • %server_max_players% - 允许的最大玩家数
  • %cmi_server_max_players% - 允许的最大玩家数
  • %server_online_[世界名]% - 特定世界中的在线人数。世界名称中不要使用下划线
  • %cmi_server_online_[世界名]% - 特定世界中的在线人数。世界名称中不要使用下划线
  • %server_unique_joins% - 服务器的唯一玩家加入次数
  • %cmi_server_unique_joins% - 服务器的唯一玩家加入次数
  • %onlineplayers_names% - 格式化后的在线玩家列表
  • %cmi_onlineplayers_names% - 格式化后的在线玩家列表
  • %onlineplayers_displaynames% - 使用显示名称(如可能)格式化后的在线玩家列表
  • %cmi_onlineplayers_displaynames% - 使用显示名称(如可能)格式化后的在线玩家列表
  • %server_time_[时间格式]_[时区]% - 按指定格式和时区的服务器时间
  • %cmi_server_time_[时间格式]_[时区]% - 按指定格式和时区的服务器时间
  • %server_time_[时间格式]% - 服务器本地时间
  • %cmi_server_time_[时间格式]% - 服务器本地时间
  • %world_time12_[世界名]% - 12 小时制的世界时间
  • %cmi_world_time12_[世界名]% - 12 小时制的世界时间
  • %world_time24_[世界名]% - 24 小时制的世界时间
  • %cmi_world_time24_[世界名]% - 24 小时制的世界时间 (内容由AI生成,仅供参考)