AsyncWorldEdit - Premium

Minecraft VIP AsyncWorldEdit - Premium 3.6.0-rc-05

You must be signed in and/or upgrade to VIP to download this resource
Tested Minecraft Versions:
1.7, 1.8, 1.9, 1.10, 1.11, 1.12
Description
This plugin has only one function: eliminate the lag caused by the WorldEdit! This is done by hooking into WorldEdit inners classes and replacing some of them with specially prepared classes. All WorldEdit operations are divided into two stages: preparation and block placing. The preparation phase is done in async thread and calculates the list of blocks that need to be changed. All the block placing in stage two is done in packages. The package size and how often the blocks are drawn are configurable in the config. AsyncWorldEdit is not a reimplementation of WorldEdit! It attaches the original WorldEdit API and WorldEdit classes and tries to fix the lags. There fore you have access to all the WorldEdit operations, and all those operations work exactly like in the original WorldEdit. So basically you get the same commands, same permissions and the same experience. In addition to that if WorldEdit team releases a new feature, fixes a bug all you need to do is update WorldEdit and AWE will do its job as usual.



1.13 Compatibility
A version that supports 1.13 was released as alpha. Although I did not find any major bugs you should be cautious to use it on the production server. The version was built against WorldEdit v7.0.0-SNAPSHOT;8bfbc55 and won't work with any older version. It was tested on the latest spigot (git-Spigot-2440e18-6304ccd (MC: 1.13.1)).

Currently the support for direct chunk was disabled (it will be restored in the next release), and all progress display plugins ware removed (I will add those one by one depending on the availability for 1.13).

If you are using BlocksHub you need to upgrade it to 3.x.

Support for PlotMe was dropped. If you want to use PlotMe with this plugin you are doing it at your own risk. Support will be restored after the release of PlotMe for 1.13.

Repository and project page

GitHub

I'm missing... (I need...)
If AsyncWorldEdit lacks a feature that you would like to have, that would make your work much easier send me a PM describing your needs.

Installation
To install the plugin simply follow those steps (steps 5-7 are optional):
  1. download and install WorldEdit 6.1.2 (or newer)
  2. buy the plugin on spigotmc.org
  3. download AsyncWorldEdit.jar (for WorldEdit dev you need to download AsyncWorldEdit-dev.jar, you can find it on the version history. Go to version history and click "download" for on the latest dev version)
  4. install AsyncWorldEdit (the injector will install automatically)
  5. (o) to enable blocks loggin and blocks access control download BlocksHub
  6. (o) if you are using PlotMe older then 0.17 and want to enable the PlotMeFix got to plugins/AsyncWorldEdit/plugins and change AsyncWorldEdit-PlotMe*.jar.dis to AsyncWorldEdit-PlotMe*.jar. Use the jar that's for your PlotMe version!
  7. (o) if you want to use additional progress display plugins enable the appropriate bridge for your progress display plugin (For example: if you want to use ActionBarAPI you need AsyncWorldEdit-ActionBarAPI)
  8. restart server
  9. edit the config file
  10. restart server or do /AWE reload
Version before 3.3.0
To install the plugin simply follow those steps (steps 5-7 are optional):
  1. download and install WorldEdit
  2. buy the plugin on spigotmc.org
  3. download AsyncWorldEdit
  4. install AsyncWorldEdit and AsyncWorldEditInjector
  5. (o) to enable blocks loggin and blocks access control download BlocksHub
  6. (o) if you are using PlotMe older then 0.17 and want to enable the PlotMeFix put AsyncWorldEdit-PlotMe* in your plugins folder. Use the jar that's for your PlotMe version!
  7. (o) if you want to use additional progress display plugins put the appropriate bridge for your progress display plugin (For example: if you want to use ActionBarAPI you need AsyncWorldEdit-ActionBarAPI)
  8. restart server
  9. edit the config file
  10. restart server or do /AWE reload
Installation - Forge (Cauldron)
To install the plugin simply follow those steps:

  1. download WorldEdit and WorldEdit Forge
    1. install WorldEdit into plugins folder
    2. install WorldEdit forge into mods folder
  2. download AsyncWorldEdit
    1. install AsyncWorldEditInjector into mods folder (do not put it into the plugins folder!)
    2. install AsyncWorldEdit into plugins folder (do not put it into the mods folder!)
  3. Follow the installation instruction from the regular version starting from p5.
Error performing safe operation...
AsyncWorldEdit
queues changed blocks in a async thread and then places them in packages. Since many WorldEdit operations need to acquire blocks from the map AsyncWorldEdit needs to get the blocks during the preparation phase (in async thread). Since almost none of the API calls should be called from async thread (its risky at most) AsyncWorldEdit checks if it can do the block get in a async thread. If it detects that it is not possible/not allowed it dispatches this to the main thread. Sometimes AWE is not able to detect that the operation is not allowed, this causes the operation to fail. AWE logs this fact in the log (Error performing safe operation) and does the operation using the dispatcher. If all the operations ware processed using the dispatcher you would experience a drasticall speed decrease. On the other hand it is not possible to be 100% sure that the get operation will not fail from async thread. To be 100% sure AWE would need to inject its own classes into Bukkit inner workings.

License
For the full license please go to this link

Issues
To report issues please use the Github (or the premium one here) issue tracker.

I'm still experiencing lag!
Read

Auto updates
This plugin does not provide auto update feature it only nags the server owner's when there's an update. To disable this feature set checkVersion to false in the config. Alternatively you can remove the AWE.admin.version permission node if you don't want to receive update information.


Direct Chunk API
Since version 3.x the plugin contains a new super fast world editing feature. It is based on direct chunk data access. It allows you to copy large pieces of the map instantly. Currently the Direct Chunk API supports Spigot since 1.8r3 up to 1.12.2. To find out more simply try the "/chunk" (not "//chunk"!) command while in game.

Block loggers & Block access control
The enables logging of blocks placed by WorldEdit and can enforce block access. This is done using a special plugin called BlocksHub. To enable block logging (or block access control) you need to enable it in AWE config. This feature requires you to download, install and configure BlocksHub and then install any of the supported block loggers (access controllers).

New loggers and new access control plugins are going to by added directly to BlocksHub plugin.

WARNING: To enable Direct Chunk API and BlocksHub integration you need to enable it in the options.

How fast you can go?
Recently a thread has been started on spigotmc.org where you can show others how fast you can place blocks using AsyncWorldEdit. You can also use that thread for reference on how to configurate AsyncWorldEdit for you hardware specification.
The thread can be found here.

How many blocks can I queue?
All tests ware done in a controlled environment. Using the official spigot, only AWE and WE ware installed and there was 1 player on the server. The AWE config was not changed.

On a minimum server (512m) free memory ~200m I managed to queue up to 1 000 000 blocks. But after the queue reached 500 000 blocks TPS started to dropped drastically because of the garbage collector. Therefore I do not recommend to queue more then 500 000 blocks on a server that has 200m free ram.

On a server that had 1g ram, approximately ~700m free, I managed to queue up to 2 500 000 blocks. After the queue reached 2 000 000 blocks the TPS started dropping because of the garbage collector.

Adding additional ram resulted in increase of the maximum number of queued blocks approximately by 1 500 000 blocks for each 500m of additional free ram. When I disabled the blocks freeze function I managed to queue additional 20% blocks, (1 800 000 for each additional 500m of free ram).

Plugin X stopped working after installing AWE
If a plugin stopped working after installing AsyncWorldEdit please contact me. I'll try to help.

Plugins that use AsyncWorldEdit
If you are a plugin author and your plugin uses AWE API contact me I'll add your plugin to the list.

API
For API and Maven please to go to Github. You might also want to check: Plugin API

Roadmap
Roadmap


Commands
Commands page

Permissions
Permissions page

Configuration
Configuration page

Changelog
Configuration page

Dependencies
This plugin depends on:
BlocksHub - block login and blocks access
Other optional dependencies:
Progress display plugins:
MCStats
This plugin uses MCStats to gather statistics. It gathers only the standard stats gathered for most of MCStat's enabled plugins (for example: OS, Java version, CPU, country, plugin and server version). For details what exactly is gathered click on the graph below. To disable the stats you need to disable stats gathering for MCStats (set opt-out to true in plugins/PluginMetrics/config.yml). This disables all the stats gathering for all plugins that use the default MCStats.

Thank you for using this plugin.
Author
Admin
Downloads
3
Views
980
First release
Last update
Rating
5.00 star(s) 1 ratings

More resources from Admin

Share this resource

Latest updates

  1. Support WorldEdit v7.0.0-beta-05

    This release is a release candidate version for Minecraft (Spigot) 1.13, 1.13.1 , 1.13.2 it...
  2. Bugfixes

    This release is a release candidate version for Minecraft (Spigot) 1.13, 1.13.1 , 1.13.2 it...
  3. Injector fixes

    This release is a release candidate version for Minecraft (Spigot) 1.13, 1.13.1 , 1.13.2 it...