01客户端导出
| 导出 | 说明 |
|---|---|
OpenMenu(page) | 打开菜单,例如从环形菜单或手机应用中打开。page 可以是 overview(默认)、market、tools、smelter、cutting 或 contracts。 |
CloseMenu() | 关闭菜单,并将鼠标控制权交还给游戏。 |
IsMenuOpen() | 菜单打开时为 True。 |
IsWorking() | 玩家正在采矿或切割宝石时为 True。 |
GetLevel() | 玩家的采矿等级。 |
02服务端导出
| 导出 | 说明 |
|---|---|
GetLevel(source) | 玩家的采矿等级,玩家未知时为 0。 |
GetProgress(source) | 等级和进度,格式为 { level, xp, need, pct, max }。 |
AddXp(source, amount) | 添加 XP,包括升级和升级提示。找到玩家时返回 true。 |
SetLevel(source, level) | 将等级设为 1 到最高等级之间的值,并将 XP 设为 0。 |
GetStats(source) | 玩家目前为止的操作记录:{ mined, smelted, cut, broken, sold, earned, contracts }。 |
GetPrice(item) | 物品当前的单件市场价格。 |
03事件
| 名称 | 端 | 说明 |
|---|---|---|
agency-minerjob:mined | 服务端 | 采矿奖励发放后在服务器上触发,包含 source、item、count 和采矿区域。使用 AddEventHandler 监听,例如用于任务或统计。 |
agency-minerjob:sold | 服务端 | 出售后在服务器上触发,包含 source、item、count 和支付总额。 |
agency-minerjob:contract | 服务端 | 交付合约后在服务器上触发,包含 source、item、count 和报酬。 |
+值得了解
Agency-Minerjob V2 提供 exports 和服务器事件,因此任务、成就、手机和管理工具可以读取等级和价格、发放 XP,并对采矿、销售和合约作出响应。
- 等级和 XP
- GetLevel、GetProgress、AddXp 和 SetLevel 可在服务器上读取和更改玩家等级。AddXp 会像采矿时一样显示升级提示。
- 统计数据和价格
- GetStats 会返回玩家采矿、熔炼、切割、破坏、销售、赚取和交付的内容。GetPrice 可读取任意物品当前的市场价格。
- 服务器事件
- 奖励发放后,服务器会触发 agency-minerjob:mined、agency-minerjob:sold 和 agency-minerjob:contract。使用 AddEventHandler 监听;这些事件仅用于报告,奖励已经发放。
?常见问题
如何从我的轮盘菜单打开菜单?
在客户端调用 exports['Agency-Minerjob']:OpenMenu(),或者传入 'market' 或 'contracts' 等页面名称,直接打开对应页面。
