Agency-Blackmarket：设计地下经济而不破坏服务器

为什么大多数黑市脚本失败

设计糟糕的黑市脚本是破坏服务器经济的最快方式。太便宜导致人人犯罪，太贵没人用，太安全无风险，太危险玩家疲惫。Agency-Blackmarket 以经济平衡为首要考虑，功能列表为次。

按需求动态定价

每件物品的价格会根据最近购买该物品的玩家数量而变化。供需关系自动发生，如果整个服务器都在购买AR-15，价格将在数小时内翻倍。当需求下降时，价格会慢慢恢复正常。这创造了自然的市场节奏，而非固定的购物清单。

风险方面

每次黑市访问都有可配置的几率触发警察派遣、伏击事件或敌对NPC遭遇。风险随购买规模增加。聪明的玩家学会将大额购买分散到多次访问中。不够谨慎的玩家会被抓获并失去藏品。这种紧张感让非法RP保持趣味。

管理员工具

每笔交易都记录玩家ID、物品、价格和时间戳。管理员一目了然服务器的黑市经济，可设定价格底线或临时禁用特定物品。这套工具让专业RP社区信赖我们核心经济脚本，我们不仅卖功能，还交付维持规模运行的管理层。

与您的职业系统集成

Agency-Blackmarket exposes events that Agency-Minerjob, Agency-Admin, and your cop scripts can listen to. The ecosystem compounds, each individual script is useful alone, but together they create systemic emergent behavior that you couldn't script by hand.

安装与设置

Agency-Blackmarket requires oxmysql for transaction logging and dynamic price persistence. Import blackmarket.sql，将资源文件夹拖入，并添加 ensure agency-blackmarket 到 server.cfg. 位置坐标定义在 config.lua，资源自带六个默认黑市坐标，分布在默认GTA V地图上，可替换为您的自定义MLO位置。

可出售的物品需要存在于您的框架物品注册表中。配置包含默认物品列表；添加或删除物品只需简单编辑配置表。

配置选项

该 config.lua 提供对经济和风险设置的完全控制：

• 物品目录，定义每个物品的基础价格、最低价格下限、最高价格上限及需求弹性系数。
• 需求窗口，定价算法回溯的购买历史小时数。默认6小时。
• 风险事件，配置警察调度概率、伏击概率和竞争NPC生成概率，按购买金额阈值计算。
• 位置旋转，黑市位置可按计划轮换，迫使玩家通过世界内信息网络保持参与以寻找当前地点。
• 管理员价格覆盖，高级管理员可在经济事件期间手动设置每个物品的临时最低价或最高价。
• 交易日志保留，购买历史保留天数。默认30天。

框架兼容性

QBCore 和 ESX 适配器随包提供。对于独立版，请实现四个配置函数：物品给予、资金移除、警察警报触发，以及可选的基于职业的访问限制。定价引擎、风险事件系统、位置管理和管理工具完全框架无关。

为什么这对角色扮演很重要

一个运作过于安全的非法经济会沦为例行购物。Agency-Blackmarket的风险系统专门设计让每次重大购买都感觉是决策，而非交易。花十分钟策划大规模武器购买、侦察地点、时机选择、决定是否带备援的玩家，获得的RP体验远胜于仅打开菜单点击购买的玩家。

动态定价无需管理员干预即可创造自然稀缺。当整个服务器为计划中的冲突装备时，武器价格飙升向所有查看市场的玩家发出信号。精明的犯罪角色学会在需求激增前购买。这是涌现的经济行为，增加了策略深度，是固定价格菜单无法比拟的。

管理员交易仪表盘体现了负责任的RP经济管理。当服务器的非法经济不透明时，管理员无法判断平衡是否健康，直到玩家开始抱怨。通过完整的交易可视化，你可以实时看到某个玩家或团体是否购买过多，并在失衡破坏服务器犯罪生态前介入。

常见问题

我可以让特定物品仅供某些犯罪组织使用吗？

是的。目录中的每个物品支持可选的 requiredFlag 字段。设置了该标志的玩家（通过Agency-Admin或你自己的系统管理）可以看到并购买该物品；其他玩家则看到灰色且标有“restricted”标签。这创建了分级黑市，高级犯罪角色可访问更好的库存。

伏击事件如何运作？

当伏击触发时，一群敌对 NPC 在黑市位置生成并立即攻击玩家。NPC 数量和装备根据触发事件的购买金额动态调整。幸存伏击的玩家保留购买物品，未幸存者则物品归战利品系统所有。此设计刻意严苛，风险必须真实存在。

能否导出定价数据以进行外部分析？

oxmysql中的交易日志可直接查询。我们还暴露了服务器端导出 exports['agency-blackmarket']:GetPriceHistory(item, hours) 返回价格快照表。如果您想要服务器非法经济随时间变化的可视化图表，可将其连接到任何外部仪表盘工具。

如何防止一个玩家利用需求系统操纵价格？

设置 Config.PerPlayerDemandCap = true 和 Config.MaxPlayerDemandWeight = 0.3这限制了单个玩家购买历史对全球价格的影响程度。单一买家的需求操控仍然有效，但需要多个玩家持续协调才能显著推动价格变动。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Blackmarket 许可证的 cfx.re 账户
• 可选：Agency-Admin（集成交易监控仪表盘）

通过管理员价格控制的季节性经济事件

Agency-Blackmarket's admin pricing tools open up event-driven economy design. A few patterns that work well:

军备竞赛活动： 将武器价格在48小时内下调30%，并通过NPC新闻广播以角色身份宣布。这创造了一个短暂的犯罪活动高峰期，警方可以做好应对准备。窗口关闭前经济不会失衡。

供应冲击： 临时禁用一类物品（例如一周内无爆炸物）。稀缺性会导致囤积、玩家间黑市交易及围绕短缺的角色扮演。恢复供应后，观察市场恢复正常。

新违禁品引入： 以高价低需求衰减推出新物品。早期采用者支付溢价；随着其他玩家发现该物品，需求上升，价格飙升后趋于正常。价格历史讲述了您的社区如何接受新物品的故事。

这些经济事件无需编写自定义逻辑脚本，它们是管理员配置更改。其目的就是让非开发者的服务器管理员仅通过Agency-Blackmarket管理面板即可运行经济有趣的事件。