TACZ 战地拾取

一、模组简介 / Introduction

TACZ Field Pickup 是一个为 TaCZ（Timeless and Classics: Zero）枪械模组打造的沉浸式捡枪体验模组。

在原版 Minecraft 和原版 TaCZ 中，捡枪就是"走过掉落物自动拾取"，毫无代入感。

本模组改变了这一切：

• 靠近枪械不再自动拾取。
• 当你把准心对准地上的枪械时，会弹出一个精致的捡枪 UI，展示枪械的名称、缩略图和捡枪提示。
• 按下按键才能真正把枪捡起来——就像 FPS 游戏里一样：瞄准、确认、拾取。

它让"捡枪"从一次无意识的碰撞，变成一个有仪式感、可操控的交互过程，大幅提升生存与 PVP 场景下的沉浸体验。

---

二、功能特性 / Features

🎯 沉浸式捡枪 UI / Immersive Pickup UI

准星对准掉落枪械时，会显示三个要素：

1. 枪械名称，放大居中显示。
2. 枪械缩略图，使用 TaCZ 枪械 HUD 贴图。
3. 捡枪提示，按键按钮加文案。

按住按键时会显示长按进度条（金色 → 绿色），反馈清晰。

🔫 全新的捡枪逻辑 / New Pickup Logic

按 F 键捡枪：自动放入快捷栏，优先当前选中格，其次第一个空格。

快捷栏已满时，捡枪会直接替换当前手持枪械——旧枪会朝你准星指向的位置抛出，新枪进入手中。

长按 F 键可把枪械直接放入背包，适合快速搜刮。

⚖️ 快捷栏枪械数量限制 / Hotbar Gun Limit

可设置快捷栏枪械上限（1-9，第 10 档为无限制）。

超出上限时，多余枪械会自动向准星方向扔出，并弹出"枪械数量超过快捷栏上限"提示。

扔枪顺序从右往左，保留最左侧的枪械。

💀 玩家缴获（死亡掉落）/ Player Capture (Death Drops)

玩家死亡时，快捷栏中的所有枪械会在尸体位置原地散落（扇形错开），方便逐一拾取。

该功能独立生效：即使服务器开启了"死亡不掉落"（keepInventory），枪械依然会掉落。

只影响快捷栏枪械；非枪械物品与背包物品不受影响。

非常适合 PVP 服务器：击杀玩家即可"缴获"对方的武器。

🎨 可视化配置界面 / Visual Config Editor

通过模组列表的 Config 按钮打开，或绑定"打开配置界面"按键。

可以调整快捷栏枪械上限、长按入背包开关、玩家缴获开关与配件缩略图开关。

UI 编辑器支持对名称、缩略图、按键提示、进度条四个元素独立调整位置、大小与背景样式。

每个元素支持九点对齐：左上、上中、右上、左中、正中、右中、左下、下中、右下。

专注模式（按 H）会隐藏全部按钮，全屏精细调节，可用方向键微调位置、数字键 1-9 快速对齐。

🌍 多语言 / Multi-language

内置简体中文与英文，游戏内自动切换。

---

三、操作指南 / Controls

操作 Action	按键 Key (default, rebindable)
捡起枪械（放入快捷栏）Pick up a gun (into hotbar)	F（长按 F 放入背包 / hold F for backpack）
打开配置界面 Open config screen	模组列表 → Config，或自行绑定按键 / Mods list → Config, or bind your own key

---

四、安装要求 / Requirements

需要 Minecraft 1.20.1 与 Forge 47.x。

需要安装 TaCZ（Timeless and Classics: Zero）1.0.3 及以上。

将本模组的 .jar 文件放入 mods 文件夹，启动游戏即可。

客户端与服务端都需要安装本模组；单机自动满足。

---

五、常见问题 / FAQ

问：为什么靠近枪械不会自动捡起来了？

答：这是本模组的核心设计——捡枪改为手动瞄准拾取。按 F 键即可捡起。

问：捡枪时手里原来的枪去哪了？

答：快捷栏已满时会替换手持枪械，旧枪会朝你准心所指的方向抛出，可以再捡回。

问：死亡不掉落开启后，为什么枪还是掉了？

答：这是"玩家缴获"功能，独立于原版死亡掉落规则，可在配置界面关闭。

问：UI 位置或大小不满意怎么办？

答：进入配置界面的"编辑UI位置大小"，用可视化编辑器自由调整，支持九点对齐与背景样式。