Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/platz1de/easyedit
A feature-rich World Editor for PocketMine-MP
https://github.com/platz1de/easyedit
phpstan-l8 pmmp pmmp-plugin pocketmine-mp world-editor worldedit
Last synced: about 21 hours ago
JSON representation
A feature-rich World Editor for PocketMine-MP
- Host: GitHub
- URL: https://github.com/platz1de/easyedit
- Owner: platz1de
- License: gpl-3.0
- Created: 2020-10-29T10:25:47.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-24T19:45:44.000Z (4 months ago)
- Last Synced: 2024-09-26T10:01:18.901Z (about 21 hours ago)
- Topics: phpstan-l8, pmmp, pmmp-plugin, pocketmine-mp, world-editor, worldedit
- Language: PHP
- Homepage: https://poggit.pmmp.io/p/EasyEdit/
- Size: 2.14 MB
- Stars: 42
- Watchers: 3
- Forks: 27
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EasyEdit
[](https://poggit.pmmp.io/p/EasyEdit)
Feature-rich WorldEditor for PocketMine-MP
## Features
- large variety of commands
- High performance:
- async editing, allowing the server to run normally while editing in the background
- low memory consumption by splitting your actions into multiple smaller ones
- read more about performance [here](#Performance)
- flicker-free editing
- support for unique Patterns
- set blocks in effectively infinite ways
- see [Pattern Documentation](#Patterns)
- selection axe & brushes
- undo & redo your actions
- tile support
- load & save java selections (load McStructure, MCEdit & Sponge format, save to Sponge)
- rotate & flip support
- Translation support
- [help translate EasyEdit](https://github.com/platz1de/EasyEdit/blob/dev/resources/lang/TRANSLATE.md)
## Commands
\ - required Argument
[argument] - optional Argument
Selection:
| Command | Description | Permission | Aliases/Notice |
|---------------------------------------------------|--------------------------------------------------------------|-----------------|---------------------------------------------------------------------------------|
| //pos1 [x] [y] [z] | Set the first position | easyedit.select | //1
left click a block in creative with a wooden axe |
| //pos2 [x] [y] [z] | Set the first position | easyedit.select | //2
break a block in creative with a wooden axe |
| //extend [direction] [count]
//extend vertical | Extend the selected area | easyedit.select | //expand
Look into the direction you want to extend to |
| //extend --min ,, --max ,, | Modify the selected area by the given vectors | easyedit.select | "Min" and "Max" refer to the corners of the selection |
| //set \ | Set blocks in the selected area | easyedit.edit |
| //replace \ \ | Replace blocks in the selected area | easyedit.edit |
| //replace \ | Replace all solid blocks in the selected area | easyedit.edit |
| //overlay \ | Overlay blocks in the selected area | easyedit.edit | Set blocks above existing blocks |
| //naturalize \[pattern] \[pattern] \[pattern] | Naturalize the selected area | easyedit.edit |
| //smooth | Smooth the selected area | easyedit.edit |
| //center [pattern] | Set the center blocks of the selected area | easyedit.edit | //middle |
| //walls [pattern] | Set the walls of the selected area | easyedit.edit | //wall |
| //sides [pattern] | Set the sides of the selected area | easyedit.edit | //side |
| //move [direction] [count] | Move the selected area | easyedit.edit | Look into the direction you want the selected blocks to move into |
| //stack [direction] [count] | Stack the selected area | easyedit.edit | Look into the direction you want the selected blocks to stack into |
| //istack [direction] [count] | Stack the selected area without overwriting existing terrain | easyedit.edit |
| //count [radius] [-d] | Count blocks in the selected area | easyedit.select |
| //extinguish [radius] | Extinguish fire in the selected area | easyedit.edit | //ext |
| //view | View the selected area | easyedit.select | //show
also allows exporting as a 3d model (thank mojang for buggy textures) |
History:
| Command | Description | Permission | Aliases/Notice |
|--------------------------|------------------------------|----------------------------------------------------|----------------------------|
| //undo [count] | Revert your latest change | easyedit.history easyedit.edit | |
| //undo \ [count] | Revert targets latest change | easyedit.history easyedit.edit easyedit.edit.other | Can be disabled via config |
| //redo [count] | Revert your latest undo | easyedit.history easyedit.edit | |
| //redo \ [count] | Revert targets latest undo | easyedit.history easyedit.edit easyedit.edit.other | Can be disabled via config |
Clipboard:
| Command | Description | Permission | Aliases/Notice |
|-------------------------|-----------------------------------------------------|---------------------------------------|-------------------------------------------------------------------|
| //copy [--center] | Copy the selected area | easyedit.clipboard | |
| //cut [--center] | Cut the selected area and copy it to your clipboard | easyedit.clipboard easyedit.edit | Copies and replaces with air |
| //paste | Paste the clipboard | easyedit.clipboard easyedit.edit | |
| //insert | Insert the clipboard | easyedit.clipboard easyedit.edit | Paste only into air blocks |
| //merge | Merge current terrain with the clipboard | easyedit.clipboard easyedit.edit | Paste only non-air blocks |
| //rpaste | Replace current terrain with the clipboard | easyedit.clipboard easyedit.edit | Replace non-air blocks with non-air blocks from the selection |
| //rotate | Rotate the clipboard | easyedit.clipboard | Rotates by 90 Degrees |
| //flip [direction] | Flip the clipboard, mirroring at copied position | easyedit.clipboard | Flips on axis you look on, always uses selected point as "mirror" |
| //load \ | Load a saved schematic from disk | easyedit.readdisk easyedit.clipboard | //loadschematic |
| //save \ | Save your clipboard as a schematic to disk | easyedit.writedisk easyedit.clipboard | //saveschematic |
Generation:
| Command | Description | Permission | Aliases/Notice |
|--------------------------------------------------------|----------------------------------------|---------------------------------|------------------------|
| //cube \ \ | Generate a cube | easyedit.generate easyedit.edit | //cb |
| //hcube \ \ [thickness] | Generate a hollow cube | easyedit.generate easyedit.edit | //hcb //hollowcube |
| //sphere \ \ | Generate a sphere | easyedit.generate easyedit.edit | //sph |
| //hsphere \ \ [thickness] | Generate a hollow sphere | easyedit.generate easyedit.edit | //hsph //hollowsphere |
| //cylinder \ \ \ | Generate a cylinder | easyedit.generate easyedit.edit | //cy |
| //hcylinder \ \ \ [thickness] | Generate a hollow cylinder | easyedit.generate easyedit.edit | //hcy //hollowcylinder |
| //noise | Generate using a simple noise function | easyedit.generate easyedit.edit | |
Utility:
| Command | Description | Permission | Aliases/Notice |
|------------------------------------------------------------------------|---------------------------------------------|-------------------------------------------------|-------------------------------------------------------------------------------------------|
| //commands [page] | List all EasyEdit commands | - | //h //cmd |
| //brush sphere \[radius] \[pattern] [gravity] | Create a spherical Brush | easyedit.brush
(To use: easyedit.edit) | //br sph |
| //brush smooth \[radius] | Create a smoothing Brush | easyedit.brush
(To use: easyedit.edit) | //br smooth |
| //brush naturalize \[radius] \[topBlock] \[middleBlock] \[bottomBlock] | Create a naturalize Brush | easyedit.brush
(To use: easyedit.edit) | //br nat |
| //brush cylinder \[radius] \[height] \[pattern] [gravity] | Create a cylindrical Brush | easyedit.brush
(To use: easyedit.edit) | //br cy |
| //brush paste [insert] | Create a pasting Brush | easyedit.brush
(To use: easyedit.edit) | //br paste | | | |
| //fill \ [direction] | Fill an area | easyedit.edit easyedit.generate | Fills into looking direction |
| //drain | Drain an area | easyedit.edit easyedit.generate |
| //line \ \ \ \[pattern] | Draw a line | easyedit.edit easyedit.generate | |
| //line [find\|solid] \ \ \ \[pattern] | Find a valid path to the destination (slow) | easyedit.edit easyedit.generate | "find" allows diagonals |
| //blockinfo | Get a blockinfo stick | easyedit.util | //bi |
| //builderrod | Get a builder rod | easyedit.rod | //rod
Expands the clicked blockface |
| //status | Check on the EditThread | easyedit.manage | |
| //cancel | Cancel the current task | easyedit.manage | |
| //benchmark | Start a benchmark | easyedit.manage | This will create a temporary world and edit a few preset actions |
| //pastestates | Paste all known blockstates | easyedit.edit easyedit.generate easyedit.manage | Mainly for debugging (can be used as an oversight of all existing blocks though) |
| //wand | Get a wooden Axe | easyedit.util | Every normal axe works as well (as long as you have permissions and are in creative mode) |
Movement:
| Command | Description | Permission | Aliases/Notice |
|-----------|-----------------------------|-----------------------------|---------------------------------------------------------|
| //thru | Teleport through blocks | easyedit.util | //t |
| //unstuck | Teleport to a safe location | easyedit.util | //u |
| //up | Teleport up | easyedit.util easyedit.edit | Places a glass block below you for simplified selecting |
## Patterns
Visit the [wiki](https://github.com/platz1de/EasyEdit/wiki/Patterns) for information on patterns.
All variants of bedrock and java states are supported.
## Schematics
To load external schematic files, place them in the "schematics" folder inside the EasyEdit plugin data folder.
Just execute `//load ` to load them and then use `//paste` to paste them. Omitting the name (`//load`) will list all available schematics.
To save a schematic, use `//save` . This will save the current clipboard (which was previous copied using `//copy`) to the schematics folder.
Schematics are fully compatible with the java edition. When loading or saving a schematic, the file will be automatically converted to the java format.
This includes blocks and tile entities.
Supported Formats:
- Sponge
- McEdit (reading only)
- McStructure (reading only)
## Performance
EasyEdit aims to be as fast as possible while still allowing for a ton of features.
All operations are executed asynchronously, meaning that the server will not lag while editing. You can always check the status of the current operation using `//status`.
Other world editors usually load the entirety of the selection into memory, which makes your server run out of memory very quickly.
EasyEdit counteracts this by loading chunks on the fly, only loading the blocks that are actually being edited at the moment.
This means that you can edit huge areas without having to worry about your server crashing. There is practically no limit to how many blocks you can edit at once.