Agency Docs
QBESXStandalone

Agency-Minerjob V2 导出 & API

一款适用于 FiveM 的采矿工作脚本,支持 QBCore、Qbox、ESX 或完全独立运行,地点包括三处:Davis Quartz 采石场、Tataviam Mountains.

v2.0.0付费5 页面

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' 等页面名称,直接打开对应页面。

看完本页仍未解决?接下来由我们的支持团队接手。