跳到主要内容

RPG Core 占位符

RPG Core 注册了 MiniPlaceholders 扩展 btc。可在任何支持占位符的文本中,将这些值作为 MiniMessage 标签使用。参数跟在标签名之后,以冒号分隔,例如 <btc_stat:health>。未知的职业或属性会返回 0(在注明之处则返回空文本)。

玩家等级与全局等级​

占位符返回
<btc_player_level>玩家的职业等级。
<btc_global_level>玩家的全局等级。
<btc_party_size> / <btc_guild_size>玩家所在队伍或公会的人数。
<btc_party_in_party> / <btc_guild_in_guild>当人数大于 1 时为 true。
<btc_party_leader>、<btc_guild_name>、<btc_guild_leader>在此版本中始终为空。
<btc_xp_share_mode> / <btc_xp_share_multiplier>经验共享模式和倍率。

职业​

将 profession 替换为职业 id,例如 mining。

占位符返回
<btc_profession_xp>所有职业的总经验。
<btc_profession_xp:profession>该职业的经验。
<btc_profession_level:profession>当前等级。
<btc_profession_total_xp:profession>累计的总经验。
<btc_profession_xp_to_next:profession>距离下一级还缺少的经验。
<btc_profession_total_xp_required:profession>达到下一级所需的总经验。
<btc_profession_xp_progress_percentage:profession>朝向下一级的进度,0 到 100。
<btc_profession_max_level:profession>最高等级。
<btc_profession_is_maxed:profession>true 或 false。
<btc_profession_name:profession>显示名称(未知时为 id 本身)。

对于列出每个等级的菜单,这些占位符接受职业和等级(<btc_profession_level_lore:mining:37>)。等级不会被限制在最高等级以内。

占位符返回
<btc_profession_level_requirement:profession:level>达到该等级所需的总经验。
<btc_profession_level_lore:profession:level>为该等级编写的奖励描述,各行以换行符连接。
<btc_profession_level_stats:profession:level>在该等级获得的永久属性,例如 STRENGTH +2, HEALTH +5。
<btc_profession_level_reward_count:profession:level>在该等级运行的触发器数量。
<btc_profession_level_palette:profession:level>一个颜色名称(已达到为 GREEN_LIGHT,当前为 GOLD,已锁定为 INK)。
<btc_profession_level_status:profession:level>ATTEINT、EN COURS 或 VERROUILLE。

增益与活动​

占位符返回
<btc_profession_boost_percent:profession>当前生效的增益总百分比。
<btc_profession_boost_remaining:profession>当前增益的剩余时间。
<btc_profession_activity_points:profession:activity>某个活动的比赛积分。
<btc_profession_activity_events:profession:activity>某个活动的事件数量。
<btc_profession_activity_multiplier:profession:activity:xp>经验倍率(使用 score 可获得分数倍率)。

属性​

将 stat 替换为属性 id,例如 health 或 crit_chance。

占位符返回
<btc_stat:stat>属性的总值(基础值加装备,经过约束),按该属性的 displayFormat 插入;使用的是原始内部值,而不是百分比显示值。
<btc_stat_max:stat>其 maxValue,或 unbounded。
<btc_stat_percent:stat>值占 maxValue 的百分比(没有最大值时为 0)。
<btc_stat_missing:stat>距离 maxValue 的差值。

物品栏​

占位符返回
<btc_item_count:STONE>物品栏中某种原版材质的物品数量。
<btc_item_count_id:id>具有该 BTC 自定义物品 id 的物品数量。
<btc_has_item:id>如果主手或副手持有该自定义物品则为 true。
<btc_inventory_free_slots>空闲的存储槽位。
<btc_main_hand_item_name>手持物品的材质名称,没有时为空。