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

工具	默认基础售价	保留用途
Golden Hourglass（金色沙漏）	133	减缓一天中的时间流逝，沿用上游工具机制。
Golden Ticket（金票）	50	传送时保留携带物品，沿用上游普通／反向传送及票券消耗机制。
Golden Glove（金手套）	800	保留原有的战斗与远距离取物等三种技能。

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

移除范围

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

类别	停用商品
服装、家具与互动摆件	Bronze Suit、Silver Suit、Gold Suit、Golden Throne、Gold Trophy、Gold Medal、Groovy Gold、Gold Toilet、Goldfather Clock
挖矿相关	Golden Pickaxe、Gold Nugget、Gold Ore
其他功能商品	Gold Crown、Credits Card、Directory LOG、Cat o Gold、Safe Box

同时停用以下系统：

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

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

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

配置：共 114 项

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

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

三件工具的独立价格

配置分组	配置键	默认值
Shop - GoldenHourglass	BasePrice	133
Shop - GoldenTicket	BasePrice	50
Shop - GoldenGlove	BasePrice	800

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

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

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

配置键	默认值	含义
Enabled	true	是否参与自然废料生成。
SpawnWeightMultiplier	1	该物品的生成权重倍率，允许范围 0–100。

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

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

保留的 11 项全局设置

分组／配置键	默认值	用途
Customization / Selected Moons	All	选择允许生成黄金废料的原版星球；支持星球英文名、All 或 None。
Customization / Multiplier Minimum Value	2.5	最低随机价值的倍率。
Customization / Multiplier Maximum Value	2	最高随机价值的倍率。
Customization / Multiplier Rarity	3	原版星球的黄金废料权重计算参数；与逐件倍率共同作用。
Customization / Multiplier Weight	1.5	黄金物品的负重倍率。
Customization / Multiplier Price	1	三工具独立基础价的统一倍率；0 使三件工具全部免费。
Modded Moons / Modded Spawn Enabled	true	是否允许在模组星球生成。
Modded Moons / Modded Spawn Rarity	1	模组星球的基础生成权重参数。
Modded Moons / Modded Minimum Cost	0	模组星球需要满足的航行费用门槛。
Other / Other Scan Command	false	是否改用本模组的终端扫描实现。
Other / Other Tools Balance	false	沿用上游工具平衡选项，以对应能力代价换取部分功能物品的防雷处理。

全局设置的默认值沿用上游。新加入的逐件开关默认全开、倍率默认 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。