# WorldEditSelectionVisualizer
\n## Overview
\nWorldEditSelectionVisualizer (WESV) is essentially the famous WorldEditCUI mod in the form of a bukkit plugin, which means that players **don’t need to install anything on their client**.<\/p>\n
## Features<\/p>\n
* Spawns particles around WorldEdit selections so players can see them
\n* No client mod required
\n* Supports cuboid, sphere, ellipsoid, cylinder, polygon and convex selections
\n* Can display the current clipboard (use `\/wesv toggle clipboard` to enable)
\n* Use `\/wesv toggle` to toggle the visualizer
\n* Option to only show the selection when holding the selection item
\n* Configurable particle effect and view distance
\n* Prevent players from spawning too many particles when selecting huge regions
\n* Highly customizable for the performance of your server
\n* Supports both WorldEdit and FastAsyncWorldEdit
\n* Compatible with all Minecraft versions starting with 1.7.10
\n* PlaceholderAPI support (you can use the placeholders `%wesv_toggled_selection%`, `%wesv_toggled_clipboard%`, `%wesv_volume_selection%` and `%wesv_volume_clipboard%`)
\n* Support for RGB color codes in messages on Minecraft 1.16 and higher, with the `&#rrggbb` format
\n* Folia support for better performance<\/p>\n
## Screenshots<\/p>\n
| Cuboid selection | Cylinder selection | Convex selection |
\n|——————————————————|——————————————————–|——————————————————|
\n|  |  |  |<\/p>\n
More screenshots
\n## Usage<\/p>\n
### Commands<\/p>\n
* `\/wesv toggle` and `\/wesv toggle clipboard`: toggle the selection\/clipboard visualization
\n* `\/wesv lock`: lock\/unlock the origin of the clipboard visualization to your current location
\n* `\/wesv lock tp`: teleport to the lock location (when clipboard visualization lock is enabled)
\n* `\/wesv reload`: reload the configuration<\/p>\n
### Permissions<\/p>\n
* `wesv.toggle`: use the toggle command
\n* `wesv.use`: allows the visualizer to be turned on
\n* `wesv.reload`: allows the configuration of this plugin to be reloaded from the config.yml file<\/p>\n
### Configuration “`yaml # When enabled, if a new update is available it will display a message in the console on enable # You can edit the plugin messages here # When enabled, if a player disables the selection visualization and leaves the server, when he will # Delay in ticks when the WorldEdit selection and clipboard are updated. # When enabled, the particles are displayed only when holding the WorldEdit selection wand item (by default a wooden axe) # When enabled, top and bottom particles will be displayed for cuboid selections # Settings for visualization ### Video<\/p>\n
\nThis plugin can be very resource expensive, try adjusting the configuration if you experience lag.<\/p>\nConfiguration File<\/summary>\n
\n# WorldEditSelectionVisualizer configuration<\/p>\n
\ncheck-updates: true<\/p>\n
\nmessages:
\n no-permissions: “&cYou don’t have the permission to use this command.”
\n config-reloaded: “&aThe config was reloaded”
\n selection-too-large: “&6The visualizer only works with selections up to a size of %blocks% blocks.”
\n visualizer-enabled: “&6Your visualizer has been &eenabled.”
\n visualizer-disabled: “&6Your visualizer has been &cdisabled.”
\n visualizer-clipboard-enabled: “&6Your clipboard visualizer has been &eenabled&6.”
\n visualizer-clipboard-disabled: “&6Your clipboard visualizer has been &cdisabled&6.”<\/p>\n
\n# come back, the selection visualization will be still disabled until he activates it again with \/wesv toggle.
\nsave-toggle: true<\/p>\n
\n# This doesn’t affect particles spawning and players performances.
\n# The server impact is medium
\nselection-update-interval: 20<\/p>\n
\n# You can change the WorldEdit wand item in the WorldEdit configuration
\nneed-we-wand: false<\/p>\n
\ncuboid-top-bottom: false<\/p>\n
\n# ‘selection’: The WorldEdit current selection
\n# ‘clipboard’: The WorldEdit clipboard (when you use \/\/copy or \/\/schem load )
\n# ‘primary’: The primary selection points (the region borders)
\n# ‘secondary’: The secondary selection points
\n# ‘fade-delay’: The number of seconds before the particles disappears. You can set it to 0 to remove the fade delay
\n# ‘max-selection-size’ : The maximum size of a selection to be display. A big value (> 1000000) can cause important lags
\n# ‘points-distance’: The distance between each particle. The higher this number is, fewer particles will be spawn
\n# ‘lines-gap’ (secondary selection only): The distance between each particles lines on cuboid and polygon. The higher this number is, fewer particles will be spawn. Set it to 0 to remove cuboid lines
\n# ‘update-interval’: The delay in ticks between particles spawn. This impact the players performances
\n# ‘view-distance’: The maximum distance in which players can see the particles. On 1.7.10 the particle distance is limited to 16 (Minecraft limitation)
\n# ‘particles’: The particles type and data. The data can be a color for redstone like in the form ‘r,g,b’ or a Material for block crack\/item crack
\n# The particle types are available on https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/Particle.html
\nvisualization:
\n selection:
\n fade-delay: 0
\n max-selection-size: 50000
\n primary:
\n points-distance: 1.0
\n update-interval: 12
\n view-distance: 64
\n particles:
\n type: “FLAME”
\n data: “”
\n secondary:
\n points-distance: 3.0
\n lines-gap: 5.0
\n update-interval: 18
\n view-distance: 32
\n particles:
\n type: “REDSTONE”
\n data: “RED”
\n clipboard:
\n fade-delay: 0
\n max-selection-size: 50000
\n primary:
\n points-distance: 1.0
\n update-interval: 12
\n view-distance: 64
\n particles:
\n type: “FLAME”
\n data: “”
\n secondary:
\n points-distance: 3.0
\n lines-gap: 5.0
\n update-interval: 18
\n view-distance: 32
\n particles:
\n type: “REDSTONE”
\n data: “BLUE”
\n“`
\n<\/details>\n