模组武器掉落框架

《无主之地》战利品池扩展 MOD 使用指南

【核心介绍】
将任意模组化武器（如「corn_slice_blade」「legend_117」）自动加入游戏战利品池，支持原版+MOD武器混合掉落，无需手动输入CET命令，开箱即得惊喜武器。

【安装指南】

1. 必须先安装前置依赖：确保已安装「Cyber Engine Tweaks（CET）」和「Native UI」模组；
2. 将 `ModdedLootFramework` 文件夹复制到游戏根目录 `/bin/x64/plugins/cyber_engine_tweaks/mods/`；
3. 确保 `init.lua` 与 `modded_weapons.txt` 位于同一文件夹内（路径示例：`/bin/x64/plugins/cyber_engine_tweaks/mods/ModdedLootFramework/`），若 `modded_weapons.txt` 不存在，请新建空白文件；
4. 缺一不可：`init.lua` + `modded_weapons.txt` 必须同时存在且路径正确，否则模组无法加载。

【功能详情】
✅ 已优化：

• 支持从 `modded_weapons.txt` 加载任意模组化枪械/近战武器（如 `Items.corn_slice_blade`）；
• 提供游戏内UI菜单，可实时调节战利品掉落概率、单次掉落数量（1–5件）、是否启用固定掉落；
• 原生UI界面支持滑块调节，操作直观；
• 战利品直接加入玩家背包，并弹出获得提示；
  ❌ 未修改：
• 敌人背包掉落逻辑（当前不支持敌人掉落，暂未实现）；
  ✨ 额外调整：
• 兼容所有通过CET代码定义的武器（无需修改w2p或材质文件）；
• 支持按敌人类型设置独立掉落概率（需在UI中配置）。

【使用要求】

• 必须安装游戏本体及最新稳定版「Cyber Engine Tweaks（CET）」；
• 必须安装「Native UI」模组（用于调出设置菜单）；
• 游戏版本：仅适配 Cyberpunk 2077 v2.1 及以上（不兼容v2.0及更早版本）；
• 无需额外运行库或脚本环境。

【兼容性说明】

• 兼容范围：所有基于CET注入的武器类模组（如「Legend Weapons」「Dark Sword」等）；
• 不兼容模组：修改战利品生成核心逻辑的模组（如「True Loot RNG Overhaul」）；
• 兼容补丁：暂未推出。

【注意事项】

• ⚠️ 每次更新本MOD前，必须手动备份 `modded_weapons.txt` 文件，否则内容将被覆盖；
• ⚠️ 添加武器时，每行仅写一个完整CET路径（如 `Items.corn_slice_blade`），不可含空格、引号或 `Game.AddToInventory()` 等函数代码；
• ⚠️ 若FPS明显下降，请关闭“高频率掉落”选项，并减少单次掉落数量至1–2件；
• ⚠️ 当前版本掉落仅作用于玩家拾取/宝箱开启，不触发敌人死亡掉落逻辑。

【更新日志】

• 2023年11月23日 v1.32 初次发布（开发中版本，核心功能已稳定）