CGN 选择视图 for WorldEdit

CGN 选择视图 for WorldEdit

使用可配置的香草粒子进行服务端WorldEdit选区可视化。

CGN SelectionView（用于 WorldEdit）

英文

CGN SelectionView 是一款完全服务端运行的 NeoForge 模组，可使用原版 Minecraft 粒子来可视化 WorldEdit 长方体选区。

可视化效果在服务器端计算，并且只发送给相关玩家。无需安装客户端模组。

主要功能

  • 完整呈现 WorldEdit 长方体选区的粒子可视化效果
  • 可配置的外边缘和辅助网格
  • 可在顶部、底部和侧面表面启用可选的辅助网格
  • 四种可选的粒子样式
  • 支持每个玩家启用、禁用和切换命令
  • 原生 NeoForge 权限节点
  • 兼容 LuckPerms 等权限管理器
  • 可重新加载的服务器配置
  • 可配置的渲染距离、更新间隔、粒子限制和网格间距
  • 无需客户端模组

支持版本

  • Minecraft： 26.1.2
  • NeoForge： 26.1.2.76
  • WorldEdit： 7.4.3
  • Java： 25

安装方法

  1. 在 NeoForge 服务器上安装 WorldEdit。
  2. 将 CGN SelectionView JAR 文件放入服务器的 mods 文件夹中。
  3. 重启服务器。
  4. 需要时编辑配置文件：
config/cgn-selection-view-common.toml

命令

/cgnsv

显示当前状态和命令概览。

/cgnsv on

为当前玩家会话启用选区可视化。

/cgnsv off

为当前玩家会话禁用选区可视化。

/cgnsv toggle

为当前玩家会话切换选区可视化的开启或关闭状态。

/cgnsv info

显示已安装的版本和当前激活的核心设置。

/cgnsv reload

无需重启服务器即可重新加载服务器配置。

普通玩家默认可以使用个人命令。

/cgnsv reload 需要操作员等级 2 或专门的重新加载权限。

权限

CGN SelectionView 注册了原生的 NeoForge 权限节点。额外的权限管理器是可选的。

如果没有额外的权限管理器，NeoForge 将使用下表列出的默认值。

cgnselectionview.use

个人命令的主要访问权限。

默认值： true

cgnselectionview.toggle

访问 /cgnsv on、/cgnsv off 和 /cgnsv toggle 的权限。

默认值： true

cgnselectionview.info

访问 /cgnsv 和 /cgnsv info 的权限。

默认值： true

cgnselectionview.reload

在无操作员等级 2 的情况下访问 /cgnsv reload 的权限。

默认值： false

拥有权限等级 2 的操作员始终可以使用 /cgnsv reload。

LuckPerms 示例

权限节点通过 NeoForge 提供。当安装了 LuckPerms 的 NeoForge 权限处理器时，LuckPerms 可以管理这些权限。

/lp group default permission set cgnselectionview.use true
/lp group default permission set cgnselectionview.toggle true
/lp group default permission set cgnselectionview.info true
/lp group admin permission set cgnselectionview.reload true

要禁用某个组的所有个人 CGN SelectionView 命令：

/lp group GROUPNAME permission set cgnselectionview.use false

配置

配置文件会在服务器首次启动时自动生成：

config/cgn-selection-view-common.toml

现有的配置文件会在需要时自动迁移。无关的设置将保留。

粒子样式

以下四个值均可用于 edgeParticleStyle 和 gridParticleStyle：

  • flame
  • orange_dust
  • red_dust
  • end_rod

默认配置：

edgeParticleStyle = "flame"
gridParticleStyle = "orange_dust"

edgeDustScale = 1.25
gridDustScale = 0.8

flame

动画橙色火焰粒子。

orange_dust

橙色粉尘粒子。

red_dust

红色粉尘粒子。

end_rod

明亮的白色末影烛粒子。

缩放值仅影响 orange_dust 和 red_dust。对 flame 或 end_rod 没有效果。

其他配置选项

defaultEnabled

每个新玩家会话的默认可视化状态。

allowPlayerToggle

允许或阻止 /cgnsv on、/cgnsv off 和 /cgnsv toggle。

renderIntervalTicks

以服务器刻为单位的更新间隔。20 刻等于一秒。

renderDistance

向玩家发送粒子的最大距离。

maxEdgeParticles

每次渲染遍历时外边缘的最大粒子预算。

maxGridParticles

每次渲染遍历时辅助网格的最大粒子预算。

minimumEdgeSpacing

外边缘粒子之间的最小间距。

smallSelectionThreshold

使用小选区网格间距的最大选区尺寸。

smallGridSpacing

小选区的网格间距。

mediumSelectionThreshold

使用中选区网格间距的最大选区尺寸。

mediumGridSpacing

中选区的网格间距。

largeGridSpacing

大选区的网格间距。

gridTop

启用或禁用顶部表面的辅助网格。

gridBottom

启用或禁用底部表面的辅助网格。

gridSides

启用或禁用侧面表面的辅助网格。

默认行为

每个新玩家会话默认启用可视化。

玩家的更改有意地仅基于会话，不会永久存储。注销或服务器重启后，将再次应用配置的默认值。

技术默认值：

  • 渲染间隔：10 刻
  • 渲染距离：256 个方块
  • 外边缘粒子预算：每次渲染遍历 280 个粒子
  • 辅助网格粒子预算：每次渲染遍历 300 个粒子
  • 外边缘最小粒子间距：0.65 个方块

当前限制

  • 仅支持 WorldEdit 长方体选区
  • 大型网格内部有限制，以防止生成过多的线条和粒子
  • 服务器上需要安装 WorldEdit

其他 Minecraft 版本

目前支持 Minecraft 26.1.2。

可以请求移植到其他 Minecraft 和 NeoForge 版本。请在请求中注明所需的 Minecraft、NeoForge 和 WorldEdit 版本。

支持与反馈

欢迎通过项目可用的支持或问题渠道提交错误报告、功能请求和移植请求。

许可证

MIT 许可证

声明

这是一个独立的社区项目，与 EngineHub 或 WorldEdit 项目无关联，亦未获得其认可。

图片说明

项目头像是一张基于模组粒子可视化的风格化宣传图片。画廊截图展示了游戏内的实际效果。