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生成,仅供参考)