✦ 功能亮点

✦ 击杀者识别机制（P1 → P4）

模组按优先级依次判定「这袋战利品该给谁」，覆盖各种复杂击杀场景：

1. P1 · 直接击杀者 — 玩家亲手击杀，或无人机 / 炮塔等召唤物击杀（自动归主人）

2. P2 · AI 锁定目标 — 僵尸当前攻击目标或仇恨对象（覆盖 Buff 灼烧、陷阱 dot 等间接致死）

3. P3 · 最后伤害来源 — 记录最后一次对该实体造成伤害的玩家（弓箭、远程等兜底）

4. P4 · 无击杀者 — 无法判定归属时，放行原版逻辑，物品正常掉落在地上

✦ 配置文件说明

模组首次启动时，会在专用服务器根目录（与 7DaysToDieServer.exe 同级）自动创建配置文件夹，无需手动打包进模组：

✅ 支持热加载：修改 AutoLootBag.xml 并保存后立即生效，无需重启服务器（日志会打印「配置已热加载生效」）。若配置文件缺失或字段不全，模组会自动补全默认值。

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<AutoLootBag>
  <!-- 自动入包 配置文件 | 修改后需重启服务器生效 -->
  <!-- 自动入包总开关：true=击杀后战利品直接进背包  false=走原版地上掉袋 -->
  <EnableAutoLoot>true</EnableAutoLoot>
  <!-- 自动割肉总开关：true=击杀后自动结算肉/皮/骨等采集产物 -->
  <EnableAutoHarvest>true</EnableAutoHarvest>
  <!-- 割肉收获率倍率：1.0=100%(原版) 2.0=双倍 0=不产出；技能/Buff 加成仍叠加计算 -->
  <HarvestRate>1.0</HarvestRate>
  <!-- 尸体清理：true=割肉接管后立即移除尸体降低负担；割肉关闭时尸体保留以便手动割肉 -->
  <EnableCorpseCleanup>true</EnableCorpseCleanup>
  <!-- 是否对小怪(僵尸等 EntityEnemy)生效 -->
  <ApplyToEnemies>true</ApplyToEnemies>
  <!-- 是否对动物(EntityAnimal)生效 -->
  <ApplyToAnimals>true</ApplyToAnimals>
  <!-- 排查问题用：true=输出详细日志(每次击杀都会打印)，正常运营建议 false -->
  <EnableDebugLog>false</EnableDebugLog>
  <!-- ===== 授权与聊天开关 ===== -->
  <!-- 白名单授权：true=仅下方授权用户可用自动入包；false=全员可用(仍受各自开关控制) -->
  <EnableWhitelist>false</EnableWhitelist>
  <!-- 聊天命令文本(玩家在聊天框输入即可，可自定义)：入包/割肉各自独立开关 -->
  <CmdEnable>入包开</CmdEnable>
  <CmdDisable>入包关</CmdDisable>
  <CmdHarvestEnable>割肉开</CmdHarvestEnable>
  <CmdHarvestDisable>割肉关</CmdHarvestDisable>
  <CmdStatus>入包状态</CmdStatus>
  <!-- 授权用户：每个 <User> 填一个 PlatformId(如 Steam_7656.../EOS_...) 或 玩家名 -->
  <AuthorizedUsers>
  </AuthorizedUsers>
</AutoLootBag>

✦ 授权白名单 与 聊天自助开关

本模组支持按用户授权使用，授权玩家还能在游戏内自助开关自己的入包与割肉（两者相互独立），无需管理员介入：

• 白名单授权：在 <AuthorizedUsers> 中添加玩家的 PlatformId（Steam_xxx / EOS_xxx）或玩家名。入包与割肉共用这份名单；名单外玩家保持完全原版体验。

• 独立自助开关：授权玩家在聊天框输入命令即可分别开/关入包与割肉，并收到私聊回复。例如可只关割肉、保留入包。

• 状态持久化：开关状态保存在 PlayerStates.xml，服务器重启后保留；授权用户默认开启。

• 命令可自定义：命令文本由 CmdEnable / CmdDisable / CmdHarvestEnable / CmdHarvestDisable / CmdStatus 配置，可改成任意中英文。命令消息不会广播到公屏。

提示：若想全员可用，把 EnableWhitelist 设为 false，此时所有玩家默认可用，并各自用聊天命令开关。

✦ 安装方法

1. 下载模组压缩包并解压

2. 将整个 AutoLootBag 文件夹放入服务器 Mods 目录

3. 确认文件夹内包含 ModInfo.xml 与 AutoLootBag.dll（两个文件均在模组根目录）

4. 启动专用服务器 — 模组会自动在服务器根目录创建 AutoLootBag_Config/AutoLootBag.xml

5. 按需修改配置文件，保存即自动热加载生效（无需重启）；并把授权玩家填入 <AuthorizedUsers>

6. 查看日志，出现以下信息即表示加载成功：
        [AutoLootBag] 已加载配置: …/AutoLootBag_Config/AutoLootBag.xml
        [AutoLootBag] Harmony 补丁已应用，自动入包已启用

✦ 依赖与限制

• 需要服务器已安装官方 0_TFP_Harmony 模组（3.0 默认自带）

• 仅专用服务器生效 — 客户端、单机、联机主机加载时会自动跳过，不会生效

• 仅处理 小怪（EntityEnemy） 与 动物（EntityAnimal），不影响玩家死亡、商人等其他实体

• 配置文件位于服务器根目录，不在 Mods 文件夹内，便于服主统一管理

✦ 常见问题

✦ 更新日志