自定义产品加载器

作用说明

自定义产品加载器（CPL）为《超市模拟器》添加了新产品，以及解锁这些产品所需的许可证。内容包是一个小文件夹：包含描述商品的products.json文件、每件商品的PNG图标，以及可选的OBJ模型。将内容包放入模组的products文件夹后，其商品即会出现在游戏中，在管理应用中拥有专属许可证卡片，可从市场应用中订购，并像内置产品一样摆放在货架、展示架和自动售货机上。

此页面为加载器。产品包需单独下载，可在此页面或从其他作者处获取。请先安装此模组，再添加产品包。

特色功能

• 真正定制产品。 每种商品都有自己的名称、品牌、价格、类别和货架类型，对应的许可证卡可在管理界面中解锁。
• 自定义模型，或复用基础物品。包含一个带有贴图的OBJ模型，或者省略它，产品将借用现有产品的模型。
• 自定义图标会显示在手持扫描仪、货架与展示架标签、价签、配送箱以及自动售货机上。
• 自定义模型使用游戏内光照，夜晚时会与其他物体一同变暗。
• 大批量也毫无压力。产品数量上限极高（数以千计），几乎无人能够触及。
• 无需重新加载游戏即可启用和禁用许可证。关闭许可证会立即将其产品从市场中移除，重新启用则会恢复这些产品。同一许可证内的单个产品也同样适用。
• 更多产品包完全兼容。为旧版更多产品模组制作的包可在CPL中无需修改直接使用。只需移动文件夹即可。
• 您的存档安全无虞。 更新会保留你的整合包、存档和已购买许可，且该模组从不修改任何游戏文件。如果游戏更新导致模组无法运行，你的游戏仍会正常工作。
  

需求

• 超市模拟器 版本 1.6.0
• Tobey的超市模拟器BepInEx整合包
  

安装

• 为《超市模拟器》安装 BepInEx 6，并运行一次游戏，以便 BepInEx 完成自身配置。
• 将此模组解压到游戏的安装文件夹中，使压缩包内的BepInEx文件夹与游戏的BepInEx文件夹合并。
• 启动游戏。BepInEx/LogOutput.log中应包含一行[Custom Products Loader] Loaded 2.1.0。
  

正在添加模组包。 将一个包含包（pack）的文件夹放入BepInEx/plugins/CustomProductsLoader/products目录下，然后启动游戏。本页面提供了一个小型示例包作为独立下载，其SampleProducts文件夹内包含一个许可证（CPL Sample License，售价10美元，开局即可购买）及两款产品。通过管理应用购买该许可证即可确认一切运行正常。如需移除某个包，直接删除其文件夹即可。模组将在下次启动时自动清理已删除包留下的数据。

更新中。 将新版本解压覆盖到现有安装目录。您的资源包、存档和已购买许可证都会保留并继续有效。您已购买的许可证不会失效。

兼容性

• 产品与纹理定制器（PTC） 自2.1.0版本起与CPL并行运行。自定义标签和PTC皮肤均可显示。
• MoreProducts-格式包可直接加载。将文件夹移至此模组的products文件夹下即可直接使用。
• 合作模式多人游戏目前尚未测试。模组可以加载，但在合作会话中，自定义产品暂不提供任何保证。
• 货币及货币格式模组。 如果自定义价格显示的是逗号而不是句点，或者扫描仪价格在大号和小号之间闪烁，那是由其它模组的货币设置引起的，与本模组无关。请在该模组的配置中寻找小数点分隔符或更小位数小数的相关选项。
  

该模组不会修改任何游戏文件，其写入的所有内容均隔离存储于BepInEx/plugins/CustomProductsLoader目录下。移除模组或删除单个数据包，不会损坏曾使用过它的存档。自定义产品会从该存档中直接消失，游戏仍可正常运行。

创建自己的包

资源包是一个文件夹，内含一个products.json文件、一个icons文件夹，以及一个可选的models文件夹。你需要自行给每个产品和许可证分配一个纯整数ID。产品ID请使用90000及以上，许可证ID请使用9000及以上，这样就不会与游戏自身的ID冲突。以下是products.json的格式：

{
  "licenses": [
    {
      "id": 9001,
      "name": "CPL 示例许可证"
      "price": 10,
      "requiredStoreLevel": 0,
      "products": [
        {
          "id": 90011,
          "name": "CPL 样品苏打水"
          "brand": "CPL测试"
          "baseProductId": 1,
          "marketPrice": 4.5,
          "icon": "icons/cpl_sample_soda.png"
        }
      ]
    }
  ]
}

每个定制产品都以现有产品为副本开始，通过baseProductId设定，然后覆盖你填写的部分。完整的字段参考涵盖模型、定价、类别、货架类型以及MoreProducts格式，见下载包中的AUTHORING.txt。示例包是可复制的可用模板。

FAQ

我需要这个模组才能使用自定义产品包吗？
是的。这是一个读取内容包的加载器。内容包本身是单独下载的，在本页面以及来自其他作者的作品中。请先安装此模组，然后将内容包放入其 products 文件夹中。

更新会清除我的存档或让我重新购买许可吗？
不。将新版本解压覆盖到旧版本上。您的模组包、存档和已购买的许可证都会保留，并且您已购买的许可证仍将保持解锁状态。

包裹会去哪里？
每个包都会放入BepInEx/plugins/CustomProductsLoader/products下的各自文件夹中。

图标的包或许可证卡没有显示。我应该检查什么？
打开BepInEx/LogOutput.log，查找带有Custom Products Loader的行。打包错误（如重复ID或缺失图标）会连同文件名一起报告在该处。如需详细日志，请在BepInEx/config/tomasz.customproductsloader.cfg中将VerboseLogs设为true，然后重启游戏。

它兼容TextureReplacer、WarehouseRefill或ProductCustomizer吗？
是的。TextureReplacer（现在 产品与贴图自定义工具 mod）自2.1.0版本起与CPL共享标签图像集。WarehouseRefill和ProductCustomizer均能识别自定义产品。MoreProducts格式的包可直接加载，无需修改。

它与MoreProducts兼容吗？
CPL兼容MoreProducts产品包。CPL是MoreProducts的直接替代品。CPL与MoreProducts不兼容，因为它们功能相同，且MoreProducts已过时且不再可用。

在合作多人模式下能生效吗？
未经测试，可能无法正常工作。该模组可以加载，但在合作模式会话中，自定义商品有其独特的麻烦之处，而我尚未抽出时间来解决这个问题。

移除安全吗？
是的。该模组不会修改任何游戏文件，存档中遗留的数据是无害且惰性的。移除模组或删除数据包绝无任何风险。

我该怎么制作自己的卡包？
参见上文“制作自己的资源包”以及下载中的完整版AUTHORING.txt。

Bug与疑问反馈

使用本页面的“帖子”和“Bug”标签页。日志文件会很有帮助。请附上BepInEx/LogOutput.log，最好先在配置中设置VerboseLogs = true，以便报告包含追踪问题所需的详细信息。

制作人员名单

由Tomasz创作，Leptoon维护。基于BepInEx构建，得益于Tobey。