外部变量与仓库

这页动作里，和玩家绑定的部分都有一个统一规则：

• 需要玩家上下文的动作，在没有玩家上下文时会直接返回 false
• 对应外部插件没装好、没接上时，也会直接返回 false
• 这批动作本身不会因为没玩家、没插件就把脚本打断

AM.服务器设置、AM.服务器增加、AM.服务器删除、AM.服务器临时设置 这几项不需要玩家，可以在全局事件、通关结算、阶段公共脚本里直接用

CraftX

CX.设置

• 用法：CX.设置("变量名", 值)
• 参数：变量名和值
• 返回值：boolean

if CX.设置("通关次数", 10) {
    消息.发送("&a已写入 CraftX 通关次数")
}

CX.增加

• 用法：CX.增加("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

CX.增加("通关次数", 1)
消息.发送("&eCraftX 通关次数 +1")

CX.扣除

• 用法：CX.扣除("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

if CX.扣除("挑战券", 1) {
    消息.发送("&a已扣除一张 CraftX 挑战券")
}

CX.删除

• 用法：CX.删除("变量名")
• 参数：变量名
• 返回值：boolean

CX.删除("活动标记")
消息.发送("&7CraftX 活动标记已删除")

CX.临时设置

• 用法：CX.临时设置("变量名", 值, [过期秒])
• 参数：变量名、值、过期秒
• 返回值：boolean

CX.临时设置("暴走状态", 1, 600)
消息.发送("&c已写入 10 分钟暴走状态")

CX.临时增加

• 用法：CX.临时增加("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

CX.临时增加("复活令", 1)
消息.发送("&a临时复活令 +1")

CX.临时扣除

• 用法：CX.临时扣除("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

if CX.临时扣除("复活令", 1) {
    消息.发送("&e已扣除一个临时复活令")
}

CX.临时删除

• 用法：CX.临时删除("变量名")
• 参数：变量名
• 返回值：boolean

CX.临时删除("暴走状态")
消息.发送("&7暴走状态已清除")

CX.临时过期设置

• 用法：CX.临时过期设置("变量名", 秒数)
• 参数：变量名、秒数
• 返回值：boolean

CX.临时过期设置("暴走状态", 120)
消息.发送("&e暴走状态剩余时间已改成 120 秒")

AchieveMaster

AM.设置

• 用法：AM.设置("变量名", 值)
• 参数：变量名和值
• 返回值：boolean

AM.设置("赛季积分", 500)
消息.发送("&a已写入 AM 赛季积分")

AM.增加

• 用法：AM.增加("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

AM.增加("赛季积分", 50)
消息.发送("&eAM 赛季积分 +50")

AM.删除

• 用法：AM.删除("变量名")
• 参数：变量名
• 返回值：boolean

AM.删除("活动资格")
消息.发送("&7AM 活动资格已删除")

AM.服务器设置

• 用法：AM.服务器设置("变量名", 值)
• 参数：变量名和值
• 返回值：boolean

AM.服务器设置("全服通关", 0)
消息.广播("&6全服通关计数已重置")

AM.服务器增加

• 用法：AM.服务器增加("变量名", 数量)
• 参数：变量名、数量
• 返回值：boolean

AM.服务器增加("全服通关", 1)
消息.广播("&6全服通关次数 +1")

AM.服务器删除

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

AM.服务器删除("周末活动")
消息.广播("&7服务器活动变量已删除")

AM.临时设置

• 用法：AM.临时设置("变量名", 值)
• 参数：变量名和值
• 返回值：boolean

AM.临时设置("副本加成", 2)
消息.发送("&d已写入 AM 临时加成")

AM.服务器临时设置

• 用法：AM.服务器临时设置("变量名", 值)
• 参数：变量名和值
• 返回值：boolean

AM.服务器临时设置("双倍掉落", true)
消息.广播("&d双倍掉落临时开关已开启")

仓库

仓库.给予

• 用法：仓库.给予("物品ID", 数量, [目标])
• 参数：物品 ID、数量、目标
• 返回值：boolean

目标省略时，默认发到 srx，也就是 SoulRingX。

if 仓库.给予("Boss材料", 3, "魂环仓库") {
    消息.发送("&a已把材料发进魂环仓库")
}

仓库.扣除

• 用法：仓库.扣除("物品ID", 数量, [目标])
• 参数：物品 ID、数量、目标
• 返回值：boolean

目标省略时，默认从 srx 扣，也就是 SoulRingX。

if 仓库.扣除("Boss材料", 1, "全部仓库") {
    消息.发送("&e已从仓库扣除一份 Boss 材料")
}

可用目标写法：

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