LCGoldScrap Lite 中文说明

Experimental fork of Simon Tendo's LCGoldScrapMod 2.2.7. Retains 50 natural gold scrap types and three buyable tools, with individual tool prices and per-item spawn settings. Every player needs this fork; do not install it alongside the original. Built against Lethal Company v81; in-game and real multiplayer testing is pending.

Fork implementation and documentation were edited with OpenAI Codex assistance. Original assets and upstream code are credited below; the original asset bundle is reused. This is not an official Simon Tendo release.

插件版本：2.2.7.1；本地安装包版本：1.0.0。本分支基于 Simon Tendo 的 LCGoldScrapMod 2.2.7，保留 50 种自然黄金废料和 3 件商店工具，用于以探索、搜刮和搬运贵重物品为主的整合包。

本文描述当前源码的功能与配置约定。尚未完成游戏内运行及真实多人联机验收；编译或静态检查结果不能替代这些验证。

保留内容

• 原有 50 种自然黄金废料及其各自的交互行为。它们仍有价值、重量、导电性等差异；本分支没有把功能性废料统一改成普通摆件。
• 三件商店工具：

终端输入 gold store 查看三件工具；输入工具英文名称购买，名称后加 info 查看介绍。gold scrap 提供简短说明。

移除范围

商店原有 20 项只开放上述 3 项，其余 17 项不再提供购买入口：

同时停用以下系统：

• Gold Fever（金潮）事件、相关奖励与 Gold Sale（金价促销）机制。
• 金镐矿点生成与挖矿流程。
• 特殊日期触发、日期密码覆盖、日期带来的生成或表现变化。
• 故事日志的活动生成流程及关联的独立 XML 存档读写。
• 随机玩家趣味标签、可选玩梗声音替换和可开启的原型模型模式。
• 与其他模组联动新增 Gold Crate 的入口。

声音和模型优先沿用原版游戏资源；缺少可用原版资源时保留必要回退，避免空引用。普通黄金废料原有的有用或危险交互不属于上述移除范围。

这里的“移除”指停用游戏内功能和入口。为了保留资源身份与注册顺序，部分旧类型、资源字段和网络预制体注册仍在。本版继续使用原 goldscrapassetbundle，没有删除包内素材，也不承诺减少资源包体积。

配置：共 114 项

配置保存在 BepInEx/config/LCGoldScrapMod.cfg。安装 LethalConfig 时，也可以在它的设置界面中编辑这些选项。

当前有效配置由 11 项全局设置 + 3 项工具独立价格 + 50 × 2 项废料设置组成。首次正常加载资源时生成新配置。修改后需重启游戏。

三件工具的独立价格

基础价格为非负整数，0 表示免费。最终售价为 BasePrice × 全局 Multiplier Price，按整数点数计算；例如沙漏基础价 133、全局倍率 2 时，售价为 266。房主计算最终整数价格并下发给成员，成员不再对该结果重复乘倍率。

每种黄金废料的开关和权重

每件自然废料都有单独的 Scrap - <folderName> 分组。folderName 是资源中的稳定名称，不随显示名称变化。

权重倍率不是出现百分比，也不是必定生成的数量。 1 保持原有权重，2 将该物品的权重乘二；实际出现概率还取决于同一生成池内其他废料的权重、游戏的抽取流程及整数权重计算。

将 Enabled 设为 false，或者将 SpawnWeightMultiplier 设为 0，都会禁止该物品的自然刷新。正倍率会继续受全局生成设置及星球范围限制，不会把原本不允许生成的星球变成允许生成。关闭生成不会自动删除存档或飞船中已有的物品。

保留的 11 项全局设置

全局设置的默认值沿用上游。新加入的逐件开关默认全开、倍率默认 1，因此没有额外提高或降低某一种废料的默认权重。

联机与使用要求

• 如果使用本地 ZIP，请每位成员在 r2modman 当前配置中通过本地模组导入功能安装。整合包导出文件／分享码不包含本地修改版的 DLL 和资源包，成员需要另行导入 ZIP。公开上架后，可以通过 Thunderstore 包清单下载相同版本。
• 房主控制自然生成和有效工具价格。成员本地填写的生成／价格配置不能覆盖房主；设置界面显示的本地配置不等于当前房间的有效值。
• 所有玩家必须安装同一个 Lite 分支、同一版本及相同资源包；不能与原版 LCGoldScrapMod 混装或混房。 本分支仍使用插件 GUID LCGoldScrapMod、原程序集名和原有类型名，不应同时加载两套 DLL。
• 修改配置后重启游戏；LethalConfig 中的相关选项也标记为需要重启。
• 本版保留旧物品和解锁项的注册身份，以避免因删去数组条目而主动改变索引。这不等于已经验证原版存档迁移；停用商品也不会通过本版自动清理旧存档中的既有实例。
• 正式用于整合包前，仍需在测试存档中验证三工具购买、自然生成、保存／读取、成员加入和重新开房等实际流程。

上游来源与许可证

• 上游作者：Simon van Luxemburg（Simon Tendo）。
• 上游仓库：SimonTendo/LCGoldScrapMod。
• 本分支基线：提交 2f26b8bcc29940403c3d556df630f8abfc29738e，提交标题为 Thunderstore v2.2.7。
• 许可证：MIT，完整版权与许可文本见 LICENSE.txt。分发源码或成品时应保留该版权和许可文本。

Lite 是基于上述源码的定制分支，不代表上游作者发布或认可的版本。修改摘要见 CHANGELOG_LITE.md。

配置示例 / Configuration example

包内 CONFIG_EXAMPLE.cfg 是完整默认配置的参考副本，不会覆盖你的设置。实际配置首次启动后生成于 BepInEx/config/LCGoldScrapMod.cfg。

LCGoldScrap Lite Changelog

1.0.2 — Optional IndustrialGoldSafe-only gold spawning

• Added Compatibility / Disable Natural Spawns With IndustrialGoldSafe, enabled by default and exposed through optional LethalConfig integration.
• With IndustrialGoldSafe loaded, the host excludes gold scrap from natural generation on vanilla and modded moons. Set the option to false to allow both safe rewards and natural gold scrap; without Safe, normal spawn settings are unchanged.
• Checks the loaded Safe GUID at generation time without adding a circular dependency or relying on the lifetime of the BepInEx bootstrap object.
• Temporarily filters natural generation candidates rather than relying only on zero weights, covering single-item days and boosted-item selection. Restores the original level pool and boosted-item index after success or failure.
• Preserves all item registrations, safe rewards, existing items, individual spawn settings, values and tool prices.
• Updated the internal plugin version to 2.2.7.3. No RPC identities or asset-bundle contents changed.
• Configuration and generation-policy checks are offline evidence; in-game and real multiplayer verification of this update remain pending.

1.0.1 — Configuration filename and documentation update

• Changed the active configuration file to BepInEx/config/GoldScrapLite.cfg.
• Added an initial settings migration: when GoldScrapLite.cfg does not exist, copy an existing LCGoldScrapMod.cfg to the new filename. Never overwrite an existing new file or delete the old file. Later edits to the old file are not synchronized.
• Updated the internal plugin version to 2.2.7.2 while retaining the plugin GUID LCGoldScrapMod.
• Replaced the public README and changelog with English documentation. The local Chinese guide remains available in the source checkout.
• Added explicit credit to Simon van Luxemburg (Simon Tendo), with direct links to the original Thunderstore package, GitHub repository, fixed upstream commit, and MIT license.
• Retained the disclosure that OpenAI Codex assisted with this fork's implementation and documentation. Original upstream assets are reused; this fork does not redraw or regenerate them with AI.
• Clarified configuration, host authority, installation requirements, and the distinction between offline verification and actual game testing.
• Built with zero errors and warnings, including Unity Netcode post-processing and assembly metadata checks. Passed 143 real-BepInEx configuration assertions, including the new filename and first-run migration. In-game and real multiplayer testing remain pending.

1.0.0 — Initial experimental fork

Content

• Retained all 50 natural gold scrap types and their individual interactions.
• Kept three shop tools: Golden Hourglass, Golden Ticket, and Golden Glove. Disabled purchase access to the other 17 store entries.
• Simplified the terminal shop and help pages.
• Disabled Gold Fever, Gold Sale, mining nodes, active story-log generation, related independent XML persistence, special-date triggers, and date-password overrides.
• Disabled random player tags, optional joke-sound replacements, selectable prototype models, and the optional extra Gold Crate integration.
• Preferred vanilla sounds and models where available, while retaining necessary fallback assets.

Configuration

• Added individual tool base prices: 133 / 50 / 800 credits for Hourglass / Ticket / Glove. A base price of 0 makes that tool free.
• Applied the existing global price multiplier to the individual prices. The host distributes final integer prices to clients.
• Blocked tool purchases for joining clients until the base host settings and final tool prices have both been applied.
• Added Enabled and SpawnWeightMultiplier for each of the 50 natural scrap types, grouped by stable asset folder name.
• Defaulted all scrap switches to enabled and all individual multipliers to 1. The multiplier range is 0–100; disabling the switch or setting 0 prevents natural spawning.
• Clarified that spawn weights are relative weights, not fixed percentages. Existing global settings and moon restrictions still apply.
• Retained 11 global settings for 114 active configuration entries in total. All entries are exposed through optional LethalConfig integration and require a game restart after changes.

Compatibility and verification

• Kept plugin GUID LCGoldScrapMod, assembly identity, original types, and legacy registration order. The original asset bundle is reused; this is not an asset-size reduction.
• Required every player to use the same Lite fork version and asset bundle. The original mod must not be installed alongside this fork or mixed into the same lobby.
• Built against Lethal Company v81 with zero build errors and warnings, including Unity Netcode post-processing and assembly metadata checks.
• Passed 287 offline assertions: 107 store-policy, 127 configuration, and 53 rarity/price checks. These checks cover selected logic and binding behavior, not real Unity execution or network delivery.
• In-game and real multiplayer testing remain pending. Build success and offline assertions do not establish runtime compatibility or save-migration safety.

Credits, provenance, and AI disclosure

Original mod by Simon van Luxemburg (Simon Tendo):

• Original Thunderstore package: LCGoldScrapMod
• Original source repository
• Upstream baseline: 2f26b8bcc29940403c3d556df630f8abfc29738e — Thunderstore v2.2.7
• Upstream MIT license and copyright notice

OpenAI Codex assisted with this fork's implementation and documentation. This fork reuses the upstream asset bundle without AI redrawing or regeneration of its art, models, or audio. It is an independent derivative, not an official or endorsed Simon Tendo release. The upstream MIT copyright and license notice are retained.