CustomVendingSetup – 自定义售货机设置

必须依赖选项

ItemRetriever
MonumentFinder

关于自定义售货机设置

• 允许定制在纪念碑自动售货机上出售的物品
• 支持所有纪念碑类型，包括定制纪念碑
• 根据自动售货机相对于纪念碑的相对位置，保存自定义设置，以便将来重新启动和清除
• 将编辑与重复纪念碑上的自动售货机的副本同步
• 与通过Monument Addons等插件在纪念碑上生成的 NPC 自动售货机兼容
• 允许定制自动售货机外观
• 允许禁用自动售货机地图标记
• 允许禁用送货无人机的访问权限
• 支持经济和服务器奖励
• 支持蓝图以及具有自定义皮肤和名称的物品
• 支持附件和其他子项
• 支持替代弹药类型和数量

注意：不会影响玩家自动售货机。

⁉️  怎么运行的

当您打开 NPC 自动售货机时，如果您有权限，您将看到一个编辑按钮。单击该编辑按钮将显示一个容器 UI，您可以在其中自定义自动售货机。

• 通过添加或移除容器中的物品来更改所售物品及其价格
• 通过重新排列容器中的项目来更改显示顺序
• 通过编辑每个商品旁边的注释来更改库存设置
• 通过单击广播图标来切换是否启用地图标记（绿色=开启，灰色=关闭）
• 点击无人机图标，切换送货无人机是否可以进入自动售货机（绿色=开启，灰色=关闭）
• 点击右下角的注释并编辑其内容，更改自动售货机外观和商店名称
• 点击“保存”按钮保存更改

关于地图和无人机市场的限制

• 在地图上查看自动售货机时看不到皮肤覆盖
• 经济和服务器奖励货币不能用于通过无人机市场购买物品
• 当通过无人机市场出售物品以换取经济或服务器奖励货币时，玩家将立即收到货币（无人机将飞行但不会运输任何物品）

数据提供者

编辑自动售货机时，您会看到一些调试文本，上面写着“数据提供者：……”，它会告诉您如何保存和检索您的定制。

• “Map”——表示数据与此特定地图相关，不会应用于其他地图。数据将保存在路径oxide/data/CustomVendingSetup/MAP_NAME.json。
• “Monument”——表示数据与最近的纪念碑相关，由纪念碑查找器确定。数据将保存在路径oxide/data/CustomVendingSetup.json。
• “Plugin”——表示另一个插件正在连接到自定义自动售货设置，以处理保存和检索特定自动售货机的数据。通常，这是由生成自动售货机的插件完成的。数据可以保存在任何地方，因为这是由作为数据提供者的插件决定的。
• 对于 Monument Addons，数据将保存在生成​​自动售货机的配置文件中oxide/data/MonumentAddons/PROFILE_NAME.json
• 对于会说话的 NPC 供应商，数据将保存在自动售货机配置文件中oxide/data/TalkingNpc/VendingMachines/PROFILE_NAME.json

如果您在纪念碑处看到“地图”，则说明您没有安装纪念碑查找器，或者您需要通过纪念碑查找器配置增加纪念碑的边界以包围自动售货机的位置。配置纪念碑边界对于自定义纪念碑非常重要，因为插件没有可靠的方法可以自动知道自定义纪念碑有多大。

🛡️  权限

• customvendingsetup.use — 允许编辑纪念碑处的 NPC 自动售货机。

🎞️ 截图

❓ 常问问题

如何更快地购买物品（无交易延迟）？
安装Instant Buy插件。它是兼容的。

如何让物品立即补货？
安装Vending In Stock插件。它是兼容的。
或者，您可以通过更改相应商品注释中的“补货间隔秒数”值来更改每台自动售货机的每件商品的补货速度。将该值设置为0将导致该商品在购买后立即补货。

我如何允许玩家批量购买更多物品？
您一次可以购买的商品数量取决于自动售货机的库存。默认情况下，自动售货机的库存足以供您购买 10 件商品，但在某些情况下可能会有更多库存（请参阅下文了解该问题）。您可以通过更改相应商品注释中的“最大库存”值来更改每台自动售货机每件商品的最大库存。

为什么有些商品显示的库存比配置的多？
这种情况可能发生在以多种价格出售同一种商品的自动售货机上（例如，废料变成木材，石头变成木材）。发生这种情况的原因是，每台自动售货机都使用一个库存容器来存放其出售的所有商品，因此它会尝试储存需要最多库存的销售商品所需的数量。

如果您希望所有商品显示相同的库存数量（例如，库存为 10 件），您可以更改销售金额和货币金额，以便销售金额与同一商品的其他列表相匹配。

示例问题：
1000 木材可换取 20 废料（显示库存 10）
500 木材可兑换 150 块石头（显示库存20 块）

示例解决方案 A（共储存 10k 木材，与原始解决方案相同）：
1000 木材可换取 20 废料（显示库存 10）
1000木材可兑换300石头（显示库存 10 块）

示例解决方案 B（库存木材总量 5k，一半原装）：
10 块废料可换取500 块木材（显示库存 10 块）
500 木材可兑换 150 块石头（显示库存 10 块）

为什么股票与香草不同？
这种情况可能发生在以多种价格出售同一种物品的自动售货机上（例如，废料变成木材，石头变成木材）。发生这种情况是因为原版库存逻辑存在不一致，这些不一致已在插件的库存逻辑中得到修复。

我可以出售 7 件以上的商品吗？
不可以。每台自动售货机最多可以出售 7 件商品。由于原版游戏中的 UI 限制，无法出售更多商品。插件的未来版本可能会实现分页功能。

如何显示自定义项目名称？
目前无法显示自定义物品名称，但计划提供此功能。不过，该插件确实存储了自定义物品名称，并正确地将这些名称设置在玩家购买的物品上。

如何设置自定义纪念碑？
作为先决条件，自定义纪念碑必须使用纪念碑标记预制件并具有唯一名称。然后，您必须在纪念碑查找器中配置纪念碑的边界以包围纪念碑，以便自定义自动售货机设置可以准确确定给定的自动售货机是否在该纪念碑内。请参阅纪念碑查找器插件文档以获取更多指导。

🔗  原网址

https://umod.org/plugins/custom-vending-setup