01客户端导出
| 导出 | 说明 |
|---|---|
GetFuel(vehicle) | 车辆的燃油量 (0 到 100)，返回方式与 LegacyFuel 相同。 |
SetFuel(vehicle, level) | 设置车辆的燃油量 (0 到 100)。 |
02服务端导出
| 导出 | 说明 |
|---|---|
GetOwner(id) | 商店或加油站店主的标识符与名称，无人拥有时返回 nil。 |
AddStock(id, item, amount) | 向已拥有商店的库存增加商品件数，上限为 Config.Ownership.MaxStock。成功时返回 true。 |
AddFuelStock(id, litres) | 向已拥有加油站的油罐增加燃油升数，上限为 Config.GasStations.MaxFuel。成功时返回 true。 |
GetBalance(id) | 已拥有商店或加油站收银机内的资金金额，或 nil。 |
03事件
| 名称 | 端 | 说明 |
|---|---|---|
agency-shop:server:purchased | 服务端 | 在购买完成后触发，附带 (source, storeId, items, total, account)。items 列出交付的物品，total 为支付金额，因此统计或任务脚本无需反复轮询。 |
agency-shop:server:shoplift | 服务端 | 当玩家携带购物篮或推车中未付款的物品走出商店时触发，附带 (source, storeId, value, coords)。当 Config.Dispatch.System = 'event' 时，这是唯一的警报方式，以便你自己的调度脚本接收处理。 |
+值得了解
Agency-Shops 提供了一些 export 函数和两个服务端事件，以便您自己的燃油、补货、调度和统计脚本能与商店协同工作。
- 油量
- 客户端上的 GetFuel 和 SetFuel 与 LegacyFuel 的调用方式相同，油量范围为 0 到 100。为 LegacyFuel 编写的脚本只需更改资源名称即可。
- 店主与库存
- GetOwner 和 GetBalance 可通过 id 读取有主商店或加油站的信息。AddStock 和 AddFuelStock 可以添加件数或公升数，例如来自您自己的补货或职业脚本。
- 事件
- agency-shop:server:purchased 会在每次结账后触发，附带玩家、商店、物品、总额和账户信息。agency-shop:server:shoplift 会在玩家携带未付款商品走出商店时触发。
?常见问题
我该如何读取商店的店主？
在服务端调用 exports['Agency-Shops']:GetOwner(id)。它会返回店主的标识符和姓名，若商店无人拥有则返回 nil。
我该如何针对偷窃行为发送自定义警方报警？
设置 Config.Dispatch.System = 'event' 并监听 agency-shop:server:shoplift。它会提供玩家、商店 id、商品价值和坐标。