WorldEditSUI - 选区可视化粒子

💡简介

WorldEditSUI 是一款服务器端插件，它通过华丽的粒子效果来可视化你的 WorldEdit 选区。它模仿了流行的 WorldEditCUI 客户端模组的功能，但无需玩家安装任何模组。本插件注重简洁性、性能和低内存占用，支持多种选区形状，并可自定义粒子效果。

🎮功能特性

• 可视化选区：为你当前的 WorldEdit 选区显示粒子轮廓。
• 支持多种选区类型：
• 立方体 (Cuboid)
• 球体/椭球体 (Sphere/Ellipsoid)
• 圆柱体 (Cylinder)
• 2D 多边形 (2D Polygonal)
• 高级网格：可为大型选区启用更详细的内部网格显示。
• 剪贴板可视化：显示通过 //copy 命令复制的选区。
• WorldGuard 区域显示：使用命令显示指定的 WorldGuard 区域。
• 高度可配置：可自定义粒子类型、数量、发送间隔、视图距离等。

选区预览图

• CUBOID SELECTION (启用高级网格)
• SPHERE/ELLIPSOID SELECTION
• CYLINDER SELECTION
• 2D POLY SELECTION

🔧命令与权限

所有命令均以 /wesui 为基础。

• /wesui
• 权限：wesui.command
• /wesui reload
• 权限：wesui.command.reload
• /wesui toggle
• 权限：wesui.command.toggle
• /wesui toggleclipboard
• 权限：wesui.command.toggleclipboard
• /wesui showregion <region>
• 权限：wesui.command.showregion
• 额外权限：wesui.maxselectionsize.bypass
• 用于绕过配置中设置的选区大小限制。

✨安装与兼容性

版本要求

• 本插件需要 WorldEdit 或其分支运行。
• 请确保 WorldEdit 版本与你的服务器核心版本匹配（例如，WorldEdit 6.x 对应 MC 1.8-1.12，WorldEdit 7.x 对应 MC 1.13+）。

支持的 WorldEdit 分支

• WorldEdit
• AsyncWorldEdit 和 AsyncWorldEditPremium
• FastAsyncWorldEdit (注意：FAWE 特有的选区类型暂未实现)

重要提示

• 若要在 1.8.x 服务器上运行，请从 GitHub Releases 页面下载对应的旧版插件。
• 请根据你的 Spigot 版本下载正确的插件版本。

⭐配置详解

以下是 config.yml 的主要配置项说明。

核心设置

• cache-calculated-positions: true
• 启用后，粒子的位置将每选区计算一次并缓存，大幅降低CPU使用率。如果遇到并发错误，请禁用此项。
• particle: FLAME
• 用于当前选区的粒子类型。所有可用粒子列表请查阅 Spigot Particle API。
• clipboard-particle: VILLAGER_HAPPY
• 用于剪贴板可视化的粒子类型。
• wg-region-particle: VILLAGER_HAPPY
• 用于 WorldGuard 区域可视化的粒子类型。
• particles-per-block: 3
• 每方块长度显示的粒子数量。推荐值 2-4，范围 1-5。
• particle-send-interval: 12
• 发送粒子效果的间隔时间（单位：游戏刻）。20刻=1秒。范围 5-200。
• max-ping: 150
• 玩家最大延迟（ping），超过此值将不向其发送粒子（仅 Paper 服务器有效）。设为 -1 禁用。
• max-selection-size-to-display: 10_000_000
• 允许显示的最大选区方块数（默认约 250150250），以防止服务器卡顿。
• enable-max-selection-bypass-perm: true
• 启用后，拥有 wesui.maxselectionsize.bypass 权限的玩家可无视上述大小限制。

高级网格设置

• advanced-grid
• enabled: false - 是否启用选区高级网格显示。
• particles-per-block: 2 - 网格的粒子密度，推荐值 2-3。
• advanced-clipboard-grid
• 剪贴板视图的网格设置，选项同上。
• advanced-wg-region-grid
• WorldGuard 区域视图的网格设置，选项同上。

其他设置

• particle-expiry
• enabled: false - 是否启用粒子过期停止发送。
• expires-after-seconds: 180 - 选区无变化多少秒后停止发送粒子。
• expire-message: true - 粒子过期时是否通知玩家。
• permission: "none"
• 设为 "none" 则所有玩家可见。否则，只有拥有指定权限的玩家才能看到自己的选区粒子。
• send-particles-to-all
• enabled: false - 是否将粒子发送给所有玩家（而不仅是选区持有者），适合团队建造。
• view-others-particles-perm: "none" - 查看他人选区粒子所需的权限。设为 "none" 则所有人可见。
• others-particle: FLAME - 他人选区的粒子类型。
• others-clipboard-particle: VILLAGER_HAPPY - 他人剪贴板的粒子类型。
• show-selection-by-default: true
• 是否默认显示选区粒子。若为 false，玩家需先使用 /wesui toggle。
• show-clipboard-by-default: false
• 是否默认显示剪贴板粒子。若为 false，玩家需先使用 /wesui toggleclipboard。
• persistent-toggles: false
• 是否将玩家的显示/隐藏状态持久化保存，使其在退出游戏和服务器重启后依然有效。
• particle-viewdistance: 99
• 粒子可见距离（单位：方块），范围 1-500。此设置不影响服务器性能。
• update-checks: true
• 是否检查插件更新，推荐启用。

❓使用特殊粒子

部分粒子（如 REDSTONE、FALLING_DUST、BLOCK_DUST、BLOCK_CRACK、ITEM_CRACK）需要额外的数据（如颜色、方块材质、速度、偏移量等）。你需要在配置文件中对应的 -particle-data 部分进行设置。

示例 1：REDSTONE 粒子（1.13+）

particle: REDSTONE
particle-data:
  r: 0    # 红色 (0-255)
  g: 0    # 绿色
  b: 0    # 蓝色
  size: 0.9  # 相对大小
  radius: 50 # 半径
  offX: 0.2  # X轴偏移
  offY: 0.1  # Y轴偏移
  offZ: 1    # Z轴偏移
  # speed: 0.5 # 速度（0-1，部分粒子不支持）

示例 2：FALLING_DUST / BLOCK_DUST / BLOCK_CRACK 粒子

clipboard-particle: FALLING_DUST
clipboard-particle-data:
  material: DIAMOND_BLOCK # 方块材质

示例 3：ITEM_CRACK 粒子

send-particles-to-all:
  others-particle: ITEM_CRACK
  others-particle-data:
    material: STICK # 物品材质

重要版本说明（1.12 及以下）

对于 BLOCK_CRACK、BLOCK_DUST 或 FALLING_DUST 粒子，在 1.12 及以下版本中，除了材质名，可能还需要指定 data（耐久值/附加值）。

例如，棕色羊毛在 1.13+ 是 YELLOW_WOOL，但在 1.12- 是 WOOL 且 data 为 4：

particle: FALLING_DUST
particle-data:
  material: WOOL
  data: 4

🔧支持与反馈

• 发现漏洞或有新功能建议？请在插件讨论区留言。
• 你也可以加入 WorldEditSUI-Support Discord 服务器，在那里通常能获得更快的答复和帮助。

已知注意事项/待改进项

• 支持默认的 WorldEdit 选区类型（凸多边形除外），但 FastAsyncWorldEdit 的特有选区暂未实现。
• 高级网格在网格尺寸较大时性能较轻量，但可能不对称。
• 视觉效果不如 WorldEditCUI Mod 丰富，但优势在于无需客户端安装模组。

---

如果觉得这个插件好用，请在发布页留下评分或评论，这将是对开发者极大的鼓励！