01事件
| 名称 | 端 | 说明 |
|---|---|---|
blackmarket:client:openMenu | Client | Opens the black market dealer main menu for the player. |
blackmarket:client:closeMenu | Client | Closes any open black market menus for the player. |
blackmarket:client:openLaunderingMenu | Client | Opens the money laundering submenu. |
blackmarket:client:showNotification | Client | Displays a styled black market notification (title, message, type, duration). |
blackmarket:server:checkAccess | Server | Checks whether the calling player can access the black market and replies with reputation data. |
blackmarket:server:completeBuy | Server | Finalises a purchase after the client minigame succeeds. |
blackmarket:server:sellItem | Server | Triggers the sell flow with optional minigame and cooldown handling. |
blackmarket:server:completeSell | Server | Finalises a sale after the client minigame succeeds. |
blackmarket:server:launderMoney | Server | Launders dirty_money/markedbills into clean cash with fees and possible extortion. |
+值得了解
本页列出了 Agency-Blackmarket 中所有可供其他资源触发以集成其功能的事件。提供了客户端和服务器端事件，允许开发者与菜单交互，处理购买和销售，或触发洗钱流程。根据需要使用这些事件扩展黑市交互或从您自己的脚本自动化流程。
- 客户端交互事件
- 客户端事件如 blackmarket:client:openMenu、blackmarket:client:closeMenu 和 blackmarket:client:openLaunderingMenu 允许您以编程方式为玩家打开或关闭主菜单或洗钱菜单。您还可以使用 blackmarket:client:showNotification 显示样式化通知以提供自定义反馈。
- 服务器端交易处理
- 服务器事件包括用于声望检查的 blackmarket:server:checkAccess，用于在小游戏后完成交易的 blackmarket:server:completeBuy 和 blackmarket:server:completeSell，以及用于启动销售流程的 blackmarket:server:sellItem。使用这些事件可安全地控制访问并处理购买或销售。
- 洗钱集成
- blackmarket:server:launderMoney 事件允许其他脚本启动对 dirty_money 或 markedbills 的洗钱流程。该事件处理转换，应用配置的费用，并且如果设置了，可以触发勒索逻辑。集成此事件以自动化或自定义洗钱场景。
?常见问题
使用这些事件前需要添加任何依赖吗？
Agency-Blackmarket 需要 QBCore 或 ESX 之一，且会自动检测。可选依赖如 Agency-Notify、Agency-Progressbar 和 qb-target 可增强体验，但使用本页列出的事件并非强制要求。
有可用的 exports 吗，还是只有事件？
目前，Agency-Blackmarket 仅通过客户端和服务器事件提供集成。本版本未定义任何 exports，因此其他资源应使用列出的事件与黑市系统交互。
如果事件未按预期触发，我应检查什么？
确保在 server.cfg 中使用 ensure Agency-Blackmarket 正确启动了 Agency-Blackmarket，并且您的脚本以正确参数触发事件。同时确认服务器运行的是支持的框架，并且所有必需依赖均已安装。
我可以限制对某些事件或功能的访问吗？
访问控制由脚本内部逻辑管理，例如通过 blackmarket:server:checkAccess 进行声望检查。若要进一步限制功能，请在触发这些事件前在您自己的脚本中实现额外检查。