外部读取函数

这页读取入口不会因为没装插件、没玩家上下文就报错。

• 需要玩家上下文的读取函数，在没有玩家上下文时会按类型给默认值
• 常见返回规则是：文本类返回 null，判断类返回 false，数量类返回 0
• 服务器级读取像 AM服务器读取()、AM服务器存在()、AM服务器临时读取() 不需要玩家

PlaceholderAPI

变量.PAPI

• 用法：变量.PAPI("%placeholder%")
• 参数：PAPI 占位符文本
• 返回值：文本、long 或 double

在线人数文本 = 变量.PAPI("%server_online%")
消息.广播("&b当前在线人数: " + 在线人数文本)

CraftX

CX读取

• 用法：CX读取("变量名")
• 参数：CraftX 永久变量名
• 返回值：String 或 null

通关次数 = CX读取("通关次数")
if 转整数(通关次数) >= 10 {
    消息.发送("&6你已经完成十次通关")
}

CX存在

• 用法：CX存在("变量名", [数量])
• 参数：变量名；可选数量，默认 1
• 返回值：boolean

if CX存在("门票", 3) {
    消息.发送("&a你拥有足够的 CraftX 门票")
}

CX数量

• 用法：CX数量("变量名")
• 参数：变量名
• 返回值：int

收藏数量 = CX数量("收藏印记")
消息.发送("&e你的收藏印记数量: " + 收藏数量)

CX临时读取

• 用法：CX临时读取("变量名")
• 参数：临时变量名
• 返回值：String 或 null

临时状态 = CX临时读取("暴走状态")
消息.发送("&c当前临时状态: " + 临时状态)

CX临时存在

• 用法：CX临时存在("变量名", [数量])
• 参数：变量名；可选数量
• 返回值：boolean

if CX临时存在("复活令", 1) {
    消息.发送("&a你当前拥有临时复活令")
}

CX临时过期

• 用法：CX临时过期("变量名")
• 参数：变量名
• 返回值：long

过期值 = CX临时过期("暴走状态")
日志("暴走状态过期值: " + 过期值)

AchieveMaster

AM读取

• 用法：AM读取("变量名")
• 参数：玩家变量名
• 返回值：任意类型

赛季积分 = AM读取("赛季积分")
消息.发送("&e你的赛季积分: " + 赛季积分)

AM存在

• 用法：AM存在("变量名")
• 参数：玩家变量名
• 返回值：boolean

if AM存在("首通奖励") {
    消息.发送("&a你已经拿过首通奖励")
}

AM服务器读取

• 用法：AM服务器读取("变量名")
• 参数：服务器变量名
• 返回值：任意类型

全服通关 = AM服务器读取("全服通关")
消息.广播("&6全服累计通关: " + 全服通关)

AM服务器存在

• 用法：AM服务器存在("变量名")
• 参数：服务器变量名
• 返回值：boolean

if AM服务器存在("周末活动开关") {
    消息.广播("&e周末活动变量已经存在")
}

AM临时读取

• 用法：AM临时读取("变量名")
• 参数：玩家临时变量名
• 返回值：任意类型

临时权限 = AM临时读取("活动通行证")
消息.发送("&b当前活动通行证状态: " + 临时权限)

AM服务器临时读取

• 用法：AM服务器临时读取("变量名")
• 参数：服务器临时变量名
• 返回值：任意类型

活动状态 = AM服务器临时读取("双倍掉落状态")
消息.广播("&d当前活动状态: " + 活动状态)

仓库

仓库数量

• 用法：仓库数量("物品ID", [目标])
• 参数：物品 ID；目标可写 all、srx、lw 及中文别名
• 返回值：int

目标省略时，默认按 all 查，也就是把 SoulRingX 和 LyWarehouse 一起算进去。

总石头 = 仓库数量("demo_stone", "all")
if 总石头 >= 64 {
    消息.发送("&a你的仓库里至少有一组石头")
}

可用目标写法：

• SoulRingX：srx、soulringx、魂环仓库、灵魂仓库
• LyWarehouse：lw、lywarehouse、传统仓库、离渊仓库
• 合计：all、warehouse、warehouses、仓库、全部仓库、全部