SurvivalEdit
A survival-focused WorldEdit fork for NeoForge.
SurvivalEdit brings WorldEdit-style building tools to survival modpacks. Edits use resources from an Applied Energistics 2 network or the player's inventory, are placed gradually, and can be undone through persistent per-world history.
Important: SurvivalEdit uses the
worldeditmod ID for WorldEditCUI compatibility. Do not install it together with the official WorldEdit mod.
Features
- WorldEdit selection and editing commands on NeoForge.
- The
worldedit:axeselection item, recipe, model, and texture. - The
worldedit:stick_mainbrush stick and 16 dye-coloured sticks, one brush slot per colour. - Brush sticks show the bound brush, size, range, material, mask, and trace mask in their lore.
- A SurvivalEdit creative tab holding the axe and every stick.
- Configurable hold-to-use delay for held tools.
- Resource payment through a selectable storage provider, with the AE2 network and player inventory built in.
//paymentto show, test, or switch the active payment provider.- Failed edits report only missing item types.
- Large missing lists use
//payment missing [page], with 6 types per chat line. //payment testreports provider availability and aggregate item totals only.- Optional Sophisticated Backpacks payment, including backpacks worn in inventory or Curios.
- Nearby container payment within a 2-block radius, including chests, barrels, shulkers, and
modded block entities that implement Minecraft
Container. - Gradual, chunk-based application of paid edits.
- Persistent per-player history stored on disk.
- Paid undo and redo:
//undorestores an edit and refunds resources that are still present.//undo nearestundoes the nearest applied edit in the current world.//redoapplies an undone edit and charges for it again.
- Protection for blocks that should not be overwritten in survival.
- Every written block notifies its neighbours, so connections, support, and redstone react as they would to a block placed by hand.
- Copycat and FramedBlocks appearance data is copied, pasted, and restored with the block.
- A block costs what it is made of: four candles cost four candles, and a copycat is charged the material it mimics as well as the copycat itself.
- Protection rules by block, mod namespace, or block tag.
- Optional survival schematic support.
- WorldEditCUI compatibility through the
worldeditchannel.
Requirements
| Requirement | Supported value |
|---|---|
| Minecraft | 1.21.1 |
| Loader | NeoForge |
| Java | 21 |
| Required mods | None; player inventory is always available |
| Optional storage mods | Applied Energistics 2 and AE2WTLib |
SurvivalEdit is NeoForge-only. It is not a Bukkit, Paper, Fabric, or Sponge plugin.
Installation
- Install NeoForge for Minecraft
1.21.1. - Optionally install Applied Energistics 2 and AE2WTLib for ME-network payment.
- Download the
survivaledit-neoforge-...-dist.jarrelease file. - Put the jar in the server's
modsdirectory. - Start the server once, then configure
config/worldedit/worldedit.properties.
Do not install the official WorldEdit mod alongside SurvivalEdit.
How survival edits work
Before a paid edit starts, SurvivalEdit checks its cost and protected blocks. If the edit cannot be paid for or would overwrite a protected block, it is refused before resources are taken.
Paid blocks are tracked by position and state. When a purchased block is replaced, the resource is refunded once if it is still identifiable as a purchased block. Blocks that were not purchased through SurvivalEdit are not refunded.
A paid edit is refused before payment if it would overwrite a block entity containing items or
inventory-like data. Empty block entities are not covered by this contents check. Appearance-only
block entities from Create's copycats, Copycats+, and FramedBlocks travel with their block, so a
copied facade keeps the block it mimics. /stop and server shutdown finalize queued jobs: applied
changes are kept, history is stored, and unpaid remaining blocks are returned through the active
payment providers.
The cost of an edit follows the blocks in it rather than the number of positions. State that holds several items is charged per item, and a copycat or framed block is charged the copycat plus the mimicked material. Falling blocks such as sand behave as they do in vanilla: they are placed where the edit put them and fall from there.
History and claim data are stored per world. A history from one save cannot be applied to another save.
Tools
The Selection Axe marks the corners of an edit region. Brushes are bound to the item in your hand
with //brush and its option commands, and stay on that item until unbound.
Seventeen sticks give each dye colour its own brush slot:
worldedit:stick_main— crafted from a vertical column of stick / unobtainium ingot / stick.worldedit:stick_<colour>— any SurvivalEdit stick plus the matching dye.- A stick's lore shows the brush, size, range, material, mask, and trace mask bound to it.
Every SurvivalEdit item is in the SurvivalEdit creative tab. The repeat rate while holding a tool
is set by survival.tool-use-delay-ticks.
WorldEdit differences
| Area | WorldEdit | SurvivalEdit |
|---|---|---|
| Platform | Multiple platform builds | NeoForge only |
| Edit cost | Normally free | Paid from AE2 or inventory in survival |
| Placement | Normal WorldEdit placement | Gradual chunk-based placement for paid edits |
| History | Standard WorldEdit history | Persistent per-player, per-world history |
| Undo | Standard WorldEdit behavior | Restores blocks and refunds eligible purchased blocks |
| Redo | Standard WorldEdit behavior | Charges resources again |
| Protection | WorldEdit/server permissions and configuration | Additional survival protected-block rules |
| Schematics | Standard WorldEdit behavior | Survival schematic use is configurable and disabled by default |
| Mod identity | worldedit |
worldedit, intentionally retained for WorldEditCUI compatibility |
SurvivalEdit is not a drop-in replacement for a WorldEdit plugin and is not compatible with an official WorldEdit installation in the same instance.
Configuration
Configuration is stored in config/worldedit/worldedit.properties.
| Key | Default | Description |
|---|---|---|
survival.blocks-per-tick |
1024 |
Maximum blocks all edits may write per tick. |
survival.per-chunk-delay-ms |
0 |
Delay before writing to the next chunk. |
survival.max-blocks-per-edit |
250000 |
Maximum size of one edit; 0 disables the limit. |
survival.history-limit |
250 |
Number of edits kept per player; 0 disables the limit. |
survival.message-threshold |
0 |
Only report edits of at least this many blocks, including their refunds; 0 reports every edit, -1 reports none. Errors are always shown. |
survival.allow-schematics |
false |
Allow schematic and clipboard use in survival. |
survival.drop-if-network-is-full |
true |
Drop returned items when storage cannot accept them. |
survival.payment-provider |
auto |
Payment mode: auto, inventory, or a registered provider id. |
survival.tool-use-delay-ticks |
4 |
Repeat delay while holding a tool; 0 repeats every tick. |
survival.protected-blocks |
See below | Blocks survival edits may not overwrite. |
survival.protected-blocks accepts:
minecraft:bedrock— one block.@ae2orae2:*— all blocks from a mod namespace.#minecraft:logs— every block in a tag.- Prefix any rule with
!to make an exception, such as@ae2,!ae2:controller.
The shipped protection list covers blocks that cannot safely be mined back, containers whose contents are not copied by an edit, and selected expensive multiblock components. Review it before using SurvivalEdit in a modpack.
Known limitations
- NeoForge and Minecraft
1.21.1are the supported platform and version. - The official WorldEdit mod cannot be installed at the same time.
- AE2/AE2WTLib is optional; the player inventory remains an available payment provider.
- Paid edits are intentionally gradual rather than instant.
- Schematic support in survival is disabled by default.
- Brush bindings are held in the player's session and are lost when the player logs out.
- Behavior involving modded block entities should be tested in the target modpack before enabling broad editing permissions.
Project status
SurvivalEdit is a focused fork rather than an upstream WorldEdit distribution. The project keeps WorldEdit's core functionality where it is useful and adds survival payment, history, protection, and NeoForge integration.
The current WorldEdit base is 7.3.8. SurvivalEdit has its own version and release notes.
Building
Building requires Java 21. Use the Gradle wrapper:
./gradlew :worldedit-neoforge:build
The distributable jar is produced in:
worldedit-neoforge/build/libs/
Use the jar with the -dist classifier for installation.
Build a NeoForge version matrix
Add Minecraft/NeoForge/Parchment combinations to gradle/neoforge-versions.txt, then run:
scripts/build-neoforge-matrix.sh
Each isolated Gradle invocation produces a separate jar in build/neoforge-matrix/. Widening a
dependency range is not used as a substitute for testing; publish a jar only after that exact
Minecraft and NeoForge combination passes.
Support and contributions
- Report bugs: GitHub Issues
- Read the project-specific changes in CHANGELOG.md.
CHANGELOG.txtis retained as the upstream WorldEdit history and is not the SurvivalEdit release changelog.
License and attribution
SurvivalEdit's own code and assets are licensed under CC BY-ND 4.0. Use it and ship it in modpacks, keep the credit, and do not share modified copies.
Files derived from WorldEdit remain under the GNU GPLv3; the full text is in LICENSE.txt. Retain the upstream copyright and attribution notices.