𝗠𝘂𝗹𝘁𝗶𝗽𝗹𝗮𝘆𝗲𝗿 𝗪𝗮𝘆𝗽𝗼𝗶𝗻𝘁 𝗦𝘆𝘀𝘁𝗲𝗺 [Always latest files]

In the menu, click "Explore public waypoints", then click on "My published waypoints". Select the waypoint for which you want to add a visitor to the blacklist:

Then click on the "Manage visitors" button to see who and when visited this published waypoint:

Now select the visitor you want to add to the blacklist:

Also, in addition to the visitor's nickname, this list shows how many times the visitor has visited this waypoint, and how long ago the last visit was.

Now, finally, you see the button for adding to the blacklist. Click on it.

The final step is to briefly describe the reason why you are adding this player to the blacklist. The player who is added to the blacklist will see this reason when they attempt to visit this waypoint.

Lastly, just click "Submit," and you can be sure this player won't visit your waypoint anymore!

For players who have been blacklisted, you will also see the number of "blocked visits" - this indicates how many times the player attempted to visit your waypoint, but the visit was blocked by the blacklist:

In the menu, click "Explore public waypoints". Then select the waypoint you want to report:

Scroll down a bit, and you will see the "Report" button. Click on it:

The final step is to briefly describe the reason why you are reporting this waypoint. Waypoint admins (those who have access to the "Waypoints Control Panel" item) will see it. Then click "Submit," and the report will be sent!

Now, everyone who views this waypoint will see a warning:

Also, in the list of public waypoints, it will have a poop icon and a gray name:

In the control panel menu, click "View waypoints reports". Then select the report you want to view:

Also, in this list, under each report, it displays the number of reports on this waypoint, its name, and the nickname of its owner.

When you click on a report, you will see detailed information about the waypoint, such as the owner's full nickname, the number of visits, how many players have added it to their favorites, and so on. Additionally, in the "Reports" section, you can read all reports about this waypoint (since multiple players may report the same waypoint).

Also, this menu contains these buttons:

Visit waypoint — allows you to visit the reported waypoint so that you can verify if the report is indeed justified.

Delete reports — This will delete all reports for this waypoint, and remove the "Explore with caution" label and poop icon. Use it if you're sure this waypoint complies with server rules and the reports were baseless.

Punish the owner — Contains various methods of punishment, such as "Unpublish waypoint," "Delete waypoint," and so on. Use them last, as any of these actions will also remove all reports about this waypoint, and you will no longer see it in the reports list!

In the control panel menu, click "Manage featured waypoints". A window will open:

Then click on "New featured waypoint", and a waypoint creation form will open. Now you can set the name, icon, coordinates, dimension, etc. Most of the parameters are automatically filled or have default values, so you don't have to fill them all:

Contains the basic settings of the addon.

Description of the options:

• 🔧"Allow players to unlock the "Waypoints Menu" item in their preferences" - If enabled, a "unlock waypoint menu item" toggle will be displayed in players' preferences, which will unlock the waypoint menu item for the player. If the player activates it, they will be able to drop the waypoint menu item, put it in a chest, etc., and it will also drop upon their death.
• 🔧"Give players who are joining the world for the first time the "Waypoints Menu" item" - If enabled, every new player who joins the world for the first time will receive a waypoints menu item. If the player has visited the world before, they will not receive the item.

Contains language-related settings.

Description of the options:

• 📃"Default language" - The language that will be set in the preferences of players who join the world for the first time
• 🔧"Allow players to change language in their preferences" - If disabled, players will not be able to change the language of their waypoints menu in their preferences.

Here you can configure the waypoint publishing system, its limits and restrictions, or completely disable it for a specific dimension.

This menu contains the following submenus:

Main system switch

Here you can enable or disable the publishing system for a specific dimension. If it is disabled, the "Explore public waypoints" button will not be displayed in the "Waypoints Menu".

Publication count limits

Here you can configure how many waypoints can be simultaneously in a published state from one player in a specific dimension.

Waypoint expiration settings

Here you can configure the maximum allowable expiration time that a player can set when publishing a waypoint in a specific dimension.

The expiration time is the duration during which the waypoint will be publicly accessible, and when it expires, the player needs to republish the waypoint.

Cooldowns between republishing

Here you can configure how often can a player republish their waypoints in a specific dimension.

Republishing - it's "refreshing" a published waypoint by resetting or modifying the expiration countdown. Additionally, it will move the waypoint to the top of the recently published waypoints list and enhances its ranking in other categories. In short, regular republishing shows that the author of the waypoint is active and that the waypoint is not abandoned.

Contains settings that control the limit of waypoints a player can have in a specific dimension, as well as the duration of countdowns during teleportation or when creating waypoints.

This menu contains the following submenus:

Waypoints count limits

Controls how many waypoints each player can have in a specific dimension. The range of values is from 0 to 999, and if it's set to 0, the player won't be able to use waypoints in that dimension.

Teleport countdowns

Controls how many seconds a player must remain still to teleport to a waypoint in a specific dimension. The range of values is from 0 to 999, and if it's set to 0, the teleportation will be instant, without particles or any camera effects.

Create & Update countdowns

Controls how many seconds a player must remain still to create or update a waypoint's coordinates in a specific dimension. The range of values is from 0 to 999, and if it's set to 0, the creation or update of a waypoint will be instant, without particles or any camera effects.

Here you can configure fees that will be charged to players for certain actions with waypoints. Each fee is configured separately for each dimension. By default, all of them are turned off (using the addon for players is free).

Actions for which you can enable fees:

Teleportation fee

Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:

Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).

Available fee types:

XP levels

This fee consumes the player's XP levels when they teleport to their waypoint in the selected dimension. If there are not enough XP levels, the teleportation fails.

List of variables for this fee:

• Teleportation fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Additional fee for every 100 blocks of distance to waypoint - Adds this value to the initial cost for every 100 blocks of distance from the player to the waypoint to which they are teleporting.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

scoreboard

This fee decreases the score in the player's scoreboard when they teleport to their waypoint in the selected dimension. If the score in the scoreboard is not enough, the teleportation fails.

List of variables for this fee:

• Teleportation fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Scoreboard objective name - Enter the name of the objective from which the fee will be deducted from the player. This is not the "display name," but rather the name you used in the command "/scoreboard objectives add <name>". Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
• Additional fee for every 100 blocks of distance to waypoint - Adds this value to the initial cost for every 100 blocks of distance from the player to the waypoint to which they are teleporting.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

Waypoint creation fee

Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:

Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).

Available fee types:

XP levels

This fee consumes the player's XP levels when they create new waypoint in the selected dimension. If there are not enough XP levels, the creation fails.

List of variables for this fee:

• Waypoint creation fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

scoreboard

This fee decreases the score in the player's scoreboard when they create new waypoint in the selected dimension. If the score in the scoreboard is not enough, the creation fails.

List of variables for this fee:

• Waypoint creation fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Scoreboard objective name - Enter the name of the objective from which the fee will be deducted from the player. This is not the "display name," but rather the name you used in the command "/scoreboard objectives add <name>". Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

Waypoint updating fee

Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:

Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).

Available fee types:

XP levels

This fee consumes the player's XP levels when they update waypoint coordinates in the selected dimension. If there are not enough XP levels, the updating fails.

List of variables for this fee:

• Waypoint updating fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Additional fee for every 100 blocks of distance to the previous waypoint coordinates - Adds this value to the initial fee for every 100 blocks of distance from the player to the previous waypoint coordinates.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

scoreboard

This fee decreases the score in the player's scoreboard when they update waypoint coordinates in the selected dimension. If the score in the scoreboard is not enough, the updating fails.

List of variables for this fee:

• Waypoint updating fee - Determines the initial cost, which is also the minimum cost under ideal conditions.
• Scoreboard objective name - Enter the name of the objective from which the fee will be deducted from the player. This is not the "display name," but rather the name you used in the command "/scoreboard objectives add <name>". Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
• Additional fee for every 100 blocks of distance to the previous waypoint coordinates - Adds this value to the initial fee for every 100 blocks of distance from the player to the previous waypoint coordinates.
• Additional fee for every 100 blocks of distance from the player to the center of the current dimension - Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
• Position of the dimension center - The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a "spawn" or "hub", enter its coordinates.

Controls the permissions that a players will have in a specific dimension. By permission, I mean a specific button in the "Waypoints Menu" for players.

The checkboxes in each button indicate the permission state for that button in each dimension. The first checkbox in the row is for the overworld, the second for the nether, and the third for the end.

To change permissions for a specific button, simply click on it, and the permission menu for that button will open:

For example, if I disallow the "teleport to waypoint" button in the overworld, it will not be displayed for players who are in the overworld:

Contains settings related to appearance, effects, and the way pop-ups are displayed. They are applied globally to all players and cannot be changed in their preferences (to prevent cheating by disabling particles and other things).

Description of the options:

• 🔧"Enable particles when teleporting or creating waypoints" - If disabled, particles will not appear around the player and the waypoint during the countdown.
• 🔧"Enable cinematic camera effects when teleporting to waypoints" - If disabled, there will be no camera effects during teleportation to a waypoint, making it more abrupt.
• 🔧"Enable purple camera fade when teleporting to waypoints" - If disabled, the camera will not have a purple fade for a few seconds during teleportation to a waypoint.
• 📃"Popups display mode" - Controls the way pop-ups are displayed during countdown. By pop-up, I mean a small semi-transparent window above the hotbar that displays the countdown, the name of the waypoint, its icon, and other information. It has three display options, each of which affects the size of the pop-up. This setting is mainly used to resolve compatibility issues with addons that use the same method for displaying pop-ups.

Contains strings with sounds played during various events (teleportation, waypoint creation, countdown ticking, etc). The value of each input field should follow this pattern:

"sound.name" [volume, pitch]

• sound.name - The name of the sound to be used in /playsound
• volume - Volume of the played sound (value ranging from 0.1 to 1).
• pitch - Speed multiplier of the played sound (value ranging from 0.1 to 5). A value of 1 equals normal speed.

This menu allows you to perform various manipulations on the waypoints of the selected player, and also allows you to set certain "permissions" specifically for that player.

This menu contains the following sub-menus:

Add waypoint

Instantly adds a new waypoint for the selected player.

Set permissions

It allows you to set permissions for the selected player. The permissions changed here take precedence over the global permissions (which are in the addon config), and overwrite the global permissions for this player.

Unchanged permissions continue to follow global permissions. If the permission matches a global permission, it is marked as "(as in config)", and will follow the global permission.

Delete waypoints

It allows you to delete all waypoints of this player in all dimensions at once.

Open the downloaded BP pack using any archiver and open the file "scripts/user/LANGUAGES.js" preferably in a code editor:

You will see an array of all the languages that this addon uses. Each language has a list of strings:

Select an object with English (or any other language you want to translate from):

And copy the selected text. Then scroll to the end of the file, type a comma after the curly bracket, and paste:

Finally, you can change any string in the new pasted object. Be sure to change id: "en_US" to the identifier of your new language. It can be any string, as long as it is unique for each language

Then compress your modified BP folder into a zip archive with the extension .mcpack and let's import it into Minecraft! (first delete the previous bp pack from the behavior_packs folders which are located in games/com.mojang/ and in games/com.mojang/minecraftWorlds/youworld/)

Now you should have a new language that you created yourself!

❓ Does this addon work on realms? Download the world from your realm, enable the necessary experiments, add this addon to it, and upload it back to the realm. If it still doesn't work, then it's a realm bug
❓Will players preferences and waypoints be saved after updating this addon? Yes of course! But just in case, create a copy of the world.

❓Your addon doesn't work! Please perform all actions listed below:

1. Make sure that the type of your Minecraft version is "release" (not beta or preview), and that the version matches the one indicated in the checklist above.
2. Make sure that in the settings of your world, you have enabled all the experiments listed in the checklist above. If the world is uploaded to a server, check the server control panel for experiments. If they are not available there, download the world, import it into Minecraft, enable all the necessary experiments, and then upload it back to the server.
3. Make sure that in the world settings, only one version of the addon is active in both "behavior packs" and "resource packs," and there are no duplicates or previous versions. If there is at least one duplicate or previous version active at the same time, the addon will not work. The same applies to the world that is uploaded to the server.

❓YOUR ADD-ON IS NOT WORKING IN MY SERVER WORLD BUT IT WORKS IN A NEW EMPTY WORLD, EVEN WHEN I DOWNLOADED THE WORLD FROM THE REALM/SERVER AND TRIED IT IN SINGLEPLAYER!

 Solving this problem is not easy, so please carefully follow the steps below:

Download the world from your Realm/server, and open the world folder. You will see a list of files that looks like this:

Open the "behavior_packs" folder. You will see a list of folders that may have random names or numbers, and these folders represent the add-ons applied to the world. Your task is to delete all the folders that contain my add-on. If you're unsure which add-on is in each folder based on the names, you can open each folder and look for the "pack_icon.png" image to understand what add-on it is. If it is my add-on, then delete that folder.

Once you have deleted all the folders of my add-on from the "behavior_packs" folder, repeat the same steps for the "resource_packs" folder. In other words, delete all the folders of my add-on from that folder as well.

Once you have deleted the folders of my add-on from both the "behavior_packs" and "resource_packs" folders, open the world in the Minecraft settings and take note of or write down the add-ons that are applied to this world. This is important because in the next step, you will be resetting the applied add-ons for the world. (Don't worry, the add-ons themselves won't disappear, you will be able to add them back to this world later)

Now delete these files in the world folder: (highlighted in blue)

Now import the world into Minecraft, and in the world settings, re-add all the add-ons that were applied to this world. When adding my add-on, make sure it is the latest version and compatible with your version of Minecraft.

Once you have re-added all the add-ons, try entering the world in singleplayer. If my add-on is now working, upload this world to your Realm/server, making sure to remove the previous world from the slot.

❓Your addon works in a local world but does not work on the server! Make sure that you have followed all the steps in the previous point. If you are using Aternos, try "turning off and on again" the experiment toggles, as there is a known issue where they sometimes do not activate on the first attempt. Also, ensure that your hosting provider supports script execution in addons (Beta APIs).