Dreamvisitor

Dreamvisitor, 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

Command	Description
/aradio <message>...	🛡️ 📗 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 <key> [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 <players>	🛡️ 📗 Remove moon globes from players.
/moonglobe create <players> <location> <max_distance>	🛡️ 📗 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 <position> <name> <weight> <home_tribe>	🛡️ 📗 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 <name>	🛡️ 📒 Remove a delivery location.
/parcel locations list	🛡️ 📗 List all mail delivery locations.
/parcel delivery terminal <players>	🛡️ 📗 Give a player a parcel or allow players to deliver parcels to a location within 10 blocks.
/parcel delivery add <players> <start> <end>	🛡️ 📗 Create deliveries for players.
/parcel delivery remove <players>	🛡️ 📗 Cancel deliveries for players.
/parcel delivery list	🛡️ 📗 List ongoing deliveries.
/pausebypass add <players>	🛡️ 📗 Allow players to chat even when chat is paused.
/pausebypass remove <players>	🛡️ 📗 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 <message>...	🛡️ 📗 Send a message to all other players who can access the radio.
/sandbox <player> [on|off]	🛡️ 📒 Manage players' access to Sandbox Mode.
/setback <players> [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 <player>	🛡️ 📗 Add a player to the soft whitelist.
/softwhitelist remove <player>	🛡️ 📗 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 <tag> <message>	🛡️ 📗 Send a message to all players with a given tag.
/togglepvp	🛡️ 📗 Toggle whether PvP is enabled or disabled.
/tribeupdate <players>	🛡️ 📗 Update the permission groups of a player based on their tribe.
/velocity <entities> <vector> [replace]	🛡️ 📗 Apply velocity to entities.
/unwax	🛡️ 📗 Unwax the sign you are looking at.
/user <player>	🛡️ 📗 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.

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.