SimpleEdit

插件

· 作者 LootingVI

World-Edit 的现代替代方案

0 本站下载 0 关注 更新于 3 个月前

最新 0.0.3 · 26.1.2 · Paper / Spigot

一键开服(送7天)

SimpleEdit

一款面向 Minecraft 26.1 的现代化 WorldEdit 风格 Paper 插件

? 概述

SimpleEdit 是一款强大且用户友好的世界编辑插件,专为 Paper 服务器设计。它为建造者和服务器管理员提供了高效编辑 Minecraft 世界所需的所有核心功能。该插件将经过验证的 WorldEdit 概念与现代优化实现相结合。

⚡ 主要功能

? 选择系统

  • 木斧工具:通过左键和右键点击进行经典的选择操作
  • 位置命令:使用 /pos1 和 /pos2 进行精确坐标输入
  • 视觉反馈:清晰的聊天消息显示已选区域
  • 灵活选择:支持任意大小的立方体区域
  • 选择扩展:使用 /expand 和 /contract 动态调整大小
  • 选择辅助:使用 /size、/count、/center、/info 获取信息和导航
  • 信息命令:/info 显示详细分析(体积、尺寸、位置、方块分布)

? 方块操作

  • /set <block>:用指定的方块类型填充整个选择区域
  • /replace <from> <to>:将选择区域内的特定方块替换为其他方块
  • /outline <block>:在选择区域周围创建框架
  • /walls <block>:填充选择区域的墙壁
  • /hollow:移除选择区域的内部(空心结构)
  • 材质支持:支持所有 Minecraft 26.1 方块和材质
  • 智能处理:针对大面积的高效批量操作

? 画笔系统

  • 球形画笔:球形画笔功能
  • 平滑画笔:地形平滑处理
  • 替换画笔:在画笔区域内替换方块
  • 蓝图画笔:放置保存的结构
  • 多工具支持:不同画笔对应不同工具
  • 可配置大小:可调整的画笔半径

? 几何形状

  • /sphere <radius> <pattern>:创建完美球体
  • /cylinder <radius> <height> <pattern>:生成圆柱体
  • /pyramid <size> <pattern>:创建各种大小的金字塔
  • /dome <radius> <pattern>:创建穹顶(半球)
  • /cone <radius> <height> <pattern>:创建圆锥体
  • /line <pattern>:两点之间的直线
  • 空心变体:所有形状均提供空心版本

? 地形生成

  • /generate cave:程序化洞穴系统
  • /generate mountain <pattern>:自然山脉形成
  • /generate forest:自动森林植被生成
  • /generate islands <pattern>:浮空岛屿
  • /generate maze <pattern>:迷宫生成
  • /generate temple <pattern>:神庙结构
  • /generate ruins <pattern>:废墟建筑
  • /generate ore_veins <pattern>:具有真实分布的矿脉

? 高级操作

  • /smooth [iterations]:可配置迭代次数的地形平滑
  • /naturalize <top> <filler>:自然地形分层
  • /deform <expression>:数学地形变形
  • /fix <fluid>:修复流体源
  • /flora <type> <density>:自动生成植物和树木
  • /erode <intensity>:自然侵蚀模拟
  • /gradient <type> <pattern1> <pattern2>:颜色渐变和过渡

?️ 建造者实用工具

  • /drain [water|lava]:移除选择区域内的水或岩浆
  • /overlay <block>:在选择区域内的表面上放置方块
  • /dome <radius> <pattern>:创建穹顶(半球)
  • /cone <radius> <height> <pattern>:创建圆锥体
  • /green [density]:在草方块上放置植被(草、花、树)
  • /snow [thickness]:添加雪层
  • /thaw:移除选择区域内的雪和冰
  • /extinguish:熄灭选择区域内的所有火焰
  • /butcher [radius] [type]:移除选择区域内的实体(生物)
  • /fillfluid <water|lava>:用水或岩浆填充选择区域
  • /info:显示关于选择区域的详细信息(体积、尺寸、方块分布)

? 复制与粘贴系统

  • /copy:将选择区域复制到剪贴板
  • /cut:剪切并复制选择区域
  • /paste:粘贴剪贴板内容
  • /rotate <degrees>:旋转剪贴板内容
  • /flip <axis>:镜像剪贴板内容
  • /move <dx> <dy> <dz>:移动选择区域

? 历史记录管理

  • 独立历史:每位玩家拥有自己的撤销/重做历史
  • /undo:撤销上一个操作
  • /redo:恢复已撤销的操作
  • 多级支持:支持多次连续的撤销/重做操作
  • 确定性恢复:生成操作将被精确还原
  • 历史 GUI:过去操作的可视化概览

? 掩码系统

  • /mask <pattern>:激活选择性编辑
  • 基于方块的掩码:仅编辑特定方块
  • 基于模式的掩码:复杂的过滤选项
  • 反向掩码:反转选择范围

? 蓝图与结构文件

  • /schem save <name>:将当前选择区域保存为结构文件
  • /schem load <name>:加载并放置结构文件
  • /schem list:显示所有可用的结构文件
  • /schem preview <name>:在放置前实时预览
  • WorldEdit 兼容性:支持 .schem 文件
  • 自定义 .se.json 格式:优化的存储方式

? 应用场景

对于建造者

  • 地形设计:创建包含山脉、洞穴和森林的复杂景观
  • 结构建造:快速创建建筑物、墙壁和建筑元素
  • 细节工作:使用画笔精确放置单个方块
  • 创作自由:尝试图案、颜色渐变和数学形状
  • 错误修正:完整的撤销/重做系统,确保无风险操作

面向服务器管理员

  • 世界维护:修复恶意破坏造成的损害并恢复地形
  • 活动筹备:快速创建竞技场、出生点和活动区域
  • 性能优化:平滑和优化地形以提升 TPS(每秒刻数)
  • 备份与恢复:安全地修改世界,支持完全回滚
  • 质量保证:自动化测试与世界变更验证

面向地图制作者

  • 程序化生成:逼真的洞穴系统、矿脉和地貌
  • 结构放置:精确放置建筑物和地标
  • 生物群系管理:调整天气、温度和植被
  • 大规模编辑:通过异步处理高效编辑巨大区域
  • 版本控制:确定性操作以支持可复现的构建

? 技术细节

  • 版本:1.0-SNAPSHOT
  • Minecraft 版本:26.1
  • 服务端软件:Paper(推荐)
  • Java 版本:Java 25
  • 性能:针对大型选择和批量操作进行了优化
  • 异步处理:并行处理,支持配置限制(8000 方块/刻)
  • 内存管理:自动垃圾回收和资源清理
  • 线程安全:完全线程安全的操作,适用于多线程环境
  • 历史记录系统:基于种子的确定性撤销/重做功能

⚙️ 配置

该插件在 config.yml 中提供广泛的配置选项:

# 性能设置
edits-per-tick: 8000  # 每刻处理的方块数(默认值:8000)
max-history: 2000     # 每个玩家的最大撤销步数

# 性能设置
performance:
  max-operation-size: 50000000  # 单次操作的最大方块数(5000万)
  chunk-batch-size: 8           # 每刻处理的区块数
  block-batch-size: 1000        # 每批处理的方块数

# 结构图预览设置
preview:
  max-blocks: 20000          # 预览允许的最大非空气方块数
  max-distance: 200.0        # 距离玩家的最大范围
  batch-size: 50             # 每批处理的方块数
  auto-cleanup: true         # 自动清理预览效果
  glow-effect: true         # 使预览方块发光
  transparency: 0.98         # 方块透明度系数

# 功能开关
features:
  enable-selection-outline: true    # 显示可视的选择轮廓
  enable-operation-progress: true   # 显示进度更新
  enable-sound-feedback: true       # 为操作播放音效
  enable-container-copy: true      # 复制容器内容
  enable-performance-monitoring: false  # 追踪操作指标

# 限制与安全
limits:
  max-selection-size: 50000000     # 选择范围内的最大方块数(5000万)
  max-operation-time: 300          # 最大操作时间(5分钟)
  warn-on-large-operations: true   # 在执行大型操作前警告玩家
  large-operation-threshold: 1000000  # 警告阈值(100万方块)

? 高级功能与 API

插件 API

SimpleEdit 提供了丰富的 Java API 供其他插件使用:

// 访问服务
SelectionManager selections = SimpleEdit.getInstance().getSelections();
HistoryManager history = SimpleEdit.getInstance().getHistory();

// 创建自定义操作
EditOperation customOp = new CustomOperation(region, pattern);
operations.start(playerId, customOp);

图案系统

可扩展的图案 API 用于自定义方块生成:

public class CustomPattern implements Pattern {
    @Override
    public BlockData dataFor(int x, int y, int z, World world) {
        // 在此处编写自定义逻辑
        return Material.DIAMOND_BLOCK.createBlockData();
    }
}

事件系统

完全集成 Bukkit 的事件 API 以确保最大兼容性。

? 安全性与性能

  • 防止内存泄漏:自动清理实体引用
  • 线程安全集合:在所有多线程场景中使用 ConcurrentHashMap
  • 输入验证:对用户输入进行全面验证
  • 异常处理:具备强大的错误处理和日志记录
  • 性能监控:详细的 TPS 影响测量
  • 资源限制:所有操作均支持可配置的限制

? 国际化

该插件支持多种语言,并提供可配置的语言文件。目前可用:

  • 德语(默认)
  • 英语(计划中)
  • 其他语言可按需提供

? 监控与统计

为服务器管理员内置了以下监控功能:

  • 性能监控:可选的操作指标追踪(类型、方块数、持续时间、B/s)
  • 性能指标:每次操作的 TPS 影响
  • 使用统计:最常用的命令和操作
  • 错误追踪:自动错误报告
  • 玩家活动:建筑活动的概览
  • Info 命令:详细分析选择范围及方块分布情况

? 安装与使用

快速入门指南

  1. 下载插件:从发布页面下载最新的 .jar 文件
  2. 服务器安装:将插件放入服务器的 plugins/ 文件夹中
  3. 重启服务器:使用 /restart 命令或完全重启 Paper 服务器
  4. 开始使用:
    # 手持木斧(或使用 /wand 自动授予)
    # 左键点击:设置位置 1
    # 右键点击:设置位置 2
    # /set stone  # 用石头填充选择区域
    

基本命令

# 选择工具
/wand              # 获取木斧
/pos1              # 将当前位置设为位置 1
/pos2              # 将当前位置设为位置 2
/size              # 显示选择范围大小

# 基本操作
/set <block>       # 填充选择区域
/replace <from> <to> # 替换方块
/copy              # 复制选择区域
/paste             # 粘贴
/undo              # 撤销
/redo              # 重做
/info              # 显示选择区域信息

建筑工具

/drain [water|lava] # 移除水/岩浆 /overlay <block> # 在表面放置方块 /dome <radius> <block> # 创建穹顶 /cone <radius> <height> <block> # 创建圆锥体 /green [density] # 放置植被 /snow [thickness] # 添加积雪 /thaw # 移除积雪/冰 /extinguish # 灭火 /butcher [radius] # 移除实体 /fillfluid <water|lava> # 填充流体

高级操作

/generate sphere stone # 生成球体 /generate cave # 创建洞穴 /generate mountain natural:stone # 建造山脉 /brush sphere stone 5 # 设置球体画笔 /smooth # 平滑地形 /naturalize # 自然分层


### GUI 菜单

SimpleEdit 提供直观的图形化菜单以执行复杂操作:

- **`/simpleedit`**: 包含所有功能的主菜单
- **画笔配置**:用于画笔设置的 `/brush` 菜单
- **图案选择**:自动预览可用图案
- **历史记录概览**:最近操作的可视化展示

## ?️ 故障排除

### 常见问题

**问题**:“选择未完整”

解决方案:确保已设置两个位置(Pos1 和 Pos2) 使用 /wand 获取一把斧头,或使用 /pos1 和 /pos2 手动输入坐标


**问题**:“操作已在运行中”

解决方案:等待当前操作完成,或使用 /cancel


**问题**:大型操作时出现性能问题

解决方案:在 config.yml 中减少 edits-per-tick 的值,或使用更小的选择区域


### 调试命令

```bash
/progress         # 显示正在运行的操作的进度
/cancel           # 取消当前操作
/help             # 显示所有可用命令

? 贡献与支持

开发

SimpleEdit 是开源的,可在 GitHub 上获取。欢迎贡献!

支持

  • GitHub Issues:用于提交错误报告和功能请求
  • Discord:社区支持与讨论
  • 文档:提供完整的 API 文档

许可证

SimpleEdit 采用 MIT 许可证,可自由使用和修改。

? 为什么选择 SimpleEdit?

  • ? 高性能:优化的异步处理,支持数百万个方块(高达 5000 万块)
  • ? 可靠性:完整的撤销/重做系统,具备确定性恢复能力
  • ? 用户友好:直观的命令和图形化菜单(/simpleedit)
  • ? 可扩展:为开发者提供丰富的 API
  • ?️ 安全:线程安全的操作及内存泄漏保护
  • ? 现代化:专为 Minecraft 26.1+ 构建,并优化了 Paper 支持
  • ? 监控:详细的统计信息及可选的性能监控
  • ?️ 建筑工具:为专业建筑师提供广泛的实用工具(排水、覆盖、穹顶、圆锥、绿化、积雪等)
  • ? 分析:通过 /info 提供详细的选区信息(方块分布、体积、尺寸)
  • ⚙️ 可配置:针对性能、限制和功能提供丰富的配置选项

SimpleEdit 是任何寻求专业、强大且可靠的 Minecraft 世界编辑工具的用户的首选!

? 最新功能

  • 建筑工具:排水、覆盖、穹顶、圆锥、绿化、积雪、融雪、灭火、屠宰
  • Info 命令:带有方块分布的详细选区分析
  • 填充流体:快速填充水或岩浆
  • 性能监控:可选的操作指标跟踪
  • 改进的 GUI:所有新命令集成到 BuildingGUI 中
  • 更好的错误处理:稳健的操作完成机制,无需多次更新

由 oFlori(Flori) ❤️ 开发 | 版本 1.0-SNAPSHOT | Minecraft 26.1+

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源