介绍
SurvivalEdit
面向生存玩法的 WorldEdit 分支,适用于 NeoForge。
SurvivalEdit 将类似 WorldEdit 的建造工具带入生存向整合包。编辑会消耗应用能源2网络或玩家物品栏中的资源,逐步放置方块,并可通过按世界保存的历史记录撤销。
重要提示: 为兼容 WorldEditCUI,SurvivalEdit 使用
worldedit模组 ID。请勿与官方 WorldEdit 模组同时安装。
功能
- 在 NeoForge 上提供 WorldEdit 选区与编辑命令。
worldedit:axe选区工具及其合成配方、模型和材质。worldedit:stick_main画笔棒和 16 根染料颜色各异的棒子,每种颜色对应一个画笔槽位。- 画笔棒的说明文字会显示绑定的画笔、尺寸、范围、材料、遮罩和追踪遮罩。
- SurvivalEdit 创造模式物品栏标签页,包含斧头和所有棒子。
- 可配置工具按住使用时的重复间隔。
- 通过可选的存储提供方支付资源,内置 AE2 网络和玩家物品栏。
//payment用于显示、测试或切换当前支付提供方。- 编辑失败时只会报告缺少的物品种类。
- 缺失物品列表过长时会使用
//payment missing [page],每行聊天消息显示 6 种物品。 //payment test只报告提供方是否可用以及物品总数。- 可选支持精妙背包支付,包括穿戴在物品栏或 Curios 中的背包。
- 可在 2 格范围内从附近容器支付,包括箱子、木桶、潜影盒,以及实现了 Minecraft
Container的模组方块实体。 - 已支付的编辑会逐步按区块应用。
- 每位玩家的历史记录会持久保存到磁盘。
- 付费撤销与重做:
//undo恢复一项编辑,并退还仍然存在的资源。//undo nearest撤销当前世界中最近应用的编辑。//redo重新应用已撤销的编辑,并再次扣除资源。
- 保护生存模式下不应被覆盖的方块。
- 每个放置的方块都会通知其邻居,因此连接、支撑和红石的反应会与手动放置方块时一样。
- Copycat 和 FramedBlocks 的外观数据会随方块一起复制、粘贴和恢复。
- 方块按其构成材料计价:四根蜡烛收费四根蜡烛;Copycat 则会同时收取其自身和所仿制材料的费用。
- 可按方块、模组命名空间或方块标签设置保护规则。
- 可选支持生存模式结构蓝图。
- 通过
worldedit通道兼容 WorldEditCUI。
运行要求
| 要求 | 支持值 |
|---|---|
| Minecraft | 1.21.1 |
| 加载器 | NeoForge |
| Java | 21 |
| 必需模组 | 无;玩家物品栏始终可用 |
| 可选存储模组 | 应用能源2和 AE2WTLib |
SurvivalEdit 仅支持 NeoForge。它不是 Bukkit、Paper、Fabric 或 Sponge 插件。
安装
- 为 Minecraft
1.21.1安装 NeoForge。 - 如需通过 ME 网络支付,可选安装应用能源2和 AE2WTLib。
- 下载
survivaledit-neoforge-...-dist.jar发行文件。 - 将 jar 文件放入服务器的
mods目录。 - 启动服务器一次,然后配置
config/worldedit/worldedit.properties。
请勿同时安装官方 WorldEdit 模组。
生存模式编辑的运作方式
付费编辑开始前,SurvivalEdit 会检查费用和受保护方块。如果无法支付,或编辑会覆盖受保护方块,就会在扣除资源前拒绝编辑。
已付费方块会按位置和状态进行追踪。购买的方块被替换时,如果仍能识别为已购方块,就会退还一次资源。未通过 SurvivalEdit 购买的方块不会退款。
如果付费编辑会覆盖包含物品或类似物品栏数据的方块实体,系统会在扣款前拒绝编辑。此内容检查不涵盖空方块实体。Create 的 Copycat、Copycats+ 和 FramedBlocks 中仅用于外观的方块实体会随方块移动,因此复制的外观方块会保留其仿制的方块。/stop 和服务器关闭时会完成排队中的任务:保留已应用的更改、保存历史记录,并通过当前支付提供方退还尚未放置方块的费用。
编辑费用按其中的方块计算,而不是按位置数量计算。包含多个物品的方块状态会按物品数量收费;Copycat 或框架方块则会收取 Copycat 本身及其仿制材料的费用。沙子等下落方块会遵循原版行为:先放置在编辑指定的位置,再从那里落下。
历史记录和认领数据按世界分别保存。一个存档的历史记录不能应用到另一个存档。
工具
选区斧用于标记编辑区域的角点。画笔通过 //brush 及其选项命令绑定到手持物品上,解除绑定前会一直保留在该物品上。
17 根棒子为每种染料颜色提供独立的画笔槽位:
worldedit:stick_main— 将木棍 / 深暗之力锭 / 木棍竖直排列合成。worldedit:stick_<colour>— 任意 SurvivalEdit 棒子加上对应颜色的染料。- 棒子的说明文字会显示绑定的画笔、尺寸、范围、材料、遮罩和追踪遮罩。
所有 SurvivalEdit 物品都在 SurvivalEdit 创造模式物品栏标签页中。按住工具时的重复速率由 survival.tool-use-delay-ticks 设置。
与 WorldEdit 的区别
| 项目 | WorldEdit | SurvivalEdit |
|---|---|---|
| 平台 | 多个平台版本 | 仅 NeoForge |
| 编辑费用 | 通常免费 | 生存模式下从 AE2 或物品栏扣除 |
| 放置方式 | WorldEdit 的常规放置方式 | 付费编辑按区块逐步放置 |
| 历史记录 | WorldEdit 标准历史记录 | 按玩家和世界分别持久保存的历史记录 |
| 撤销 | WorldEdit 标准行为 | 恢复方块,并退还符合条件的已购方块资源 |
| 重做 | WorldEdit 标准行为 | 再次扣除资源 |
| 保护 | WorldEdit/服务器权限与配置 | 额外的生存模式受保护方块规则 |
| 结构蓝图 | WorldEdit 标准行为 | 生存模式结构蓝图功能可配置,默认关闭 |
| 模组身份 | worldedit |
worldedit 为兼容 WorldEditCUI 而保留 |
SurvivalEdit 不是 WorldEdit 插件的即插即用替代品,也不能与同一实例中的官方 WorldEdit 安装兼容。
配置
配置文件保存在 config/worldedit/worldedit.properties。
| 键 | 默认值 | 说明 |
|---|---|---|
survival.blocks-per-tick |
1024 |
每个游戏刻所有编辑最多可写入的方块数。 |
survival.per-chunk-delay-ms |
0 |
写入下一个区块前的延迟。 |
survival.max-blocks-per-edit |
250000 |
单次编辑的最大尺寸;0 表示不限制。 |
survival.history-limit |
250 |
每位玩家保留的编辑记录数;0 表示不限制。 |
survival.message-threshold |
0 |
仅报告方块数达到此数量的编辑,包括退款;0 表示报告每次编辑,-1 表示不报告。错误始终会显示。 |
survival.allow-schematics |
false |
允许在生存模式中使用结构蓝图和剪贴板。 |
survival.drop-if-network-is-full |
true |
存储无法接收退还物品时,将物品掉落出来。 |
survival.payment-provider |
auto |
支付模式:auto、inventory,或已注册的提供方 ID。 |
survival.tool-use-delay-ticks |
4 |
按住工具时的重复延迟;0 表示每个游戏刻重复一次。 |
survival.protected-blocks |
见下文 | 生存模式编辑不得覆盖的方块。 |
survival.protected-blocks 接受以下规则:
minecraft:bedrock— 单个方块。@ae2或ae2:*— 某个模组命名空间中的所有方块。#minecraft:logs— 某个标签中的所有方块。- 在规则前加上
!可设为例外,例如@ae2,!ae2:controller。
附带的保护列表涵盖无法安全挖回的方块、编辑不会复制其内容的容器,以及选定的高价值多方块结构组件。在整合包中使用 SurvivalEdit 前,请先检查此列表。
已知限制
- 支持平台与版本为 NeoForge 和 Minecraft
1.21.1。 - 不能同时安装官方 WorldEdit 模组。
- AE2/AE2WTLib 为可选项;玩家物品栏仍可作为支付提供方。
- 付费编辑有意采用逐步应用,而非即时完成。
- 生存模式结构蓝图功能默认关闭。
- 画笔绑定保存在玩家会话中,玩家登出后会丢失。
- 启用广泛的编辑权限前,应在目标整合包中测试模组方块实体的相关行为。
项目状态
SurvivalEdit 是一个专注于特定需求的分支,并非上游 WorldEdit 的发行版本。项目保留了实用的 WorldEdit 核心功能,并增加了生存模式支付、历史记录、保护规则和 NeoForge 集成。
当前使用的 WorldEdit 基础版本为 7.3.8。SurvivalEdit 有自己的版本号和发行说明。
构建
构建需要 Java 21。请使用 Gradle 包装器:
./gradlew :worldedit-neoforge:build
可分发的 jar 文件会生成在:
worldedit-neoforge/build/libs/
安装时请使用带有 -dist 分类器的 jar 文件。
构建 NeoForge 版本矩阵
将 Minecraft/NeoForge/Parchment 组合添加到 gradle/neoforge-versions.txt,然后运行:
scripts/build-neoforge-matrix.sh
每次独立运行 Gradle 都会在 build/neoforge-matrix/ 中生成单独的 jar 文件。不会以扩大依赖版本范围代替实际测试;只有在特定 Minecraft 和 NeoForge 组合通过测试后,才发布对应的 jar。
支持与贡献
- 报告错误:GitHub Issues
- 请查看项目专属的更改记录:
CHANGELOG.md。 CHANGELOG.txt是上游 WorldEdit 的历史记录,不是 SurvivalEdit 的发行日志。
许可证与署名
SurvivalEdit 自有代码和资源使用 CC BY-ND 4.0 许可。你可以使用这些内容并将其加入整合包,但请保留署名,且不得分享修改后的副本。
源自 WorldEdit 的文件仍采用 GNU GPLv3 许可;完整文本见 LICENSE.txt。请保留上游版权和署名声明。
常见问题
SurvivalEdit 支持哪些 Minecraft 版本?
SurvivalEdit 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。
SurvivalEdit 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分