VoxelClient
一款适用于 Minecraft 1.21.4 的 Fabric 客户端模组,拥有自定义 HUD、缩放、自由视角、装饰性外观、实用功能以及诸多体验优化。
? 安装
自动安装(推荐)
- 下载安装程序 → Releases
- 运行
voxelclient-installer.exe
- 选择你需要的
mods/ 文件夹(会自动检测)
- 点击 “立即安装”
- 使用 Fabric Launcher 启动 Minecraft
安装程序会自动下载最新版本及所需的 Fabric API。
手动安装
- 安装 Fabric Loader ≥ 0.16
- 下载 Fabric API
- 从 Releases 下载最新的
voxelclient-x.x.x.jar
- 将两个
.jar 文件放入 .minecraft/mods/ 目录
- 启动 Minecraft 1.21.4
✦ 功能
? 自定义 HUD
一个简洁且可定制的游戏内显示界面:
- FPS 计数器
- XYZ 坐标
- 朝向方向
- 护甲显示
- 速度表
- Ping 显示(颜色编码)
- CPS 计数器(左键 / 右键)
- 按键提示叠加层(WASD、空格、左键、右键)
所有 HUD 元素均可自由移动位置。
?️ HUD 编辑器
在 设置 → UI → HUD 编辑器 中,你可以:
- 拖拽所有 HUD 元素
- 永久保存位置
- 单独自定义布局
数据保存至:voxelclient/hud_position.json
所有 UI 界面均具备现代化的 淡入 + 滑动动画(250ms,easeOutCubic)。
? 游戏性功能
? 切换疾跑
保持疾跑状态永久激活(默认按键:R)。
停止时会自动禁用。
?️ 切换潜行
保持潜行状态永久激活(按键可配置)。
? 视角吸附
将你的相机角度吸附到最近的 45° 角:
北、东北、东、东南、南、西南、西、西北
(按键可配置)
? 平滑缩放
带有电影感缓动效果的平滑缩放。
可通过鼠标滚轮微调缩放强度。
默认按键: C
?️ 自由视角
独立于玩家模型旋转相机——非常适合 PvP、探索及制作过场动画。
默认按键: Left Alt
? 航点系统
在游戏内直接保存和管理航点。
- 创建与删除航点
- 屏幕边缘的方向指示器
- 在 设置 → 实用工具 → 航点 中管理
数据保存至:voxelclient/waypoints.json
☠ 死亡航点
死亡时会自动创建一个航点:
?️ 护甲耐久警告
- 显示所有护甲部件的耐久度
- ? 低于 50% 显示橙色
- ? 低于 20% 显示红色
? CPS 计数器
显示每秒点击次数:
基于 1 秒滑动窗口计算。
? Ping 显示
显示当前服务器延迟:
- ? 绿色 < 50ms
- ? 中等
- ? 红色 > 300ms
⌨️ 按键提示叠加层
动态显示以下按键状态:
默认位置:右下角
可在 HUD 编辑器中自由移动。
? 聊天时间戳
自动为每条消息添加时间戳前缀:[HH:mm] 消息内容
? 装饰性外观
通过任意 PNG URL 加载你自己的披风。
披风异步加载,不会延迟游戏启动。
✦ 玩家徽章
每个玩家名称前都会显示一个徽章:
- 灰色
✦ → 普通玩家
- 深红色
✦ → VoxelClient 创作者
可见于:
⚙️ 设置 GUI
一个带有标签导航的现代游戏内菜单。
- 所有功能均可配置
- 基于 JSON 存储
- 包含实用工具、UI 和游戏性功能板块
默认按键: Right Shift
? 自动更新器
启动时自动检查新版本。
- 主菜单显示金色横幅
- 提供下载页面的直接链接
- 按
U 打开更新页面
? Discord Rich Presence
在 Discord 中显示你的当前状态:
服务器 Logo 会自动显示。
⌨️ 键位绑定(默认)
| 功能 |
按键 |
| 打开设置 |
Right Shift |
| 缩放 |
C(按住) |
| 自由视角 |
Left 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 License — 请参阅
VoxelClient
A Fabric client mod for Minecraft 1.21.4 with a custom HUD, zoom, freelook, cosmetics, utility features, and many quality-of-life improvements.
? Installation
Automatic (recommended)
- Download the installer → Releases
- Run
voxelclient-installer.exe
- Select your desired
mods/ folder (detected automatically)
- Click "Install Now"
- Launch Minecraft with the Fabric Launcher
The installer automatically downloads the latest version and the required Fabric API.
Manual
- Install Fabric Loader ≥ 0.16
- Download Fabric API
- Download the latest
voxelclient-x.x.x.jar from Releases
- Place both
.jar files in .minecraft/mods/
- Launch Minecraft 1.21.4
✦ Features
? Custom HUD
A clean, customizable in-game display:
- FPS Counter
- XYZ Coordinates
- Facing Direction
- Armor Display
- Speedometer
- Ping Display (color-coded)
- CPS Counter (LMB / RMB)
- Keystrokes Overlay (WASD, SPACE, LMB, RMB)
All HUD elements can be freely repositioned.
?️ HUD Editor
Under Settings → UI → HUD Editor you can:
- Drag and drop all HUD elements
- Save positions permanently
- Customize the layout individually
Saved to: voxelclient/hud_position.json
All UI screens also feature a modern Fade + Slide Animation (250ms, easeOutCubic).
? Gameplay Features
? Toggle Sprint
Keep sprint permanently active (default: R).
Disables automatically when stopping.
?️ Toggle Sneak
Keep sneak permanently active (key configurable).
? Snap Look
Snaps your camera to the nearest 45° angle:
N, NE, E, SE, S, SW, W, NW
(Key configurable)
? Smooth Zoom
Smooth zoom-in with a cinematic easing effect.
Fine-tune zoom strength with the scroll wheel.
Default key: C
?️ Freelook
Rotate the camera independently of the player model — ideal for PvP, exploration, and cinematics.
Default key: Left Alt
? Waypoint System
Save and manage waypoints directly in-game.
- Create & delete waypoints
- Direction indicator on screen edge
- Manage under Settings → Utility → Waypoints
Saved to: voxelclient/waypoints.json
☠ Death Waypoint
A waypoint is automatically created upon death:
- Saves coordinates + timestamp
- Up to 10 death waypoints stored
?️ Armor Durability Warning
- Shows durability of all armor pieces
- ? Orange below 50%
- ? Red below 20%
? CPS Counter
Shows clicks per second for:
Based on a 1-second sliding window.
? Ping Display
Shows current server ping:
- ? Green < 50ms
- ? Medium
- ? Red > 300ms
⌨️ Keystrokes Overlay
Animated display of:
Default position: bottom right
Freely movable in the HUD Editor.
? Chat Timestamps
Automatically prepends a timestamp to every message: [HH:mm] Message
? Cosmetics
Load your own cape via any PNG URL.
The cape is loaded asynchronously without delaying game startup.
✦ Player Badges
A badge appears before every player name:
- Gray
✦ → regular player
- Dark Red
✦ → VoxelClient Creator
Visible in:
- The tab list
- Above the player's head
⚙️ Settings GUI
A modern in-game menu with tab navigation.
- All features configurable
- JSON-based storage
- Utility, UI, and Gameplay sections
Default key: Right Shift
? Auto-Updater
Automatically checks for a new version on startup.
- Golden banner on the main menu
- Direct link to the download page
- Press
U to open the update page
? Discord Rich Presence
Shows your current status in Discord:
- Main Menu
- Singleplayer
- Multiplayer
- Realms
Server logos are displayed automatically.
⌨️ Keybinds (Default)
| Function |
Key |
| Open Settings |
Right Shift |
| Zoom |
C (hold) |
| Freelook |
Left Alt (hold) |
| Toggle Sprint |
R |
| Open Update Page |
U |
| Snap Look |
configurable |
| Toggle Sneak |
configurable |
All keys can be freely remapped under
Minecraft → Options → Controls → VoxelClient
? Requirements
| What |
Version |
| Minecraft |
1.21.4 |
| Fabric Loader |
≥ 0.16 |
| Fabric API |
1.21.4 |
| Java |
21+ |
?️ Build It Yourself
git clone https://github.com/VoxelLabs-Minecraft/voxelclient.git
cd voxelclient
./gradlew build
# → build/libs/voxelclient-x.x.x.jar
Run the client directly:
./gradlew runClient
? License
MIT License — see
评论 0
登录后参与评分
还没有评论,来抢沙发吧