Bukkit CbLmPapi - 方可梦1.7.1变量拓展,可搭配Tr实现功能(Neoforge/Fabric) 1.2.8

📚 占位符列表 (Placeholders List)
● 基础信息
● %cobblemonpapi_member1_englishname% - 英文名 (e.g., pikachu)
● %cobblemonpapi_member1_chinesename% - 中文名 (e.g., 皮卡丘)
● %cobblemonpapi_member1_nickname% - 昵称
● %cobblemonpapi_member1_level% - 等级
● %cobblemonpapi_member1_hp% - 当前 HP
● %cobblemonpapi_member1_max_health% - 最大 HP
● %cobblemonpapi_member1_isshiny% - 是否闪光 (true/false)
● %cobblemonpapi_member1_legendary% - 是否神兽 (true/false)
● %cobblemonpapi_member1_ultra_beast% - 是否异兽 (true/false)
● %cobblemonpapi_member1_mythical% - 是否幻兽 (true/false)
● %cobblemonpapi_member1_common% - 是否普通精灵 (true/false)
● %cobblemonpapi_member1_uncatchable% - 是否无法捕获 (true/false)
● %cobblemonpapi_member1_battle_clone% - 是否临时克隆体 (true/false)
● %cobblemonpapi_member1_fire_immune% - 是否火系免疫 (true/false)
● %cobblemonpapi_member1_full_health% - 是否满血状态 (true/false)
● %cobblemonpapi_member1_tradeable% - 是否可以交易 (true/false)
● %cobblemonpapi_member1_ability% - 特性
● %cobblemonpapi_member1_ability_desc% - 特性描述
● %cobblemonpapi_member1_nature% - 性格
● %cobblemonpapi_member1_nature_desc% - 性格描述
● %cobblemonpapi_member1_gender% - 性别 (雄性/雌性)
● %cobblemonpapi_member1_features% - 形态特征 (e.g., Alolan, Gigantamax)
● %cobblemonpapi_member1_aspects% - 多形态特征 (精灵图标)
● %cobblemonpapi_member1_trainername% - 原始训练家名字
● %cobblemonpapi_member1_friendship% - 亲密度
● %cobblemonpapi_member1_ball% - 捕获的球组名
● %cobblemonpapi_member1_metabolismcycle% - 孵化周期
● %cobblemonpapi_member1_tera% - 太晶属性
● %cobblemonpapi_member1_experience% - 当前精灵累计经验值
● %cobblemonpapi_member1_experience_to_next% - 精灵距离下一级所需经验
● %cobblemonpapi_member1_can_evolve% - 是否满足进化条件 (true/false)
● %cobblemonpapi_member1_next_evolution_english% - 下一次进化的英文名
● %cobblemonpapi_member1_next_evolution_chinese% - 下一次进化的中文显示名
● %cobblemonpapi_member1_type1% - 宝可梦第一属性
● %cobblemonpapi_member1_type2% - 宝可梦第二属性
● %cobblemonpapi_member1_iv_rating% - 个体评级(普通/良好/优秀/完美)
● %cobblemonpapi_member1_helditem% - 携带的中文道具名
● %cobblemonpapi_member1_ride_stamina% - 当前精灵骑乘耐力
● %cobblemonpapi_member1_ride_speed% - 骑乘移动速度（陆地）
● %cobblemonpapi_member1_ride_jump% - 骑乘跳跃高度（陆地）
● %cobblemonpapi_member1_ride_acceleration% - 骑乘加速度（陆地）
● %cobblemonpapi_member1_ride_water_speed% - 骑乘移动速度（水上）
● %cobblemonpapi_member1_ride_water_acceleration% - 骑乘加速度（水上）
● %cobblemonpapi_member1_ride_water_jump% - 骑乘跳跃高度（水上）
● %cobblemonpapi_member1_ride_air_speed% - 骑乘移动速度（空中）
● %cobblemonpapi_member1_ride_air_acceleration% - 骑乘加速度（空中）
● %cobblemonpapi_member1_ride_air_jump% - 骑乘跳跃高度（空中）
● %cobblemonpapi_member1_egg_groups% - 当前精灵蛋组
● %cobblemonpapi_member1_v_count% 返回个体V (1V/2V)
● %cobblemonpapi_member1_iv_num% 返回个体V (1/2)
● %cobblemonpapi_member1_has_标签名%  识别队伍宝可梦的标签
● %cobblemonpapi_member1_has_gen1%    队伍第1只宝可梦是否为第一世代
● %cobblemonpapi_member1_has_legendary%    队伍第1只是否为传说宝可梦
● %cobblemonpapi_member1_has_custom%    队伍第1只是否为自定义宝可梦
● %cobblemonpapi_member1_has_mega%    队伍第1只是否为 Mega 形态
● %cobblemonpapi_member1_has_gmax%    队伍第1只是否为极巨化
● %cobblemonpapi_member1_has_baby%    队伍第1只是否为宝宝可梦

● 王冠特训后的个体
● %cobblemonpapi_member1_hyper_ivshp%    生命 (最大 31)
● %cobblemonpapi_member1_hyper_ivsattack%    攻击 (最大 31)
● %cobblemonpapi_member1_hyper_ivsdefence% 防御 (最大 31)
● %cobblemonpapi_member1_hyper_ivsspecial_attack%    特攻 (最大 31)
● %cobblemonpapi_member1_hyper_ivsspecial_defence% 特防 (最大 31)
● %cobblemonpapi_member1_hyper_ivsspeed%    速度 (最大 31)
● %cobblemonpapi_member1_hyper_ivstotal%    个体总和 (最大 186)
● %cobblemonpapi_member1_hyper_ivspercentage%    六项个体值经过特训后的完美度百分比
● %cobblemonpapi_member1_hyper_v_count%    显示经过特训后达到31 (如 "6V")
● %cobblemonpapi_member1_hyper_iv_num%    显示经过特训后达到31 (如 "6")
● %cobblemonpapi_member1_hyper_is_6iv%    是否为特训6V，返回true或 false

● PC 盒子相关
● %cobblemonpapi_pc_box_count% - 已解锁 PC 盒子数量
● %cobblemonpapi_pc_unlocked_wallpapers% - 已解锁壁纸数
● %cobblemonpapi_pc_box1_slot1_nickname% - 第 1 盒第 1 格昵称
● %cobblemonpapi_pc_box2_slot5_isshiny% - 第 2 盒第 5 格是否闪光

● 队伍变量
● %cobblemonpapi_party_shiny_count% - 队伍中闪光宝可梦数量
● %cobblemonpapi_party_legendary_count% - 队伍中神兽数量
● %cobblemonpapi_party_mythical_count% - 队伍中幻兽数量
● %cobblemonpapi_party_ultra_beast_count% - 队伍中异兽数量
● %cobblemonpapi_party_average_level% - 队伍平均等级（四舍五入取整）
● %cobblemonpapi_party_total_level% - 队伍总等级
● %cobblemonpapi_party_fainted_count% - 队伍中倒下的宝可梦数量
● %cobblemonpapi_party_has_pokemon_{宝可梦英文名}% - 检查队伍中是否包含指定的宝可梦
● %cobblemonpapi_party_has_shiny% - 队伍是否有闪光宝可梦（返回 true/false）
● %cobblemonpapi_party_has_legendary% - 队伍是否有传说宝可梦（返回 true/false）
● %cobblemonpapi_party_all_healthy% - 队伍是否全部健康（返回 true/false）
● %cobblemonpapi_party_any_fainted% - 队伍是否有倒下的宝可梦（返回 true/false）
● %cobblemonpapi_party_size% - 当前队伍中宝可梦数量
● %cobblemonpapi_party_max_size% - 队伍最大容量
● %cobblemonpapi_party_is_full% - 队伍是否已满

● 统计玩家 PC
● %cobblemonpapi_pc_total% - PC 中宝可梦总数
● %cobblemonpapi_pc_normal_total% - 普通精灵数量
● %cobblemonpapi_pc_shiny_total% - 闪光精灵数量
● %cobblemonpapi_pc_legend_total% - 神兽数量
● %cobblemonpapi_pc_ultra_total% - 异兽数量
● %cobblemonpapi_pc_mythical_total% - 幻兽数量
● %cobblemonpapi_pc_[精灵名]% - 是否有指定精灵（如 %cobblemonpapi_pc_pikachu%）

● 种族值变量
● %cobblemonpapi_member1_base_hp% - HP 种族值
● %cobblemonpapi_member1_base_attack% - 攻击种族值
● %cobblemonpapi_member1_base_defence% - 防御种族值
● %cobblemonpapi_member1_base_special_attack% - 特攻种族值
● %cobblemonpapi_member1_base_special_defence% - 特防种族值
● %cobblemonpapi_member1_base_speed% - 速度种族值
● %cobblemonpapi_member1_bst% - 种族值总和

● 个体值 (IVs)
● %cobblemonpapi_member1_ivshp% - HP 个体值
● %cobblemonpapi_member1_ivsattack% - 攻击个体值
● %cobblemonpapi_member1_ivsdefence% - 防御个体值
● %cobblemonpapi_member1_ivsspecial_attack% - 特攻个体值
● %cobblemonpapi_member1_ivsspecial_defence% - 特防个体值
● %cobblemonpapi_member1_ivsspeed% - 速度个体值
● %cobblemonpapi_member1_ivstotal% - 个体值总和
● %cobblemonpapi_member1_ivspercentage% - 个体值百分比 (总和 / 186 × 100%)


● 努力值 (EVs)
● %cobblemonpapi_member1_evshp% - HP 努力值
● %cobblemonpapi_member1_evsattack% - 攻击努力值
● %cobblemonpapi_member1_evsdefence% - 防御努力值
● %cobblemonpapi_member1_evsspecial_attack% - 特攻努力值
● %cobblemonpapi_member1_evsspecial_defence% - 特防努力值
● %cobblemonpapi_member1_evsspeed% - 速度努力值
● %cobblemonpapi_member1_evssum% - 努力值总和
● %cobblemonpapi_member1_dmax_level% - 机巨化等级
● %cobblemonpapi_member1_evsformatter% - 格式化的努力值字符串 (e.g., 252 HP / 252 Atk / 4 Def)


● 交易变量相关
● %cobblemonpapi_trade_trading%    玩家当前是否正在交易中    true / false
● %cobblemonpapi_trade_partner%    交易对手的玩家名称    Steve / 无
● %cobblemonpapi_trade_partner_uuid%    交易对手的 UUID    550e8400-... / none
● %cobblemonpapi_trade_accepted%    当前玩家是否已点击确认    true / false
● %cobblemonpapi_trade_partner_accepted%    对手玩家是否已点击确认    true / false
● %cobblemonpapi_trade_both_accepted%    双方是否都已确认 (即将成交)    true / false
● %cobblemonpapi_trade_slot_1_name%    我方放入的宝可梦中文名    皮卡丘 / 无
● %cobblemonpapi_trade_slot_1_shiny%    我方宝可梦是否为闪光    true / false
● %cobblemonpapi_trade_slot_1_level%    我方宝可梦的等级    50 / 0
● %cobblemonpapi_trade_slot_2_name%    对手放入的宝可梦中文名    喷火龙 / 无
● %cobblemonpapi_trade_slot_2_shiny%    对手宝可梦是否为闪光    true / false
● %cobblemonpapi_trade_slot_2_level%    对手宝可梦的等级    65 / 0

● 成就统计 (Advancement Stats)
● 按属性捕捉
● %cobblemonpapi_total_capture_fire% - 火系捕捉总数
● %cobblemonpapi_total_capture_water% - 水系捕捉总数
● %cobblemonpapi_total_capture_grass% - 草系捕捉总数
● %cobblemonpapi_total_capture_electric% - 电系捕捉总数
● %cobblemonpapi_total_capture_ice% - 冰系捕捉总数
● %cobblemonpapi_total_capture_fighting% - 格斗系捕捉总数
● %cobblemonpapi_total_capture_poison% - 毒系捕捉总数
● %cobblemonpapi_total_capture_ground% - 地面系捕捉总数
● %cobblemonpapi_total_capture_flying% - 飞行系捕捉总数
● %cobblemonpapi_total_capture_psychic% - 超能力系捕捉总数
● %cobblemonpapi_total_capture_bug% - 虫系捕捉总数
● %cobblemonpapi_total_capture_rock% - 岩石系捕捉总数
● %cobblemonpapi_total_capture_ghost% - 幽灵系捕捉总数
● %cobblemonpapi_total_capture_dragon% - 龙系捕捉总数
● %cobblemonpapi_total_capture_dark% - 恶系捕捉总数
● %cobblemonpapi_total_capture_steel% - 钢系捕捉总数
● %cobblemonpapi_total_capture_fairy% - 妖精系捕捉总数
● %cobblemonpapi_total_capture_normal% - 一般系捕捉总数


● 总计与特殊
● %cobblemonpapi_total_capture_count% - 总捕捉数
● %cobblemonpapi_total_shiny_capture_count% - 闪光捕捉数
● %cobblemonpapi_total_traded_count% - 总交易数
● %cobblemonpapi_total_eggs_hatched% - 孵化蛋数
● %cobblemonpapi_total_evolved_count% - 进化次数
● %cobblemonpapi_total_pvp_battle_victory_count% - PvP 胜利场次
● %cobblemonpapi_total_pvw_battle_victory_count% - PvW (玩家 vs 野生) 胜利场次
● %cobblemonpapi_total_pvn_battle_victory_count% - PvN (玩家 vs NPC) 胜利场次
● %cobblemonpapi_total_battle_victory_count% - 总胜利场次

● 图鉴变量相关
● %cobblemonpapi_total_dex% - 已捕捉图鉴数量
● %cobblemonpapi_dex_total_species%    服务器当前加载的宝可梦总种类数
● %cobblemonpapi_dex_seen_count%    玩家已见过（扫描/遭遇）的宝可梦数量
● %cobblemonpapi_dex_missing_count%    玩家还差多少只完成捕捉图鉴
● %cobblemonpapi_dex_completion_percent%    捕捉完成度百分比(保留1位小数)
● %cobblemonpapi_dex_seen_percent%    见过完成度百分比 (保留1位小数)
● %cobblemonpapi_dex_has_<精灵英文名>%    检查玩家是否已捕捉特定宝可梦    true / false

● 服务器配置变量
● %cobblemonpapi_server_rule_max_level% 宝可梦等级上限    100
● %cobblemonpapi_server_rule_max_friendship% 亲密度上限    255
● %cobblemonpapi_server_rule_max_dmax%    极巨化等级上限    10
● %cobblemonpapi_server_rule_shiny_rate% 闪光出现率 (分母)    8192
● %cobblemonpapi_server_rule_tera_rate% 太晶化出现率 (分母)    20
● %cobblemonpapi_server_rule_exp_multiplier% 全局经验获取倍率    2.0
● %cobblemonpapi_server_rule_pvp_exp% PVP战斗是否给予经验true / false
● %cobblemonpapi_server_rule_faint_timer%    宝可梦濒死复活倒计时 (秒)    300
● %cobblemonpapi_server_rule_heal_percent%    自然恢复生命值比例    0.05
● %cobblemonpapi_server_rule_player_damage_pokemon% 玩家攻击是否伤害宝可梦    true / false
● %cobblemonpapi_server_spawn_enabled% 是否开启野生生成    true
● %cobblemonpapi_server_spawn_per_chunk% 每区块最大生成数量    1.0
● %cobblemonpapi_server_spawn_min_dist% 宝可梦间最小生成间距    8.0
● %cobblemonpapi_server_spawn_max_per_pass%  每次生成尝试的最大数量    8
● %cobblemonpapi_server_spawn_ticks%    生成尝试间隔 (游戏刻)    20
● %cobblemonpapi_server_spawn_despawn_near% 近距离自动消失距离    32
● %cobblemonpapi_server_spawn_despawn_far%    远距离自动消失距离    96
● %cobblemonpapi_server_storage_type%    数据存储格式    nbt / json / mongodb
● %cobblemonpapi_server_storage_boxes%    初始 PC 箱子数量    40
● %cobblemonpapi_server_storage_save_int%    自动保存间隔 (秒)    30
● %cobblemonpapi_server_storage_prevent_full%    是否禁止满员时存入PC    false
● %cobblemonpapi_server_storage_infinite_healer%    治疗机是否无限电荷    false
● %cobblemonpapi_server_storage_healer_charge%    治疗机最大电荷量    6.0
● %cobblemonpapi_server_battle_flee_dist%    默认逃跑距离    32.0
● %cobblemonpapi_server_battle_wild_dist% 野生战斗最大触发距离    12.0
● %cobblemonpapi_server_battle_pvp_dist% PVP战斗最大触发距离    32.0
● %cobblemonpapi_server_battle_lucky_egg% 幸运蛋经验加成倍率    1.5
● %cobblemonpapi_server_battle_share_exp% 队伍经验分享比例    0.5
● %cobblemonpapi_server_ride_infinite_stamina%    骑乘是否无限体力    false
● %cobblemonpapi_server_ride_invert_pitch%    骑乘视角是否反转俯仰    false
● %cobblemonpapi_server_ride_invert_yaw% 骑乘视角是否反转偏航    false
● %cobblemonpapi_server_world_pasture_limit%牧场默认容纳数量    16
● %cobblemonpapi_server_world_apple_leftovers%    苹果树掉落剩饭概率    0.025

● 其他全局变量
● %cobblemonpapi_player_has_selected_starter% - 是否已选择初始宝可梦
● %cobblemonpapi_player_starter_locked% - 初始宝可梦是否锁定
● %cobblemonpapi_player_keyitems_count% - 关键道具数量
● %cobblemonpapi_player_battle_theme% - 当前对战音乐资源ID

指令列表
/cblmpapi rank 查看排行榜(三分钟刷新一次)
/cblmpapi reload 重载配置文件和刷新排行榜

配置列表
# 修改PAPI占位符前缀需要重启服务器才能生效papi-prefix: 'cobblemonpapi'
# =============================================
#        CbLmPapi 排行榜插件配置文件
# =============================================
gui:
# 主菜单标题
main-menu-title: '&0&l请选择排行榜'

# 显示前 N 名（最大不超过 GUI 容量）
top-limit: 10

# 所有排行榜的标题（支持颜色代码）
rank-titles:
capture: '&a&l捕捉排行榜'
battle: '&b&l战斗胜利榜'
evolve: '&d&l进化排行榜'
trade: '&2&l交易排行榜'
egg_collect: '&e&l收集蛋榜'
pvn_battle: '&9&lNPC对战胜利榜'
pvw_battle: '&a&l野外对战胜利榜'
shiny_capture: '&6&l闪光捕捉榜'
pvp_battle: '&c&l玩家对战胜利榜'
egg_hatch: '&f&l孵化蛋榜'

# 主菜单图标（每个排行榜一个入口）
menu-icons:
capture:
material: COBBLEMON_CITRINE_BALL
name: '&a&l捕捉排行榜'
lore:
- '&7点击查看捕捉精灵榜'

battle:
material: COBBLEMON_AZURE_BALL
name: '&b&l战斗胜利榜'
lore:
- '&7点击查看战斗胜场榜'

evolve:
material: COBBLEMON_ROSEATE_BALL
name: '&d&l进化排行榜'
lore:
- '&7点击查看进化次数榜'

trade:
material: EMERALD
name: '&2&l交易排行榜'
lore:
- '&7交易宝可梦次数排行'

egg_collect:
material: TURTLE_EGG
name: '&e&l收集蛋榜'
lore:
- '&7拾取的精灵蛋数量'

pvn_battle:
material: IRON_SWORD
name: '&9&lNPC对战胜利榜'
lore:
- '&7击败训练师次数'

pvw_battle:
material: BONE
name: '&a&l野外对战胜利榜'
lore:
- '&7击败野生宝可梦次数'

shiny_capture:
material: GLOWSTONE_DUST
name: '&6&l闪光捕捉榜'
lore:
- '&d捕捉的闪光宝可梦数量'

pvp_battle:
material: NETHERITE_SWORD
name: '&c&l玩家对战胜利榜'
lore:
- '&7击败其他玩家次数'

egg_hatch:
material: CHICKEN_SPAWN_EGG
name: '&f&l孵化蛋榜'
lore:
- '&7成功孵化的蛋数量'

# 玩家头像 fallback（当无法获取真实皮肤时）
player-head-fallback:
material: PLAYER_HEAD
name: '&e#{rank} &f{player}'
lore:
- '&a{type}: &f{value}'

cache:
# 排行榜数据缓存刷新间隔（单位：分钟）
refresh-interval-minutes: 3