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.
/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.

Alt Tracker

Dreamvisitor can record Discord alternate accounts. Alts are stored as Alt Families. Each has one parent or "main" account and any number of child or "alt" accounts, stored in alts.yml using Discord Snowflake IDs. You can link a child account to a parent account using the Discord command /alts link <User: parent> <User: child>. Note that if the child is already linked to a different parent, you must first unset it. If the parent is a child of another parent, you'll have to unset it first. When you link a child account to a parent account, the infractions of the child are transferred to the parent. This operation is cannot be undone.

You can get the alts of an account with the Discord command /alts get <User: user>. Whether the user you specified is a parent or child account, the alt family will be retrieved. Note that although Dreamvisitor stores all child accounts added, only users in the same guild will be listed. If a child account leaves, it will still be stored, but not listed. You can also remove child account from the embed.

Infraction Tracker

Dreamvisitor can track infractions of Discord members.

Infractions have a value between 0 and 3 (inclusive). Infractions are recorded using the /warn <User: member> <Int: value> <Bool: silent> [String: reason] Discord command. The value plus the value of all previous infractions cannot exceed the ban point (three). If silent is True, the infraction will be recorded, but the member not notified. The reason will default to "No reason provided" if a reason is not provided.

If the user reaches the ban point after this infraction, Dreamvisitor will ask if you also want to ban the user. If the user has not been temp-banned before, Dreamvisitor will suggest a temp-ban of two weeks. Otherwise, you'll have the option to ban the user from only the Minecraft server or from both. Note that if you choose both, the user will be banned immediately and no warning will be sent. Alternatively, you can also choose to keep the note about the ban without the auto-ban, or you can choose to have Dreamvisitor not mention a ban in the warning at all.

If the infraction is not silent, Dreamvisitor will create a channel in the category defined by infractions-category-id in the configuration. The user will be added to the channel and the warning message will be sent. The user has the option to either mark it as dismissed (at which point the user will be removed, but the channel not deleted) or they can request help from a staff member, in which case Dreamvisitor will send a message that a staff member will assist. Dreamvisitor will send a reminder every 24 hours if there is no response to the warning.

The /infractions Discord command lists a user's infractions. It is also possible to expire an infraction or delete an infraction from this message. These actions cannot be undone. Infractions automatically expire after the time defined in infraction-expire-time-days from their creation.

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.