体素客户端

VoxelClient

一个为 Minecraft 1.21.4 打造的 Fabric 客户端模组，拥有自定义 HUD、缩放、自由视角、装饰、实用功能以及众多生活品质改进。

---

📥 安装

自动安装（推荐）

1. 下载安装程序 → 发布页面
2. 运行 voxelclient-installer.exe
3. 选择你想要的 mods/ 文件夹（会自动检测）
4. 点击 “立即安装”
5. 使用 Fabric 启动器 启动 Minecraft

安装程序会自动下载最新版本和所需的 Fabric API。

---

手动安装

1. 安装 Fabric Loader ≥ 0.16
2. 下载 Fabric API
3. 从 发布页面 下载最新的 voxelclient-x.x.x.jar
4. 将两个 .jar 文件放入 .minecraft/mods/ 文件夹
5. 启动 Minecraft 1.21.4

---

✦ 功能

📊 自定义 HUD

一个清晰、可自定义的游戏内显示：

• FPS 计数器
• XYZ 坐标
• 朝向
• 护甲显示
• 速度计
• 延迟显示（颜色标识）
• CPS 计数器（左键 / 右键）
• 按键显示（WASD、空格、左键、右键）

所有 HUD 元素均可自由移动位置。

---

🖱️ HUD 编辑器

在 设置 → 界面 → HUD 编辑器 下，你可以：

• 拖拽所有 HUD 元素
• 永久保存位置
• 单独自定义布局

保存至：voxelclient/hud_position.json

所有界面屏幕还拥有现代的 淡入淡出 + 滑动动画（250ms，easeOutCubic）。

---

🎮 游戏功能

🏃 保持疾跑

保持疾跑持续激活（默认：R）。
停止移动时自动关闭。

🕵️ 保持潜行

保持潜行持续激活（按键可配置）。

🧭 快速对齐视角

将你的视角对齐到最近的 45° 角度：
北、东北、东、东南、南、西南、西、西北
（按键可配置）

---

🔍 平滑缩放

具有电影级缓动效果的平滑缩放。
使用滚轮微调缩放强度。

默认按键： C

---

👁️ 自由视角

可以独立于玩家模型旋转摄像机——非常适合 PvP、探索和过场动画。

默认按键： 左 Alt

---

📍 路径点系统

直接在游戏中保存和管理路径点。

• 创建和删除路径点
• 屏幕边缘有方向指示器
• 在 设置 → 实用功能 → 路径点 下管理

保存至：voxelclient/waypoints.json

☠ 死亡路径点

死亡时会自动创建一个路径点：

• 保存坐标 + 时间戳
• 最多存储 10 个死亡路径点

---

🛡️ 护甲耐久度警告

• 显示所有护甲部件的耐久度
• 🟠 低于 50% 显示橙色
• 🔴 低于 20% 显示红色

---

📊 CPS 计数器

显示每秒点击次数：

• 左键
• 右键

基于 1 秒滑动窗口。

---

🌐 延迟显示

显示当前服务器延迟：

• 🟢 绿色 < 50ms
• 🟡 中等
• 🔴 红色 > 300ms

---

⌨️ 按键显示

动画显示：

• W、A、S、D
• 空格
• 左键
• 右键

默认位置：右下角
可在 HUD 编辑器中自由移动。

---

💬 聊天时间戳

自动在每条消息前添加时间戳：[HH:mm] 消息

---

🎭 装饰

通过任意 PNG 链接加载你自己的披风。
披风以异步方式加载，不会延迟游戏启动。

---

✦ 玩家徽章

每个玩家名字前会显示一个徽章：

• 灰色 ✦ → 普通玩家
• 深红色 ✦ → VoxelClient 创建者

显示在：

• Tab 列表
• 玩家头顶

---

⚙️ 设置界面

一个带有标签导航的现代游戏内菜单。

• 所有功能均可配置
• 基于 JSON 的存储
• 实用功能、界面和游戏功能分类

默认按键： 右 Shift

---

🔔 自动更新器

启动时自动检查新版本。

• 主菜单上的金色横幅
• 直接链接到下载页面
• 按 U 打开更新页面

---

🎮 Discord 状态显示

在 Discord 中显示你当前的状态：

• 主菜单
• 单人游戏
• 多人游戏
• 领域

服务器图标会自动显示。

---

⌨️ 按键绑定（默认）

功能	按键
打开设置	右 Shift
缩放	C（按住）
自由视角	左 Alt（按住）
保持疾跑	R
打开更新页面	U
快速对齐视角	可配置
保持潜行	可配置

所有按键均可在
Minecraft → 选项 → 控制 → VoxelClient 下自由重新映射

---

📋 要求

项目	版本
Minecraft	1.21.4
Fabric Loader	≥ 0.16
Fabric API	1.21.4
Java	21+

---

🏗️ 自行构建

git clone https://github.com/VoxelLabs-Minecraft/voxelclient.git
cd voxelclient
./gradlew build
# → build/libs/voxelclient-x.x.x.jar

直接运行客户端：

./gradlew runClient

---

📄 许可证

MIT 许可证 — 参见
https://github.com/VoxelLabs-Minecraft/voxelclient/blob/main/LICENSE.txt

---