插件变量

LyDragonTrade 提供 PlaceholderAPI 变量，用于读取玩家当前交易对象或交易申请者的信息。

变量标识为 ldt。服务器必须安装并启用 PlaceholderAPI，插件才会注册这些变量；未安装 PlaceholderAPI 时，交易功能仍可运行，但本页变量不会生效。

变量列表

变量	返回内容	生效条件
%ldt_trade_player_name%	当前交易对象的玩家名称	查询玩家正在交易界面中
%ldt_trade_player_uuid%	当前交易对象的 UUID	查询玩家正在交易界面中
%ldt_apply_player_name%	当前交易申请发起者的玩家名称	查询玩家是待处理申请的接收者
%ldt_apply_player_uuid%	当前交易申请发起者的 UUID	查询玩家是待处理申请的接收者

交易对象变量

%ldt_trade_player_name% 和 %ldt_trade_player_uuid% 会从当前交易数据中查找另一方玩家。

交易双方都可以解析这些变量：

• 发起者查询时，返回接收者的信息。
• 接收者查询时，返回发起者的信息。
• 交易尚未被接受、交易已经结束或玩家不在交易中时，返回空字符串。

显示需求	使用变量
显示对方玩家名称	%ldt_trade_player_name%
按对方 UUID 显示内容	%ldt_trade_player_uuid%

交易申请变量

%ldt_apply_player_name% 和 %ldt_apply_player_uuid% 用于待处理的交易申请。

这两个变量只会为交易申请的接收者返回发起者信息。申请发起者查询时不会返回接收者信息。

显示需求	使用变量
在申请弹窗显示申请者名称	%ldt_apply_player_name%
按申请者 UUID 显示内容	%ldt_apply_player_uuid%

申请被接受、拒绝或倒计时结束后，对应申请数据会被移除，变量将返回空字符串。

返回规则

以下情况会返回空字符串：

• PlaceholderAPI 没有传入有效玩家。
• 玩家当前没有正在进行的交易。
• 玩家不是待处理交易申请的接收者。
• 交易申请已经被接受、拒绝或超时。
• 交易已经完成或取消。
• 使用了 LyDragonTrade 未提供的变量名称。

这些变量读取的是当前内存中的交易状态，不提供历史交易记录，也不提供物品、货币、税率、锁定状态或倒计时变量。