ChunkVisualizer
ChunkVisualizer 是一款轻量且强大的 Minecraft 插件,允许玩家在不使用调试菜单(F3 + G)的情况下实时查看区块边界。
它是 Towny 或其他领地系统的完美伴侣,因为它能让玩家清晰地看到特定的区块边缘,而不会因全局网格而使屏幕显得杂乱无章。
? 演示
1. 动态区块追踪
可视化效果会在玩家跨越区块边界时自动跟随玩家,确保无缝的领土控制。它支持两种高亮模式(角块和墙壁),并在传送和重生后进行刷新。
2. 完整的 GUI 自定义
使用 /cv settings 命令打开直观界面,允许你:
- 切换可见性,只需单击即可(在“方块”模式下为
Shift + 点击)。
- 在角块和区块墙壁之间切换高亮模式。
- 调整边界方块相对于你当前位置的高度。
- 更改用于可视化的材质:在菜单打开时点击背包中的任何方块。
- 更改角块的轮廓颜色(红色、橙色、黄色、绿色、青色、蓝色、紫色或白色)。
- 自定义墙壁(需要权限
chunkvisualizer.use.display):
- 选择墙壁颜色,
- 调整不透明度,范围从 5% 到 100%,
- 切换发光效果。
- 右键点击材质槽可将方块材质重置为服务器默认值。
所有设置均按玩家保存,并在下次加入时恢复。
3. 非侵入式“幽灵”方块
基于现代数据包和 Display Entities 构建,这些方块没有碰撞体积。它们不会干扰游戏进程:你可以直接穿过可视化效果挖掘矿石或与物品互动。所有内容仅在客户端显示,且仅对启用它的玩家可见。
4. 两种高亮模式
- 角块:位于区块四个角的幽灵方块,带有彩色轮廓。高度、材质和轮廓颜色均可配置。
- 墙壁:沿区块边缘的半透明彩色墙壁(
text_display),具有可调节的不透明度和可选的发光效果。需要 chunkvisualizer.use.display 权限。
? 命令与权限
| 命令 |
描述 |
权限 |
/cv |
主命令(帮助) |
— |
/cv settings |
打开自定义 GUI |
chunkvisualizer.settings |
| — |
在 GUI 中使用墙壁高亮模式 |
chunkvisualizer.use.display |
/cv reload |
重新加载 config.yml 和 messages.yml |
chunkvisualizer.admin |
请授予你的玩家 chunkvisualizer.settings 权限(例如通过 LuckPerms),以便他们能够打开菜单。如果没有 chunkvisualizer.use.display 权限,玩家将始终显示角块模式。
? 配置
新玩家的默认设置在 plugins/ChunkVisualizer/config.yml 中设置:
| 选项 |
描述 |
default-enabled |
首次加入时开启/关闭可视化 |
default-mode |
BLOCKS(方块)或 WALLS(墙壁) |
default-height |
角块相对于玩家的高度 |
default-material |
角块的材质(任何有效的 Bukkit Material) |
default-block-glow-color |
角块的轮廓颜色 |
default-wall-color |
墙壁颜色(RED、ORANGE、YELLOW、GREEN、CYAN、BLUE、PURPLE、WHITE) |
default-wall-alpha |
墙壁不透明度百分比(5-100) |
default-wall-glow |
墙壁发光效果的开启/关闭 |
对这些默认值的更改仅影响首次加入的玩家。现有玩家保留其自己的已保存设置。
所有文本位于 messages.yml 中。使用 /cv reload 应用配置和消息更改。
玩家设置存储在 SQLite 数据库 (plugins/ChunkVisualizer/data.db) 中,并与玩家名称绑定。
? 要求
- Paper 1.21+
- Java 21
- 无外部依赖:PacketEvents 已打包在 jar 文件中。
⚙️ 安装
- 从 Releases 页面下载最新的
.jar 文件。
- 将其放入服务器的
plugins 文件夹中。
- 重启服务器或使用插件管理器加载它。
- 给予你的玩家
chunkvisualizer.settings 权限。
ChunkVisualizer
ChunkVisualizer is a lightweight and powerful Minecraft plugin that allows players to visualize chunk boundaries in real-time without using the debug menu (F3 + G).
It is a perfect companion for Towny or other land-claim systems, as it allows players to see specific chunk edges clearly without cluttering the screen with a global grid.
? Demonstration
1. Dynamic Chunk Tracking
The visualization automatically follows the player when crossing chunk borders, ensuring seamless territory control. It works with both highlight modes (corner blocks and walls) and is refreshed after teleports and respawns.
2. Full GUI Customization
Use the /cv settings command to open an intuitive interface that allows you to:
- Toggle visibility with a single click (
Shift + Click in Blocks mode).
- Switch highlight mode between corner blocks and chunk walls.
- Adjust height of the boundary blocks relative to your current position.
- Change materials used for the visualization: click any block in your inventory while the menu is open.
- Change outline color of the corner blocks (red, orange, yellow, green, cyan, blue, purple or white).
- Customize walls (requires
chunkvisualizer.use.display):
- pick the wall color,
- adjust opacity from 5% to 100%,
- toggle the glow effect.
- Reset the block material to the server default with a right click on the material slot.
All settings are saved per player and restored on the next join.
3. Non-Intrusive "Ghost" Blocks
Built using modern packets and Display Entities, these blocks have no collision. They do not interfere with gameplay: you can mine ores or interact with items directly through the visualization. Everything is client-side and visible only to the player who enabled it.
4. Two Highlight Modes
- Corner blocks: ghost blocks at the four chunk corners with a colored outline. Height, material and outline color are configurable.
- Walls: semi-transparent colored walls along the chunk edges (
text_display), with adjustable opacity and an optional glow effect. Requires the chunkvisualizer.use.display permission.
? Commands & Permissions
| Command |
Description |
Permission |
/cv |
Main command (help) |
— |
/cv settings |
Open the customization GUI |
chunkvisualizer.settings |
| — |
Use the Walls highlight mode in the GUI |
chunkvisualizer.use.display |
/cv reload |
Reload config.yml and messages.yml |
chunkvisualizer.admin |
Grant chunkvisualizer.settings to your players (e.g. via LuckPerms) so they can open the menu. Without chunkvisualizer.use.display, players are always shown the corner blocks mode.
? Configuration
Defaults for new players are set in plugins/ChunkVisualizer/config.yml:
| Option |
Description |
default-enabled |
Visualization on/off on first join |
default-mode |
BLOCKS or WALLS |
default-height |
Height of the corner blocks relative to the player |
default-material |
Material of the corner blocks (any valid Bukkit Material) |
default-block-glow-color |
Outline color of the corner blocks |
default-wall-color |
Wall color (RED, ORANGE, YELLOW, GREEN, CYAN, BLUE, PURPLE, WHITE) |
default-wall-alpha |
Wall opacity in percent (5-100) |
default-wall-glow |
Wall glow on/off |
Changes to these defaults affect only players who join for the first time. Existing players keep their own saved settings.
All texts live in messages.yml. Use /cv reload to apply config and message changes.
Player settings are stored in SQLite (plugins/ChunkVisualizer/data.db) and are tied to the player name.
? Requirements
- Paper 1.21+
- Java 21
- No external dependencies: PacketEvents is bundled inside the jar.
⚙️ Installation
- Download the latest
.jar file from the Releases page.
- Place it into your server's
plugins folder.
- Restart the server or load it using a plugin manager.
- Give your players the
chunkvisualizer.settings permission.
评论 0
登录后参与评分
还没有评论,来抢沙发吧