Agency-Vending：真正能在你的经济中销售物品的自动售货机

GTA V中最被忽视的道具

GTA V 点缀着自动售货机，在原版 FiveM 服务器中纯属装饰。Agency-Vending 使每台自动售货机都能正常使用，玩家走近，交互，购买合理价格的食物或饮料，并获得相应的增益。简单、无处不在，让地图比原版更有生机。

库存耗尽

每台机器都有独立库存，玩家购买物品时库存会减少。空机器显示“缺货”状态，直到补货。这看似微不足道，但创造了一个新的工作角色：自动售货路线操作员。补货的玩家可获得其库存销售额的一部分分成。突然间，每个道具都有了经济活动。

每种机器类型的物品种类

饮料自动售货机出售带有轻微解渴效果的饮料。零食自动售货机出售带有饥饿效果的食物。咖啡亭出售能消除疲劳的热饮。Agency-Vending根据道具模型自动识别机器类型并适当补货。标准摆放无需配置。

定价信号

价格故意比餐厅食物便宜，但比家庭烹饪贵。这创造了合理的经济层次：家 > 自动贩卖机 > 快餐 > 餐厅。玩家自然倾向于选择符合其情况的选项，这正是现实购买行为的体现。

管理员举报

服务器管理员每周会收到自动贩卖活动总结：哪些机器收益最高，哪些补货不足，哪些社区存在需求缺口。这些数据对于平衡地图和发现新的游戏玩法机会非常宝贵，无需打扰玩家调查。

安装与设置

Agency-Vending requires oxmysql for stock tracking per machine. Import vending.sql，将资源拖入服务器，并添加 ensure agency-vending 到 server.cfg. 首次启动时，资源会扫描地图上的所有原生自动售货机道具，并自动在数据库中注册。默认机器位置无需手动输入坐标。

机器分发的物品需要存在于您的框架物品注册表中。配置附带 QBCore 和 ESX 的标准食物和饮料物品名称。自定义物品名称每种机器类型只需一行更改。

配置选项

该 config.lua 涵盖机器行为和经济设置：

• 每台机器的库存，每台机器的容量，达到后需补充。默认50单位。
• 补货方式，自动定时补货（简单）、玩家驱动补货（经济角色）或仅限管理员补货。
• 补货工作要求，可选，限制补货仅限于配送或销售工作角色的玩家。
• 利润分成，销售收入中分配给最后补货玩家的百分比。
• 机器类型覆盖，为特定机器道具模型手动设置不同的物品列表。
• 效果持续时间，食物/饮料增益持续时间。可针对每种物品类型配置。
• 缺货视觉效果，切换机器道具的“空”视觉状态。

框架兼容性

QBCore 和 ESX 适配器已捆绑。对于独立版，请实现 Config.GiveItem(src, item, count) 和 Config.TakeMoney(src, amount). 机器扫描、库存管理、补货经济和管理员报告均与框架无关。

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

地图密度是RP服务器质量中被低估的因素之一。当玩家可以与地图上更多现有的道具、机器、长椅、垃圾桶、门互动时，世界感觉更像是有人居住而非戏剧化。Agency-Vending 是朝这个方向最容易取得的成果之一：每个自动售货机道具都变成了一个互动的经济节点，服务器团队无需额外工作。

自动售货路线运营角色可能是脚本启用的最有趣的自发玩法。玩家角色通过补货机器、管理路线、跟踪哪些社区周转率高来谋生，这是一个平凡但合法的RP角色，一些玩家真正喜欢。并非每个角色都需要是罪犯或警察。

管理员报告层是服务器经济健康的实用工具。如果某个机器位置持续空置（需求高），而另一个总是满员（人流少），这就是放置定制商店NPC或调整玩家出生点的可操作信息。自动售货数据告诉你玩家实际停留的位置。

常见问题

我可以添加非GTA V原生道具的自定义机器位置吗？

是的。在中定义自定义机器。 Config.CustomMachines 带有坐标、道具模型和物品列表。这是添加自动售货机到原生道具扫描器无法触及的自定义MLO室内的方法。

玩家可以抢劫自动售货机吗？

config.lua中有一个可选抢劫机制。启用后设置撬开时长、失败概率和战利品范围。成功抢劫会获得当前库存的一部分物品，并将机器标记为损坏，直到补货。此机制增加了犯罪玩法，但不破坏经济，每台机器的战利品故意设定较少。

当多个玩家补货同一机器时，利润如何分配？

最近补货的玩家拥有该机器的利润分成，直到机器耗尽并再次补货。多个补货者之间没有分成，最后补货者拥有下一周期的收益。这保持了账目简单，并在配送路线运营商之间创造了自然竞争。

是否支持仅服务器端运行（无客户端资源）？

不。机器扫描和交互UI运行于客户端。Agency-Vending使用服务器和客户端脚本。服务器处理库存状态和经济交易；客户端处理道具检测、UI渲染和玩家接近触发。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Vending 许可证的 cfx.re 账户
• 可选：ox_lib（用于UI组件，若不存在则有回退方案）

扩展自动售货经济

自动售货机经济在作为更广泛的食品和饮料系统的一部分时效果最佳，而不是唯一选择。以下是有效分层的方法：

自制（通过制作脚本）应该是获得食物的最便宜方式且具有最佳增益值，但需要材料和时间。自动售货机是便利级别：无需准备，立即购买，中等成本，中等增益。玩家经营的餐厅是高级级别：最佳食物增益，最高成本，需要玩家厨师。快餐NPC介于自动售货机和餐厅之间。

当存在全部四个等级时，玩家会根据自身情况做出自然的经济决策。任务中途的玩家使用自动售货机，因为无法停餐厅。时间和资金充裕的玩家则去玩家餐厅体验角色扮演和增益。分级创造了经济中的有意义选择，而非单一主导选项。

Agency-Vending also works well as a revenue stream for neighborhood business owners in city RP. A shop owner who "owns the vending route" in their neighborhood has a passive income mechanism and a reason to patrol and defend their territory.