# 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 [optional_argument] [greedy_optional_argument]... ``` - `command` is the name of the command. - `subcommand` is the name of the subcommand if relevant. - `` is an argument that must be included to execute the command. - `[optional_argument]` is an argument that may optionally be included. - `...` 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.
**Command****Description**
`/advancement`πŸ›‘οΈ πŸ“— πŸ“’ Grants or revokes an advancement. [Wiki](https://minecraft.wiki/w/Commands/advancement)
`/attribute`πŸ›‘οΈ πŸ“’ Queries, adds, removes or sets an entity attribute. [Wiki](https://minecraft.wiki/w/Commands/attribute)
`/ban`πŸ›‘οΈ πŸ“• Adds a player to the banlist. [Wiki](https://minecraft.wiki/w/Commands/ban)
`/banlist`πŸ›‘οΈ πŸ“— Displays the banlist. [Wiki](https://minecraft.wiki/w/Commands/ban#banlist)
`/bossbar`πŸ›‘οΈ πŸ“— Creates and modifies bossbars. [Wiki](https://minecraft.wiki/w/Commands/bossbar)
`/clear`πŸ›‘οΈ πŸ“’ πŸ“• Clears items from player inventory. [Wiki](https://minecraft.wiki/w/Commands/clear)
`/clone`πŸ›‘οΈ πŸ“’ Copies blocks from one place to another. [Wiki](https://minecraft.wiki/w/Commands/clone)
`/damage`πŸ›‘οΈ πŸ“— Applies damage to specified entities. [Wiki](https://minecraft.wiki/w/Commands/damage)
`/data`πŸ›‘οΈ πŸ“’ Manipulates block, entity, and storage NBT data. [Wiki](https://minecraft.wiki/w/Commands/data)
`/datapack`πŸ›‘οΈ πŸ“’ πŸ“• Controls the data packs interface. [Wiki](https://minecraft.wiki/w/Commands/datapack)
`/debug`πŸ›‘οΈ πŸ“— πŸ“’ Starts or stops a debugging session. [Wiki](https://minecraft.wiki/w/Commands/debug)
`/defaultgamemode`πŸ›‘οΈ πŸ“— πŸ“’ Sets the default game mode. [Wiki](https://minecraft.wiki/w/Commands/defaultgamemode)
`/deop`πŸ›‘οΈ πŸ“’ πŸ“• Revokes operator status from a player. [Wiki](https://minecraft.wiki/w/Commands/deop)
`/difficulty`πŸ›‘οΈ πŸ“— Sets the difficulty level. [Wiki](https://minecraft.wiki/w/Commands/difficulty)
`/effect`πŸ›‘οΈ πŸ“— Adds or removes status effects. [Wiki](https://minecraft.wiki/w/Commands/effect)
`/enchant`πŸ›‘οΈ πŸ“— Adds an enchantment to a player's selected item. [Wiki](https://minecraft.wiki/w/Commands/enchant)
`/execute`πŸ›‘οΈ πŸ“— πŸ“’ Executes another command. [Wiki](https://minecraft.wiki/w/Commands/execute)
`/experience, /xp`πŸ›‘οΈ πŸ“— Adds or removes player experience. [Wiki](https://minecraft.wiki/w/Commands/experience)
`/fill`πŸ›‘οΈ πŸ“’ πŸ“• Fills a region with a specific block. [Wiki](https://minecraft.wiki/w/Commands/fill)
`/fillbiome`πŸ›‘οΈ πŸ“’ Sets a region with a specific biome. [Wiki](https://minecraft.wiki/w/Commands/fillbiome)
`/forceload`πŸ›‘οΈ πŸ“’ Forces chunks to constantly be loaded or not. [Wiki](https://minecraft.wiki/w/Commands/forceload)
`/function`πŸ›‘οΈ πŸ“’ πŸ“• Runs a function. [Wiki](https://minecraft.wiki/w/Commands/function)
`/gamemode`πŸ›‘οΈ πŸ“— πŸ“’ Sets a player's game mode. [Wiki](https://minecraft.wiki/w/Commands/gamemode)
`/gamerule`πŸ›‘οΈ πŸ“— πŸ“’ Sets or queries a game rule value. [Wiki](https://minecraft.wiki/w/Commands/gamerule)
`/give`πŸ›‘οΈ πŸ“— πŸ“’ Gives an item to a player. [Wiki](https://minecraft.wiki/w/Commands/give)
`/help`πŸ“— Provides a list of commands or help for a command. [Wiki](https://minecraft.wiki/w/Commands/help)
`/item`πŸ›‘οΈ πŸ“’ Manipulates items in inventories. [Wiki](https://minecraft.wiki/w/Commands/item)
`/jfr`πŸ›‘οΈ πŸ“— πŸ“’ Start or stop a JFR profiler. [Wiki](https://minecraft.wiki/w/Commands/jfr)
`/kick`πŸ›‘οΈ πŸ“’ Kicks a player off a server. [Wiki](https://minecraft.wiki/w/Commands/kick)
`/kill`πŸ›‘οΈ πŸ“• Kills entities (players, mobs, items, etc.). [Wiki](https://minecraft.wiki/w/Commands/kill)
`/list`πŸ“— Lists players on the server. [Wiki](https://minecraft.wiki/w/Commands/list)
`/locate`πŸ›‘οΈ πŸ“— Locates closest structure, biome, or point of interest. [Wiki](https://minecraft.wiki/w/Commands/locate)
`/loot`πŸ›‘οΈ πŸ“— Give a loot table to a selector or spawn a loot table. [Wiki](https://minecraft.wiki/w/Commands/loot)
`/me`πŸ“— Displays a message about the sender. [Wiki](https://minecraft.wiki/w/Commands/me)
`/msg, /tell, /w`πŸ“— Displays a private message to other players. [Wiki](https://minecraft.wiki/w/Commands/msg)
`/op`πŸ›‘οΈ πŸ“• Grants operator status to a player. [Wiki](https://minecraft.wiki/w/Commands/op)
`/pardon`πŸ›‘οΈ πŸ“’ Removes players from the banlist. [Wiki](https://minecraft.wiki/w/Commands/pardon)
`/pardon-ip`πŸ›‘οΈ πŸ“’ Removes an IP address from the banlist. [Wiki](https://minecraft.wiki/w/Commands/pardon#pardon-ip)
`/particle`πŸ›‘οΈ πŸ“— πŸ“’ Generates particles. [Wiki](https://minecraft.wiki/w/Commands/particle)
`/perf`πŸ›‘οΈ πŸ“— Captures info and metrics about the game for 10 seconds. [Wiki](https://minecraft.wiki/w/Commands/perf)
`/place`πŸ›‘οΈ πŸ“— πŸ“’ Used to place a configured feature, jigsaw, template, or structure at a given location. [Wiki](https://minecraft.wiki/w/Commands/place)
`/playsound`πŸ›‘οΈ πŸ“—Plays a sound. [Wiki](https://minecraft.wiki/w/Commands/playsound)
`/publish`πŸ›‘οΈ πŸ“’ Opens a single-player world to a local network. [Wiki](https://minecraft.wiki/w/Commands/publish)
`/recipe`πŸ›‘οΈ πŸ“— πŸ“’ Gives or takes player recipes. [Wiki](https://minecraft.wiki/w/Commands/recipe)
`/reload`πŸ›‘οΈ πŸ“’ Reloads loot tables, advancements, and functions from disk. [Wiki](https://minecraft.wiki/w/Commands/reload)
`/return`πŸ›‘οΈ πŸ“— πŸ“’ Control execution flow inside functions. [Wiki](https://minecraft.wiki/w/Commands/return)
`/ride`πŸ›‘οΈ πŸ“— 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)
`/save-all`πŸ›‘οΈ πŸ“• Saves the server to disk. [Wiki](https://minecraft.wiki/w/Commands/save-all)
`/save-off`πŸ›‘οΈ πŸ“• Disables automatic server saves. [Wiki](https://minecraft.wiki/w/Commands/save-off)
`/save-on`πŸ›‘οΈ πŸ“• Enables automatic server saves. [Wiki](https://minecraft.wiki/w/Commands/save-on)
`/say`πŸ“— Displays a message to multiple players. [Wiki](https://minecraft.wiki/w/Commands/say)
`/schedule`πŸ›‘οΈ πŸ“’ πŸ“• Schedule the execution of a function. [Wiki](https://minecraft.wiki/w/Commands/schedule)
`/scoreboard`πŸ›‘οΈ πŸ“’ Manages scoreboard objectives and players. [Wiki](https://minecraft.wiki/w/Commands/scoreboard)
`/seed`πŸ›‘οΈ πŸ“— Displays the world seed. [Wiki](https://minecraft.wiki/w/Commands/seed)
`/setblock`πŸ›‘οΈ πŸ“— Changes a block to another block. [Wiki](https://minecraft.wiki/w/Commands/setblock)
`/setidletimeout`πŸ›‘οΈ πŸ“— πŸ“’ Sets the time before idle players are kicked. [Wiki](https://minecraft.wiki/w/Commands/setidletimeout)
`/setworldspawn`πŸ›‘οΈ πŸ“’ Sets the world spawn. [Wiki](https://minecraft.wiki/w/Commands/setworldspawn)
`/spawnpoint`πŸ›‘οΈ πŸ“— πŸ“’ Sets the spawn point for a player. [Wiki](https://minecraft.wiki/w/Commands/spawnpoint)
`/spectate`πŸ›‘οΈ πŸ“— Force a spectating player to spectate an entity. [Wiki](https://minecraft.wiki/w/Commands/spectate)
`/spreadplayers`πŸ›‘οΈ πŸ“— πŸ“’ Teleports entities to random locations. [Wiki](https://minecraft.wiki/w/Commands/spreadplayers)
`/stop`πŸ›‘οΈ πŸ“• Stops the server. [Wiki](https://minecraft.wiki/w/Commands/stop)
`/stopsound`πŸ›‘οΈ πŸ“— Stops a sound currently playing. [Wiki](https://minecraft.wiki/w/Commands/stopsound)
`/summon`πŸ›‘οΈ πŸ“—Summons an entity. [Wiki](https://minecraft.wiki/w/Commands/summon)
`/tag`πŸ›‘οΈ πŸ“— Manages entity tags. [Wiki](https://minecraft.wiki/w/Commands/tag)
`/team`πŸ›‘οΈ πŸ“— Controls teams. [Wiki](https://minecraft.wiki/w/Commands/team)
`/teammsg, /tm`πŸ“— Sends a message to the player's team. [Wiki](https://minecraft.wiki/w/Commands/teammsg)
`/teleport, /tp`πŸ›‘οΈ πŸ“— πŸ“’ Teleports entities. [Wiki](https://minecraft.wiki/w/Commands/teleport)
`/tellraw`πŸ›‘οΈ πŸ“— Displays a JSON-formatted message to players. [Wiki](https://minecraft.wiki/w/Commands/tellraw)
`/time`πŸ›‘οΈ πŸ“— Changes or queries the world's game time. [Wiki](https://minecraft.wiki/w/Commands/time)
`/title`πŸ›‘οΈ πŸ“— Manages screen titles. [Wiki](https://minecraft.wiki/w/Commands/title)
`/trigger`πŸ“— Manages trigger scoreboards. [Wiki](https://minecraft.wiki/w/Commands/trigger)
`/weather`πŸ›‘οΈ πŸ“— Sets the weather. [Wiki](https://minecraft.wiki/w/Commands/weather)
`/whitelist`πŸ›‘οΈ πŸ“— πŸ“’ Manages the server whitelist. [Wiki](https://minecraft.wiki/w/Commands/whitelist)
`/worldborder`πŸ›‘οΈ πŸ“’ Manages the world border. [Wiki](https://minecraft.wiki/w/Commands/worldborder)
# 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**.
**Target Selector****Entities Selected**
`@p`Nearest player
`@r`One random player
`@a`All players, living and dead
`@e`All loaded, living entities
`@s`Entity executing the current command
### 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.
**Target Selector Argument****Filter By...**
`x`, `y`, `z`[coordinate](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_coordinate)
`distance`[distance](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_distance)
`dx`, `dy`, `dz`[volume dimensions](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_volume)
`x_rotation`[vertical rotation (pitch)](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_vertical_rotation)
`y_rotation`[horizontal rotation (yaw)](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_horizontal_rotation)
`scores`[scores](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_scores)
`tag`[tag](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_tag)
`team`[team](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_team)
`name`[entity name](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_name)
`type`[entity type](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_type)
`predicate`[predicate](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_predicate)
`nbt`[nbt](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_nbt)
`level`[experience level](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_experience_level)
`gamemode`[gamemode](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_game_mode)
`advancements`[advancements](https://minecraft.wiki/w/Target_selectors#Selecting_targets_by_advancements)
`limit`, `sort`[selector limiting](https://minecraft.wiki/w/Target_selectors#Selecting_targets_with_a_limit)
### `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.
`@e[distance=1.5]`Target all entities **exactly 1.5 blocks** away.
`@a[distance=8..16]`Target all players **8 to 16 blocks away, inclusive**.
`@p[distance=..40]`Target the nearest player **up to 40 blocks away, inclusive**. Note that if the first number is excluded, the command interprets it as 0.
`@r[distance=12..]`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.
### `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.
`@a[dx=3, dy=5, dz=2]`Target all players whose **hitbox lies within the volume extending 4 blocks east, 6 blocks up, and 3 blocks south** of the execution spot.
### 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.
`@e[scores={myScore1=4}]`Target all entities with a **score of exactly 4 in myScore1**.
`@p[scores={myScore2=..5, myScore3=10..}]`Target the nearest player with **at most a score of 5 in myScore2 *and* at least a score of 10 in myScore3**.
### tag= `tag` targets entities with a specified tag. These tags can be applied with the `/tag` command.
`@a[tag=myTag1]`Target all players **with the myTag1 tag**.
`@p[tag=!myTag2]`Target the nearest player who **does not have the myTag2 tag**.
`@e[tag=myTag3, tag=myTag4, tag=!myTag5]`Target all entities who **have the myTag3 tag, *and* the myTag4 tag, *and* do not have the myTag5 tag**.
`@r[tag=]`Target a random player that has **no tags**.
`@s[tag=!]`Target the current executing entity if they have **at least one tag**.
### 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.
`@a[team=myTeam1]`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.
`@p[team=!myTeam2, team=!myTeam3]`Target all players who **are not in myTeam2 or myTeam3**. Note that this argument *can* be used more than once.
`@r[team=]`Target a random player who **is not on a team**.
`@a[team=!]`Target all players who **are on any team**.
### 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.**
`@a[nbt={Inventory: [{id: "minecraft:iron_sword}]}]`Target all players who **have an iron sword in their inventory**.
`@e[nbt={DeathLootTable: "myLootTable"}]`Target all entities who **have the myLootTable death loot 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.
`@e[limit=15]`Target **at most 15 entities**.
`@a[limit=4]`Target at **most 4 players**.
### 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.
`@e[sort=nearest]`Target all entities, **selecting the nearest entities first**.
`@a[limit=4, sort=random]`Target at **most 4 random players**.
### 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 `. 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. - `` - 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.
`/ban | ban-ip [reason]`Syntax for the command.
`ban jjj_North`Kick and ban jjj\_North.
`ban-ip 7pencilsharpen3r Hacking`Kick and ban 7pencilsharpen3r's IP for hacking, preventing any account from joining from that IP.
## `/clear` Clears an item or all items from a player or valid selector entities.
`/clear [item] [amount]`Syntax for the command.
`clear mmaurice196`Clear every item from mmaurice196.
`clear @a[team=SkyWing] cooked_beef 12`Clear 12 steak from every player on the SkyWing team.
`clear CalamityLegendz diamond_sword{Enchantments: [{id: "minecraft:sharpness", lvl: 1000s}]}`Clear all diamond swords with Sharpness 1000 from CalamityLegendz.
`clear @s iron_sword{titanium: 1b} 0`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.*
## `/datapack` Enable or disable a data pack or list all data packs.
`/datapack <(disable | enable) | list>`Syntax for the command.
`datapack disable "file/Ender Dragon"`Disable the "Ender Dragon" data pack.
`datapack enable "file/Example Datapack"`Load the "Example Datapack" data pack.
`datapack list`List all data packs.
## `/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 ` - 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 ` - sets the position of the command execution to either the eyes or feet of the executor. - `as ` - 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 ` - sets the location of the execution without changing the executor. You must use `as` to set the executor. - `facing >` - sets the execution rotation. - `in ` - sets the execution dimension. This will account for distance scaling in the nether and custom dimensions. - `on ` - sets the executor based on relation to the current executor. - `positioned ` - sets the execution position. - `rotated >` - sets the execution rotation. - `summon ` - summons a new entity at the execution position and sets it as the executor. - `(if|unless) biome ` - checks for the given biome at a given position. - `(if|unless) block ` - checks for the given block at a given position. - `(if|unless) blocks (all|masked)` - compares blocks in two volumes. - `(if|unless) data ` - checks whether the targeted block, entity or storage has any data tag for a given path. - `(if|unless) dimension ` - checks if the execution is in a matching dimension. - `(if|unless) 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 ` - checks whether one or more entities exist. - `(if|unless) loaded ` - checks if chunks at a given position is fully loaded. - `(if|unless) predicate ` - checks whether the predicate successes. This is primarily a data pack feature. - `(if|unless) score >` - checks whether a score has the specific relation to another score, or whether it is in a given range. - `store (result|success) ` - 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`.
`/execute [run ]`Syntax for the command.
`execute run say Hello, world!`The same thing as simply using "/say Hello, world!" Not very practical...
`execute as @e[type=pig] run say I'm a pig!`Change the executing entity to all pigs... ...then force them to use "/say I'm a pig!". Nice!
`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`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.
## `/give` Gives the targeted selectors an item with optional NBT attached.
`/give [nbt]`Syntax for the command.
`give BogTheMudWing potato`Give BogTheMudWing 1 potato.
`give @a[limit=10, sort=random] diamond{display: {Name: "Actual Coal"}}`Give 10 random players 1 diamond named "Actual Coal".
## `/kick` Terminates a player's connection to the server.
`/kick [reason]`Syntax for the command.
`kick FlawLessII`Kick FlawLessII from the server.
`kick s0meb0dysupply Profanity`Kick s0meb0dysupply from the server for profanity.
## `/pardon, pardon-ip` Remove a player or an IP from the banlist, regranting said player or IP access to the server.
`/pardon | pardon-ip `Syntax for the command.
`pardon jjj_North`Pardon jjj\_North.
`pardon-ip 7pencilsharpen3r`Pardon 7pencilsharpen3r's IP.
## `/scoreboard` Add objectives, get player scores, manipulate scoreboard objectives, and much more. This command is **very** extensive and powerful!
`/scoreboard ...`Syntax for the command.
`scoreboard objectives add player_health health`Create a scoreboard objective called "player\_health" that tracks... the players' health.
`scoreboard objectives modify player_health displayname {"text": "Player Health", "color": "red"}`Modify the "player\_health" scoreboard to appear as "Player Health" in red.
`scoreboard players get Julibeau WhiteKills`Get Julibeau's score in the objective WhiteKills.
## `/summon` Summons an entity.
`/summon [ [NBT]]`Syntax for the command.
`summon ender_dragon`Summons an Ender Dragon.
`summon iron_golem ~ ~ ~ {NoAI: 1b}`Summons an iron golem at the current position with no AI.
`summon cow ^ ^ ^10 {active_effects: [{id: "minecraft:levitation", amplifier: 10, duration: 200}], DeathLootTable: "chests/abandoned_mineshaft"}`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.
## `/tellraw` Announce a [highly-customizable message](https://www.minecraftjson.com/) to a selector using JSON.
`/tellraw [string or JSON]`Syntax for the command.
`tellraw FrazzledDingo "Welcome to the server!"`Show the message "Welcome to the server!" to FrazzledDingo.
`tellraw @a[team=Green] {"text": "You are on the Green team!", "color": "dark_green"}`Show the message "Welcome to the server!" to all players on the Green team.
`tellraw @a[distance=..30] [{"selector": "@r[distance=..30]", "color": "red"}, {"text": " won the ", "color": "gray"}, {"text": "Grand Raffle", "color": "gold"}, {"text": "!", "color": "gray"}]`Show the message "<random player up to 30 blocks away> won the Grand Raffle!" to all players up to 30 blocks away.
## `/whitelist` Add or remove a player from the whitelist, enable or disable the whitelist, or reload the whitelist.
`/whitelist `Syntax for the command.
`whitelist add RaspberryConflict`Adds RaspberryConflict to the whitelist.
`whitelist remove known__clams`Removes known\_\_clams from the whitelist.
`whitelist on`Activates the whitelist, allowing only those on the whitelist to join the server.
`whitelist off`Deactivates the whitelist, allowing any player to join the server.
`whitelist reload`Reloads the whitelist.
# Plugins # Overview There are a variety of plugins that add important or convenient commands. Keep in mind that ****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) is our data logging and anti-griefing tool. We use this plugin to rollback areas, check for player actions, and backup the server.
CommandDescription
`/co help` πŸ›‘οΈ πŸ“— Display a list of commands in-game.
`/co inspect` πŸ›‘οΈ πŸ“— Enable the inspector. Type the command again to disable it. You can also use just `/co i` .
`/co lookup` πŸ›‘οΈ πŸ“— Check for specific actions by a player, in an area, or even in the past set amount of time.
`/co rollback` πŸ›‘οΈ πŸ“’ Perform a rollback. Uses the same parameters as `/co lookup` . **Rollbacks can be used to revert player actions.**
`/co restore` πŸ›‘οΈ πŸ“’ Perform a restore. Uses the same parameters as `/co lookup` . **Restoring can be used to undo rollbacks or to restore player actions.**
`/co purge t:` πŸ›‘οΈ πŸ“• Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.
`/co reload` πŸ›‘οΈ πŸ“— Reloads the configuration file.
`/co status` πŸ›‘οΈ πŸ“— Displays the plugin status and version information.
`/co consumer` πŸ›‘οΈ πŸ“— Console command to pause or resume consumer queue processing.
ParameterDescription
`u:` Specifies a single user or multiple users.
`t:` Specifies weeks, days, hours, minutes, and/or seconds. Time amounts can be combined, and decimals may be used.
`r:` Specifies a spherical radius centered at your current location.
`a:` Specifies an action to check.
`i:` Specifies a block, item, or entity that the operation must include.
`e:` Specified a block, item, or entity that the operation must not include.
`#` Add a hashtag to the end of your command to perform additional actions.
# Dreamvisitor [Dreamvisitor](https://github.com/stonley890/Dreamvisitor/wiki), 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 [Dreamvisitor wiki](https://github.com/stonley890/Dreamvisitor/wiki/Commands).
CommandDescription
`/aradio ...` πŸ›‘οΈ πŸ“— Send a message to all operators.
`/discord` πŸ“— Toggle whether messages from the Discord chat bridge appear in your chat. This can also be adjusted with `/dvset` .
`/dreamvisitor manage` πŸ›‘οΈ πŸ“• View or modify the Dreamvisitor configuration.
`/dvset` πŸ“— Manage your Dreamvisitor settings.
`/hub [entities]` πŸ›‘οΈ πŸ“— 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.
`/invswap` πŸ›‘οΈ πŸ“— Swap between two different inventories.
`/itemblacklist` πŸ›‘οΈ πŸ“’ Open the item ban list inventory GUI.
`/moonglobe remove ` πŸ›‘οΈ πŸ“— Remove moon globes from players.
`/moonglobe add ` πŸ›‘οΈ πŸ“— Give players moon globes.
`/panic` πŸ›‘οΈ πŸ“• Kick all players and sets the player limit override to 0.
`/parcel cancel` πŸ›‘οΈ πŸ“— Cancel your current parcel delivery.
`/parcel locations add ` πŸ›‘οΈ πŸ“— Add a delivery location. `name` cannot contain spaces, but underscores will be replaced with spaces when displayed to players. `weight` determines the likelihood of the location being chosen. At 0, it will never be chosen. At 4, it is quite likely to be chosen. `home_tribe` determines only which names will appear on parcels to or from this location.
`/parcel locations remove ` πŸ›‘οΈ πŸ“’ Remove a delivery location.
`/parcel locations list` πŸ›‘οΈ πŸ“— List all mail delivery locations.
`/parcel delivery terminal ` πŸ›‘οΈ πŸ“— Give a player a parcel or allow players to deliver parcels to a location within 10 blocks.
`/parcel delivery add ` πŸ›‘οΈ πŸ“— Create deliveries for players.
`/parcel delivery remove ` πŸ›‘οΈ πŸ“— Cancel deliveries for players.
`/parcel delivery list` πŸ›‘οΈ πŸ“— List ongoing deliveries.
`/pausebypass add ` πŸ›‘οΈ πŸ“— Allow players to chat even when chat is paused.
`/pausechat` πŸ›‘οΈ πŸ“• Suppresses messages from players and the Discord chat bridge.
`/playerlimit [newLimit]` πŸ›‘οΈ πŸ“• Override the server player limit.
`/radio ` πŸ›‘οΈ πŸ“— Send a message to all other players who can access the radio.
`/sandbox [on|off]` πŸ›‘οΈ πŸ“’ Manage players' access to Sandbox Mode.
`/setback [location] [rotation] [world]` πŸ›‘οΈ πŸ“— 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.
`/setmotd [newMotd...]]` πŸ›‘οΈ πŸ“— Change or reset the server MOTD.
`/softwhitelist add ` πŸ›‘οΈ πŸ“— Add a player to the soft whitelist.
`/softwhitelist remove ` πŸ›‘οΈ πŸ“— Remove a player from the soft whitelist.
`/softwhitelist list` πŸ›‘οΈ πŸ“— List all players on the soft whitelist.
`/softwhitelist on` πŸ›‘οΈ πŸ“— Enable the soft whitelist.
`/softwhitelist off` πŸ›‘οΈ πŸ“— Disable the soft whitelist.
`/synctime [world]` πŸ›‘οΈ πŸ“— Sync time across all worlds.
`/tagradio ` πŸ›‘οΈ πŸ“— Send a message to all players with a given tag.
`/togglepvp` πŸ›‘οΈ πŸ“— Toggle whether PvP is enabled or disabled.
`/tribeupdate ` πŸ›‘οΈ πŸ“— Update the roles of a player based on their tribe.
`/unwax` πŸ›‘οΈ πŸ“— Unwax the sign you are looking at.
`/user ` πŸ›‘οΈ πŸ“— Get details of a player, online or offline.
`/zoop` πŸ›‘οΈ πŸ“— Sends a fake leave message to Discord and hides you from the list command.
## ****Item Blacklist**** `/itemblacklist` 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. ****This removal is permanent.**** Be cautious of items you add. ****Items are only removed if the data is an exact match.**** If you put a potato into the blacklist GUI, potatoes that have been renamed or enchanted will not be removed. ![](https://raw.githubusercontent.com/Stonley890/ItemVoid/main/ItemVoidDemoSmall.GIF) A demonstration of the item blacklist. ## ****Soft Whitelist**** 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 `dreamvisitor.nowhitelist` permission will always bypass the soft whitelist. ****Operators will always bypass the soft whitelist.**** The soft whitelist persists through restarts. ## ****Sandbox Mode**** ****Sandbox Mode**** 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: - They cannot access containers. - They cannot drop items. - They cannot use spawn eggs. - They cannot teleport. A player with the `dreamvisitor.sandbox` 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. ## ****Pause Chat**** The `/pausechat` command will stop all incoming chat messages from being broadcasted. It will also block messages from `/me` and Discord pass-through. You can allow certain players to bypass this with `/pausebypass`. Players with the `dreamvisitor.nopause` permission will always bypass chat pause. ****Operators will always bypass chat pause.**** Chat pause will persist through restarts. ## ****Moon Globes**** Moon Globes can be created with the `moonglobe` command. 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 **not** 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. ## ****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. When a player interacts with a terminal (a command block with the command `/parcel terminal @p`), 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 `mailDeliveryLocationSelectionDistanceWeightMultiplier` option in `config.yml`. 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. 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 `mailDistanceToRewardMultiplier` in `config.yml`. ## ****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. 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 `dailyBaseAmount` and the steak multiplier is configured by `dailyStreakMultiplier` in `config.yml`. Users can work once every hour. The work reward is configured by `workReward`. # EssentialsX [EssentialsX](https://essinfo.xeya.me/commands.html) 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:
CommandDescription
`/editsign [line number] [text]` πŸ›‘οΈ πŸ“— Edits a sign that the player is looking at.
`/msgtoggle [player] [on|off]` πŸ“— Blocks receiving all private messages.
`/mute [datediff]` πŸ“— Mutes or unmutes a player.
`/spawner [delay]` πŸ›‘οΈ πŸ“— Change the mob type of a spawner.
`/powertool [l:|a:|r:|c:|d:][command] [arguments] ({player} can be replaced by name of a clicked player.)` πŸ›‘οΈ πŸ“’ Assigns a command to the item in hand. Use `c:` as the command to make a chat macro. Use `a:` to append multiple commands. Use `r:` to remove a single command. Use `l:` to list all power tools Use `d:` to remove all power tools.
`/gc` πŸ›‘οΈ πŸ“— Reports memory, uptime and tick info.
`/enderchest [player], /ec` πŸ›‘οΈ πŸ“— Lets you see inside an ender chest.
`/powertooltoggle` πŸ›‘οΈ πŸ“— Enables or disables all current powertools.
`/speed [type] [player]` πŸ›‘οΈ πŸ“— Change your walk or fly speed.
`/whois ` πŸ›‘οΈ πŸ“— Displays player information.
`/disposal` πŸ›‘οΈ πŸ“— Opens a portable disposal menu.
`/condense [itemname]` πŸ›‘οΈ πŸ“— Condenses items into more compact blocks.
`/book [title|author [name]]` πŸ›‘οΈ πŸ“— Allows reopening and editing of sealed books.
`/mail [read|clear|clear [number]|send [to] [message]|sendtemp [to] [expire time] [message]|sendall [message]]` πŸ“— Manages inter-player, intra-server mail.
`/pweather [list|reset|storm|sun|clear] [player|*]` πŸ›‘οΈ πŸ“— Adjust a player's weather.
`/ignore ` πŸ“— Toggles ignoring other players.
`/near [playername] [radius]` πŸ“— Lists the players nearby or around a player.
`/invsee [armor]` πŸ›‘οΈ πŸ“— See and/or edit the inventory of other players.
`/socialspy [player] [on|off]` πŸ›‘οΈ πŸ“— Toggles if you can see msg/mail commands in chat.
`/ptime [list|reset|day|night|dawn|17:30|4pm|4000ticks] [player|*]` πŸ›‘οΈ πŸ“— Adjust player's client time. Add @ prefix to fix.
`/home [player:]` πŸ“— Teleport to your home.
`/vanish [player] [on|off]` πŸ›‘οΈ πŸ“— Hide yourself from other players.
`/god [player] [on|off]` πŸ›‘οΈ πŸ“— Enables your godly powers.
`/skull [owner]` πŸ›‘οΈ πŸ“— 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.
`/broadcast ` πŸ›‘οΈ πŸ“— Broadcasts a message to the entire server.
`/itemdb ` πŸ›‘οΈ πŸ“— Searches for an item.
`/itemlore [text\|line] [text]` πŸ›‘οΈ πŸ“— Edit the lore of an item.
`/itemname [name]` πŸ›‘οΈ πŸ“— Renames the item you're currently holding. Leave `[name]` empty to reset. You can add in color codes when you have permission to.
`/eco ` πŸ›‘οΈ πŸ“’ Manages a player's economy.
`/feed [player]` πŸ›‘οΈ πŸ“— Satisfy the hunger of a specified player.
`/heal [player]` πŸ›‘οΈ πŸ“— Heals you or the given player.
`/nick [player] ` πŸ›‘οΈ πŸ“— Change your nickname or that of another player.
## ****Powertools**** `/powertool` allows you to assign a command to an item. Pressing the attack button (left mouse button by default) will execute the command. The argument `{player}` will insert the name of a clicked player. There are five flags you can prepend to the argument that change the behavior of `/powertool. c:` will create a chat macro. Instead of running a command, the powertool will send a chat message. Use `a:` to append multiple commands. Use `r:` to remove a single command from a powertool. Use `l:` to list all power tools and their commands. Use `d:` to remove all power tools.
Command Description
`/powertool setblock ~ ~-1 ~ stone` Executes 'setblock ~ ~-1 ~ stone' on click.
`/powertool effect give {player} regeneration` Gives regeneration to a player that you click on.
`/powertool a:effect give {player} saturation` Adds a subsequent command to give saturation to a clicked player
# GriefDefender [GriefDefender](https://docs.griefdefender.com/wiki) is the claim and anti-grief system we use that allows players to claim and protect 2D and 3D land plots.
CommandDescription
`/abandon ` πŸ“’ πŸ“• Abandon a specific claim, or all of your owned claims.
`/abandon world [world]` πŸ›‘οΈ πŸ“• Abandon all claims in the current world or a specified world.
`/buyblocks ` πŸ“— Purchases additional claim blocks.
`/gd buy claim` πŸ“— View a list of claims for sale.
`/contractclaim ` πŸ“— Contracts/shrinks the claim from the direction you are facing.
`/claimcreate [type]` πŸ“— Creates a claim around the player of the given type.
`/expandclaim ` πŸ“— Expands the claim in the direction you are facing.
`/gd claim farewell ` πŸ“— Sets a message to display when a player leaves the claim.
`/gd claim greeting ` πŸ“— Sets a message to display when a player enters the claim.
`/claimnotifications` πŸ“— Enable/disable greeting and farewell messages on trusted claims.
`/gd claim we ` πŸ“— Used to manage GD claims with WorldEdit.
`/cuboid` πŸ“— Toggles 3D claiming on and off.
`/modeadmin` πŸ›‘οΈ πŸ“— Enables admin claim mode with the claiming tool.
`/modebasic` πŸ“— Enables basic claim mode with the claiming tool.
`/modesubdivide` πŸ“— Enables subdivide claim mode with the claiming tool.
`/modetown` πŸ“— Enables town claim mode with the claiming tool.
`/gd player info ||[]` πŸ›‘οΈ πŸ“— Gets information about a player and their claim blocks.
`/sellblocks ` πŸ“— Sell your claim blocks for server money.
`/gd sell claim ` πŸ“— 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.
`/transferblocks ` πŸ“— Transfers the player's claim blocks to another player.
`/trapped` πŸ“— Teleports the player to a safe location if they are stuck and unable to build.
`/trust|trustall ` πŸ“— View and manage claim permissions for this claim or all claims you own.
`/untrust|untrustall ` πŸ“— Revoke a player or group's access to this claim or all claims you own.
## ****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) is a permissions plugin for Minecraft servers. It allows server admins to control what features players can use by creating groups and assigning permissions.
CommandDescription
`/lp editor` πŸ›‘οΈ πŸ“— Provides a link to a web editor. This editor is used to manage permissions.
# SignShop [SignShop](https://dev.bukkit.org/projects/signshop/pages/signs) 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.
SignDescription
`[Buy]` / `[Sell]` Buy / sell an item from the shop chest for the price specified on the 4th line.
`[Trade]` Trades one set of items for another, 2 chests required.
`[Share]` 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).
`[Bank]` 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).
`[Donate]` Gives an item to the shop chest.
`[DonateHand]` Donates the item in your hand to the shop chest.
`[Dispose]` Takes the item in your hand and safely decomposes the material.
`[Slot]` Gives a random item from the selected chest items (not the entire inventory) to the player.
`[DeviceOn]` Turns a lever on.
`[DeviceOff]` Turns a lever off.
`[Toggle]` Toggles a lever.
`[Device]` Temporarily turns on a lever.
`[DeviceItem]` Temporarily turns on a lever using items as payment.
`[Jukebox]` Allows players to create jukeboxes by placing music discs in a chest.
`[Restricted]` Makes it so only certain permission groups can use the linked SignShop (listed on lines 2, 3, and 4).
`[gBuy]` πŸ›‘οΈ Buy an item from the shop chest, but the owner receives no money.
`[gSell]` πŸ›‘οΈ Sell an item to the shop chest, and the player receives money, but not from the owner.
`[iBuy]` πŸ›‘οΈ Buy an item from the "shop", money goes to no one, infinite items.
`[iSell]` πŸ›‘οΈ Sell an item to the "shop", infinite money, item disappears.
`[iTrade]` πŸ›‘οΈ Trades one set of items for another, infinite stock.
`[Class]` πŸ›‘οΈ Takes the user's inventory and replaces it with items from a chest, infinite stock.
`[Kit]` πŸ›‘οΈ Gives the buyer a set of items once (infinite stock), must be reset using ResetKit sign before they can use it again.
`[ResetKit]` πŸ›‘οΈ Allows a player to use a Kit sign again.
`[iBuyXP]` πŸ›‘οΈ Buy the number of XP levels on the third line of the sign.
`[iSellXP]` πŸ›‘οΈ Sell the number of XP levels on the third line of the sign.
`[iXPBuy]` πŸ›‘οΈ Buy an item using raw XP points on the third line of the sign.
`[iXPSell]` πŸ›‘οΈ Sell an item using raw XP points on the third line of the sign.
`[iSlot]` πŸ›‘οΈ Gives a random item from the selected chest items with infinite stock.
`[Day]` πŸ›‘οΈ Turns the time to day.
`[Night]` πŸ›‘οΈ Turns the time to night.
`[Rain]` πŸ›‘οΈ Turns on rain + thunder.
`[ClearSkies]` πŸ›‘οΈ Turns off rain + thunder.
`[Repair]` πŸ›‘οΈ Repairs the current item.
`[Heal]` πŸ›‘οΈ Fully heals the player.
`[Enchant]` πŸ›‘οΈ Sells the enchantments from the item in the chest.
`[Disenchant]` πŸ›‘οΈ Removes enchantments from an item.
`[TpToOwner]` πŸ›‘οΈ An example of a custom sign for running commands.
`[Command]` πŸ›‘οΈ Allows players to run commands on the 2nd and 3rd lines of the sign.
`[UserCommand]` πŸ›‘οΈ Allows players to run commands on the 2nd and 3rd lines of the sign as if they typed it themselves.
`[Promote]` πŸ›‘οΈ Promotes players to the permission group listed on the 2nd line of the sign.
# spark [spark](https://spark.lucko.me/docs/Command-Usage) (yes, the **s** is not capitalized) is a performance monitoring tool.
CommandDescription
`/spark profiler` πŸ›‘οΈ πŸ“— Used to start, stop, or view information on a profiler. Profilers are used to create digestible information on how well the server is running.
`/spark tps` πŸ›‘οΈ πŸ“— Prints information about the servers TPS (ticks per second) rate and CPU usage.
`/spark health` πŸ›‘οΈ πŸ“— Generates a health report for the server, including TPS, CPU, Memory and Disk Usage.
`/spark ping [--player ]` πŸ›‘οΈ πŸ“— Prints information about average (or specific) player ping.
`/spark tickmonitor` πŸ›‘οΈ πŸ“— Controls the tick monitoring system.
`/spark gc` πŸ›‘οΈ πŸ“— Prints information about the servers GC (garbage collection) history.
`/spark gcmonitor` πŸ›‘οΈ πŸ“— Toggles the GC (garbage collection) monitoring system on or off.
`/spark heapsummary` πŸ›‘οΈ πŸ“— Generates a new memory (heap) dump summary and upload it to the viewer.
`/spark heapdump` πŸ›‘οΈ πŸ“— Generates a new heapdump (.hprof snapshot) file and saves to the disk.
`/spark activity` πŸ›‘οΈ πŸ“— Prints information about recent activity performed by spark.
# WorldEdit [WorldEdit](https://worldedit.enginehub.org/en/latest/) is a terrain editing plugin that allows operators to move and shape large quantities of blocks. We recommend using [WorldEdit CUI](https://www.curseforge.com/minecraft/mc-mods/worldeditcui-fabric) 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 [WorldEdit Documentation Hub](https://worldedit.enginehub.org/en/latest/commands/). ## Basic Commands
CommandDescription
`//wand` πŸ›‘οΈ πŸ“— Gives the player a wand (wooden axe). Left click to select the first desired position, right click to select the second.
`//undo [#]` πŸ›‘οΈ πŸ“— Reverses a chosen number of WorldEdit commands. Defaults to 1.
`//redo [#]` πŸ›‘οΈ πŸ“— Reverses a chosen number of `//undo` commands. Defaults to 1.
`//pos1|pos2` , `//1|2` πŸ›‘οΈ πŸ“— Sets first and second positions to your current location respectively without the wand.
`//set ` πŸ›‘οΈ πŸ“— πŸ“’ Sets the current selection to the chosen block.
`//replace ` πŸ›‘οΈ πŸ“— πŸ“’ Replaces the target block in a selection to the chosen block.
`//replacenear ` πŸ›‘οΈ πŸ“’ Replaces the target block in the radius to the chosen block.
`//copy` πŸ›‘οΈ πŸ“— Copies all blocks in a selection to the clipboard.
`//cut` πŸ›‘οΈ πŸ“— Cuts all blocks in a selection to the clipboard.
`//paste` πŸ›‘οΈ πŸ“’ πŸ“• Pastes all blocks in the clipboard relative to the player's position.
`//clear clipboard` πŸ›‘οΈ πŸ“— Clears the clipboard.
`//rotate ` πŸ›‘οΈ πŸ“— Rotates the contents of the clipboard with the given angle (multiples of 90).
`//flip ` πŸ›‘οΈ πŸ“— Flips the contents of the clipboard across the given direction or the direction the player is facing.
`//move ` πŸ›‘οΈ πŸ“— πŸ“’ Moves all blocks in the selection to the chosen distance relative to the direction the player is facing.
## Tool Commands
CommandDescription
`//shift ` πŸ›‘οΈ πŸ“— πŸ“’ Shifts the selection a given amount.
`//expand ` πŸ›‘οΈ πŸ“— Expands the selection a given amount.
`//contract ` πŸ›‘οΈ πŸ“— Contracts the selection a given amount.
`//sel` πŸ›‘οΈ πŸ“— Deselects the selection.
`//count ` πŸ›‘οΈ πŸ“— Counts the number of blocks in a selection.
`//size` πŸ›‘οΈ πŸ“— Provides information about the selection.
`//drain ` πŸ›‘οΈ πŸ“— Drains water and lava in the given radius.
`//fixwater|fixlava ` πŸ›‘οΈ πŸ“— Levels water or lava in the given radius.
`/butcher ` πŸ›‘οΈ πŸ“— πŸ“’ Kills mobs in the given radius.
`/up ` πŸ›‘οΈ πŸ“— Teleports the player up on the y axis the given amount of blocks.
`/thru` πŸ›‘οΈ πŸ“— Teleports the player through obstacles in the facing direction.
`/give debugstick 1` πŸ›‘οΈ πŸ“— Gives the player a debug stick that can be used to easily rotate blocks.
## Generation Commands
CommandDescription
`//stack <#>` πŸ›‘οΈ πŸ“— Repeats the content of the selection the chosen distance (#) relative to the direction the player is facing.
`//schematic list` πŸ›‘οΈ πŸ“— Lists available saved schematics.
`//schematic load ` πŸ›‘οΈ πŸ“— Loads the chosen schematic into the clipboard.
`//schematic paste` πŸ›‘οΈ πŸ“’ Pastes the schematic currently in the clipboard.
`//schematic save ` πŸ›‘οΈ πŸ“— Saves the current selection as a schematic with the chosen name.
`//schematic delete ` πŸ›‘οΈ πŸ“— Deletes the chosen saved schematic.
`//hollow ` πŸ›‘οΈ πŸ“— Hollows out the object in the selection with the given wall thickness and block.
`//walls ` πŸ›‘οΈ πŸ“— Creates walls around the sides of the selection with the chosen block.
`//cyl ` πŸ›‘οΈ πŸ“— Creates a cylinder of the specified size using the chosen block.
`//hcyl ` πŸ›‘οΈ πŸ“— Creates a hollow cylinder of the specified size using the chosen block.
`//sphere ` πŸ›‘οΈ πŸ“— Creates a sphere of the specified size using the chosen block.
`//hsphere ` πŸ›‘οΈ πŸ“— Creates a hollow sphere of the specified size using the chosen block.
`//pyramid ` πŸ›‘οΈ πŸ“— Creates a pyramid of the specified size using the chosen block.
`//hpyramid ` πŸ›‘οΈ πŸ“— Creates a hollow pyramid of the specified size using the chosen block.
`//fill ` πŸ›‘οΈ πŸ“— πŸ“’ Fills a hole or container with the given block.
`//forest ` πŸ›‘οΈ πŸ“— Generates the specified type of forest in the selected region.
`//snow ` πŸ›‘οΈ πŸ“— Places snow in a given radius.
## Brush Commands
CommandDescription
`//br sphere ` πŸ›‘οΈ πŸ“— Applies a sphere brush to the held tool. Right click to use the brush.
`//br cyl ` πŸ›‘οΈ πŸ“— Applies a cylinder brush to the held tool. Unlike the sphere, the cylinder brush has a height parameter along with a radius.
`//br smooth ` πŸ›‘οΈ πŸ“— Applies a horizontal smoothing brush to the held tool.
`//br deform ` πŸ›‘οΈ πŸ“— Applies a deform brush to the held tool.
`/br none/unbind` πŸ›‘οΈ πŸ“— Unbinds the brush from the tool you are currently holding.
`/mask ` πŸ›‘οΈ πŸ“— Applies or removes a mask to the selected brush. The brush will only affect the specified block until the mask is disabled using `/mask` again.
`/gmask ` πŸ›‘οΈ πŸ“— Sets a global mask for all brushes. The brush will only affect the specified block until the mask is disabled using `/gmask` again.
`/tracemask #solid` πŸ›‘οΈ πŸ“— Allows brush to work underwater. Run `/tracemask` to disable.
## Flags
FlagDescription
`[%block1,%block2,%block3,...]` 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. / `/replace stone 70%dirt,30%cobblestone` )
`[facing=direction]` Specifies where a directional block should face.
`[-a]` Ignore air blocks.
`[-e]` Include entities.
`[-b]` Include biomes.
`[-m ]` Excludes everything that isn't a given block.
`[!]` Prefixing any block with an exclamation point will exclude everything that comes after it. (e.g. <code>//replace !dirt stone</code> will replace everything that is not dirt with stone.)
`[*]` Prefixing any block with an asterisk (\*) will set the given block in random directions.
# WorldGuard [WorldGuard](https://worldguard.enginehub.org/en/latest) is a plugin that allows operators to create regions with specific game rules and functions. We recommend using [WorldEdit CUI](https://www.curseforge.com/minecraft/mc-mods/worldeditcui-fabric) 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 [WorldGuard Documentation Hub](https://worldguard.enginehub.org/en/latest/). ## Basic Commands
CommandDescription
`//wand` πŸ›‘οΈ πŸ“— Gives the player a wand (wooden axe). Left click to select the first desired position, right click to select the second.
`//pos1|pos2` πŸ›‘οΈ πŸ“— Sets first and second positions to your current location respectively without the wand.
`/rg define ` πŸ›‘οΈ πŸ“— Creates a new region using the current selection.
`/rg remove ` πŸ›‘οΈ πŸ“’ πŸ“• Deletes the given region. This cannot be undone.
`/rg info ` πŸ›‘οΈ πŸ“— 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.
`/rg flags ` πŸ›‘οΈ πŸ“— Lists all region flags in the given region. Manual selections can be made in this menu.
`/rg flag ` πŸ›‘οΈ πŸ“— πŸ“’ Allows or denies a specified game rule in the given region.
`/rg setpriority` πŸ›‘οΈ πŸ“— πŸ“’ Sets the priority of a given region. Higher number priorities override the permissions of lower number priorities.
`/rg flag deny-message ` πŸ›‘οΈ πŸ“— Sets the message players will receive when an action they attempt is blocked.
`/rg flag blocked-cmds ` πŸ›‘οΈ πŸ“— πŸ“’ Blocks specific commands from being used in the given region. Additional commands can be added by separating with a comma (e.g. `/rg flag spawn blocked-cmd /tpa,/back,/tell` ).
## Flags Flags are used to make changes to what can be edited by certain players. Note that there are three default permission groups: `non-member`, `member`, and `owner`. ****You do not need to set any flags to protect a region.**** Also note that flags are not player-specific. Setting `block-break` 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 ****members****. A member is anything **inside** the region. By default, pistons will work inside the region, but pistons outside the region cannot push blocks inside because they are **non-members**. 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 ****deny building for all permission groups.**** This is when you want to set `build` to `deny`. 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 **members** but deny **non-members**. Setting a flag to `allow` or `deny` applies that setting to both members and non-members.
FlagDescription
`passthrough` πŸ“’ 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 `deny` , then the region protects its area. If set to `allow` , then the region no longer protects its area.
`build` πŸ“’ πŸ“• 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. ****This should not be used to protect a region!**** Regions are automatically protected by the `passthrough` flag.
`interact` πŸ“— 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.
`block-break` / `block-place` πŸ“— Whether blocks can be mined / used.
`use` πŸ“— Whether doors, levers, etc. (but not inventories) can be used.
`damage-animals` πŸ“— Whether players can harm friendly animals (cows, sheep, etc).
`chest-access` πŸ“— Whether inventories can be accessed.
`ride` πŸ“— Whether vehicles (including animals) can be mounted.
`pvp` πŸ“— Whether player versus player combat is permitted.
`sleep` πŸ“— Whether sleeping in a bed is permitted.
`respawn-anchors` πŸ“— Whether respawn anchors can be activated.
`tnt` πŸ“— Whether TNT detonation or damage is permitted.
`vehicle-place` / `vehicle-destroy` πŸ“— Whether vehicles (boats, minecarts) can be placed / destroyed.
`lighter` πŸ“— Whether flint and steel can be used.
`block-trampling` πŸ“— Whether farmland and turtle eggs can be trampled.
`frosted-ice-form` πŸ“— Whether players with frost walker boots will form ice.
`item-frame-rotation` πŸ“— Whether items can be rotated within item frames.
`firework-damage` πŸ“— Whether fireworks can deal damage to entities.
`use-anvil` πŸ“— Whether anvils can be used.
`use-dripleaf` πŸ“— Whether dripleaf can be used.
WorldGuard Extra Flags provides the following extra flags. Note that ****most of these flags bypass operators entirely.****
FlagDescription
`blocked-effects` πŸ“— Disables the effects of potion effects while inside.
`chat-prefix` / `chat-suffix` πŸ“— Defines the prefix/suffix shown when inside the region.
`chunk-unload` πŸ“’ Prevents chunks the region occupies from being unloaded.
`command-on-entry` / `command-on-exit` πŸ“’ Executes a command as the player when a player enters/exits the region.
`console-command-on-entry` / `console-command-on-exit` πŸ“’ Executes a command as the console when a player enters/exits the region.
`fly` πŸ“— πŸ“’ When set to `deny` , disallows creative flight from the ground.
`frostwalker` πŸ“— When set to `deny` , stops Frostwalker boots from forming ice on water within the region.
`give-effects` πŸ“— Gives players who enter the region a permanent [potion effect](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html) until they leave.
`glide` πŸ“— When set to `deny` , stops all gliding inside the region.
`godmode` πŸ“— When set to `allow` , stops all damage delivered to players.
`item-durability` πŸ“— When set to `deny` , tools will not be damaged by any actions.
`join-location` πŸ“— Players who disconnect in the region will teleport to the given location when joining.
`keep-exp` πŸ“’ When set to `allow` , players always keep experience levels on death. If the `keepInventory` gamerule is set to `true` and this flag is set to `deny` , the experience will be deleted on death.
`keep-inventory` πŸ“’ When set to `allow` , players always keep inventory on death. If the `keepInventory` gamerule is set to `true` and this flag is set to `deny` , the inventory will be deleted on death.
`nether-portals` πŸ“— When set to `deny` , nether portals cannot be lit.
`play-sounds` πŸ“’ 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.
`respawn-location` πŸ“— Sets the location to respawn players upon death.
`teleport-on-entry` / `teleport-on-exit` πŸ“— Teleports a player to the give location when they enter/exit the region.
`walk-speed` / `fly-speed` πŸ“— Players inside the region will inherit this speed while walking/flying.
`worldedit` πŸ“— When set to `deny` , stops all WorldEdit operations.
# CoreProtect [CoreProtect](https://docs.coreprotect.net) is our data logging and anti-griefing tool. We use this plugin to rollback areas, check for player actions, and backup the server.
CommandDescription
`/co help` πŸ›‘οΈ πŸ“— Display a list of commands in-game.
`/co inspect` πŸ›‘οΈ πŸ“— Enable the inspector. Type the command again to disable it. You can also use just `/co i`.
`/co lookup` πŸ›‘οΈ πŸ“— Check for specific actions by a player, in an area, or even in the past set amount of time.
`/co rollback` πŸ›‘οΈ πŸ“’ Perform a rollback. Uses the same parameters as `/co lookup`. *Rollbacks can be used to revert player actions.*
`/co restore` πŸ›‘οΈ πŸ“’ Perform a restore. Uses the same parameters as `/co lookup`. *Restoring can be used to undo rollbacks or to restore player actions.*
`/co purge t:` πŸ›‘οΈ πŸ“• Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.
`/co reload` πŸ›‘οΈ πŸ“— Reloads the configuration file.
`/co status` πŸ›‘οΈ πŸ“— Displays the plugin status and version information.
`/co consumer` πŸ›‘οΈ πŸ“— Console command to pause or resume consumer queue processing.
`/co near` πŸ›‘οΈ πŸ“— Performs a lookup with a radius of 5.
`/co undo` πŸ›‘οΈ πŸ“’ Revert a rollback/restore via the opposite action.
ParameterDescription
`u:` Specifies a single user or multiple users.
`t:` Specifies weeks, days, hours, minutes, and/or seconds. Time amounts can be combined, and decimals may be used.
`r:` Specifies a spherical radius centered at your current location.
`a:` Specifies an action to check.
`i:` Specifies a block, item, or entity that the operation must include.
`e:` Specified a block, item, or entity that the operation must not include.
`#` Add a hashtag to the end of your command to perform additional actions.
ActionDescription
`a:block`blocks placed/broken
`a:+block`blocks placed
`a:-block`blocks broken
`a:chat`messages sent in chat
`a:click`player interactions
`a:command`commands used
`a:container`items taken from or put in chests
`a:+container`items put in chests
`a:-container`items taken from chests
`a:inventory`items added or removed from player inventories
`a:+inventory`items added to player inventories
`a:-inventory`items removed from player inventories
`a:item`items dropped, thrown, picked up, deposited, or withdrawn by players
`a:+item`items picked up or withdrawn by players
`a:-item`items dropped, thrown, or deposited by players
`a:kill`mobs/animals killed
`a:session`player logins/logouts
`a:+session`player logins
`a:-session`player logouts
`a:sign`messages written on signs
`a:username`username changes
## 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 & 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), 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. ## Commands
CommandDescription
`/aradio ...` πŸ›‘οΈ πŸ“— Send a message to all operators.
`/discord` πŸ“— Toggle whether messages from the Discord chat bridge appear in your chat. This can also be adjusted with `/dvset`.
`/dreamvisitor manage [value]` πŸ›‘οΈ πŸ“• View or modify the Dreamvisitor configuration.
`/dvset` πŸ“— Manage your Dreamvisitor settings.
`/hub [entities]` πŸ›‘οΈ πŸ“— 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.
`/invswap` πŸ›‘οΈ πŸ“— Swap between two different inventories.
`/itembanlist` πŸ›‘οΈ πŸ“’ Open the item ban list inventory GUI.
`/moonglobe remove ` πŸ›‘οΈ πŸ“— Remove moon globes from players.
`/moonglobe create ` πŸ›‘οΈ πŸ“— Give players moon globes.
`/panic` πŸ›‘οΈ πŸ“• Kick all players and sets the player limit override to 0.
`/parcel cancel` πŸ›‘οΈ πŸ“— Cancel your current parcel delivery.
`/parcel locations add ` πŸ›‘οΈ πŸ“— Add a delivery location. `name` cannot contain spaces, but underscores will be replaced with spaces when displayed to players. `weight` determines the likelihood of the location being chosen. At 0, it will never be chosen. At 4, it is quite likely to be chosen. `home_tribe` determines only which names will appear on parcels to or from this location.
`/parcel locations remove ` πŸ›‘οΈ πŸ“’ Remove a delivery location.
`/parcel locations list` πŸ›‘οΈ πŸ“— List all mail delivery locations.
`/parcel delivery terminal ` πŸ›‘οΈ πŸ“— Give a player a parcel or allow players to deliver parcels to a location within 10 blocks.
`/parcel delivery add ` πŸ›‘οΈ πŸ“— Create deliveries for players.
`/parcel delivery remove ` πŸ›‘οΈ πŸ“— Cancel deliveries for players.
`/parcel delivery list` πŸ›‘οΈ πŸ“— List ongoing deliveries.
`/pausebypass add ` πŸ›‘οΈ πŸ“— Allow players to chat even when chat is paused.
`/pausebypass remove ` πŸ›‘οΈ πŸ“— Disallow players to chat when chat is paused.
`/pausebypass list` πŸ›‘οΈ πŸ“— List players allowed to chat even when chat is paused.
`/pausechat` πŸ›‘οΈ πŸ“• Suppresses messages from players and the Discord chat bridge.
`/playerlimit [new_limit]` πŸ›‘οΈ πŸ“• Override the server player limit.
`/radio ...` πŸ›‘οΈ πŸ“— Send a message to all other players who can access the radio.
`/sandbox [on|off]` πŸ›‘οΈ πŸ“’ Manage players' access to Sandbox Mode.
`/setback [location] [rotation] [world]` πŸ›‘οΈ πŸ“— 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.
`/setmotd [new_motd]...` πŸ›‘οΈ πŸ“— Change or reset the server MOTD.
`/softwhitelist add ` πŸ›‘οΈ πŸ“— Add a player to the soft whitelist.
`/softwhitelist remove ` πŸ›‘οΈ πŸ“— Remove a player from the soft whitelist.
`/softwhitelist list` πŸ›‘οΈ πŸ“— List all players on the soft whitelist.
`/softwhitelist on` πŸ›‘οΈ πŸ“— Enable the soft whitelist.
`/softwhitelist off` πŸ›‘οΈ πŸ“— Disable the soft whitelist.
`/synctime [world]` πŸ›‘οΈ πŸ“— Sync time across all worlds.
`/tagradio ` πŸ›‘οΈ πŸ“— Send a message to all players with a given tag.
`/togglepvp` πŸ›‘οΈ πŸ“— Toggle whether PvP is enabled or disabled.
`/tribeupdate ` πŸ›‘οΈ πŸ“— Update the permission groups of a player based on their tribe.
`/velocity [replace]` πŸ›‘οΈ πŸ“— Apply velocity to entities.
`/unwax` πŸ›‘οΈ πŸ“— Unwax the sign you are looking at.
`/user ` πŸ›‘οΈ πŸ“— Get details of a player, online or offline.
`/zoop` πŸ›‘οΈ πŸ“— Sends a fake leave message to Discord and hides you from the list command.
## 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 `/itembanlist` 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. **This removal is permanent.** Be cautious of items you add. **Items are only removed if the data is an exact match.** If you put a potato into the blacklist GUI, potatoes that have been renamed or enchanted will not be removed. ![](https://raw.githubusercontent.com/Stonley890/ItemVoid/main/ItemVoidDemoSmall.GIF) A demonstration of the item blacklist. ## Soft Whitelist 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 `dreamvisitor.nowhitelist` permission will always bypass the soft whitelist. **Operators will always bypass the soft whitelist.** The soft whitelist persists through restarts. ## Sandbox Mode **Sandbox Mode** 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: - They cannot access containers. - They cannot drop items. - They cannot use spawn eggs. - They cannot teleport. A player with the `dreamvisitor.sandbox` 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. [![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 The `/pausechat` command will stop all incoming chat messages from being broadcasted. It will also block messages from `/me` and Discord pass-through. You can allow certain players to bypass this with `/pausebypass`. Players with the `dreamvisitor.nopause` permission will always bypass chat pause. **Operators will always bypass chat pause.** Chat pause will persist through restarts. ## Moon Globes Moon Globes can be created with the `moonglobe` command. 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 *not* 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. ## 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. When a player interacts with a terminal (a command block with the command `/parcel terminal @p`), 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 `mailDeliveryLocationSelectionDistanceWeightMultiplier` option in `config.yml`. 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. 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 `mailDistanceToRewardMultiplier` in `config.yml`. ## 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 ``` - Daily Schedules ``` /schedule daily