# Minecraft

# Commands

# Overview

As a staff member, you have access to **many of Minecraft's wide variety of commands**. Commands are powerful tools that staff members of any Minecraft server should become familiar with, as they make up a lot of your administrative work in game. This page will discuss many vital parts of **how to write commands, describe some of the most important commands to know on WOFTNW, and provide some examples on how to write them**.

# Usage Notation

The command usage is notated like so:

```
/command subcommand <required_argument> [optional_argument] [greedy_optional_argument]...
```

- `command` is the name of the command.
- `subcommand` is the name of the subcommand if relevant.
- `<required_argument>` is an argument that must be included to execute the command.
- `[optional_argument]` is an argument that may optionally be included.
- `<greedy_required_argument>...` or `[greedy_optional_argument]...` are arguments which permit spaces. If present, they will always be at the end of a command.

# Vanilla Commands

Minecraft's vanilla commands are plentiful, but **most are either not important or are simple to understand**. The following is a complete list of the vanilla commands for our server version; **you do not have to be familiar with every command listed**! If you are curious about any specific command, please visit the wiki via the link in the description of the command.

<table id="bkmrk-command-description-"><thead><tr><th>**Command**</th><th>**Description**</th></tr></thead><tbody><tr><td>`/advancement`</td><td>🛡️ 📗 📒 Grants or revokes an advancement. [Wiki](https://minecraft.wiki/w/Commands/advancement)</td></tr><tr><td>`/attribute`</td><td>🛡️ 📒 Queries, adds, removes or sets an entity attribute. [Wiki](https://minecraft.wiki/w/Commands/attribute)</td></tr><tr><td>`/ban`</td><td>🛡️ 📕 Adds a player to the banlist. [Wiki](https://minecraft.wiki/w/Commands/ban)</td></tr><tr><td>`/banlist`</td><td>🛡️ 📗 Displays the banlist. [Wiki](https://minecraft.wiki/w/Commands/ban#banlist)</td></tr><tr><td>`/bossbar`</td><td>🛡️ 📗 Creates and modifies bossbars. [Wiki](https://minecraft.wiki/w/Commands/bossbar)</td></tr><tr><td>`/clear`</td><td>🛡️ 📒 📕 Clears items from player inventory. [Wiki](https://minecraft.wiki/w/Commands/clear)</td></tr><tr><td>`/clone`</td><td>🛡️ 📒 Copies blocks from one place to another. [Wiki](https://minecraft.wiki/w/Commands/clone)</td></tr><tr><td>`/damage`</td><td>🛡️ 📗 Applies damage to specified entities. [Wiki](https://minecraft.wiki/w/Commands/damage)</td></tr><tr><td>`/data`</td><td>🛡️ 📒 Manipulates block, entity, and storage NBT data. [Wiki](https://minecraft.wiki/w/Commands/data)</td></tr><tr><td>`/datapack`</td><td>🛡️ 📒 📕 Controls the data packs interface. [Wiki](https://minecraft.wiki/w/Commands/datapack)</td></tr><tr><td>`/debug`</td><td>🛡️ 📗 📒 Starts or stops a debugging session. [Wiki](https://minecraft.wiki/w/Commands/debug)</td></tr><tr><td>`/defaultgamemode`</td><td>🛡️ 📗 📒 Sets the default game mode. [Wiki](https://minecraft.wiki/w/Commands/defaultgamemode)</td></tr><tr><td>`/deop`</td><td>🛡️ 📒 📕 Revokes operator status from a player. [Wiki](https://minecraft.wiki/w/Commands/deop)</td></tr><tr><td>`/difficulty`</td><td>🛡️ 📗 Sets the difficulty level. [Wiki](https://minecraft.wiki/w/Commands/difficulty)</td></tr><tr><td>`/effect`</td><td>🛡️ 📗 Adds or removes status effects. [Wiki](https://minecraft.wiki/w/Commands/effect)</td></tr><tr><td>`/enchant`</td><td>🛡️ 📗 Adds an enchantment to a player's selected item. [Wiki](https://minecraft.wiki/w/Commands/enchant)</td></tr><tr><td>`/execute`</td><td>🛡️ 📗 📒 Executes another command. [Wiki](https://minecraft.wiki/w/Commands/execute)</td></tr><tr><td>`/experience, /xp`</td><td>🛡️ 📗 Adds or removes player experience. [Wiki](https://minecraft.wiki/w/Commands/experience)</td></tr><tr><td>`/fill`</td><td>🛡️ 📒 📕 Fills a region with a specific block. [Wiki](https://minecraft.wiki/w/Commands/fill)</td></tr><tr><td>`/fillbiome`</td><td>🛡️ 📒 Sets a region with a specific biome. [Wiki](https://minecraft.wiki/w/Commands/fillbiome)</td></tr><tr><td>`/forceload`</td><td>🛡️ 📒 Forces chunks to constantly be loaded or not. [Wiki](https://minecraft.wiki/w/Commands/forceload)</td></tr><tr><td>`/function`</td><td>🛡️ 📒 📕 Runs a function. [Wiki](https://minecraft.wiki/w/Commands/function)</td></tr><tr><td>`/gamemode`</td><td>🛡️ 📗 📒 Sets a player's game mode. [Wiki](https://minecraft.wiki/w/Commands/gamemode)</td></tr><tr><td>`/gamerule`</td><td>🛡️ 📗 📒 Sets or queries a game rule value. [Wiki](https://minecraft.wiki/w/Commands/gamerule)</td></tr><tr><td>`/give`</td><td>🛡️ 📗 📒 Gives an item to a player. [Wiki](https://minecraft.wiki/w/Commands/give)</td></tr><tr><td>`/help`</td><td>📗 Provides a list of commands or help for a command. [Wiki](https://minecraft.wiki/w/Commands/help)</td></tr><tr><td>`/item`</td><td>🛡️ 📒 Manipulates items in inventories. [Wiki](https://minecraft.wiki/w/Commands/item)</td></tr><tr><td>`/jfr`</td><td>🛡️ 📗 📒 Start or stop a JFR profiler. [Wiki](https://minecraft.wiki/w/Commands/jfr)</td></tr><tr><td>`/kick`</td><td>🛡️ 📒 Kicks a player off a server. [Wiki](https://minecraft.wiki/w/Commands/kick)</td></tr><tr><td>`/kill`</td><td>🛡️ 📕 Kills entities (players, mobs, items, etc.). [Wiki](https://minecraft.wiki/w/Commands/kill)</td></tr><tr><td>`/list`</td><td>📗 Lists players on the server. [Wiki](https://minecraft.wiki/w/Commands/list)</td></tr><tr><td>`/locate`</td><td>🛡️ 📗 Locates closest structure, biome, or point of interest. [Wiki](https://minecraft.wiki/w/Commands/locate)</td></tr><tr><td>`/loot`</td><td>🛡️ 📗 Give a loot table to a selector or spawn a loot table. [Wiki](https://minecraft.wiki/w/Commands/loot)</td></tr><tr><td>`/me`</td><td>📗 Displays a message about the sender. [Wiki](https://minecraft.wiki/w/Commands/me)</td></tr><tr><td>`/msg, /tell, /w`</td><td>📗 Displays a private message to other players. [Wiki](https://minecraft.wiki/w/Commands/msg)</td></tr><tr><td>`/op`</td><td>🛡️ 📕 Grants operator status to a player. [Wiki](https://minecraft.wiki/w/Commands/op)</td></tr><tr><td>`/pardon`</td><td>🛡️ 📒 Removes players from the banlist. [Wiki](https://minecraft.wiki/w/Commands/pardon)</td></tr><tr><td>`/pardon-ip`</td><td>🛡️ 📒 Removes an IP address from the banlist. [Wiki](https://minecraft.wiki/w/Commands/pardon#pardon-ip)</td></tr><tr><td>`/particle`</td><td>🛡️ 📗 📒 Generates particles. [Wiki](https://minecraft.wiki/w/Commands/particle)</td></tr><tr><td>`/perf`</td><td>🛡️ 📗 Captures info and metrics about the game for 10 seconds. [Wiki](https://minecraft.wiki/w/Commands/perf)</td></tr><tr><td>`/place`</td><td>🛡️ 📗 📒 Used to place a configured feature, jigsaw, template, or structure at a given location. [Wiki](https://minecraft.wiki/w/Commands/place)</td></tr><tr><td>`/playsound`</td><td>🛡️ 📗Plays a sound. [Wiki](https://minecraft.wiki/w/Commands/playsound)</td></tr><tr><td>`/publish`</td><td>🛡️ 📒 Opens a single-player world to a local network. [Wiki](https://minecraft.wiki/w/Commands/publish)</td></tr><tr><td>`/recipe`</td><td>🛡️ 📗 📒 Gives or takes player recipes. [Wiki](https://minecraft.wiki/w/Commands/recipe)</td></tr><tr><td>`/reload`</td><td>🛡️ 📒 Reloads loot tables, advancements, and functions from disk. [Wiki](https://minecraft.wiki/w/Commands/reload)</td></tr><tr><td>`/return`</td><td>🛡️ 📗 📒 Control execution flow inside functions. [Wiki](https://minecraft.wiki/w/Commands/return)</td></tr><tr><td>`/ride`</td><td>🛡️ 📗 Used to make entities ride other entities, stop entities from riding, make rides evict their riders, or summon rides or riders. [Wiki](https://minecraft.wiki/w/Commands/ride)</td></tr><tr><td>`/save-all`</td><td>🛡️ 📕 Saves the server to disk. [Wiki](https://minecraft.wiki/w/Commands/save-all)</td></tr><tr><td>`/save-off`</td><td>🛡️ 📕 Disables automatic server saves. [Wiki](https://minecraft.wiki/w/Commands/save-off)</td></tr><tr><td>`/save-on`</td><td>🛡️ 📕 Enables automatic server saves. [Wiki](https://minecraft.wiki/w/Commands/save-on)</td></tr><tr><td>`/say`</td><td>📗 Displays a message to multiple players. [Wiki](https://minecraft.wiki/w/Commands/say)</td></tr><tr><td>`/schedule`</td><td>🛡️ 📒 📕 Schedule the execution of a function. [Wiki](https://minecraft.wiki/w/Commands/schedule)</td></tr><tr><td>`/scoreboard`</td><td>🛡️ 📒 Manages scoreboard objectives and players. [Wiki](https://minecraft.wiki/w/Commands/scoreboard)</td></tr><tr><td>`/seed`</td><td>🛡️ 📗 Displays the world seed. [Wiki](https://minecraft.wiki/w/Commands/seed)</td></tr><tr><td>`/setblock`</td><td>🛡️ 📗 Changes a block to another block. [Wiki](https://minecraft.wiki/w/Commands/setblock)</td></tr><tr><td>`/setidletimeout`</td><td>🛡️ 📗 📒 Sets the time before idle players are kicked. [Wiki](https://minecraft.wiki/w/Commands/setidletimeout)</td></tr><tr><td>`/setworldspawn`</td><td>🛡️ 📒 Sets the world spawn. [Wiki](https://minecraft.wiki/w/Commands/setworldspawn)</td></tr><tr><td>`/spawnpoint`</td><td>🛡️ 📗 📒 Sets the spawn point for a player. [Wiki](https://minecraft.wiki/w/Commands/spawnpoint)</td></tr><tr><td>`/spectate`</td><td>🛡️ 📗 Force a spectating player to spectate an entity. [Wiki](https://minecraft.wiki/w/Commands/spectate)</td></tr><tr><td>`/spreadplayers`</td><td>🛡️ 📗 📒 Teleports entities to random locations. [Wiki](https://minecraft.wiki/w/Commands/spreadplayers)</td></tr><tr><td>`/stop`</td><td>🛡️ 📕 Stops the server. [Wiki](https://minecraft.wiki/w/Commands/stop)</td></tr><tr><td>`/stopsound`</td><td>🛡️ 📗 Stops a sound currently playing. [Wiki](https://minecraft.wiki/w/Commands/stopsound)</td></tr><tr><td>`/summon`</td><td>🛡️ 📗Summons an entity. [Wiki](https://minecraft.wiki/w/Commands/summon)</td></tr><tr><td>`/tag`</td><td>🛡️ 📗 Manages entity tags. [Wiki](https://minecraft.wiki/w/Commands/tag)</td></tr><tr><td>`/team`</td><td>🛡️ 📗 Controls teams. [Wiki](https://minecraft.wiki/w/Commands/team)</td></tr><tr><td>`/teammsg, /tm`</td><td>📗 Sends a message to the player's team. [Wiki](https://minecraft.wiki/w/Commands/teammsg)</td></tr><tr><td>`/teleport, /tp`</td><td>🛡️ 📗 📒 Teleports entities. [Wiki](https://minecraft.wiki/w/Commands/teleport)</td></tr><tr><td>`/tellraw`</td><td>🛡️ 📗 Displays a JSON-formatted message to players. [Wiki](https://minecraft.wiki/w/Commands/tellraw)</td></tr><tr><td>`/time`</td><td>🛡️ 📗 Changes or queries the world's game time. [Wiki](https://minecraft.wiki/w/Commands/time)</td></tr><tr><td>`/title`</td><td>🛡️ 📗 Manages screen titles. [Wiki](https://minecraft.wiki/w/Commands/title)</td></tr><tr><td>`/trigger`</td><td>📗 Manages trigger scoreboards. [Wiki](https://minecraft.wiki/w/Commands/trigger)</td></tr><tr><td>`/weather`</td><td>🛡️ 📗 Sets the weather. [Wiki](https://minecraft.wiki/w/Commands/weather)</td></tr><tr><td>`/whitelist`</td><td>🛡️ 📗 📒 Manages the server whitelist. [Wiki](https://minecraft.wiki/w/Commands/whitelist)</td></tr><tr><td>`/worldborder`</td><td>🛡️ 📒 Manages the world border. [Wiki](https://minecraft.wiki/w/Commands/worldborder)</td></tr></tbody></table>

# Targeting Entities

## Target Selectors

### Overview

Target selectors are used in many commands in place of usernames or UUIDs to **target multiple entities that match a broad criteria**.

<table id="bkmrk-target-selector-enti"><thead><tr><th>**Target Selector**</th><th>**Entities Selected**</th></tr></thead><tbody><tr><td>`@p`</td><td>Nearest player</td></tr><tr><td>`@r`</td><td>One random player</td></tr><tr><td>`@a`</td><td>All players, living and dead</td></tr><tr><td>`@e`</td><td>All loaded, living entities</td></tr><tr><td>`@s`</td><td>Entity executing the current command</td></tr></tbody></table>

### Tips

- **Use the most specific selector available**. For example, if you want to target the nearest player, use `@p` instead of `@a[sort=nearest, limit=1]`. This is because some selectors such as `@e` will create a massive list of entities, which can unintentionally cause lag.

## Selector Arguments

### Overview

**Selector arguments** can be used to filter entities from the selection even further. These allow you to narrow your selection based on various attributes. There are a wide variety of arguments, but those detailed below are the most important.

<table id="bkmrk-target-selector-argu"><thead><tr><th>**Target Selector Argument**</th><th>**Filter By...**</th></tr></thead><tbody><tr><td>`x`, `y`, `z`</td><td>[coordinate](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_coordinate)</td></tr><tr><td>`distance`</td><td>[distance](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_distance)</td></tr><tr><td>`dx`, `dy`, `dz`</td><td>[volume dimensions](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_volume)</td></tr><tr><td>`x_rotation`</td><td>[vertical rotation (pitch)](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_vertical_rotation)</td></tr><tr><td>`y_rotation`</td><td>[horizontal rotation (yaw)](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_horizontal_rotation)</td></tr><tr><td>`scores`</td><td>[scores](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_scores)</td></tr><tr><td>`tag`</td><td>[tag](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_tag)</td></tr><tr><td>`team`</td><td>[team](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_team)</td></tr><tr><td>`name`</td><td>[entity name](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_name)</td></tr><tr><td>`type`</td><td>[entity type](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_type)</td></tr><tr><td>`predicate`</td><td>[predicate](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_predicate)</td></tr><tr><td>`nbt`</td><td>[nbt](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_nbt)</td></tr><tr><td>`level`</td><td>[experience level](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_experience_level)</td></tr><tr><td>`gamemode`</td><td>[gamemode](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_game_mode)</td></tr><tr><td>`advancements`</td><td>[advancements](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_advancements)</td></tr><tr><td>`limit`, `sort`</td><td>[selector limiting](https://minecraft.wiki/w/Target_selectors#Selecting_targets_with_a_limit)</td></tr></tbody></table>

### `distance=`

`distance` allows you to target entities within a specified *spherical range* in blocks. The entity will only be targeted if the origin of their hitbox (bottom center) is within the distance. This selector also limits the selection to the current dimension.

<table id="bkmrk-%40e%5Bdistance%3D1.5%5D-tar"><tbody><tr><td>`@e[distance=1.5]`</td><td>Target all entities **exactly 1.5 blocks** away.</td></tr><tr><td>`@a[distance=8..16]`</td><td>Target all players **8 to 16 blocks away, inclusive**.</td></tr><tr><td>`@p[distance=..40]`</td><td>Target the nearest player **up to 40 blocks away, inclusive**. Note that if the first number is excluded, the command interprets it as 0.</td></tr><tr><td>`@r[distance=12..]`</td><td>Target a random player **at least 12 blocks away, inclusive**. Note that if the second number is excluded, the command will interpret it as infinity, which will include all entities in the dimension.</td></tr></tbody></table>

### `dx=`, dy=, dz=

`dx`, `dy`, and `dz` select by rectangular volume from the command origin. These specify the distance from the origin rather than a global coordinate and extend asymmetrically. Unlike `distance`, volume selection targets entities if any part of their hitbox is inside the selection.

<table id="bkmrk-%40a%5Bdx%3D3%2C-dy%3D5%2C-dz%3D2%5D"><tbody><tr><td>`@a[dx=3, dy=5, dz=2]`</td><td>Target all players whose **hitbox lies within the volume extending 4 blocks east, 6 blocks up, and 3 blocks south** of the execution spot.</td></tr></tbody></table>

### scores=

`scores` selects by matching scoreboard objectives. Targeted entities must have all specified scores on all specified objectives. You also can specify an integer range (inclusive) similar to the `distance` selector.

<table id="bkmrk-%40e%5Bscores%3D%7Bmyscore1%3D"><tbody><tr><td>`@e[scores={myScore1=4}]`</td><td>Target all entities with a **score of exactly 4 in myScore1**.</td></tr><tr><td>`@p[scores={myScore2=..5, myScore3=10..}]`</td><td>Target the nearest player with **at most a score of 5 in myScore2 *and* at least a score of 10 in myScore3**.</td></tr></tbody></table>

### tag=

`tag` targets entities with a specified tag. These tags can be applied with the `/tag` command.

<table id="bkmrk-%40a%5Btag%3Dmytag1%5D-targe"><tbody><tr><td>`@a[tag=myTag1]`</td><td>Target all players **with the myTag1 tag**.</td></tr><tr><td>`@p[tag=!myTag2]`</td><td>Target the nearest player who **does not have the myTag2 tag**.</td></tr><tr><td>`@e[tag=myTag3, tag=myTag4, tag=!myTag5]`</td><td>Target all entities who **have the myTag3 tag, *and* the myTag4 tag, *and* do not have the myTag5 tag**.</td></tr><tr><td>`@r[tag=]`</td><td>Target a random player that has **no tags**.</td></tr><tr><td>`@s[tag=!]`</td><td>Target the current executing entity if they have **at least one tag**.</td></tr></tbody></table>

### team=

`team` targets entities who are on a specified team, and works in nearly the exact same way as `tag`. Note that using this argument will only target living entities.

<table id="bkmrk-%40a%5Bteam%3Dmyteam1%5D-tar"><tbody><tr><td>`@a[team=myTeam1]`</td><td>Target all players who **are in myTeam1**. Note that, in this instance, this argument can only be stated once since entities can only belong to one team.</td></tr><tr><td>`@p[team=!myTeam2, team=!myTeam3]`</td><td>Target all players who **are not in myTeam2 or myTeam3**. Note that this argument *can* be used more than once.</td></tr><tr><td>`@r[team=]`</td><td>Target a random player who **is not on a team**.</td></tr><tr><td>`@a[team=!]`</td><td>Target all players who **are on any team**.</td></tr></tbody></table>

### nbt=

`nbt` targets entities with specified NBT data, and as such is the most resource-intensive arguments. **Avoid using NBT unless ABSOLUTELY necessary as misusing it has a high potential to cause lag.**

<table id="bkmrk-%40a%5Bnbt%3D%7Binventory%3A-%5B"><tbody><tr><td>`@a[nbt={Inventory: [{id: "minecraft:iron_sword}]}]`</td><td>Target all players who **have an iron sword in their inventory**.</td></tr><tr><td>`@e[nbt={DeathLootTable: "myLootTable"}]`</td><td>Target all entities who **have the myLootTable death loot table**.</td></tr></tbody></table>

### limit=

`limit` can be used to limit the number of targeted entities.

Note that `limit` **and** `sort` **are most commonly used together**, as they can significantly improve the performance of selectors.

<table id="bkmrk-%40e%5Blimit%3D15%5D-target-"><tbody><tr><td>`@e[limit=15]`</td><td>Target **at most 15 entities**.</td></tr><tr><td>`@a[limit=4]`</td><td>Target at **most 4 players**.</td></tr></tbody></table>

### sort=

Finally, `sort` can be used to sort through the currently selected entities. `sort` has four possible values: `arbitrary`, `nearest`, `furthest`, and `random`. `arbitrary` is the default, selecting sorting entities based off of their time of creation. `nearest` and `furthest` sort by increasing and decreasing distance respectively, and `random` is... well, random.

Note that `limit` **and** `sort` **are most commonly used together**, as they can significantly improve the performance of selectors.

<table id="bkmrk-%40e%5Bsort%3Dnearest%5D-tar"><tbody><tr><td>`@e[sort=nearest]`</td><td>Target all entities, **selecting the nearest entities first**.</td></tr><tr><td>`@a[limit=4, sort=random]`</td><td>Target at **most 4 random players**.</td></tr></tbody></table>

### Tips

- **Selector arguments — or lack thereof — can make commands dangerous**! When you run certain commands, always remember that selectors are made to target *everything* that matches the criteria. Ensure your arguments are specific and correct, and run them by a more experienced staff member if you are unsure.
- **x, y, z can almost always be replaced by** `execute positioned <x> <y> <z>`. You will rarely run into an instance where the former is necessary.
- **Use selector arguments to optimize your selector. Order matters**! The following list is the recommended order of selector arguments. **At the very least, specify type and limit**, but use all that apply: 
    - `sort=`
    - `limit=`
    - `type=`
    - `gamemode=`
    - `gamemode=!`
    - `distance=`
    - `x_rotation=` / `y_rotation=`
    - `x, y, z` / `dx, dy, dz`
    - `level=`
    - `team=`
    - `team=!`
    - `type=!`
    - `tag=`
    - `tag=!`
    - `name=`
    - `name=!`
    - `predicate=`
    - `predicate=!`
    - `scores=`
    - `advancements=`
    - `nbt=`
    - `nbt=!`

# Important Commands

The following commands listed are important to know during your time as a staff member. Here is a quick guide to understanding the command layout:

- `text` - Text that should be written how it is shown.
- `<keyword>` - A specific option from a list of valid entries.
- `[keyword]` - An optional entry.
- `(option1 | option2)` - A required "or", meaning you *must* use one field or another.
- `[option1 | option2]` - An optional "or", meaning you *may* use one field or another if you wish.

## `/ban, ban-ip`

Bans a player or ip from the server. The player does not have to be online to be banned. In addition to being added to the banlist, they will be kicked automatically.

<table id="bkmrk-%2Fban-%7C-ban-ip-%3Cplaye"><tbody><tr><td>`/ban | ban-ip <player> [reason]`</td><td>Syntax for the command.</td></tr><tr><td>`ban jjj_North`</td><td>Kick and ban jjj\_North.</td></tr><tr><td>`ban-ip 7pencilsharpen3r Hacking`</td><td>Kick and ban 7pencilsharpen3r's IP for hacking, preventing any account from joining from that IP.</td></tr></tbody></table>

## `/clear`

Clears an item or all items from a player or valid selector entities.

<table id="bkmrk-%2Fclear-%3Cselector%3E-%5Bi"><tbody><tr><td>`/clear <selector> [item] [amount]`</td><td>Syntax for the command.</td></tr><tr><td>`clear mmaurice196`</td><td>Clear every item from mmaurice196.</td></tr><tr><td>`clear @a[team=SkyWing] cooked_beef 12`</td><td>Clear 12 steak from every player on the SkyWing team.</td></tr><tr><td>`clear CalamityLegendz diamond_sword{Enchantments: [{id: "minecraft:sharpness", lvl: 1000s}]}`</td><td>Clear all diamond swords with Sharpness 1000 from CalamityLegendz.</td></tr><tr><td>`clear @s iron_sword{titanium: 1b} 0`</td><td>Check if the executing entity has an iron sword with the NBT "titanium:1b".   
*By setting the quantity to 0, we can instead check if the selected entities have the item declared. This is mainly only useful in data packs, but you may find certain use cases for this feature.*</td></tr></tbody></table>

## `/datapack`

Enable or disable a data pack or list all data packs.

<table id="bkmrk-%2Fdatapack-%3C%28disable-"><tbody><tr><td>`/datapack <(disable | enable) <name> | list>`</td><td>Syntax for the command.</td></tr><tr><td>`datapack disable "file/Ender Dragon"`</td><td>Disable the "Ender Dragon" data pack.</td></tr><tr><td>`datapack enable "file/Example Datapack"`</td><td>Load the "Example Datapack" data pack.</td></tr><tr><td>`datapack list`</td><td>List all data packs.</td></tr></tbody></table>

## `/execute`

Execute is an extremely powerful command that allows you to execute multiple subcommands to modify given parameters, check for different variables, and fork the command execution. While you do not need to know every in and out of this command, there may be cases in which you will utilise it, so it is important to know the basics!

- `align <axes>` - aligns the position of the command execution with the block position along the given axes. This allows you to to align to the edges of a block.
- `anchored <anchor>` - sets the position of the command execution to either the eyes or feet of the executor.
- `as <targets>` - sets the executor without changing the location. You must use `at` to set the location. If multiple targets are selected, the following subcommands will apply to all targets
- `at <targets>` - sets the location of the execution without changing the executor. You must use `as` to set the executor.
- `facing <pos | <targets> <anchor>>` - sets the execution rotation.
- `in <dimension>` - sets the execution dimension. This will account for distance scaling in the nether and custom dimensions.
- `on <attacker | controller | leasher | origin | owner | passengers | target | vehicle>` - sets the executor based on relation to the current executor.
- `positioned <pos | as | over>` - sets the execution position.
- `rotated <rot | as <targets>>` - sets the execution rotation.
- `summon <entity>` - summons a new entity at the execution position and sets it as the executor.
- `(if|unless) biome <pos> <biome>` - checks for the given biome at a given position.
- `(if|unless) block <pos> <block>` - checks for the given block at a given position.
- `(if|unless) blocks <start> <end> <destination> (all|masked)` - compares blocks in two volumes.
- `(if|unless) data <block | entity | storage> <source> <path>` - checks whether the targeted block, entity or storage has any data tag for a given path.
- `(if|unless) dimension <dimension>` - checks if the execution is in a matching dimension.
- `(if|unless) function <function>` - checks a function or function tag and matches the return value(s). If a tag is given, all functions run regardless of the results of prior functions.
- `(if|unless) entity <entities>` - checks whether one or more entities exist.
- `(if|unless) loaded <pos>` - checks if chunks at a given position is fully loaded.
- `(if|unless) predicate <predicate>` - checks whether the predicate successes. This is primarily a data pack feature.
- `(if|unless) score <target> <targetObjective> <operation | matches <target> <targetObjective>>` - checks whether a score has the specific relation to another score, or whether it is in a given range.
- `store (result|success) <block | bossbar | entity | score | storage>` - stores either the result (i.e. save the number of items in a chest to a scoreboard objective) or the success (i.e. checking if a chest has a specific item in it) of the following command.

Minecraft will process subcommands in the order they are arranged in the command. Note that `execute ... run execute ... run ...` has no effect as it is essentially the same as `execute ... run`.

<table id="bkmrk-%2Fexecute-%3Csubcommand"><tbody><tr><td>`/execute <subcommands> [run <command>]`</td><td>Syntax for the command.</td></tr><tr><td>`execute run say Hello, world!`</td><td>The same thing as simply using "/say Hello, world!" Not very practical...</td></tr><tr><td>`execute as @e[type=pig] run say I'm a pig!`</td><td>Change the executing entity to all pigs... ...then force them to use "/say I'm a pig!". Nice!</td></tr><tr><td>`execute in the_end if block 0 64 0 beacon as @e[type=armor_stand, distance=0..] at @s facing 0 64 0 run tp ^ ^ ^1`</td><td>Change the command location to The End... ...then check if there is a beacon at 0 64 0... (if there is no beacon at 0 64 0, the command will stop here entirely!) ...then change the executing entity to all armor stands in the current dimension... ...then change the location of the command execution to the executing entity — all armor stands in the current dimension... ...then change the direction the command is running to face 0 64 0... ...then teleport the executing entities forwards one block. Phew.</td></tr></tbody></table>

## `/give`

Gives the targeted selectors an item with optional NBT attached.

<table id="bkmrk-%2Fgive-%3Cselector%3E-%3Cit"><tbody><tr><td>`/give <selector> <item> [nbt]`</td><td>Syntax for the command.</td></tr><tr><td>`give BogTheMudWing potato`</td><td>Give BogTheMudWing 1 potato.</td></tr><tr><td>`give @a[limit=10, sort=random] diamond{display: {Name: "Actual Coal"}}`</td><td>Give 10 random players 1 diamond named "Actual Coal".</td></tr></tbody></table>

## `/kick`

Terminates a player's connection to the server.

<table id="bkmrk-%2Fkick-%3Cplayer%3E-%5Breas"><tbody><tr><td>`/kick <player> [reason]`</td><td>Syntax for the command.</td></tr><tr><td>`kick FlawLessII`</td><td>Kick FlawLessII from the server.</td></tr><tr><td>`kick s0meb0dysupply Profanity`</td><td>Kick s0meb0dysupply from the server for profanity.</td></tr></tbody></table>

## `/pardon, pardon-ip`

Remove a player or an IP from the banlist, regranting said player or IP access to the server.

<table id="bkmrk-%C2%A0-%C2%A0-%2Fpardon-%7C-pardon"><thead><tr><th> </th><th> </th></tr></thead><tbody><tr><td>`/pardon | pardon-ip <player>`</td><td>Syntax for the command.</td></tr><tr><td>`pardon jjj_North`</td><td>Pardon jjj\_North.</td></tr><tr><td>`pardon-ip 7pencilsharpen3r`</td><td>Pardon 7pencilsharpen3r's IP.</td></tr></tbody></table>

## `/scoreboard`

Add objectives, get player scores, manipulate scoreboard objectives, and much more. This command is **very** extensive and powerful!

<table id="bkmrk-%2Fscoreboard-%3Cobjecti"><tbody><tr><td>`/scoreboard <objective | players> ...`</td><td>Syntax for the command.</td></tr><tr><td>`scoreboard objectives add player_health health`</td><td>Create a scoreboard objective called "player\_health" that tracks... the players' health.</td></tr><tr><td>`scoreboard objectives modify player_health displayname {"text": "Player Health", "color": "red"}`</td><td>Modify the "player\_health" scoreboard to appear as "Player Health" in red.</td></tr><tr><td>`scoreboard players get Julibeau WhiteKills`</td><td>Get Julibeau's score in the objective WhiteKills.</td></tr></tbody></table>

## `/summon`

Summons an entity.

<table id="bkmrk-%2Fsummon-%3Centity%3E-%5B%3Cp"><tbody><tr><td>`/summon <entity> [<posX posY posZ> [NBT]]`</td><td>Syntax for the command.</td></tr><tr><td>`summon ender_dragon`</td><td>Summons an Ender Dragon.</td></tr><tr><td>`summon iron_golem ~ ~ ~ {NoAI: 1b}`</td><td>Summons an iron golem at the current position with no AI.</td></tr><tr><td>`summon cow ^ ^ ^10 {active_effects: [{id: "minecraft:levitation", amplifier: 10, duration: 200}], DeathLootTable: "chests/abandoned_mineshaft"}`</td><td>Summons a cow 10 blocks forwards from the player's current direction, with Levitation 11 for 10 seconds, that will drop loot from an abandoned mineshaft... wow.</td></tr></tbody></table>

## `/tellraw`

Announce a [highly-customizable message](https://www.minecraftjson.com/) to a selector using JSON.

<table id="bkmrk-%2Ftellraw-%3Cselector%3E-"><tbody><tr><td>`/tellraw <selector> [string or JSON]`</td><td>Syntax for the command.</td></tr><tr><td>`tellraw FrazzledDingo "Welcome to the server!"`</td><td>Show the message "Welcome to the server!" to FrazzledDingo.</td></tr><tr><td>`tellraw @a[team=Green] {"text": "You are on the Green team!", "color": "dark_green"}`</td><td>Show the message "Welcome to the server!" to all players on the Green team.</td></tr><tr><td>`tellraw @a[distance=..30] [{"selector": "@r[distance=..30]", "color": "red"}, {"text": " won the ", "color": "gray"}, {"text": "Grand Raffle", "color": "gold"}, {"text": "!", "color": "gray"}]`</td><td>Show the message "&lt;random player up to 30 blocks away&gt; won the Grand Raffle!" to all players up to 30 blocks away.</td></tr></tbody></table>

## `/whitelist`

Add or remove a player from the whitelist, enable or disable the whitelist, or reload the whitelist.

<table id="bkmrk-%2Fwhitelist-%3Cadd-%7C-on" style="width: 100%; height: 212.4px;"><tbody><tr style="height: 46.6px;"><td style="width: 44.9345%; height: 46.6px;">`/whitelist <add | on | off | reload | remove> <player>`</td><td style="width: 54.9464%; height: 46.6px;">Syntax for the command.</td></tr><tr style="height: 29.8px;"><td style="width: 44.9345%; height: 29.8px;">`whitelist add RaspberryConflict`</td><td style="width: 54.9464%; height: 29.8px;">Adds RaspberryConflict to the whitelist.</td></tr><tr style="height: 29.8px;"><td style="width: 44.9345%; height: 29.8px;">`whitelist remove known__clams`</td><td style="width: 54.9464%; height: 29.8px;">Removes known\_\_clams from the whitelist.</td></tr><tr style="height: 46.6px;"><td style="width: 44.9345%; height: 46.6px;">`whitelist on`</td><td style="width: 54.9464%; height: 46.6px;">Activates the whitelist, allowing only those on the whitelist to join the server.</td></tr><tr style="height: 29.8px;"><td style="width: 44.9345%; height: 29.8px;">`whitelist off`</td><td style="width: 54.9464%; height: 29.8px;">Deactivates the whitelist, allowing any player to join the server.</td></tr><tr style="height: 29.8px;"><td style="width: 44.9345%; height: 29.8px;">`whitelist reload`</td><td style="width: 54.9464%; height: 29.8px;">Reloads the whitelist.</td></tr></tbody></table>

# EssentialsX

[EssentialsX](https://essinfo.xeya.me/commands.html)<span style="white-space: pre-wrap;"> is a comprehensive general-purpose plugin. It provides teleportation, moderation tools, gameplay enhancements, homes, warps, sign shops, kits, and everything in between.</span>

## <span style="white-space: pre-wrap;">Teleportation</span>

The most important feature to TNW provided by EssentialsX is its teleportation commands.

### Teleport Safety

On TNW, Essentials is configured to enforce teleport safety. On default settings, Essentials will try to find a safe location for a player to teleport to if the desired location is not safe. For example, if you are trying to teleport to a block that is on fire, Essentials will instead teleport you one block to the side. This is normally desired behavior, but the bounded areas of TNW create potential for out-of-bounds exploits using safety teleporting.

To prevent this, Essentials will not execute a teleport unless the location is absolutely safe. A teleport will fail if:

- The location is not air.
- The location has no block to stand on.
- The location is on a dangerous block (like a magma block).

This causes some problems that will be addressed in the following sections.

### Homes

The home system allows players to save their favorite locations so that they can teleport to them again later. These locations are called *homes*. A player can set a home with the `/sethome` command.

```
/sethome [<name>]
```

Once a home is set, it is forever stored for that player. Players have a configurable limit to how many homes they can set. On TNW, **players may only set up to five homes**. The creation of homes is disabled in the void dimension and specific regions, but allowed everywhere else. The creation of homes within a region can be disabled by revoking access to the commands `/sethome` and `/esethome`.

Players may teleport to their homes using the `/home` command.

```
/home [<name>]
```

The teleportation occurs instantly at no cost and with no cool-down time.

<p class="callout warning">A home teleport will fail if the location is not safe. This can be caused by the removal or addition of blocks around the teleportation area. Typically, Essentials does not notify this to the user. The home should be re-set.</p>

### <span style="white-space: pre-wrap;">Teleport Ask</span>

<span style="white-space: pre-wrap;">Essentials has a teleport-ask system that allows players to teleport to each other. A player may request to teleport to another player with the `/tpask` command.</span>

```
/tpask <player>
```

More commonly, the aliased `/tpa` command is used instead. As with all Essentials commands, fuzzy search is implemented on the player selection for both usernames and display names, so instead of typing the username `fffsgfdf`, you could type the beginning of the display name `Seav`.

Alternatively, a player can ask a player to teleport to their own location with the `/tpahere` or `/tphere` commands.

This will send a teleport request to that player. The receiving player can then accept the request with `/tpaccept` or deny the request with `/tpdeny`. The asking player can also cancel their outgoing request with `/tpacancel`.

Once accepted, the teleport will occur instantly at no cost and with no cool-down time.

### Last Location

When an Essentials teleport occurs or on death, the location a player teleported from is stored as their last location. Players may return to their last location using the `/back` command. Likewise, they may execute `/back` again to return to where they were before using `/back`. This can be potentially dangerous for highly-controlled areas like events where the locations of players must be carefully controlled.

Bog's Trial Admin Event, Waves of Enemies, was an ongoing event in which players would enter an arena and fight waves of monsters. After death, players would respawn in the viewing area. However, players were able to use the `/back` command to re-enter the arena after death.

Always consider last location when creating a controlled region.

<p class="callout info">A player's last location can be set manually using Dreamvisitor's `/setback` command. See [Dreamvisitor](https://docs.woftnw.org/books/admin-handbook/page/dreamvisitor "Dreamvisitor") for more details.</p>

## Sign Editing

It is possible to edit signs with formatting using the command `/editsign`.

```
/editsign set <line number> <text>
/editsign clear <line number>
/editsign copy <line number>
/editsign paste <line number>
```

## Sudo

Named after the sudo program, the `/sudo` command allows you to execute a command as another player.

```
/sudo <player> <command...>
```

This does **not** act the same as `/execute as <player> run <command...>`. Sudo effectively makes the player run a command, rather than executing a command with the player as the contextual executor. It acts exactly as if the player had run the command themselves, so their permissions, data, and location will be taken into account and any command feedback will be sent to the player, not to you.

## Moderation Tools

Essentials includes a set of moderation tools beyond the `/kick` and `/ban` commands that Minecraft provides.

The `/mute` command prevents players from sending messages.

### SocialSpy

SocialSpy allows moderators to view private messages and mail between users.

# Plugins

# Overview

<span style="white-space: pre-wrap;">There are a variety of plugins that add important or convenient commands. Keep in mind that </span>****most of the commands added with our plugins are not important enough to memorize; some plugins might not even add commands at all!****

# Coreprotect

[CoreProtect](https://docs.coreprotect.net)<span style="white-space: pre-wrap;"> is our data logging and anti-griefing tool. We use this plugin to rollback areas, check for player actions, and backup the server.</span>

<table id="bkmrk-command-description-" style="width: 100%;"><colgroup><col style="width: 29.6738%;"></col><col style="width: 70.3262%;"></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/co help</span>`

</td><td>🛡️ 📗 Display a list of commands in-game.

</td></tr><tr><td>`<span class="editor-theme-code">/co inspect</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Enable the inspector. Type the command again to disable it. You can also use just </span>

`<span class="editor-theme-code">/co i</span>`

.

</td></tr><tr><td>`<span class="editor-theme-code">/co lookup</span>`

</td><td>🛡️ 📗 Check for specific actions by a player, in an area, or even in the past set amount of time.

</td></tr><tr><td>`<span class="editor-theme-code">/co rollback</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a rollback. Uses the same parameters as </span>

`<span class="editor-theme-code">/co lookup</span>`

<span style="white-space: pre-wrap;">. </span>

**Rollbacks can be used to revert player actions.**

</td></tr><tr><td>`<span class="editor-theme-code">/co restore</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a restore. Uses the same parameters as </span>

`<span class="editor-theme-code">/co lookup</span>`

<span style="white-space: pre-wrap;">. </span>

**Restoring can be used to undo rollbacks or to restore player actions.**

</td></tr><tr><td>`<span class="editor-theme-code">/co purge t:<time> r:<world></span>`

</td><td>🛡️ 📕 Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.

</td></tr><tr><td>`<span class="editor-theme-code">/co reload</span>`

</td><td>🛡️ 📗 Reloads the configuration file.

</td></tr><tr><td>`<span class="editor-theme-code">/co status</span>`

</td><td>🛡️ 📗 Displays the plugin status and version information.

</td></tr><tr><td>`<span class="editor-theme-code">/co consumer</span>`

</td><td>🛡️ 📗 Console command to pause or resume consumer queue processing.

</td></tr></tbody></table>

<table id="bkmrk-parameter-descriptio" style="width: 100%;"><colgroup><col style="width: 15.0155%;"></col><col style="width: 84.9845%;"></col></colgroup><thead><tr><td>Parameter</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">u:<user></span>`

</td><td>Specifies a single user or multiple users.

</td></tr><tr><td>`<span class="editor-theme-code">t:<time></span>`

</td><td>Specifies weeks, days, hours, minutes, and/or seconds. Time amounts can be combined, and decimals may be used.

</td></tr><tr><td>`<span class="editor-theme-code">r:<radius></span>`

</td><td>Specifies a spherical radius centered at your current location.

</td></tr><tr><td>`<span class="editor-theme-code">a:<action></span>`

</td><td>Specifies an action to check.

</td></tr><tr><td>`<span class="editor-theme-code">i:<include></span>`

</td><td>Specifies a block, item, or entity that the operation must include.

</td></tr><tr><td>`<span class="editor-theme-code">e:<exclude></span>`

</td><td>Specified a block, item, or entity that the operation must not include.

</td></tr><tr><td>`<span class="editor-theme-code">#<parameter></span>`

</td><td>Add a hashtag to the end of your command to perform additional actions.

</td></tr></tbody></table>

# Dreamvisitor

[Dreamvisitor](https://github.com/stonley890/Dreamvisitor/wiki)<span style="white-space: pre-wrap;">, created by Bog specifically for the server, has a variety of features. It serves as an all-in-one utility plugin and Discord bot. Below are several commands. You can view them all on the </span>[Dreamvisitor wiki](https://github.com/stonley890/Dreamvisitor/wiki/Commands).

<table id="bkmrk-command-description--1"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/aradio <message>...</span>`

</td><td>🛡️ 📗 Send a message to all operators.

</td></tr><tr><td>`<span class="editor-theme-code">/discord</span>`

</td><td><span style="white-space: pre-wrap;">📗 Toggle whether messages from the Discord chat bridge appear in your chat. This can also be adjusted with </span>

`<span class="editor-theme-code">/dvset</span>`

.

</td></tr><tr><td>`<span class="editor-theme-code">/dreamvisitor manage</span>`

</td><td>🛡️ 📕 View or modify the Dreamvisitor configuration.

</td></tr><tr><td>`<span class="editor-theme-code">/dvset</span>`

</td><td>📗 Manage your Dreamvisitor settings.

</td></tr><tr><td>`<span class="editor-theme-code">/hub [entities]</span>`

</td><td>🛡️ 📗 Teleport yourself entities to the hub location. If you have an entity on a lead, the entity will teleport with you below the normal hub location.

</td></tr><tr><td>`<span class="editor-theme-code">/invswap</span>`

</td><td>🛡️ 📗 Swap between two different inventories.

</td></tr><tr><td>`<span class="editor-theme-code">/itemblacklist</span>`

</td><td>🛡️ 📒 Open the item ban list inventory GUI.

</td></tr><tr><td>`<span class="editor-theme-code">/moonglobe remove <players></span>`

</td><td>🛡️ 📗 Remove moon globes from players.

</td></tr><tr><td>`<span class="editor-theme-code">/moonglobe add <players> <location> <maxDistance></span>`

</td><td>🛡️ 📗 Give players moon globes.

</td></tr><tr><td>`<span class="editor-theme-code">/panic</span>`

</td><td>🛡️ 📕 Kick all players and sets the player limit override to 0.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel cancel</span>`

</td><td>🛡️ 📗 Cancel your current parcel delivery.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations add <position> <name> <weight> <home_tribe></span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Add a delivery location. </span>

`<span class="editor-theme-code">name</span>`

<span style="white-space: pre-wrap;"> cannot contain spaces, but underscores will be replaced with spaces when displayed to players. </span>

`<span class="editor-theme-code">weight</span>`

<span style="white-space: pre-wrap;"> determines the likelihood of the location being chosen. At 0, it will never be chosen. At 4, it is quite likely to be chosen. </span>

`<span class="editor-theme-code">home_tribe</span>`

<span style="white-space: pre-wrap;"> determines only which names will appear on parcels to or from this location.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations remove <name></span>`

</td><td>🛡️ 📒 Remove a delivery location.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations list</span>`

</td><td>🛡️ 📗 List all mail delivery locations.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery terminal <players></span>`

</td><td>🛡️ 📗 Give a player a parcel or allow players to deliver parcels to a location within 10 blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery add <players> <start> <end></span>`

</td><td>🛡️ 📗 Create deliveries for players.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery remove <players></span>`

</td><td>🛡️ 📗 Cancel deliveries for players.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery list</span>`

</td><td>🛡️ 📗 List ongoing deliveries.

</td></tr><tr><td>`<span class="editor-theme-code">/pausebypass add <players></span>`

</td><td>🛡️ 📗 Allow players to chat even when chat is paused.

</td></tr><tr><td>`<span class="editor-theme-code">/pausechat</span>`

</td><td>🛡️ 📕 Suppresses messages from players and the Discord chat bridge.

</td></tr><tr><td>`<span class="editor-theme-code">/playerlimit [newLimit]</span>`

</td><td>🛡️ 📕 Override the server player limit.

</td></tr><tr><td>`<span class="editor-theme-code">/radio <message></span>`

</td><td>🛡️ 📗 Send a message to all other players who can access the radio.

</td></tr><tr><td>`<span class="editor-theme-code">/sandbox <player> [on|off]</span>`

</td><td>🛡️ 📒 Manage players' access to Sandbox Mode.

</td></tr><tr><td>`<span class="editor-theme-code">/setback <players> [location] [rotation] [world]</span>`

</td><td>🛡️ 📗 Set a player's last EssentialsX location. If no world is specified, the current world is assumed. If no rotation is specified, none will be applied. If no location is specified, the execution position will be used.

</td></tr><tr><td>`<span class="editor-theme-code">/setmotd [newMotd...]]</span>`

</td><td>🛡️ 📗 Change or reset the server MOTD.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist add <player></span>`

</td><td>🛡️ 📗 Add a player to the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist remove <player></span>`

</td><td>🛡️ 📗 Remove a player from the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist list</span>`

</td><td>🛡️ 📗 List all players on the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist on</span>`

</td><td>🛡️ 📗 Enable the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist off</span>`

</td><td>🛡️ 📗 Disable the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/synctime [world]</span>`

</td><td>🛡️ 📗 Sync time across all worlds.

</td></tr><tr><td>`<span class="editor-theme-code">/tagradio <tag> <message></span>`

</td><td>🛡️ 📗 Send a message to all players with a given tag.

</td></tr><tr><td>`<span class="editor-theme-code">/togglepvp</span>`

</td><td>🛡️ 📗 Toggle whether PvP is enabled or disabled.

</td></tr><tr><td>`<span class="editor-theme-code">/tribeupdate <players></span>`

</td><td>🛡️ 📗 Update the roles of a player based on their tribe.

</td></tr><tr><td>`<span class="editor-theme-code">/unwax</span>`

</td><td>🛡️ 📗 Unwax the sign you are looking at.

</td></tr><tr><td>`<span class="editor-theme-code">/user <player></span>`

</td><td>🛡️ 📗 Get details of a player, online or offline.

</td></tr><tr><td>`<span class="editor-theme-code">/zoop</span>`

</td><td>🛡️ 📗 Sends a fake leave message to Discord and hides you from the list command.

</td></tr></tbody></table>

## ****Item Blacklist****

`<span class="editor-theme-code">/itemblacklist</span>`<span style="white-space: pre-wrap;"> will open a chest-like inventory. Items placed in this container will be saved in their place and players with matching items will have them automatically removed from non-operator player inventories. </span>****This removal is permanent.****<span style="white-space: pre-wrap;"> Be cautious of items you add. </span>****Items are only removed if the data is an exact match.****<span style="white-space: pre-wrap;"> If you put a potato into the blacklist GUI, potatoes that have been renamed or enchanted will not be removed.</span>

![](https://raw.githubusercontent.com/Stonley890/ItemVoid/main/ItemVoidDemoSmall.GIF)

A demonstration of the item blacklist.

## ****Soft Whitelist****

<span style="white-space: pre-wrap;">The soft whitelist acts as a secondary whitelist that works much like Minecraft's built-in whitelist feature. This allows reducing the allowed players to a specified group while not modifying the main whitelist. Players with the </span>`<span class="editor-theme-code">dreamvisitor.nowhitelist</span>`<span style="white-space: pre-wrap;"> permission will always bypass the soft whitelist. </span>****Operators will always bypass the soft whitelist.****

The soft whitelist persists through restarts.

## ****Sandbox Mode****

****Sandbox Mode****<span style="white-space: pre-wrap;"> is a feature that allows administrators to safely allow players to use Creative Mode. When a player is put into Sandbox Mode, their inventory is swapped, and they are put into Creative Mode with the following restrictions:</span>

- They cannot access containers.
- They cannot drop items.
- They cannot use spawn eggs.
- They cannot teleport.

<span style="white-space: pre-wrap;">A player with the </span>`<span class="editor-theme-code">dreamvisitor.sandbox</span>`<span style="white-space: pre-wrap;"> permission — usually an admin — must be online for Sandbox Mode to remain active. If all admins leave, all players in Sandbox Mode will have it removed, restoring their inventories. If players leave the game while in Sandbox Mode, they will remain in Sandbox Mode when they rejoin unless there are no admins. When a Sandboxed player joins, admins will be notified.</span>

## ****Pause Chat****

<span style="white-space: pre-wrap;">The </span>`<span class="editor-theme-code">/pausechat</span>`<span style="white-space: pre-wrap;"> command will stop all incoming chat messages from being broadcasted. It will also block messages from </span>`<span class="editor-theme-code">/me</span>`<span style="white-space: pre-wrap;"> and Discord pass-through. You can allow certain players to bypass this with </span>`<span class="editor-theme-code">/pausebypass</span>`<span style="white-space: pre-wrap;">. Players with the </span>`<span class="editor-theme-code">dreamvisitor.nopause</span>`<span style="white-space: pre-wrap;"> permission will always bypass chat pause. </span>****Operators will always bypass chat pause.****

Chat pause will persist through restarts.

## ****Moon Globes****

<span style="white-space: pre-wrap;">Moon Globes can be created with the </span>`<span class="editor-theme-code">moonglobe</span>`<span style="white-space: pre-wrap;"> command.</span>

<span style="white-space: pre-wrap;">A player may only have one moon globe at a time. Each moon globe has an origin and a maximum distance. By default, the maximum distance is 256 blocks. If a moon globe (not the player) moves beyond that distance, it will be removed. It will also be removed if the player moves to a different dimension. It will </span>**not**<span style="white-space: pre-wrap;"> be removed if the player disconnects, though it will disappear until the player reconnects. Moon globes are not saved, so they will be deleted upon a server shutdown.</span>

## ****Mail System****

Players can earn money by delivering mail. Players may interact with a mail terminal to receive a parcel. They will be assigned a location to deliver it to, and they must interact with the terminal at that location without teleportation to get a reward based on the distance.

<span style="white-space: pre-wrap;">When a player interacts with a terminal (a command block with the command </span>`<span class="editor-theme-code">/parcel terminal @p</span>`<span style="white-space: pre-wrap;">), Dreamvisitor will choose a random end location with each location weighted by an inherent, preset weight, and the distance from the start location, weighing closer locations higher than further ones. The distance weight can be multiplied using the </span>`<span class="editor-theme-code">mailDeliveryLocationSelectionDistanceWeightMultiplier</span>`<span style="white-space: pre-wrap;"> option in </span>`<span class="editor-theme-code">config.yml</span>`.

The player will be given an enchanted book that they must keep with them until they complete the delivery. The book will be addressed to a random name. There is a 45% chance that the name will be of the tribe associated with the start location, a 45% chance that the name will be of the tribe associated with the end location, and a 10% chance that the name will be of a random tribe. A random lore string will also be chosen from a preset pool. If the player does not have the parcel when they reach the destination location, they delivery will not be completed and they must re-obtain the parcel or cancel the delivery. If a player cancels their deliver while they still have the parcel, they will keep the parcel.

<span style="white-space: pre-wrap;">When a player completes a delivery, the parcel will be removed from them, and they will be given a reward based on the distance between the start and end location, multiplied by </span>`<span class="editor-theme-code">mailDistanceToRewardMultiplier</span>`<span style="white-space: pre-wrap;"> in </span>`<span class="editor-theme-code">config.yml</span>`.

## ****Discord Economy****

Dreamvisitor has an economy system. Users may purchase items from a shop using currency that can be used.

The shop consists of up to 25 items. Items have an ID, name, description, price, sale percent, quantity, and max allowed quantity. The ID is randomly chosen upon item creation. The name and description are chosen upon creation. The price represent the regular price of the item. It must not be negative. The sale percent is a number form 0 to 100 that represents the percent removed from the price. The quantity represents the number of items available in the shop (or infinity if -1). If the item is purchased, the quantity will be reduced by one. When at zero, the item can no longer be purchased. Max allowed quantity represents the maximum number of the item a user can hold in their inventory.

Items also have the following flags:

- enabled - Whether the item appears in the shop and can be purchased.
- giftingEnabled - Whether the item can be transferred by one user to another.
- useDisabled - Whether the item can be used.
- useOnPurchase - Whether the item is automatically used when purchased. Does not override useDisabled.

Items can do the any of following on use:

- Add roles
- Remove roles
- Add parent groups (requires LuckPerms)
- Remove parent groups (requires LuckPerms)
- Execute commands via the console

Users can gain currency by claiming daily rewards and working.

<span style="white-space: pre-wrap;">Users can claim a daily reward every 24 hours. If they claim their reward before 48 hours after their last, they can build a streak. The daily reward is configured by </span>`<span class="editor-theme-code">dailyBaseAmount</span>`<span style="white-space: pre-wrap;"> and the steak multiplier is configured by </span>`<span class="editor-theme-code">dailyStreakMultiplier</span>`<span style="white-space: pre-wrap;"> in </span>`<span class="editor-theme-code">config.yml</span>`.

<span style="white-space: pre-wrap;">Users can work once every hour. The work reward is configured by </span>`<span class="editor-theme-code">workReward</span>`.

# EssentialsX

[EssentialsX](https://essinfo.xeya.me/commands.html)<span style="white-space: pre-wrap;"> is the most comprehensive general-purpose plugin available. It provides teleportation, moderation tools, gameplay enhancements, homes, warps, sign shops, kits, and everything in between. Being a general-purpose plugin, it doesn't excel at any specific feature or function, but its versatility means there are a lot of commands to consider. Here are the most important for an admin:</span>

<table id="bkmrk-command-description--2"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/editsign <set|clear|copy|paste> [line number] [text]</span>`

</td><td>🛡️ 📗 Edits a sign that the player is looking at.

</td></tr><tr><td>`<span class="editor-theme-code">/msgtoggle [player] [on|off]</span>`

</td><td>📗 Blocks receiving all private messages.

</td></tr><tr><td>`<span class="editor-theme-code">/mute <player> [datediff]</span>`

</td><td>📗 Mutes or unmutes a player.

</td></tr><tr><td>`<span class="editor-theme-code">/spawner <mob> [delay]</span>`

</td><td>🛡️ 📗 Change the mob type of a spawner.

</td></tr><tr><td>`<span class="editor-theme-code">/powertool [l:|a:|r:|c:|d:][command] [arguments] ({player} can be replaced by name of a clicked player.)</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Assigns a command to the item in hand. Use </span>

`<span class="editor-theme-code">c:</span>`

<span style="white-space: pre-wrap;"> as the command to make a chat macro. Use </span>

`<span class="editor-theme-code">a:</span>`

<span style="white-space: pre-wrap;"> to append multiple commands. Use </span>

`<span class="editor-theme-code">r:</span>`

<span style="white-space: pre-wrap;"> to remove a single command. Use </span>

`<span class="editor-theme-code">l:</span>`

<span style="white-space: pre-wrap;"> to list all power tools Use </span>

`<span class="editor-theme-code">d:</span>`

<span style="white-space: pre-wrap;"> to remove all power tools.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/gc</span>`

</td><td>🛡️ 📗 Reports memory, uptime and tick info.

</td></tr><tr><td>`<span class="editor-theme-code">/enderchest [player], /ec</span>`

</td><td>🛡️ 📗 Lets you see inside an ender chest.

</td></tr><tr><td>`<span class="editor-theme-code">/powertooltoggle</span>`

</td><td>🛡️ 📗 Enables or disables all current powertools.

</td></tr><tr><td>`<span class="editor-theme-code">/speed [type] <speed> [player]</span>`

</td><td>🛡️ 📗 Change your walk or fly speed.

</td></tr><tr><td>`<span class="editor-theme-code">/whois <nickname|playername></span>`

</td><td>🛡️ 📗 Displays player information.

</td></tr><tr><td>`<span class="editor-theme-code">/disposal</span>`

</td><td>🛡️ 📗 Opens a portable disposal menu.

</td></tr><tr><td>`<span class="editor-theme-code">/condense [itemname]</span>`

</td><td>🛡️ 📗 Condenses items into more compact blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/book [title|author [name]]</span>`

</td><td>🛡️ 📗 Allows reopening and editing of sealed books.

</td></tr><tr><td>`<span class="editor-theme-code">/mail [read|clear|clear [number]|send [to] [message]|sendtemp [to] [expire time] [message]|sendall [message]]</span>`

</td><td>📗 Manages inter-player, intra-server mail.

</td></tr><tr><td>`<span class="editor-theme-code">/pweather [list|reset|storm|sun|clear] [player|*]</span>`

</td><td>🛡️ 📗 Adjust a player's weather.

</td></tr><tr><td>`<span class="editor-theme-code">/ignore <player></span>`

</td><td>📗 Toggles ignoring other players.

</td></tr><tr><td>`<span class="editor-theme-code">/near [playername] [radius]</span>`

</td><td>📗 Lists the players nearby or around a player.

</td></tr><tr><td>`<span class="editor-theme-code">/invsee <player> [armor]</span>`

</td><td>🛡️ 📗 See and/or edit the inventory of other players.

</td></tr><tr><td>`<span class="editor-theme-code">/socialspy [player] [on|off]</span>`

</td><td>🛡️ 📗 Toggles if you can see msg/mail commands in chat.

</td></tr><tr><td>`<span class="editor-theme-code">/ptime [list|reset|day|night|dawn|17:30|4pm|4000ticks] [player|*]</span>`

</td><td>🛡️ 📗 Adjust player's client time. Add @ prefix to fix.

</td></tr><tr><td>`<span class="editor-theme-code">/home [player:]<name></span>`

</td><td>📗 Teleport to your home.

</td></tr><tr><td>`<span class="editor-theme-code">/vanish [player] [on|off]</span>`

</td><td>🛡️ 📗 Hide yourself from other players.

</td></tr><tr><td>`<span class="editor-theme-code">/god [player] [on|off]</span>`

</td><td>🛡️ 📗 Enables your godly powers.

</td></tr><tr><td>`<span class="editor-theme-code">/skull [owner]</span>`

</td><td>🛡️ 📗 Get the player head item with your skin or a skin of a specified player, or change the skin of the head you're holding.

</td></tr><tr><td>`<span class="editor-theme-code">/broadcast <msg></span>`

</td><td>🛡️ 📗 Broadcasts a message to the entire server.

</td></tr><tr><td>`<span class="editor-theme-code">/itemdb <item></span>`

</td><td>🛡️ 📗 Searches for an item.

</td></tr><tr><td>`<span class="editor-theme-code">/itemlore <add\|set\|clear> [text\|line] [text]</span>`

</td><td>🛡️ 📗 Edit the lore of an item.

</td></tr><tr><td>`<span class="editor-theme-code">/itemname [name]</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Renames the item you're currently holding. Leave </span>

`<span class="editor-theme-code">[name]</span>`

<span style="white-space: pre-wrap;"> empty to reset. You can add in color codes when you have permission to.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/eco <give|take|set|reset> <player> <amount></span>`

</td><td>🛡️ 📒 Manages a player's economy.

</td></tr><tr><td>`<span class="editor-theme-code">/feed [player]</span>`

</td><td>🛡️ 📗 Satisfy the hunger of a specified player.

</td></tr><tr><td>`<span class="editor-theme-code">/heal [player]</span>`

</td><td>🛡️ 📗 Heals you or the given player.

</td></tr><tr><td>`<span class="editor-theme-code">/nick [player] <nickname|off></span>`

</td><td>🛡️ 📗 Change your nickname or that of another player.

</td></tr></tbody></table>

## ****Powertools****

`<span class="editor-theme-code">/powertool</span>`<span style="white-space: pre-wrap;"> allows you to assign a command to an item. Pressing the attack button (left mouse button by default) will execute the command. The argument </span>`<span class="editor-theme-code">{player}</span>`<span style="white-space: pre-wrap;"> will insert the name of a clicked player. There are five flags you can prepend to the argument that change the behavior of </span>`<span class="editor-theme-code">/powertool. c:</span>`<span style="white-space: pre-wrap;"> will create a chat macro. Instead of running a command, the powertool will send a chat message. Use </span>`<span class="editor-theme-code">a:</span>`<span style="white-space: pre-wrap;"> to append multiple commands. Use </span>`<span class="editor-theme-code">r:</span>`<span style="white-space: pre-wrap;"> to remove a single command from a powertool. Use </span>`<span class="editor-theme-code">l:</span>`<span style="white-space: pre-wrap;"> to list all power tools and their commands. Use </span>`<span class="editor-theme-code">d:</span>`<span style="white-space: pre-wrap;"> to remove all power tools.</span>

<table id="bkmrk-%C2%A0-%C2%A0-%2Fpowertool-setbl"><colgroup><col></col><col></col></colgroup><thead><tr><td><span style="white-space: pre-wrap;"> Command</span>

</td><td><span style="white-space: pre-wrap;"> Description</span>

</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/powertool setblock ~ ~-1 ~ stone</span>`

</td><td>Executes 'setblock ~ ~-1 ~ stone' on click.

</td></tr><tr><td>`<span class="editor-theme-code">/powertool effect give {player} regeneration</span>`

</td><td>Gives regeneration to a player that you click on.

</td></tr><tr><td>`<span class="editor-theme-code">/powertool a:effect give {player} saturation</span>`

</td><td>Adds a subsequent command to give saturation to a clicked player

</td></tr></tbody></table>

# GriefDefender

[GriefDefender](https://docs.griefdefender.com/wiki)<span style="white-space: pre-wrap;"> is the claim and anti-grief system we use that allows players to claim and protect 2D and 3D land plots.</span>

<table id="bkmrk-command-description--3"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/abandon <all|claim|top></span>`

</td><td>📒 📕 Abandon a specific claim, or all of your owned claims.

</td></tr><tr><td>`<span class="editor-theme-code">/abandon world [world]</span>`

</td><td>🛡️ 📕 Abandon all claims in the current world or a specified world.

</td></tr><tr><td>`<span class="editor-theme-code">/buyblocks <count></span>`

</td><td>📗 Purchases additional claim blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/gd buy claim</span>`

</td><td>📗 View a list of claims for sale.

</td></tr><tr><td>`<span class="editor-theme-code">/contractclaim <amount></span>`

</td><td>📗 Contracts/shrinks the claim from the direction you are facing.

</td></tr><tr><td>`<span class="editor-theme-code">/claimcreate <radius> [type]</span>`

</td><td>📗 Creates a claim around the player of the given type.

</td></tr><tr><td>`<span class="editor-theme-code">/expandclaim <amount></span>`

</td><td>📗 Expands the claim in the direction you are facing.

</td></tr><tr><td>`<span class="editor-theme-code">/gd claim farewell <clear|message></span>`

</td><td>📗 Sets a message to display when a player leaves the claim.

</td></tr><tr><td>`<span class="editor-theme-code">/gd claim greeting <clear|message></span>`

</td><td>📗 Sets a message to display when a player enters the claim.

</td></tr><tr><td>`<span class="editor-theme-code">/claimnotifications</span>`

</td><td>📗 Enable/disable greeting and farewell messages on trusted claims.

</td></tr><tr><td>`<span class="editor-theme-code">/gd claim we <claim|clear|select></span>`

</td><td>📗 Used to manage GD claims with WorldEdit.

</td></tr><tr><td>`<span class="editor-theme-code">/cuboid</span>`

</td><td>📗 Toggles 3D claiming on and off.

</td></tr><tr><td>`<span class="editor-theme-code">/modeadmin</span>`

</td><td>🛡️ 📗 Enables admin claim mode with the claiming tool.

</td></tr><tr><td>`<span class="editor-theme-code">/modebasic</span>`

</td><td>📗 Enables basic claim mode with the claiming tool.

</td></tr><tr><td>`<span class="editor-theme-code">/modesubdivide</span>`

</td><td>📗 Enables subdivide claim mode with the claiming tool.

</td></tr><tr><td>`<span class="editor-theme-code">/modetown</span>`

</td><td>📗 Enables town claim mode with the claiming tool.

</td></tr><tr><td>`<span class="editor-theme-code">/gd player info <player> <world>|<player>|[<world>]</span>`

</td><td>🛡️ 📗 Gets information about a player and their claim blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/sellblocks <blocks></span>`

</td><td>📗 Sell your claim blocks for server money.

</td></tr><tr><td>`<span class="editor-theme-code">/gd sell claim <price></span>`

</td><td>📗 Puts your claim up for sale at the set price. To disable sale, set the price to -1 or set ForSale setting in /claiminfo to false.

</td></tr><tr><td>`<span class="editor-theme-code">/transferblocks <player> <amount></span>`

</td><td>📗 Transfers the player's claim blocks to another player.

</td></tr><tr><td>`<span class="editor-theme-code">/trapped</span>`

</td><td>📗 Teleports the player to a safe location if they are stuck and unable to build.

</td></tr><tr><td>`<span class="editor-theme-code">/trust|trustall <player|group|list> <trusttype></span>`

</td><td>📗 View and manage claim permissions for this claim or all claims you own.

</td></tr><tr><td>`<span class="editor-theme-code">/untrust|untrustall <player|group></span>`

</td><td>📗 Revoke a player or group's access to this claim or all claims you own.

</td></tr></tbody></table>

## ****Claim Types****

- [****Basic****](https://docs.griefdefender.com/wiki/basic/Claim-Types.html#basic): Default claim type used for users.
- [****Town****](https://docs.griefdefender.com/wiki/basic/Claim-Types.html#town): Can house other basic claims, similarly to how basic or admin claims can house subdivisions.
- [****Admin****](https://docs.griefdefender.com/wiki/basic/Claim-Types.html#admin): Has no size restrictions, does not cost anything to create, can be created around any existing claim, can be rented, and are only manageable by administrators.
- [****Wilderness****](https://docs.griefdefender.com/wiki/basic/Claim-Types.html#wilderness): The default claim around the world that is not owned by any player.
- [****Subdivision****](https://docs.griefdefender.com/wiki/basic/Claim-Types.html#subdivision): Used to subdivide top level claims such as basic/admin/town into smaller areas.

## ****Trust Types****

- ****Resident****: Player/group can create (sub?)claims. Includes Accessor trust.
- ****Accessor****: Player/group can enter your claim and use your bed.
- ****Container****: Player/group can access containers, crops, animals, beds, buttons, and levers in your claim.
- ****Builder****: Player/group can build in your claim.
- ****Manager****: Player/group can do all of the above and use this command.

# LuckPerms

[LuckPerms](https://luckperms.net/wiki/Command-Usage%22%3ELuckPerms)<span style="white-space: pre-wrap;"> is a permissions plugin for Minecraft servers. It allows server admins to control what features players can use by creating groups and assigning permissions.</span>

<table id="bkmrk-command-description--4"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/lp editor</span>`

</td><td>🛡️ 📗 Provides a link to a web editor. This editor is used to manage permissions.

</td></tr></tbody></table>

# SignShop

[SignShop](https://dev.bukkit.org/projects/signshop/pages/signs)<span style="white-space: pre-wrap;"> is an economy-dependent plugin that allows players to exchange goods with an installed economy plugin (for us, this is Vault). As there are few, if any, commands to know for SignShop usage, below is a table of sign types available with SignShop instead.</span>

<table id="bkmrk-sign-description-%5Bbu" style="width: 100%;"><colgroup><col style="width: 15.0156%;"></col><col style="width: 84.9844%;"></col></colgroup><thead><tr><td>Sign</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">[Buy]</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">[Sell]</span>`

</td><td>Buy / sell an item from the shop chest for the price specified on the 4th line.

</td></tr><tr><td>`<span class="editor-theme-code">[Trade]</span>`

</td><td>Trades one set of items for another, 2 chests required.

</td></tr><tr><td>`<span class="editor-theme-code">[Share]</span>`

</td><td>Link to another SignShop to split profits, lines 2 and 3 are for the other players, line 4 is for % amounts (e.g. "25/50" for 75% to others).

</td></tr><tr><td>`<span class="editor-theme-code">[Bank]</span>`

</td><td>Link to another SignShop to make the shop take/give money to a bank account, The bank account is specified on line 2 of the sign (Note: you must own the bank account for this to work).

</td></tr><tr><td>`<span class="editor-theme-code">[Donate]</span>`

</td><td>Gives an item to the shop chest.

</td></tr><tr><td>`<span class="editor-theme-code">[DonateHand]</span>`

</td><td>Donates the item in your hand to the shop chest.

</td></tr><tr><td>`<span class="editor-theme-code">[Dispose]</span>`

</td><td>Takes the item in your hand and safely decomposes the material.

</td></tr><tr><td>`<span class="editor-theme-code">[Slot]</span>`

</td><td>Gives a random item from the selected chest items (not the entire inventory) to the player.

</td></tr><tr><td>`<span class="editor-theme-code">[DeviceOn]</span>`

</td><td>Turns a lever on.

</td></tr><tr><td>`<span class="editor-theme-code">[DeviceOff]</span>`

</td><td>Turns a lever off.

</td></tr><tr><td>`<span class="editor-theme-code">[Toggle]</span>`

</td><td>Toggles a lever.

</td></tr><tr><td>`<span class="editor-theme-code">[Device]</span>`

</td><td>Temporarily turns on a lever.

</td></tr><tr><td>`<span class="editor-theme-code">[DeviceItem]</span>`

</td><td>Temporarily turns on a lever using items as payment.

</td></tr><tr><td>`<span class="editor-theme-code">[Jukebox]</span>`

</td><td>Allows players to create jukeboxes by placing music discs in a chest.

</td></tr><tr><td>`<span class="editor-theme-code">[Restricted]</span>`

</td><td>Makes it so only certain permission groups can use the linked SignShop (listed on lines 2, 3, and 4).

</td></tr><tr><td>`<span class="editor-theme-code">[gBuy]</span>`

</td><td>🛡️ Buy an item from the shop chest, but the owner receives no money.

</td></tr><tr><td>`<span class="editor-theme-code">[gSell]</span>`

</td><td>🛡️ Sell an item to the shop chest, and the player receives money, but not from the owner.

</td></tr><tr><td>`<span class="editor-theme-code">[iBuy]</span>`

</td><td>🛡️ Buy an item from the "shop", money goes to no one, infinite items.

</td></tr><tr><td>`<span class="editor-theme-code">[iSell]</span>`

</td><td>🛡️ Sell an item to the "shop", infinite money, item disappears.

</td></tr><tr><td>`<span class="editor-theme-code">[iTrade]</span>`

</td><td>🛡️ Trades one set of items for another, infinite stock.

</td></tr><tr><td>`<span class="editor-theme-code">[Class]</span>`

</td><td>🛡️ Takes the user's inventory and replaces it with items from a chest, infinite stock.

</td></tr><tr><td>`<span class="editor-theme-code">[Kit]</span>`

</td><td>🛡️ Gives the buyer a set of items once (infinite stock), must be reset using ResetKit sign before they can use it again.

</td></tr><tr><td>`<span class="editor-theme-code">[ResetKit]</span>`

</td><td>🛡️ Allows a player to use a Kit sign again.

</td></tr><tr><td>`<span class="editor-theme-code">[iBuyXP]</span>`

</td><td>🛡️ Buy the number of XP levels on the third line of the sign.

</td></tr><tr><td>`<span class="editor-theme-code">[iSellXP]</span>`

</td><td>🛡️ Sell the number of XP levels on the third line of the sign.

</td></tr><tr><td>`<span class="editor-theme-code">[iXPBuy]</span>`

</td><td>🛡️ Buy an item using raw XP points on the third line of the sign.

</td></tr><tr><td>`<span class="editor-theme-code">[iXPSell]</span>`

</td><td>🛡️ Sell an item using raw XP points on the third line of the sign.

</td></tr><tr><td>`<span class="editor-theme-code">[iSlot]</span>`

</td><td>🛡️ Gives a random item from the selected chest items with infinite stock.

</td></tr><tr><td>`<span class="editor-theme-code">[Day]</span>`

</td><td>🛡️ Turns the time to day.

</td></tr><tr><td>`<span class="editor-theme-code">[Night]</span>`

</td><td>🛡️ Turns the time to night.

</td></tr><tr><td>`<span class="editor-theme-code">[Rain]</span>`

</td><td>🛡️ Turns on rain + thunder.

</td></tr><tr><td>`<span class="editor-theme-code">[ClearSkies]</span>`

</td><td>🛡️ Turns off rain + thunder.

</td></tr><tr><td>`<span class="editor-theme-code">[Repair]</span>`

</td><td>🛡️ Repairs the current item.

</td></tr><tr><td>`<span class="editor-theme-code">[Heal]</span>`

</td><td>🛡️ Fully heals the player.

</td></tr><tr><td>`<span class="editor-theme-code">[Enchant]</span>`

</td><td>🛡️ Sells the enchantments from the item in the chest.

</td></tr><tr><td>`<span class="editor-theme-code">[Disenchant]</span>`

</td><td>🛡️ Removes enchantments from an item.

</td></tr><tr><td>`<span class="editor-theme-code">[TpToOwner]</span>`

</td><td>🛡️ An example of a custom sign for running commands.

</td></tr><tr><td>`<span class="editor-theme-code">[Command]</span>`

</td><td>🛡️ Allows players to run commands on the 2nd and 3rd lines of the sign.

</td></tr><tr><td>`<span class="editor-theme-code">[UserCommand]</span>`

</td><td>🛡️ Allows players to run commands on the 2nd and 3rd lines of the sign as if they typed it themselves.

</td></tr><tr><td>`<span class="editor-theme-code">[Promote]</span>`

</td><td>🛡️ Promotes players to the permission group listed on the 2nd line of the sign.

</td></tr></tbody></table>

# spark

[spark](https://spark.lucko.me/docs/Command-Usage)<span style="white-space: pre-wrap;"> (yes, the </span>**s**<span style="white-space: pre-wrap;"> is not capitalized) is a performance monitoring tool.</span>

<table id="bkmrk-command-description--5"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/spark profiler</span>`

</td><td>🛡️ 📗 Used to start, stop, or view information on a profiler. Profilers are used to create digestible information on how well the server is running.

</td></tr><tr><td>`<span class="editor-theme-code">/spark tps</span>`

</td><td>🛡️ 📗 Prints information about the servers TPS (ticks per second) rate and CPU usage.

</td></tr><tr><td>`<span class="editor-theme-code">/spark health</span>`

</td><td>🛡️ 📗 Generates a health report for the server, including TPS, CPU, Memory and Disk Usage.

</td></tr><tr><td>`<span class="editor-theme-code">/spark ping [--player <username>]</span>`

</td><td>🛡️ 📗 Prints information about average (or specific) player ping.

</td></tr><tr><td>`<span class="editor-theme-code">/spark tickmonitor</span>`

</td><td>🛡️ 📗 Controls the tick monitoring system.

</td></tr><tr><td>`<span class="editor-theme-code">/spark gc</span>`

</td><td>🛡️ 📗 Prints information about the servers GC (garbage collection) history.

</td></tr><tr><td>`<span class="editor-theme-code">/spark gcmonitor</span>`

</td><td>🛡️ 📗 Toggles the GC (garbage collection) monitoring system on or off.

</td></tr><tr><td>`<span class="editor-theme-code">/spark heapsummary</span>`

</td><td>🛡️ 📗 Generates a new memory (heap) dump summary and upload it to the viewer.

</td></tr><tr><td>`<span class="editor-theme-code">/spark heapdump</span>`

</td><td>🛡️ 📗 Generates a new heapdump (.hprof snapshot) file and saves to the disk.

</td></tr><tr><td>`<span class="editor-theme-code">/spark activity</span>`

</td><td>🛡️ 📗 Prints information about recent activity performed by spark.

</td></tr></tbody></table>

# WorldEdit

[WorldEdit](https://worldedit.enginehub.org/en/latest/)<span style="white-space: pre-wrap;"> is a terrain editing plugin that allows operators to move and shape large quantities of blocks. We recommend using </span>[WorldEdit CUI](https://www.curseforge.com/minecraft/mc-mods/worldeditcui-fabric)<span style="white-space: pre-wrap;"> for some helpful visual information when using this tool. This guide will cover the most common commands. To find more in-depth information, see the </span>[WorldEdit Documentation Hub](https://worldedit.enginehub.org/en/latest/commands/).

## Basic Commands

<table id="bkmrk-command-description--6"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">//wand</span>`

</td><td>🛡️ 📗 Gives the player a wand (wooden axe). Left click to select the first desired position, right click to select the second.

</td></tr><tr><td>`<span class="editor-theme-code">//undo [#]</span>`

</td><td>🛡️ 📗 Reverses a chosen number of WorldEdit commands. Defaults to 1.

</td></tr><tr><td>`<span class="editor-theme-code">//redo [#]</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Reverses a chosen number of </span>

`<span class="editor-theme-code">//undo</span>`

<span style="white-space: pre-wrap;"> commands. Defaults to 1.</span>

</td></tr><tr><td>`<span class="editor-theme-code">//pos1|pos2</span>`

<span style="white-space: pre-wrap;">, </span>

`<span class="editor-theme-code">//1|2</span>`

</td><td>🛡️ 📗 Sets first and second positions to your current location respectively without the wand.

</td></tr><tr><td>`<span class="editor-theme-code">//set <block></span>`

</td><td>🛡️ 📗 📒 Sets the current selection to the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//replace <from> <to></span>`

</td><td>🛡️ 📗 📒 Replaces the target block in a selection to the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//replacenear <radius> <from> <to></span>`

</td><td>🛡️ 📒 Replaces the target block in the radius to the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//copy</span>`

</td><td>🛡️ 📗 Copies all blocks in a selection to the clipboard.

</td></tr><tr><td>`<span class="editor-theme-code">//cut</span>`

</td><td>🛡️ 📗 Cuts all blocks in a selection to the clipboard.

</td></tr><tr><td>`<span class="editor-theme-code">//paste</span>`

</td><td>🛡️ 📒 📕 Pastes all blocks in the clipboard relative to the player's position.

</td></tr><tr><td>`<span class="editor-theme-code">//clear clipboard</span>`

</td><td>🛡️ 📗 Clears the clipboard.

</td></tr><tr><td>`<span class="editor-theme-code">//rotate <amount></span>`

</td><td>🛡️ 📗 Rotates the contents of the clipboard with the given angle (multiples of 90).

</td></tr><tr><td>`<span class="editor-theme-code">//flip <direction></span>`

</td><td>🛡️ 📗 Flips the contents of the clipboard across the given direction or the direction the player is facing.

</td></tr><tr><td>`<span class="editor-theme-code">//move <amount></span>`

</td><td>🛡️ 📗 📒 Moves all blocks in the selection to the chosen distance relative to the direction the player is facing.

</td></tr></tbody></table>

## Tool Commands

<table id="bkmrk-command-description--7"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">//shift <amount></span>`

</td><td>🛡️ 📗 📒 Shifts the selection a given amount.

</td></tr><tr><td>`<span class="editor-theme-code">//expand <amount></span>`

</td><td>🛡️ 📗 Expands the selection a given amount.

</td></tr><tr><td>`<span class="editor-theme-code">//contract <amount></span>`

</td><td>🛡️ 📗 Contracts the selection a given amount.

</td></tr><tr><td>`<span class="editor-theme-code">//sel</span>`

</td><td>🛡️ 📗 Deselects the selection.

</td></tr><tr><td>`<span class="editor-theme-code">//count <target></span>`

</td><td>🛡️ 📗 Counts the number of blocks in a selection.

</td></tr><tr><td>`<span class="editor-theme-code">//size</span>`

</td><td>🛡️ 📗 Provides information about the selection.

</td></tr><tr><td>`<span class="editor-theme-code">//drain <radius></span>`

</td><td>🛡️ 📗 Drains water and lava in the given radius.

</td></tr><tr><td>`<span class="editor-theme-code">//fixwater|fixlava <radius></span>`

</td><td>🛡️ 📗 Levels water or lava in the given radius.

</td></tr><tr><td>`<span class="editor-theme-code">/butcher <radius></span>`

</td><td>🛡️ 📗 📒 Kills mobs in the given radius.

</td></tr><tr><td>`<span class="editor-theme-code">/up <amount></span>`

</td><td>🛡️ 📗 Teleports the player up on the y axis the given amount of blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/thru</span>`

</td><td>🛡️ 📗 Teleports the player through obstacles in the facing direction.

</td></tr><tr><td>`<span class="editor-theme-code">/give <player> debugstick 1</span>`

</td><td>🛡️ 📗 Gives the player a debug stick that can be used to easily rotate blocks.

</td></tr></tbody></table>

## Generation Commands

<table id="bkmrk-command-description--8"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">//stack <#></span>`

</td><td>🛡️ 📗 Repeats the content of the selection the chosen distance (#) relative to the direction the player is facing.

</td></tr><tr><td>`<span class="editor-theme-code">//schematic list</span>`

</td><td>🛡️ 📗 Lists available saved schematics.

</td></tr><tr><td>`<span class="editor-theme-code">//schematic load <name></span>`

</td><td>🛡️ 📗 Loads the chosen schematic into the clipboard.

</td></tr><tr><td>`<span class="editor-theme-code">//schematic paste</span>`

</td><td>🛡️ 📒 Pastes the schematic currently in the clipboard.

</td></tr><tr><td>`<span class="editor-theme-code">//schematic save <name></span>`

</td><td>🛡️ 📗 Saves the current selection as a schematic with the chosen name.

</td></tr><tr><td>`<span class="editor-theme-code">//schematic delete <name></span>`

</td><td>🛡️ 📗 Deletes the chosen saved schematic.

</td></tr><tr><td>`<span class="editor-theme-code">//hollow <thickness> <block></span>`

</td><td>🛡️ 📗 Hollows out the object in the selection with the given wall thickness and block.

</td></tr><tr><td>`<span class="editor-theme-code">//walls <block></span>`

</td><td>🛡️ 📗 Creates walls around the sides of the selection with the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//cyl <block> <radius> <height></span>`

</td><td>🛡️ 📗 Creates a cylinder of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//hcyl <block> <radius> <height></span>`

</td><td>🛡️ 📗 Creates a hollow cylinder of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//sphere <block> <radius></span>`

</td><td>🛡️ 📗 Creates a sphere of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//hsphere <block> <radius></span>`

</td><td>🛡️ 📗 Creates a hollow sphere of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//pyramid <block> <radius></span>`

</td><td>🛡️ 📗 Creates a pyramid of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//hpyramid <block> <radius></span>`

</td><td>🛡️ 📗 Creates a hollow pyramid of the specified size using the chosen block.

</td></tr><tr><td>`<span class="editor-theme-code">//fill <block></span>`

</td><td>🛡️ 📗 📒 Fills a hole or container with the given block.

</td></tr><tr><td>`<span class="editor-theme-code">//forest <type></span>`

</td><td>🛡️ 📗 Generates the specified type of forest in the selected region.

</td></tr><tr><td>`<span class="editor-theme-code">//snow <radius></span>`

</td><td>🛡️ 📗 Places snow in a given radius.

</td></tr></tbody></table>

## Brush Commands

<table id="bkmrk-command-description--9"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">//br sphere <block> <radius></span>`

</td><td>🛡️ 📗 Applies a sphere brush to the held tool. Right click to use the brush.

</td></tr><tr><td>`<span class="editor-theme-code">//br cyl <block> <radius> <height></span>`

</td><td>🛡️ 📗 Applies a cylinder brush to the held tool. Unlike the sphere, the cylinder brush has a height parameter along with a radius.

</td></tr><tr><td>`<span class="editor-theme-code">//br smooth <radius> <height></span>`

</td><td>🛡️ 📗 Applies a horizontal smoothing brush to the held tool.

</td></tr><tr><td>`<span class="editor-theme-code">//br deform <radius></span>`

</td><td>🛡️ 📗 Applies a deform brush to the held tool.

</td></tr><tr><td>`<span class="editor-theme-code">/br none/unbind</span>`

</td><td>🛡️ 📗 Unbinds the brush from the tool you are currently holding.

</td></tr><tr><td>`<span class="editor-theme-code">/mask <block></span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Applies or removes a mask to the selected brush. The brush will only affect the specified block until the mask is disabled using </span>

`<span class="editor-theme-code">/mask</span>`

<span style="white-space: pre-wrap;"> again.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/gmask <block></span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Sets a global mask for all brushes. The brush will only affect the specified block until the mask is disabled using </span>

`<span class="editor-theme-code">/gmask</span>`

<span style="white-space: pre-wrap;"> again.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/tracemask #solid</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Allows brush to work underwater. Run </span>

`<span class="editor-theme-code">/tracemask</span>`

<span style="white-space: pre-wrap;"> to disable.</span>

</td></tr></tbody></table>

## Flags

<table id="bkmrk-flag-description-%5B%25b"><colgroup><col></col><col></col></colgroup><thead><tr><td>Flag</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">[%block1,%block2,%block3,...]</span>`

</td><td>Percentage modifier that allows multiple blocks to be included in a command. The given percentage values must add up to 100% and are separated by a comma with no spaces. Exclude percentages for equal distribution. (e.g. /

`<span class="editor-theme-code">/replace stone 70%dirt,30%cobblestone</span>`

)

</td></tr><tr><td>`<span class="editor-theme-code">[facing=direction]</span>`

</td><td>Specifies where a directional block should face.

</td></tr><tr><td>`<span class="editor-theme-code">[-a]</span>`

</td><td>Ignore air blocks.

</td></tr><tr><td>`<span class="editor-theme-code">[-e]</span>`

</td><td>Include entities.

</td></tr><tr><td>`<span class="editor-theme-code">[-b]</span>`

</td><td>Include biomes.

</td></tr><tr><td>`<span class="editor-theme-code">[-m <block>]</span>`

</td><td>Excludes everything that isn't a given block.

</td></tr><tr><td>`<span class="editor-theme-code">[!]</span>`

</td><td>Prefixing any block with an exclamation point will exclude everything that comes after it. (e.g. &lt;code&gt;//replace !dirt stone&lt;/code&gt; will replace everything that is not dirt with stone.)

</td></tr><tr><td>`<span class="editor-theme-code">[*]</span>`

</td><td>Prefixing any block with an asterisk (\*) will set the given block in random directions.

</td></tr></tbody></table>

# WorldGuard

[WorldGuard](https://worldguard.enginehub.org/en/latest)<span style="white-space: pre-wrap;"> is a plugin that allows operators to create regions with specific game rules and functions. We recommend using </span>[WorldEdit CUI](https://www.curseforge.com/minecraft/mc-mods/worldeditcui-fabric)<span style="white-space: pre-wrap;"> for some helpful visual information when using this tool. This guide will cover the most common commands. To find more in-depth information, see the </span>[WorldGuard Documentation Hub](https://worldguard.enginehub.org/en/latest/).

## Basic Commands

<table id="bkmrk-command-description--10"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">//wand</span>`

</td><td>🛡️ 📗 Gives the player a wand (wooden axe). Left click to select the first desired position, right click to select the second.

</td></tr><tr><td>`<span class="editor-theme-code">//pos1|pos2</span>`

</td><td>🛡️ 📗 Sets first and second positions to your current location respectively without the wand.

</td></tr><tr><td>`<span class="editor-theme-code">/rg define <name></span>`

</td><td>🛡️ 📗 Creates a new region using the current selection.

</td></tr><tr><td>`<span class="editor-theme-code">/rg remove <name></span>`

</td><td>🛡️ 📒 📕 Deletes the given region. This cannot be undone.

</td></tr><tr><td>`<span class="editor-theme-code">/rg info <name></span>`

</td><td>🛡️ 📗 Provides information on the given region. Defaults to the region the player is currently inside if no name is specified. Manual selections and changes can be made in this menu.

</td></tr><tr><td>`<span class="editor-theme-code">/rg flags <name></span>`

</td><td>🛡️ 📗 Lists all region flags in the given region. Manual selections can be made in this menu.

</td></tr><tr><td>`<span class="editor-theme-code">/rg flag <name></span>`

</td><td>🛡️ 📗 📒 Allows or denies a specified game rule in the given region.

</td></tr><tr><td>`<span class="editor-theme-code">/rg setpriority</span>`

</td><td>🛡️ 📗 📒 Sets the priority of a given region. Higher number priorities override the permissions of lower number priorities.

</td></tr><tr><td>`<span class="editor-theme-code">/rg flag <name> deny-message <content></span>`

</td><td>🛡️ 📗 Sets the message players will receive when an action they attempt is blocked.

</td></tr><tr><td>`<span class="editor-theme-code">/rg flag <name> blocked-cmds <command></span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 📒 Blocks specific commands from being used in the given region. Additional commands can be added by separating with a comma (e.g. </span>

`<span class="editor-theme-code">/rg flag spawn blocked-cmd /tpa,/back,/tell</span>`

).

</td></tr></tbody></table>

## Flags

<span style="white-space: pre-wrap;">Flags are used to make changes to what can be edited by certain players. Note that there are three default permission groups: </span>`<span class="editor-theme-code">non-member</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">member</span>`<span style="white-space: pre-wrap;">, and </span>`<span class="editor-theme-code">owner</span>`<span style="white-space: pre-wrap;">. </span>****You do not need to set any flags to protect a region.****<span style="white-space: pre-wrap;"> Also note that flags are not player-specific. Setting </span>`<span class="editor-theme-code">block-break</span>`<span style="white-space: pre-wrap;"> to deny will prevent pistons, endermen, and any other mechanics that move or remove blocks from doing so because setting that flag denies access to </span>****members****.

<span style="white-space: pre-wrap;">A member is anything </span>**inside**<span style="white-space: pre-wrap;"> the region. By default, pistons will work inside the region, but pistons outside the region cannot push blocks inside because they are </span>**non-members**<span style="white-space: pre-wrap;">. Because players are non-members by default, you don't need to set any flags for protection, and it still allows members to function correctly. In specific cases, you may want to disallow any block modification whatsoever. What you want to do is to </span>****deny building for all permission groups.****<span style="white-space: pre-wrap;"> This is when you want to set </span>`<span class="editor-theme-code">build</span>`<span style="white-space: pre-wrap;"> to </span>`<span class="editor-theme-code">deny</span>`.

<span style="white-space: pre-wrap;">Region groups are powerful, but can be difficult to understand. Keep this in mind: Members are objects that exist/originate within the region. Non-members are objects that do not exist/originate within the region, including all players. Most flags, by default, unset, allow </span>**members**<span style="white-space: pre-wrap;"> but deny </span>**non-members**<span style="white-space: pre-wrap;">. Setting a flag to </span>`<span class="editor-theme-code">allow</span>`<span style="white-space: pre-wrap;"> or </span>`<span class="editor-theme-code">deny</span>`<span style="white-space: pre-wrap;"> applies that setting to both members and non-members.</span>

<table id="bkmrk-flag-description-pas" style="width: 100%;"><colgroup><col style="width: 16.6838%;"></col><col style="width: 83.3162%;"></col></colgroup><thead><tr><td>Flag</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">passthrough</span>`

</td><td><span style="white-space: pre-wrap;">📒 This flag is short for passthrough build'. It has nothing to do with movement. If not set (default), then the region protects it area. If set to </span>

`<span class="editor-theme-code">deny</span>`

<span style="white-space: pre-wrap;">, then the region protects its area. If set to </span>

`<span class="editor-theme-code">allow</span>`

, then the region no longer protects its area.

</td></tr><tr><td>`<span class="editor-theme-code">build</span>`

</td><td><span style="white-space: pre-wrap;">📒 📕 Whether blocks can be mined or placed, whether doors, levers, etc. (but not inventories) can be used, whether entities and blocks can be interacted with, whether player versus player combat is permitted, whether sleeping in a bed is permitted, whether inventories can be accessed, whether vehicles (boats, minecarts) can be placed, etc. </span>

****This should not be used to protect a region!****

<span style="white-space: pre-wrap;"> Regions are automatically protected by the </span>

`<span class="editor-theme-code">passthrough</span>`

<span style="white-space: pre-wrap;"> flag.</span>

</td></tr><tr><td>`<span class="editor-theme-code">interact</span>`

</td><td>📗 Everything that involves 'using' a block or entity: Whether doors, levers, etc. (but not inventories) can be used, whether vehicles (including animals) can be mounted, etc.

</td></tr><tr><td>`<span class="editor-theme-code">block-break</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">block-place</span>`

</td><td>📗 Whether blocks can be mined / used.

</td></tr><tr><td>`<span class="editor-theme-code">use</span>`

</td><td>📗 Whether doors, levers, etc. (but not inventories) can be used.

</td></tr><tr><td>`<span class="editor-theme-code">damage-animals</span>`

</td><td>📗 Whether players can harm friendly animals (cows, sheep, etc).

</td></tr><tr><td>`<span class="editor-theme-code">chest-access</span>`

</td><td>📗 Whether inventories can be accessed.

</td></tr><tr><td>`<span class="editor-theme-code">ride</span>`

</td><td>📗 Whether vehicles (including animals) can be mounted.

</td></tr><tr><td>`<span class="editor-theme-code">pvp</span>`

</td><td>📗 Whether player versus player combat is permitted.

</td></tr><tr><td>`<span class="editor-theme-code">sleep</span>`

</td><td>📗 Whether sleeping in a bed is permitted.

</td></tr><tr><td>`<span class="editor-theme-code">respawn-anchors</span>`

</td><td>📗 Whether respawn anchors can be activated.

</td></tr><tr><td>`<span class="editor-theme-code">tnt</span>`

</td><td>📗 Whether TNT detonation or damage is permitted.

</td></tr><tr><td>`<span class="editor-theme-code">vehicle-place</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">vehicle-destroy</span>`

</td><td>📗 Whether vehicles (boats, minecarts) can be placed / destroyed.

</td></tr><tr><td>`<span class="editor-theme-code">lighter</span>`

</td><td>📗 Whether flint and steel can be used.

</td></tr><tr><td>`<span class="editor-theme-code">block-trampling</span>`

</td><td>📗 Whether farmland and turtle eggs can be trampled.

</td></tr><tr><td>`<span class="editor-theme-code">frosted-ice-form</span>`

</td><td>📗 Whether players with frost walker boots will form ice.

</td></tr><tr><td>`<span class="editor-theme-code">item-frame-rotation</span>`

</td><td>📗 Whether items can be rotated within item frames.

</td></tr><tr><td>`<span class="editor-theme-code">firework-damage</span>`

</td><td>📗 Whether fireworks can deal damage to entities.

</td></tr><tr><td>`<span class="editor-theme-code">use-anvil</span>`

</td><td>📗 Whether anvils can be used.

</td></tr><tr><td>`<span class="editor-theme-code">use-dripleaf</span>`

</td><td>📗 Whether dripleaf can be used.

</td></tr></tbody></table>

<span style="white-space: pre-wrap;">WorldGuard Extra Flags provides the following extra flags. Note that </span>****most of these flags bypass operators entirely.****

<table id="bkmrk-flag-description-blo" style="width: 100%;"><colgroup><col style="width: 24.4321%;"></col><col style="width: 75.5679%;"></col></colgroup><thead><tr><td>Flag</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">blocked-effects</span>`

</td><td>📗 Disables the effects of potion effects while inside.

</td></tr><tr><td>`<span class="editor-theme-code">chat-prefix</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">chat-suffix</span>`

</td><td>📗 Defines the prefix/suffix shown when inside the region.

</td></tr><tr><td>`<span class="editor-theme-code">chunk-unload</span>`

</td><td>📒 Prevents chunks the region occupies from being unloaded.

</td></tr><tr><td>`<span class="editor-theme-code">command-on-entry</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">command-on-exit</span>`

</td><td>📒 Executes a command as the player when a player enters/exits the region.

</td></tr><tr><td>`<span class="editor-theme-code">console-command-on-entry</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">console-command-on-exit</span>`

</td><td>📒 Executes a command as the console when a player enters/exits the region.

</td></tr><tr><td>`<span class="editor-theme-code">fly</span>`

</td><td><span style="white-space: pre-wrap;">📗 📒 When set to </span>

`<span class="editor-theme-code">deny</span>`

, disallows creative flight from the ground.

</td></tr><tr><td>`<span class="editor-theme-code">frostwalker</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">deny</span>`

, stops Frostwalker boots from forming ice on water within the region.

</td></tr><tr><td>`<span class="editor-theme-code">give-effects</span>`

</td><td><span style="white-space: pre-wrap;">📗 Gives players who enter the region a permanent </span>

[potion effect](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html)

<span style="white-space: pre-wrap;"> until they leave.</span>

</td></tr><tr><td>`<span class="editor-theme-code">glide</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">deny</span>`

, stops all gliding inside the region.

</td></tr><tr><td>`<span class="editor-theme-code">godmode</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">allow</span>`

, stops all damage delivered to players.

</td></tr><tr><td>`<span class="editor-theme-code">item-durability</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">deny</span>`

, tools will not be damaged by any actions.

</td></tr><tr><td>`<span class="editor-theme-code">join-location</span>`

</td><td>📗 Players who disconnect in the region will teleport to the given location when joining.

</td></tr><tr><td>`<span class="editor-theme-code">keep-exp</span>`

</td><td><span style="white-space: pre-wrap;">📒 When set to </span>

`<span class="editor-theme-code">allow</span>`

<span style="white-space: pre-wrap;">, players always keep experience levels on death. If the </span>

`<span class="editor-theme-code">keepInventory</span>`

<span style="white-space: pre-wrap;"> gamerule is set to </span>

`<span class="editor-theme-code">true</span>`

<span style="white-space: pre-wrap;"> and this flag is set to </span>

`<span class="editor-theme-code">deny</span>`

, the experience will be deleted on death.

</td></tr><tr><td>`<span class="editor-theme-code">keep-inventory</span>`

</td><td><span style="white-space: pre-wrap;">📒 When set to </span>

`<span class="editor-theme-code">allow</span>`

<span style="white-space: pre-wrap;">, players always keep inventory on death. If the </span>

`<span class="editor-theme-code">keepInventory</span>`

<span style="white-space: pre-wrap;"> gamerule is set to </span>

`<span class="editor-theme-code">true</span>`

<span style="white-space: pre-wrap;"> and this flag is set to </span>

`<span class="editor-theme-code">deny</span>`

, the inventory will be deleted on death.

</td></tr><tr><td>`<span class="editor-theme-code">nether-portals</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">deny</span>`

, nether portals cannot be lit.

</td></tr><tr><td>`<span class="editor-theme-code">play-sounds</span>`

</td><td>📒 Plays a sound (from a resource location) repeatedly at a specified interval to players inside the region. This flag may produce errors if it is set incorrectly. Ask a friend to help you set this if you're not sure.

</td></tr><tr><td>`<span class="editor-theme-code">respawn-location</span>`

</td><td>📗 Sets the location to respawn players upon death.

</td></tr><tr><td>`<span class="editor-theme-code">teleport-on-entry</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">teleport-on-exit</span>`

</td><td>📗 Teleports a player to the give location when they enter/exit the region.

</td></tr><tr><td>`<span class="editor-theme-code">walk-speed</span>`

<span style="white-space: pre-wrap;"> / </span>

`<span class="editor-theme-code">fly-speed</span>`

</td><td>📗 Players inside the region will inherit this speed while walking/flying.

</td></tr><tr><td>`<span class="editor-theme-code">worldedit</span>`

</td><td><span style="white-space: pre-wrap;">📗 When set to </span>

`<span class="editor-theme-code">deny</span>`

, stops all WorldEdit operations.

</td></tr></tbody></table>

# CoreProtect

[CoreProtect](https://docs.coreprotect.net)<span style="white-space: pre-wrap;"> is our data logging and anti-griefing tool. We use this plugin to rollback areas, check for player actions, and backup the server.</span>

<table id="bkmrk-command-description-" style="width: 100%;"><colgroup><col style="width: 29.6738%;"></col><col style="width: 70.3262%;"></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/co help</span>`

</td><td>🛡️ 📗 Display a list of commands in-game.

</td></tr><tr><td>`<span class="editor-theme-code">/co inspect</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Enable the inspector. Type the command again to disable it. You can also use just </span>`<span class="editor-theme-code">/co i</span>`.

</td></tr><tr><td>`<span class="editor-theme-code">/co lookup</span>`

</td><td>🛡️ 📗 Check for specific actions by a player, in an area, or even in the past set amount of time.

</td></tr><tr><td>`<span class="editor-theme-code">/co rollback</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a rollback. Uses the same parameters as </span>`<span class="editor-theme-code">/co lookup</span>`<span style="white-space: pre-wrap;">. </span>

*Rollbacks can be used to revert player actions.*

</td></tr><tr><td>`<span class="editor-theme-code">/co restore</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a restore. Uses the same parameters as </span>`<span class="editor-theme-code">/co lookup</span>`<span style="white-space: pre-wrap;">. </span>

*Restoring can be used to undo rollbacks or to restore player actions.*

</td></tr><tr><td>`<span class="editor-theme-code">/co purge t:<time> r:<world></span>`

</td><td>🛡️ 📕 Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.

</td></tr><tr><td>`<span class="editor-theme-code">/co reload</span>`

</td><td>🛡️ 📗 Reloads the configuration file.

</td></tr><tr><td>`<span class="editor-theme-code">/co status</span>`

</td><td>🛡️ 📗 Displays the plugin status and version information.

</td></tr><tr><td>`<span class="editor-theme-code">/co consumer</span>`

</td><td>🛡️ 📗 Console command to pause or resume consumer queue processing.

</td></tr><tr><td><span class="editor-theme-code">`/co near`</span>

</td><td>🛡️ 📗 Performs a lookup with a radius of 5.

</td></tr><tr><td><span class="editor-theme-code">`/co undo`</span>

</td><td><span style="white-space: pre-wrap;">🛡️ 📒</span> Revert a rollback/restore via the opposite action.

</td></tr></tbody></table>

<table id="bkmrk-parameter-descriptio" style="width: 100%;"><colgroup><col style="width: 15.0155%;"></col><col style="width: 84.9845%;"></col></colgroup><thead><tr><td>Parameter</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">u:<user></span>`

</td><td>Specifies a single user or multiple users.

</td></tr><tr><td>`<span class="editor-theme-code">t:<time></span>`

</td><td>Specifies weeks, days, hours, minutes, and/or seconds. Time amounts can be combined, and decimals may be used.

</td></tr><tr><td>`<span class="editor-theme-code">r:<radius></span>`

</td><td>Specifies a spherical radius centered at your current location.

</td></tr><tr><td>`<span class="editor-theme-code">a:<action></span>`

</td><td>Specifies an action to check.

</td></tr><tr><td>`<span class="editor-theme-code">i:<include></span>`

</td><td>Specifies a block, item, or entity that the operation must include.

</td></tr><tr><td>`<span class="editor-theme-code">e:<exclude></span>`

</td><td>Specified a block, item, or entity that the operation must not include.

</td></tr><tr><td>`<span class="editor-theme-code">#<parameter></span>`

</td><td>Add a hashtag to the end of your command to perform additional actions.

</td></tr></tbody></table>

<table class="docutils" id="bkmrk-action-description-a"><thead><tr><th class="align-left">Action</th><th class="align-left">Description</th></tr></thead><tbody><tr><td>`a:block`</td><td>blocks placed/broken</td></tr><tr><td>`a:+block`</td><td>blocks placed</td></tr><tr><td>`a:-block`</td><td>blocks broken</td></tr><tr><td>`a:chat`</td><td>messages sent in chat</td></tr><tr><td>`a:click`</td><td>player interactions</td></tr><tr><td>`a:command`</td><td>commands used</td></tr><tr><td>`a:container`</td><td>items taken from or put in chests</td></tr><tr><td>`a:+container`</td><td>items put in chests</td></tr><tr><td>`a:-container`</td><td>items taken from chests</td></tr><tr><td>`a:inventory`</td><td>items added or removed from player inventories</td></tr><tr><td>`a:+inventory`</td><td>items added to player inventories</td></tr><tr><td>`a:-inventory`</td><td>items removed from player inventories</td></tr><tr><td>`a:item`</td><td>items dropped, thrown, picked up, deposited, or withdrawn by players</td></tr><tr><td>`a:+item`</td><td>items picked up or withdrawn by players</td></tr><tr><td>`a:-item`</td><td>items dropped, thrown, or deposited by players</td></tr><tr><td>`a:kill`</td><td>mobs/animals killed</td></tr><tr><td>`a:session`</td><td>player logins/logouts</td></tr><tr><td>`a:+session`</td><td>player logins</td></tr><tr><td>`a:-session`</td><td>player logouts</td></tr><tr><td>`a:sign`</td><td>messages written on signs</td></tr><tr><td>`a:username`</td><td>username changes</td></tr></tbody></table>

## Example Commands

### Example Rollback Commands

By default, if no radius is specified, a radius of 10 will be applied, restricting the rollback to within 10 blocks of you. Use `r:#global` to do a global rollback.

- `/co rollback Notch t:1h`  
    *(rollback Notch 1 hour (with default radius of 10))*
- `/co rollback u:Notch,Intelli t:1h #preview`  
    *(PREVIEW rolling back both Notch &amp; Intelli 1 hour (with default radius of 10))*
- `/co rollback u:Notch t:23h17m`  
    *(rollback Notch 23 hours and 17 minutes (with default radius of 10))*
- `/co rollback u:Notch t:1h i:stone`  
    *(rollback ONLY stone placed/broken by Notch within the last hour (with default radius of 10))*
- `/co rollback u:Notch t:1h i:stone a:-block`  
    *(rollback ONLY stone BROKEN by Notch within the last hour (with default radius of 10))*
- `/co rollback u:Notch t:1h r:#global e:stone,dirt`  
    *(rollback EVERYTHING Notch did in the last hour EXCEPT for stone and dirt placed/broken)*
- `/co rollback u:Notch t:1h r:20`  
    *(rollback griefing Notch did in the last hour that is within 20 blocks of you)*
- `/co rollback u:Notch t:1h r:#nether`  
    *(rollback griefing Notch did in the last hour ONLY in the Nether)*
- `/co rollback u:Notch t:5m a:inventory`  
    *(rollback inventory transactions by Notch in the last 5 minutes)*
- `/co rollback t:15m r:30`  
    *(rollback everything done in the last 15 minutes by anyone within 30 blocks of you)*
- `/co rollback t:15m r:#worldedit`  
    *(rollback everything done in the last 15 minutes in a WorldEdit selection)*

### Example Lookup Commands

Lookup commands are generally the same as rollback commands. The primary difference is that a default radius is not applied to lookups, meaning all lookup commands do a global search by default.

- `/co lookup i:diamond_ore t:1h a:-block`  
    *(lookup all diamond ore mined in the last hour)*
- `/co lookup u:Notch t:30m a:chat`  
    *(lookup chat messages sent by Notch in the last 30 minutes)*
- `/co lookup u:Notch t:3d a:inventory`  
    *(lookup inventory transactions by Notch in the last 3 days)*
- `/co lookup u:Notch a:login`  
    *(lookup all logins ever done by Notch)*
- `/co lookup u:Notch a:login`  
    *(lookup all logins ever done by Notch)*
- `/co lookup u:Notch a:username`  
    *(lookup previous usernames used by Notch)*

# Dreamvisitor

[Dreamvisitor](https://github.com/stonley890/Dreamvisitor/wiki)<span style="white-space: pre-wrap;">, created by Bog specifically for Wings of Fire: The New World, has a variety of features. It serves as an all-in-one utility plugin and Discord bot.</span>

## <span style="white-space: pre-wrap;">Commands</span>

<table id="bkmrk-command-description--1"><colgroup><col></col><col></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/aradio <message>...</span>`

</td><td>🛡️ 📗 Send a message to all operators.

</td></tr><tr><td>`<span class="editor-theme-code">/discord</span>`

</td><td><span style="white-space: pre-wrap;">📗 Toggle whether messages from the Discord chat bridge appear in your chat. This can also be adjusted with </span>`<span class="editor-theme-code">/dvset</span>`.

</td></tr><tr><td>`<span class="editor-theme-code">/dreamvisitor manage <key> [value]</span>`

</td><td>🛡️ 📕 View or modify the Dreamvisitor configuration.

</td></tr><tr><td>`<span class="editor-theme-code">/dvset</span>`

</td><td>📗 Manage your Dreamvisitor settings.

</td></tr><tr><td>`<span class="editor-theme-code">/hub [entities]</span>`

</td><td>🛡️ 📗 Teleport yourself entities to the hub location. If you have an entity on a lead, the entity will teleport with you below the normal hub location.

</td></tr><tr><td>`<span class="editor-theme-code">/invswap</span>`

</td><td>🛡️ 📗 Swap between two different inventories.

</td></tr><tr><td>`<span class="editor-theme-code">/itembanlist</span>`

</td><td>🛡️ 📒 Open the item ban list inventory GUI.

</td></tr><tr><td>`<span class="editor-theme-code">/moonglobe remove <players></span>`

</td><td>🛡️ 📗 Remove moon globes from players.

</td></tr><tr><td>`<span class="editor-theme-code">/moonglobe create <players> <location> <max_distance></span>`

</td><td>🛡️ 📗 Give players moon globes.

</td></tr><tr><td>`<span class="editor-theme-code">/panic</span>`

</td><td>🛡️ 📕 Kick all players and sets the player limit override to 0.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel cancel</span>`

</td><td>🛡️ 📗 Cancel your current parcel delivery.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations add <position> <name> <weight> <home_tribe></span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Add a delivery location. </span>`<span class="editor-theme-code">name</span>`<span style="white-space: pre-wrap;"> cannot contain spaces, but underscores will be replaced with spaces when displayed to players. </span>`<span class="editor-theme-code">weight</span>`<span style="white-space: pre-wrap;"> determines the likelihood of the location being chosen. At 0, it will never be chosen. At 4, it is quite likely to be chosen. </span>`<span class="editor-theme-code">home_tribe</span>`<span style="white-space: pre-wrap;"> determines only which names will appear on parcels to or from this location.</span>

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations remove <name></span>`

</td><td>🛡️ 📒 Remove a delivery location.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel locations list</span>`

</td><td>🛡️ 📗 List all mail delivery locations.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery terminal <players></span>`

</td><td>🛡️ 📗 Give a player a parcel or allow players to deliver parcels to a location within 10 blocks.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery add <players> <start> <end></span>`

</td><td>🛡️ 📗 Create deliveries for players.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery remove <players></span>`

</td><td>🛡️ 📗 Cancel deliveries for players.

</td></tr><tr><td>`<span class="editor-theme-code">/parcel delivery list</span>`

</td><td>🛡️ 📗 List ongoing deliveries.

</td></tr><tr><td>`<span class="editor-theme-code">/pausebypass add <players></span>`

</td><td>🛡️ 📗 Allow players to chat even when chat is paused.

</td></tr><tr><td><span class="editor-theme-code">`/pausebypass remove <players>`</span>

</td><td>🛡️ 📗 Disallow players to chat when chat is paused.

</td></tr><tr><td><span class="editor-theme-code">`/pausebypass list`</span>

</td><td>🛡️ 📗 List players allowed to chat even when chat is paused.

</td></tr><tr><td>`<span class="editor-theme-code">/pausechat</span>`

</td><td>🛡️ 📕 Suppresses messages from players and the Discord chat bridge.

</td></tr><tr><td>`<span class="editor-theme-code">/playerlimit [new_limit]</span>`

</td><td>🛡️ 📕 Override the server player limit.

</td></tr><tr><td>`<span class="editor-theme-code">/radio <message>...</span>`

</td><td>🛡️ 📗 Send a message to all other players who can access the radio.

</td></tr><tr><td>`<span class="editor-theme-code">/sandbox <player> [on|off]</span>`

</td><td>🛡️ 📒 Manage players' access to Sandbox Mode.

</td></tr><tr><td>`<span class="editor-theme-code">/setback <players> [location] [rotation] [world]</span>`

</td><td>🛡️ 📗 Set a player's last EssentialsX location. If no world is specified, the current world is assumed. If no rotation is specified, none will be applied. If no location is specified, the execution position will be used.

</td></tr><tr><td>`<span class="editor-theme-code">/setmotd [new_motd]...</span>`

</td><td>🛡️ 📗 Change or reset the server MOTD.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist add <player></span>`

</td><td>🛡️ 📗 Add a player to the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist remove <player></span>`

</td><td>🛡️ 📗 Remove a player from the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist list</span>`

</td><td>🛡️ 📗 List all players on the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist on</span>`

</td><td>🛡️ 📗 Enable the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/softwhitelist off</span>`

</td><td>🛡️ 📗 Disable the soft whitelist.

</td></tr><tr><td>`<span class="editor-theme-code">/synctime [world]</span>`

</td><td>🛡️ 📗 Sync time across all worlds.

</td></tr><tr><td>`<span class="editor-theme-code">/tagradio <tag> <message></span>`

</td><td>🛡️ 📗 Send a message to all players with a given tag.

</td></tr><tr><td>`<span class="editor-theme-code">/togglepvp</span>`

</td><td>🛡️ 📗 Toggle whether PvP is enabled or disabled.

</td></tr><tr><td>`<span class="editor-theme-code">/tribeupdate <players></span>`

</td><td>🛡️ 📗 Update the permission groups of a player based on their tribe.

</td></tr><tr><td>`<span class="editor-theme-code">/velocity <entities> <vector> [replace]</span>`

</td><td>🛡️ 📗 Apply velocity to entities.

</td></tr><tr><td>`<span class="editor-theme-code">/unwax</span>`

</td><td>🛡️ 📗 Unwax the sign you are looking at.

</td></tr><tr><td>`<span class="editor-theme-code">/user <player></span>`

</td><td>🛡️ 📗 Get details of a player, online or offline.

</td></tr><tr><td>`<span class="editor-theme-code">/zoop</span>`

</td><td>🛡️ 📗 Sends a fake leave message to Discord and hides you from the list command.

</td></tr></tbody></table>

## Auto-Whitelist

The whitelist functionality is built to handle whitelisting players completely automatically.

When a user on Discord sends a username in the whitelist channel, Dreamvisitor will first check to see whether the player is marked as banned. If so, they will not be allowed to add players to the whitelist. Dreamvisitor will then check if the username is legal. Minecraft usernames are alphanumeric (including underscores). If the message is not alphanumeric, Dreamvisitor will take no action. This also occurs if the Mojang API cannot find the provided username.

If the username *is* valid, Dreamvisitor will first fetch the UUID of the username and add it to `accountLink.txt`, which tracks which Minecraft UUIDs are connected to which Discord Snowflake IDs. A new entry will be recorded every time, unless the UUID has already been registered. This means that a Discord account can be linked to multiple Minecraft accounts, but not the other way around.

Dreamvisitor will then check whether the account is already whitelisted. If they are not, they are added to the whitelist. Either way, the user will be directed to check the FAQ for the IP.

For both Discord whitelisting and web whitelisting, any new user added to the whitelist will be recorded in the guild's system logs channel.

## Item Banlist

`<span class="editor-theme-code">/itembanlist</span>`<span style="white-space: pre-wrap;"> will open a chest-like inventory. Items placed in this container will be saved in their place and players with matching items will have them automatically removed from non-operator player inventories. </span>**This removal is permanent.**<span style="white-space: pre-wrap;"> Be cautious of items you add. </span>**Items are only removed if the data is an exact match.**<span style="white-space: pre-wrap;"> If you put a potato into the blacklist GUI, potatoes that have been renamed or enchanted will not be removed.</span>

![](https://raw.githubusercontent.com/Stonley890/ItemVoid/main/ItemVoidDemoSmall.GIF)

A demonstration of the item blacklist.

## Soft Whitelist

<span style="white-space: pre-wrap;">The soft whitelist acts as a secondary whitelist that works much like Minecraft's built-in whitelist feature. This allows reducing the allowed players to a specified group while not modifying the main whitelist. Players with the </span>`<span class="editor-theme-code">dreamvisitor.nowhitelist</span>`<span style="white-space: pre-wrap;"> permission will always bypass the soft whitelist. </span>**Operators will always bypass the soft whitelist.**

The soft whitelist persists through restarts.

## Sandbox Mode

**Sandbox Mode**<span style="white-space: pre-wrap;"> is a feature that allows administrators to safely allow players to use Creative Mode. When a player is put into Sandbox Mode, their inventory is swapped, and they are put into Creative Mode with the following restrictions:</span>

- They cannot access containers.
- They cannot drop items.
- They cannot use spawn eggs.
- They cannot teleport.

<span style="white-space: pre-wrap;">A player with the </span>`<span class="editor-theme-code">dreamvisitor.sandbox</span>`<span style="white-space: pre-wrap;"> permission — usually an admin — must be online for Sandbox Mode to remain active. If all admins leave, all players in Sandbox Mode will have it removed, restoring their inventories. If players leave the game while in Sandbox Mode, they will remain in Sandbox Mode when they rejoin unless there are no admins. When a Sandboxed player joins, admins will be notified.</span>

[![demo.GIF](https://docs.woftnw.org/uploads/images/gallery/2025-02/demo.GIF)](https://docs.woftnw.org/uploads/images/gallery/2025-02/demo.GIF)

## Pause Chat

<span style="white-space: pre-wrap;">The </span>`<span class="editor-theme-code">/pausechat</span>`<span style="white-space: pre-wrap;"> command will stop all incoming chat messages from being broadcasted. It will also block messages from </span>`<span class="editor-theme-code">/me</span>`<span style="white-space: pre-wrap;"> and Discord pass-through. You can allow certain players to bypass this with </span>`<span class="editor-theme-code">/pausebypass</span>`<span style="white-space: pre-wrap;">. Players with the </span>`<span class="editor-theme-code">dreamvisitor.nopause</span>`<span style="white-space: pre-wrap;"> permission will always bypass chat pause. </span>**Operators will always bypass chat pause.**

Chat pause will persist through restarts.

## Moon Globes

<span style="white-space: pre-wrap;">Moon Globes can be created with the </span>`<span class="editor-theme-code">moonglobe</span>`<span style="white-space: pre-wrap;"> command.</span>

<span style="white-space: pre-wrap;">A player may only have one moon globe at a time. Each moon globe has an origin and a maximum distance. By default, the maximum distance is 256 blocks. If a moon globe (not the player) moves beyond that distance, it will be removed. It will also be removed if the player moves to a different dimension. It will </span>*not*<span style="white-space: pre-wrap;"> be removed if the player disconnects, though it will disappear until the player reconnects. Moon globes are not saved, so they will be deleted upon a server shutdown.</span>

## Mail System

Players can earn money by delivering mail. Players may interact with a mail terminal to receive a parcel. They will be assigned a location to deliver it to, and they must interact with the terminal at that location without teleportation to get a reward based on the distance.

<span style="white-space: pre-wrap;">When a player interacts with a terminal (a command block with the command </span>`<span class="editor-theme-code">/parcel terminal @p</span>`<span style="white-space: pre-wrap;">), Dreamvisitor will choose a random end location with each location weighted by an inherent, preset weight, and the distance from the start location, weighing closer locations higher than further ones. The distance weight can be multiplied using the </span>`<span class="editor-theme-code">mailDeliveryLocationSelectionDistanceWeightMultiplier</span>`<span style="white-space: pre-wrap;"> option in </span>`<span class="editor-theme-code">config.yml</span>`.

The player will be given an enchanted book that they must keep with them until they complete the delivery. The book will be addressed to a random name. There is a 45% chance that the name will be of the tribe associated with the start location, a 45% chance that the name will be of the tribe associated with the end location, and a 10% chance that the name will be of a random tribe. A random lore string will also be chosen from a preset pool. If the player does not have the parcel when they reach the destination location, they delivery will not be completed and they must re-obtain the parcel or cancel the delivery. If a player cancels their deliver while they still have the parcel, they will keep the parcel.

<span style="white-space: pre-wrap;">When a player completes a delivery, the parcel will be removed from them, and they will be given a reward based on the distance between the start and end location, multiplied by </span>`<span class="editor-theme-code">mailDistanceToRewardMultiplier</span>`<span style="white-space: pre-wrap;"> in </span>`<span class="editor-theme-code">config.yml</span>`.

## Command Scheduler

The Dreamvisitor Command Scheduler is a powerful system for automating server tasks at specific times or intervals. It supports running individual commands or sequences of commands with configurable delays between them.

#### Key Features

- Multiple schedule types: Run commands at intervals, daily at specific times, or using cron patterns
- Command sequences: Execute multiple commands in order from a single schedule
- Configurable delays: Add pauses between commands in a sequence
- User-friendly commands: Simple interface for managing schedules

### Getting Started

#### Prerequisites

The command scheduler is included in the Dreamvisitor plugin. Make sure you have the appropriate permission:

```
dreamvisitor.schedule
```

### Schedule Types

The scheduler supports three types of scheduling patterns:

#### Interval-based Schedules

Runs every X minutes.

**Example:**

```
/schedule interval backup 120 save-all
```

This runs the save-all command every 2 hours (120 minutes).

#### Daily Schedules

Runs once per day at a specific time.

**Example:**

```
/schedule daily restart 03:00:00 restart

```

This runs the restart command every day at 3:00 AM.

#### Cron-style Schedules

Uses cron patterns for more advanced scheduling.

**Example:**

```
/schedule cron resource-reset "0 0 * * 0" world reset resource

```

This reloads the resource world at midnight every Sunday.

##### Cron Pattern Format

The pattern follows the standard cron format: minute hour day-of-month month day-of-week

- minute: 0-59
- hour: 0-23
- day-of-month: 1-31
- month: 1-12
- day-of-week: 0-6 (Sunday to Saturday)

##### Special characters:

- \*: any value
- ,: value list separator
- -: range of values
- /: step values

##### Examples:

- 0 0 \* \* \*: Every day at midnight
- 0 \*/2 \* \* \*: Every 2 hours
- 0 0 \* \* 1-5: Every weekday at midnight
- \*/10 \* \* \* \*: Every 10 minutes

### Command Reference

#### Creating Schedules

- Interval Schedules
    
    ```
    /schedule interval <name> <minutes> <command>
    ```
- Daily Schedules
    
    ```
    /schedule daily <name> <time> <command>
    ```
    
    Time format must be HH:MM:SS (24-hour format)
- Cron Schedules
    
    ```
    /schedule cron <name> <pattern> <command>
    ```
    
    Pattern must follow cron format (see above)

#### Managing Schedules

- List All Schedules
    
    ```
    /schedule list
    ```
    
    Shows all schedules with their next run times
- Remove a Schedule
    
    ```
    /schedule remove <name>
    ```
    
    Deletes a schedule completely
- Run a Schedule Immediately
    
    ```
    /schedule run <name>
    ```
    
    Executes a schedule now

#### Managing Commands in a Schedule

- Add a Command
    
    ```
    /schedule add-command <name> <command>
    ```
    
    Adds a new command to an existing schedule
- Remove a Command
    
    ```
    /schedule remove-command <name> <index>
    ```
    
    Removes a command from a schedule by its index

<p class="callout info">Command indexes start at 1 (not 0).</p>

#### Managing Delays

- Add a Delay
    
    ```
    /schedule add-delay <name> <index> <seconds>
    ```
    
    Adds a delay before executing the specified command
- Remove a Delay
    
    ```
    /schedule remove-delay <name> <index>
    ```
    
    Removes a delay from the specified command

### Command Sequences

You can create sequences of commands that run in order by separating commands with semicolons (;).

**Example:**

```
/schedule daily server-restart 04:00:00 broadcast Server restart in 10 minutes!;broadcast Server restart in 1 minute!;broadcast Server restarting NOW!;restart
```

This will:

- Broadcast "Server restart in 10 minutes!"
- Broadcast "Server restart in 1 minute!"
- Broadcast "Server restarting NOW!"
- Restart the server

All at 4:00 AM each day.

You can also add commands to an existing schedule:

```
/schedule add-command server-restart broadcast The server is restarting for daily maintenance
```

### Delays Between Commands

For more precise control, you can add delays between specific commands in a sequence:

```
/schedule add-delay server-restart 1 540
/schedule add-delay server-restart 2 50
/schedule add-delay server-restart 3 10
```

This would modify our example to:

- Broadcast "Server restart in 10 minutes!"
- Wait 540 seconds (9 minutes)
- Broadcast "Server restart in 1 minute!"
- Wait 50 seconds
- Broadcast "Server restarting NOW!"
- Wait 10 seconds
- Restart the server

The delay is applied before the command at the specified index runs. Indexes start at 1 for the first command.

### Common Use Cases

#### Resource World Reset

Reset resource worlds automatically every Sunday at midnight:

```
/schedule cron resource-reset "0 0 * * 0" broadcast Resource world will reset in 5 minutes!;world reset resource
```

Add a longer delay:

```
/schedule add-delay resource-reset 2 300
```

#### Daily Backups

Create a daily backup schedule:

```
/schedule daily backup 02:00:00 broadcast Starting daily backup...;save-all;backup start
```

#### Server Restart

Schedule a restart when the server is quiet:

```
/schedule daily restart 04:00:00 restart
```

### Technical Reference

#### Storage Location

All schedules are saved in the schedules.yml file in the Dreamvisitor plugin folder.

#### Format of schedules.yml

The schedules.yml file uses a structured format to store all scheduled tasks. Here's the basic structure:

```yaml
schedules:
  schedule-name:
    type: [interval|daily|cron]
    # For interval schedules:
    interval-minutes: 120
    # For daily schedules:
    time: "04:00:00" # HH:MM:SS
    # For cron schedules:
    pattern: "0 0 * * 0" # minute hour day month weekday
    commands:
      - "command1"
      - "command2"
    delays:
      2: 30 # 30 second delay before command at index 2
    last-run: 1234567890 # Unix timestamp
```

Each schedule must have:

- A unique name identifier
- A type (interval, daily, or cron)
- Type-specific configuration (interval-minutes, time, or pattern)
- A list of commands to execute
- Optional delays between specific commands
- A last-run timestamp to track when it last executed

The CommandScheduler loads this configuration at startup and whenever schedules are modified through commands.

### Troubleshooting

#### Schedule Not Running

- Check if the schedule has been created with /schedule list
- Verify the server has permission to run the commands (check console for permission errors)
- For daily schedules, ensure time format is correct (HH:MM:SS)
- For cron schedules, validate the cron pattern is correct
- Check the server log for any errors related to the CommandScheduler
- Verify the system time on your server is accurate
- Check that schedules.yml hasn't been manually edited with invalid syntax

#### Commands in Sequence Not Running

- Check if there are syntax errors in any command
- Ensure delays aren't too long
- Verify command permissions
- Look for error messages in the console when the schedule runs
- Make sure commands that require a player don't use @p in a server context
- For commands with selectors, ensure they have the appropriate permissions

#### Invalid Cron Pattern

Common cron pattern mistakes:

- Not having exactly 5 parts
- Using values outside the valid ranges (e.g., minutes &gt; 59)
- Incorrect format for ranges or steps
- Missing required fields or using incorrect special characters

Use these valid pattern examples for reference:

- `0 4 * * *` - Every day at 4:00 AM
- `*/15 * * * *` - Every 15 minutes
- `0 0 * * 0` - Every Sunday at midnight
- `0 0,12 * * *` - Every day at midnight and noon