WorldEditSelectionVisualizer - WorldEdit选区可视化器

💡概述

WorldEditSelectionVisualizer (WESV) 将著名的 WorldEditCUI 客户端模组功能以 Bukkit 插件的形式实现。这意味着玩家无需在客户端安装任何模组，即可在服务器上直观地看到 WorldEdit 选区与剪贴板的范围。

✨核心特性

• 在 WorldEdit 选区周围生成粒子效果，使玩家能够直观地看到选区范围。
• 无需客户端模组，所有玩家均可使用。
• 支持多种选区类型：立方体、球体、椭球体、圆柱体、多边形和凸面选区。
• 可以显示当前的剪贴板内容（使用 /wesv toggle clipboard 启用）。
• 使用 /wesv toggle 命令可开关选区可视化。
• 可配置为仅当手持 WorldEdit 选区工具（默认木斧）时才显示粒子。
• 可配置粒子效果类型、可见距离等参数。
• 防止玩家选择超大区域时生成过多粒子，影响性能。
• 高度可定制化，以适应不同服务器的性能需求。
• 支持 FastAsyncWorldEdit (FAWE)。
• 兼容自 Minecraft 1.7.10 以来的所有版本。
• 在 1.16 及以上版本中，消息支持 RGB 颜色代码（格式为 &#rrggbb）。
• 支持 PlaceholderAPI，可使用以下占位符：

-   `%wesv_toggled_selection%`

-   `%wesv_toggled_clipboard%`

-   `%wesv_volume_selection%`

-   `%wesv_volume_clipboard%`

• 支持 Folia 服务端，以获得更好的性能。

🔧命令与权限

可用命令

• /wesv toggle – 切换选区可视化显示。
• /wesv toggle clipboard – 切换剪贴板可视化显示。
• /wesv lock – 将剪贴板可视化的原点锁定/解锁到当前位置。
• /wesv lock tp – 当剪贴板可视化锁定启用时，传送到锁定位置。
• /wesv reload – 重新加载插件配置文件。

权限节点

• wesv.toggle – 允许使用切换命令。
• wesv.use – 允许开启可视化器。
• wesv.reload – 允许从 config.yml 文件重新加载插件配置。

🎮配置说明

本插件可能消耗较多服务器资源。如果遇到卡顿，请尝试调整配置。

主要配置项

# 启用后，如果有新版本可用，会在插件启用时在控制台显示更新消息。
check-updates: true

# 当启用时，如果玩家关闭了选区可视化并离开服务器，那么当他再次进入时，选区可视化将保持关闭状态，直到他使用 /wesv toggle 再次激活。
save-toggle: true

# WorldEdit 选区和剪贴板更新的延迟（单位：游戏刻）。这不影响粒子生成和玩家性能，对服务器影响中等。
selection-update-interval: 20

# 启用后，仅当手持 WorldEdit 选区工具（默认木斧）时才显示粒子。你可以在 WorldEdit 配置中更改工具。
need-we-wand: false

# 启用后，将为立方体选区显示顶部和底部的粒子。
cuboid-top-bottom: false

可视化设置

配置分为 selection（选区）和 clipboard（剪贴板）两部分，每部分又包含 primary（主选点/边界）和 secondary（次选点/内部）的详细设置。

• fade-delay：粒子消失前的延迟秒数。设为 0 可取消延迟。
• max-selection-size：可显示的最大选区体积（方块数）。设置过大（> 1000000）可能导致严重卡顿。
• points-distance：每个粒子之间的间隔距离。数值越大，生成的粒子越少。
• lines-gap（仅限 secondary）：立方体或多边形选区上粒子线之间的间隔。数值越大，粒子线越少。设为 0 可移除立方体边线。
• update-interval：粒子生成间隔（游戏刻）。直接影响玩家端的性能。
• view-distance：玩家能看到粒子的最远距离。在 1.7.10 版本中，粒子距离被限制在 16 格以内（Minecraft 限制）。
• particles：粒子类型和数据。

-   `type`：粒子类型。可用类型列表见 [Spigot Javadocs](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html)。

-   `data`：粒子数据。对于类似 `REDSTONE` 的粒子，可以是 `'r,g,b'` 形式的颜色；对于 `BLOCK_CRACK` 或 `ITEM_CRACK`，可以是材质名。

示例配置片段：

visualization:
  selection:
    fade-delay: 0
    max-selection-size: 50000
    primary:
      points-distance: 1.0
      update-interval: 12
      view-distance: 64
      particles:
        type: "FLAME"
        data: ""
    secondary:
      points-distance: 3.0
      lines-gap: 5.0
      update-interval: 18
      view-distance: 32
      particles:
        type: "REDSTONE"
        data: "RED"
  clipboard:
    # ... 结构类似，可设置不同颜色（如 data: "BLUE"）以区分剪贴板

❓反馈与支持

• 请勿在插件发布页的评论区内提交错误报告或功能建议。
• 如需报告错误或提出建议，请在 GitHub Issues 页面或插件讨论区提交。
• 如果有使用问题，可以在插件讨论区或作者的 Discord 服务器 提问。
• 如果你喜欢这个插件，可以在发布页留下评论，或到 GitHub 项目 点个 Star。

⭐作者与鸣谢

WorldEditSelectionVisualizer (WESV) 最初由 rojet601 创建。由于该用户自 2015 年 11 月起不再活跃，且插件存在一些错误，ZathrusWriter 决定发布一个修复了这些错误、兼容 1.8 及以上版本的更新。