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 命令:详细分析选择范围及方块分布情况
? 安装与使用
快速入门指南
- 下载插件:从发布页面下载最新的
.jar文件 - 服务器安装:将插件放入服务器的
plugins/文件夹中 - 重启服务器:使用
/restart命令或完全重启 Paper 服务器 - 开始使用:
# 手持木斧(或使用 /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+
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧